cupyx.scipy.ndimage.maximum_position

cupyx.scipy.ndimage.maximum_position(input, labels=None, index=None)

Find the positions of the maximums of the values of an array at labels.

For each region specified by labels, the position of the maximum value of input within the region is returned.

Parameters
  • input (cupy.ndarray) – Array of values. For each region specified by labels, the maximal values of input over the region is computed.

  • labels (cupy.ndarray, optional) –

    An array of integers marking different regions over which the position of the maximum value of input is to be computed. labels must have the same shape as input. If labels is not specified, the location of the first maximum over the whole array is returned.

    The labels argument only works when index is specified.

  • index (array_like, optional) –

    A list of region labels that are taken into account for finding the location of the maxima. If index is None, the first maximum over all elements where labels is non-zero is returned.

    The index argument only works when labels is specified.

Returns

Tuple of ints or list of tuples of ints that specify the location of maxima of input over the regions determaxed by labels and whose index is in index.

If index or labels are not specified, a tuple of ints is returned specifying the location of the first maximal value of input.

Note

When input has multiple identical maxima within a labeled region, the coordinates returned are not guaranteed to match those returned by SciPy.