11.26. ITK Erode Object Morphology Image Filter

Shrinks (erodes) a single labeled object in a mask image — a fast single-object variant of binary erosion.

Group (Subgroup)

ITKBinaryMathematicalMorphology (BinaryMathematicalMorphology)

Description

This filter erodes one object in a mask image. Pixels whose value equals the Object Value are treated as the object; all other pixels are background. Wherever an object pixel sits at the boundary with background, the structuring element (the probe shape swept over the image) is centered on it and the covered neighboring pixels are set to the Background Value, shrinking the object inward. It is intended for masks that contain a single object; to erode any of several segment values in a general segmented image, use ITK Binary Erode Image Filter.

Parameter Guidance

  • Object Value — the pixel value of the object to erode. Default 1.

  • Background Value — the value assigned to eroded pixels. Default 0.

  • Kernel Radius — the radius of the structuring element, in pixels (one value per axis). The object shrinks by this amount.

Kernel Type

The Kernel Type parameter selects the structuring element shape:

  • Annulus [0]: A ring-shaped structuring element.

  • Ball [1]: A spherical structuring element (default). Most commonly used for general morphological operations.

  • Box [2]: A rectangular/cuboid structuring element.

  • Cross [3]: A cross-shaped structuring element.

Required Input Sources

Operates on a binary/single-object mask image — typically the output of a thresholding filter such as ITK Binary Threshold Image Filter or Multi-Threshold Objects.

Input Parameter(s)

Parameter Name

Parameter Type

Parameter Notes

Description

Kernel Radius

Vector of UInt32 Values

Order=X,Y,Z

The radius of the kernel structuring element.

Kernel Type

Choices

Set the kernel or structuring element used for the morphology.

Object Value

Scalar Value

Float64

The pixel value of the ‘Object’ to be dilated

Background Value

Scalar Value

Float64

Set the value to be assigned to eroded pixels

Input Cell Data

Parameter Name

Parameter Type

Parameter Notes

Description

Image Geometry

Geometry Selection

Image

Select the Image Geometry Group from the DataStructure.

Input Cell Data

Array Selection

Allowed Types: int8, uint8, int16, uint16, int32, uint32, int64, uint64, float32, float64

The image data that will be processed by this filter.

Output Cell Data

Parameter Name

Parameter Type

Parameter Notes

Description

Output Cell Data

DataObjectName

The result of the processing will be stored in this Data Array inside the same group as the input data.

Example Pipelines

DREAM3D-NX Help

If you need help, need to file a bug report or want to request a new feature, please head over to the DREAM3DNX-Issues GitHub site where the community of DREAM3D-NX users can help answer your questions.