Label

cvcuda.label(src: nvcv.Tensor, connectivity: cvcuda.ConnectivityType = <ConnectivityType.CONNECTIVITY_4_2D: 0>, assign_labels: cvcuda.LABEL = <LABEL.FAST: 0>, mask_type: cvcuda.LabelMaskType = <LabelMaskType.REMOVE_ISLANDS_OUTSIDE_MASK_ONLY: 0>, *, count: bool = False, stats: bool = False, max_labels: int = 10000, bg_label: Optional[nvcv.Tensor] = None, min_thresh: Optional[nvcv.Tensor] = None, max_thresh: Optional[nvcv.Tensor] = None, min_size: Optional[nvcv.Tensor] = None, mask: Optional[nvcv.Tensor] = None, stream: Optional[nvcv.cuda.Stream] = None) → tuple[nvcv.Tensor, Optional[nvcv.Tensor], Optional[nvcv.Tensor]]

Executes the Label operation on the given cuda stream.

See also

Refer to the CV-CUDA C API reference for the Label operator for more details and usage examples.

Parameters

src (nvcv.Tensor) – Input tensor to label connected-component regions.
connectivity (cvcuda.ConnectivityType, optional) – Choice to control connectivity of input elements, default is cvcuda.CONNECTIVITY_4_2D.
assign_labels (cvcuda.LABEL, optional) – Choice on how labels are assigned, default is cvcuda.LABEL.FAST.
mask_type (cvcuda.LabelMaskType, optional) – Choice on how the mask is used, default is cvcuda.REMOVE_ISLANDS_OUTSIDE_MASK_ONLY.
count (bool, optional) – Use True to return the count of valid labeled regions.
stats (bool, optional) – Use True to return the statistics of valid labeled regions.
max_labels (Number, optional) – Maximum number of labels to compute statistics for, default is 10000.
bg_label (nvcv.Tensor, optional) – Background tensor to define input values to be considered background labels and thus ignored.
min_thresh (nvcv.Tensor, optional) – Minimum threshold tensor to mask input values below it to be 0, and others 1.
max_thresh (nvcv.Tensor, optional) – Maximum threshold tensor to mask input values above it to be 0, and others 1.
min_size (nvcv.Tensor, optional) – Minimum size tensor to remove islands, i.e. labeled regions with number of elements less than the minimum size.
mask (nvcv.Tensor, optional) – Mask tensor, its behavior is controlled by ref mask_type. One choice is to control island removal in addition to ref min_size, i.e. regions with at least one element inside the mask (non-zero values) are not removed in case mask_type is cvcuda.REMOVE_ISLANDS_OUTSIDE_MASK_ONLY.
stream (nvcv.cuda.Stream, optional) – CUDA Stream on which to perform the operation.

Returns

A tuple with output labels, count of regions and their statistics.: The count or stats tensors may be None if theirs arguments are False.

Return type

Tuple[nvcv.Tensor, nvcv.Tensor, nvcv.Tensor]

Caution

Restrictions to several arguments may apply. Check the C API references of the CV-CUDA operator.

cvcuda.label_into(dst: nvcv.Tensor, count: Optional[nvcv.Tensor] = None, stats: Optional[nvcv.Tensor] = None, src: nvcv.Tensor, connectivity: cvcuda.ConnectivityType = <ConnectivityType.CONNECTIVITY_4_2D: 0>, assign_labels: cvcuda.LABEL = <LABEL.FAST: 0>, mask_type: cvcuda.LabelMaskType = <LabelMaskType.REMOVE_ISLANDS_OUTSIDE_MASK_ONLY: 0>, *, bg_label: Optional[nvcv.Tensor] = None, min_thresh: Optional[nvcv.Tensor] = None, max_thresh: Optional[nvcv.Tensor] = None, min_size: Optional[nvcv.Tensor] = None, mask: Optional[nvcv.Tensor] = None, stream: Optional[nvcv.cuda.Stream] = None) → tuple[nvcv.Tensor, Optional[nvcv.Tensor], Optional[nvcv.Tensor]]

Executes the Label operation on the given cuda stream.