cupyx.scipy.ndimage.binary_hit_or_miss#

cupyx.scipy.ndimage.binary_hit_or_miss(input, structure1=None, structure2=None, output=None, origin1=0, origin2=None, *, axes=None)[source]#

Multidimensional binary hit-or-miss transform.

The hit-or-miss transform finds the locations of a given pattern inside the input image.

Parameters:

input (cupy.ndarray) – Binary image where a pattern is to be detected.
structure1 (cupy.ndarray, optional) – Part of the structuring element to be fitted to the foreground (non-zero elements) of input. If no value is provided, a structure of square connectivity 1 is chosen.
structure2 (cupy.ndarray, optional) – Second part of the structuring element that has to miss completely the foreground. If no value is provided, the complementary of structure1 is taken.
output (cupy.ndarray, dtype or None, optional) – Array of the same shape as input, into which the output is placed. By default, a new array is created.
origin1 (int or tuple of ints, optional) – Placement of the first part of the structuring element structure1, by default 0 for a centered structure.
origin2 (int or tuple of ints or None, optional) – Placement of the second part of the structuring element structure2, by default 0 for a centered structure. If a value is provided for origin1 and not for origin2, then origin2 is set to origin1.
axes (tuple of int or None) – The axes over which to apply the filter. If None, input is filtered along all axes. If an origin tuple is provided, its length must match the number of axes.

Returns:

Hit-or-miss transform of input with the given structuring element (structure1, structure2).

Return type:

cupy.ndarray

Warning

This function may synchronize the device.