11.15. ITK Binary Threshold Image Filter

Produces a two-value (binary) image by marking pixels whose intensity falls inside a chosen range.

Group (Subgroup)

ITKThresholding (Thresholding)

Description

This filter binarizes an image. Every pixel whose value lies between the Lower Threshold and Upper Threshold (inclusive) is set to the Inside Value; every other pixel is set to the Outside Value:

$$ \text{output}(x) = \begin{cases} \text{InsideValue} & \text{if } \text{LowerThreshold} \le x \le \text{UpperThreshold} \ \text{OutsideValue} & \text{otherwise} \end{cases} $$

Parameter Guidance

Lower Threshold / Upper Threshold — the bounds of the “inside” range, in the input image’s intensity units. By default the lower bound is the smallest possible pixel value and the upper bound is the largest, so the range spans everything; in practice you usually set only one of the two — a lower bound to keep everything above a value, or an upper bound to keep everything below a value.
Inside Value — the output value written for pixels inside the range (a uint8 label, default 1).
Outside Value — the output value written for pixels outside the range (a uint8 label, default 0).

Binary threshold result.

Required Input Sources

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

Input Parameter(s)

Parameter Name	Parameter Type	Parameter Notes	Description
Lower Threshold	Scalar Value	Float64	The lower threshold that a pixel value could be and still be considered ‘Inside Value’
Upper Threshold	Scalar Value	Float64	Set the thresholds. The default lower threshold is NumericTraits::NonpositiveMin() . The default upper threshold is NumericTraits::max . An exception is thrown if the lower threshold is greater than the upper threshold.
Inside Value	UInt8		Set the ‘inside’ pixel value. The default value NumericTraits::max()
Outside Value	UInt8		Set the ‘outside’ pixel value. The default value NumericTraits::ZeroValue() .

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

License & Copyright

Please see the description file distributed with this Plugin

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.