measure_threshT_measure_threshMeasureThreshMeasureThresh (Operator)

Name

measure_threshT_measure_threshMeasureThreshMeasureThresh — Extracting points with a particular gray value along a rectangle or an annular arc.

Signature

measure_thresh(Image : : MeasureHandle, Sigma, Threshold, Select : RowThresh, ColumnThresh, Distance)

Herror T_measure_thresh(const Hobject Image, const Htuple MeasureHandle, const Htuple Sigma, const Htuple Threshold, const Htuple Select, Htuple* RowThresh, Htuple* ColumnThresh, Htuple* Distance)

void MeasureThresh(const HObject& Image, const HTuple& MeasureHandle, const HTuple& Sigma, const HTuple& Threshold, const HTuple& Select, HTuple* RowThresh, HTuple* ColumnThresh, HTuple* Distance)

void HMeasure::MeasureThresh(const HImage& Image, double Sigma, double Threshold, const HString& Select, HTuple* RowThresh, HTuple* ColumnThresh, HTuple* Distance) const

void HMeasure::MeasureThresh(const HImage& Image, double Sigma, double Threshold, const char* Select, HTuple* RowThresh, HTuple* ColumnThresh, HTuple* Distance) const

void HMeasure::MeasureThresh(const HImage& Image, double Sigma, double Threshold, const wchar_t* Select, HTuple* RowThresh, HTuple* ColumnThresh, HTuple* Distance) const   (Windows only)

void HImage::MeasureThresh(const HMeasure& MeasureHandle, double Sigma, double Threshold, const HString& Select, HTuple* RowThresh, HTuple* ColumnThresh, HTuple* Distance) const

void HImage::MeasureThresh(const HMeasure& MeasureHandle, double Sigma, double Threshold, const char* Select, HTuple* RowThresh, HTuple* ColumnThresh, HTuple* Distance) const

void HImage::MeasureThresh(const HMeasure& MeasureHandle, double Sigma, double Threshold, const wchar_t* Select, HTuple* RowThresh, HTuple* ColumnThresh, HTuple* Distance) const   (Windows only)

static void HOperatorSet.MeasureThresh(HObject image, HTuple measureHandle, HTuple sigma, HTuple threshold, HTuple select, out HTuple rowThresh, out HTuple columnThresh, out HTuple distance)

void HMeasure.MeasureThresh(HImage image, double sigma, double threshold, string select, out HTuple rowThresh, out HTuple columnThresh, out HTuple distance)

void HImage.MeasureThresh(HMeasure measureHandle, double sigma, double threshold, string select, out HTuple rowThresh, out HTuple columnThresh, out HTuple distance)

Description

measure_threshmeasure_threshMeasureThreshMeasureThreshMeasureThresh extracts points for which the gray value within an one-dimensional gray value profile is equal to the specified threshold ThresholdThresholdThresholdThresholdthreshold. The gray value profile is projected onto the major axis of the measure rectangle which is passed with the parameter MeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandle, so the threshold points calculated within the gray value profile correspond to certain image coordinates on the rectangle's major axis. These coordinates are returned as the operator results in RowThreshRowThreshRowThreshRowThreshrowThresh and ColumnThreshColumnThreshColumnThreshColumnThreshcolumnThresh.

For an explanation of the concept of 1D measuring see the introduction of chapter 1D Measuring.

If the gray value profile intersects the threshold line for several times, the parameter SelectSelectSelectSelectselect determines which values to return. Possible settings are 'first'"first""first""first""first", 'last'"last""last""last""last", 'first_last'"first_last""first_last""first_last""first_last" (first and last) or 'all'"all""all""all""all". For the last two cases DistanceDistanceDistanceDistancedistance returns the distances between the calculated points.

The gray value profile is created by averaging the gray values along all line segments, which are defined by the measure rectangle as follows:

  1. The segments are perpendicular to the major axis of the rectangle,

  2. they have an integer distance to the center of the rectangle,

  3. the rectangle bounds the segments.

For every line segment, the average of the gray values of all points with an integer distance to the major axis is calculated. Due to translation and rotation of the measure rectangle with respect to the image coordinates the input image ImageImageImageImageimage is in general sampled at subpixel positions.

Since this involves some calculations which can be used repeatedly in several projections, the operator gen_measure_rectangle2gen_measure_rectangle2GenMeasureRectangle2GenMeasureRectangle2GenMeasureRectangle2 is used to perform these calculations only once in advance. Here, the measure object MeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandle is generated and different interpolation schemes can be selected.

Attention

measure_threshmeasure_threshMeasureThreshMeasureThreshMeasureThresh only returns meaningful results if the assumptions that the edges are straight and perpendicular to the major axis of the rectangle are fulfilled. Thus, it should not be used to extract edges from curved objects, for example. Furthermore, the user should ensure that the rectangle is as close to perpendicular as possible to the edges in the image. Additionally, SigmaSigmaSigmaSigmasigma must not become larger than approx. 0.5 * Length1 (for Length1 see gen_measure_rectangle2gen_measure_rectangle2GenMeasureRectangle2GenMeasureRectangle2GenMeasureRectangle2).

It should be kept in mind that measure_threshmeasure_threshMeasureThreshMeasureThreshMeasureThresh ignores the domain of ImageImageImageImageimage for efficiency reasons. If certain regions in the image should be excluded from the measurement a new measure object with appropriately modified parameters should be generated.

Execution Information

Parameters

ImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHobject (byte / uint2 / real)

Input image.

MeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandle (input_control)  measure HMeasure, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Measure object handle.

SigmaSigmaSigmaSigmasigma (input_control)  number HTupleHTupleHtuple (real) (double) (double) (double)

Sigma of gaussian smoothing.

Default value: 1.0

Suggested values: 0.0, 0.4, 0.6, 0.8, 1.0, 1.5, 2.0, 3.0, 4.0, 5.0, 7.0, 10.0

Typical range of values: 0.4 ≤ Sigma Sigma Sigma Sigma sigma ≤ 100 (lin)

Minimum increment: 0.01

Recommended increment: 0.1

Restriction: Sigma >= 0.0

ThresholdThresholdThresholdThresholdthreshold (input_control)  number HTupleHTupleHtuple (real) (double) (double) (double)

Threshold.

Default value: 128.0

Typical range of values: 0 ≤ Threshold Threshold Threshold Threshold threshold ≤ 255 (lin)

Minimum increment: 0.5

Recommended increment: 1

SelectSelectSelectSelectselect (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Selection of points.

Default value: 'all' "all" "all" "all" "all"

List of values: 'all'"all""all""all""all", 'first'"first""first""first""first", 'first_last'"first_last""first_last""first_last""first_last", 'last'"last""last""last""last"

RowThreshRowThreshRowThreshRowThreshrowThresh (output_control)  point.y-array HTupleHTupleHtuple (real) (double) (double) (double)

Row coordinates of points with threshold value.

ColumnThreshColumnThreshColumnThreshColumnThreshcolumnThresh (output_control)  point.x-array HTupleHTupleHtuple (real) (double) (double) (double)

Column coordinates of points with threshold value.

DistanceDistanceDistanceDistancedistance (output_control)  real-array HTupleHTupleHtuple (real) (double) (double) (double)

Distance between consecutive points.

Result

If the parameter values are correct the operator measure_threshmeasure_threshMeasureThreshMeasureThreshMeasureThresh returns the value 2 (H_MSG_TRUE). Otherwise, an exception is raised.

Possible Predecessors

gen_measure_rectangle2gen_measure_rectangle2GenMeasureRectangle2GenMeasureRectangle2GenMeasureRectangle2

Possible Successors

close_measureclose_measureCloseMeasureCloseMeasureCloseMeasure

Alternatives

measure_posmeasure_posMeasurePosMeasurePosMeasurePos, edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPix, measure_pairsmeasure_pairsMeasurePairsMeasurePairsMeasurePairs

Module

1D Metrology