11.23. ITK Dilate Object Morphology Image Filter

Grows (dilates) a single labeled object in a mask image — a fast single-object variant of binary dilation.

Group (Subgroup)

ITKBinaryMathematicalMorphology (BinaryMathematicalMorphology)

Description

This filter dilates one object in a mask image. Pixels whose value equals the Object Value are treated as the object (foreground); all other pixels are background. Wherever an object pixel is adjacent to a background pixel, the structuring element (the probe shape swept over the image) is centered on the object pixel and the background pixels it covers are set to the object value, growing the object outward. It is intended for masks that contain a single object; to dilate any of several segment values in a general segmented image, use ITK Binary Dilate Image Filter.

Parameter Guidance

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

  • Kernel Radius — the radius of the structuring element, in pixels (one value per axis). The object grows 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

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.