11.35. ITK Grayscale Grind Peak Image Filter

Removes bright “peaks” from a grayscale image — enclosed bright spots that are not connected to the image border.

Group (Subgroup)

ITKMathematicalMorphology (MathematicalMorphology)

Description

This filter removes peaks in a grayscale image. A peak is a local maximum (a bright spot) that is fully enclosed by darker pixels and not connected to the image border. The filter lowers each peak down to the gray level of the surrounding pixels, smoothing over bright spots while leaving dark features (local minima) untouched. It is the exact dual of ITK Grayscale Fillhole Image Filter.

A useful trick: subtract this filter’s output from the original image (and optionally threshold the difference) to obtain a map of the bright spots that were removed.

Parameter Guidance

  • Fully Connected — controls neighbor connectivity when deciding whether a region is “enclosed” (face-only versus face + edge + corner). Turn it on for thin, one-pixel-wide structures.

Required Input Sources

Operates on any scalar (grayscale) image — typically from Read Image, Read Images [3D Stack], or the output of a prior ITK image filter.

Grayscale grind-peak example.

Reference

Pierre Soille, Morphological Image Analysis: Principles and Applications, Second Edition, Springer, 2003 (Chapter 6).

Input Parameter(s)

Parameter Name

Parameter Type

Parameter Notes

Description

Fully Connected

Bool

Set/Get whether the connected components are defined strictly by face connectivity or by face+edge+vertex connectivity. Default is FullyConnectedOff. For objects that are 1 pixel wide, use FullyConnectedOn.

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.