measure_pairsT_measure_pairsMeasurePairsMeasurePairsmeasure_pairs (Operator)
Name
measure_pairsT_measure_pairsMeasurePairsMeasurePairsmeasure_pairs — Extract straight edge pairs perpendicular to a rectangle or annular arc.
Signature
measure_pairs(Image : : MeasureHandle, Sigma, Threshold, Transition, Select : RowEdgeFirst, ColumnEdgeFirst, AmplitudeFirst, RowEdgeSecond, ColumnEdgeSecond, AmplitudeSecond, IntraDistance, InterDistance)
Herror T_measure_pairs(const Hobject Image, const Htuple MeasureHandle, const Htuple Sigma, const Htuple Threshold, const Htuple Transition, const Htuple Select, Htuple* RowEdgeFirst, Htuple* ColumnEdgeFirst, Htuple* AmplitudeFirst, Htuple* RowEdgeSecond, Htuple* ColumnEdgeSecond, Htuple* AmplitudeSecond, Htuple* IntraDistance, Htuple* InterDistance)
void MeasurePairs(const HObject& Image, const HTuple& MeasureHandle, const HTuple& Sigma, const HTuple& Threshold, const HTuple& Transition, const HTuple& Select, HTuple* RowEdgeFirst, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* IntraDistance, HTuple* InterDistance)
void HMeasure::MeasurePairs(const HImage& Image, double Sigma, double Threshold, const HString& Transition, const HString& Select, HTuple* RowEdgeFirst, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* IntraDistance, HTuple* InterDistance) const
void HMeasure::MeasurePairs(const HImage& Image, double Sigma, double Threshold, const char* Transition, const char* Select, HTuple* RowEdgeFirst, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* IntraDistance, HTuple* InterDistance) const
void HMeasure::MeasurePairs(const HImage& Image, double Sigma, double Threshold, const wchar_t* Transition, const wchar_t* Select, HTuple* RowEdgeFirst, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* IntraDistance, HTuple* InterDistance) const
(Windows only)
void HImage::MeasurePairs(const HMeasure& MeasureHandle, double Sigma, double Threshold, const HString& Transition, const HString& Select, HTuple* RowEdgeFirst, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* IntraDistance, HTuple* InterDistance) const
void HImage::MeasurePairs(const HMeasure& MeasureHandle, double Sigma, double Threshold, const char* Transition, const char* Select, HTuple* RowEdgeFirst, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* IntraDistance, HTuple* InterDistance) const
void HImage::MeasurePairs(const HMeasure& MeasureHandle, double Sigma, double Threshold, const wchar_t* Transition, const wchar_t* Select, HTuple* RowEdgeFirst, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* IntraDistance, HTuple* InterDistance) const
(Windows only)
static void HOperatorSet.MeasurePairs(HObject image, HTuple measureHandle, HTuple sigma, HTuple threshold, HTuple transition, HTuple select, out HTuple rowEdgeFirst, out HTuple columnEdgeFirst, out HTuple amplitudeFirst, out HTuple rowEdgeSecond, out HTuple columnEdgeSecond, out HTuple amplitudeSecond, out HTuple intraDistance, out HTuple interDistance)
void HMeasure.MeasurePairs(HImage image, double sigma, double threshold, string transition, string select, out HTuple rowEdgeFirst, out HTuple columnEdgeFirst, out HTuple amplitudeFirst, out HTuple rowEdgeSecond, out HTuple columnEdgeSecond, out HTuple amplitudeSecond, out HTuple intraDistance, out HTuple interDistance)
void HImage.MeasurePairs(HMeasure measureHandle, double sigma, double threshold, string transition, string select, out HTuple rowEdgeFirst, out HTuple columnEdgeFirst, out HTuple amplitudeFirst, out HTuple rowEdgeSecond, out HTuple columnEdgeSecond, out HTuple amplitudeSecond, out HTuple intraDistance, out HTuple interDistance)
def measure_pairs(image: HObject, measure_handle: HHandle, sigma: float, threshold: float, transition: str, select: str) -> Tuple[Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float]]
Description
measure_pairsmeasure_pairsMeasurePairsMeasurePairsMeasurePairsmeasure_pairs serves to extract straight edge pairs
which lie perpendicular to the major axis of a rectangle or
annular arc.
For an explanation of the concept of 1D measuring see the introduction of
chapter 1D Measuring.
The extraction algorithm of measure_pairsmeasure_pairsMeasurePairsMeasurePairsMeasurePairsmeasure_pairs
is identical to measure_posmeasure_posMeasurePosMeasurePosMeasurePosmeasure_pos. In addition
the edges are grouped to pairs: If TransitionTransitionTransitionTransitiontransitiontransition = 'positive'"positive""positive""positive""positive""positive",
the edge points with a dark-to-light transition in the direction of the major
axis of the rectangle are returned in RowEdgeFirstRowEdgeFirstRowEdgeFirstRowEdgeFirstrowEdgeFirstrow_edge_first and
ColumnEdgeFirstColumnEdgeFirstColumnEdgeFirstColumnEdgeFirstcolumnEdgeFirstcolumn_edge_first. In this case, the corresponding edges with a
light-to-dark transition are returned in RowEdgeSecondRowEdgeSecondRowEdgeSecondRowEdgeSecondrowEdgeSecondrow_edge_second and
ColumnEdgeSecondColumnEdgeSecondColumnEdgeSecondColumnEdgeSecondcolumnEdgeSecondcolumn_edge_second. If TransitionTransitionTransitionTransitiontransitiontransition = 'negative'"negative""negative""negative""negative""negative", the
behavior is exactly opposite. If TransitionTransitionTransitionTransitiontransitiontransition = 'all'"all""all""all""all""all", the
first detected edge defines the transition for RowEdgeFirstRowEdgeFirstRowEdgeFirstRowEdgeFirstrowEdgeFirstrow_edge_first and
ColumnEdgeFirstColumnEdgeFirstColumnEdgeFirstColumnEdgeFirstcolumnEdgeFirstcolumn_edge_first. I.e., dependent on the positioning of the measure
object, edge pairs with a light-dark-light transition or edge pairs with a
dark-light-dark transition are returned. This is suited, e.g., to measure
objects with different brightness relative to the background.
If more than one consecutive edge with
the same transition is found, the first one is used as a pair element. This
behavior may cause problems in applications in which the threshold
ThresholdThresholdThresholdThresholdthresholdthreshold cannot be selected high enough to suppress consecutive
edges of the same transition. For these applications, a second pairing mode
exists that only selects the respective strongest edges of a sequence of
consecutive rising and falling edges. This mode is selected by appending
'_strongest'"_strongest""_strongest""_strongest""_strongest""_strongest" to any of the above modes for TransitionTransitionTransitionTransitiontransitiontransition,
e.g., 'negative_strongest'"negative_strongest""negative_strongest""negative_strongest""negative_strongest""negative_strongest". Finally, it is possible to select which
edge pairs are returned. If SelectSelectSelectSelectselectselect is set to 'all'"all""all""all""all""all", all
edge pairs are returned. If it is set to 'first'"first""first""first""first""first", only the first of
the extracted edge pairs is returned, while it is set to 'last'"last""last""last""last""last",
only the last one is returned.
The extracted edges are returned as single points which lie on the
major axis of the rectangle. The corresponding edge amplitudes are
returned in AmplitudeFirstAmplitudeFirstAmplitudeFirstAmplitudeFirstamplitudeFirstamplitude_first and AmplitudeSecondAmplitudeSecondAmplitudeSecondAmplitudeSecondamplitudeSecondamplitude_second.
In addition, the distance between each edge pair is returned in
IntraDistanceIntraDistanceIntraDistanceIntraDistanceintraDistanceintra_distance and the distance between consecutive edge
pairs is returned in InterDistanceInterDistanceInterDistanceInterDistanceinterDistanceinter_distance. Here, IntraDistance[i]
corresponds to the distance between EdgeFirst[i] and EdgeSecond[i],
while InterDistance[i] corresponds to the distance between
EdgeSecond[i] and EdgeFirst[i+1], i.e., the tuple
InterDistanceInterDistanceInterDistanceInterDistanceinterDistanceinter_distance contains one element less than the tuples
of the edge pairs.
Attention
measure_pairsmeasure_pairsMeasurePairsMeasurePairsMeasurePairsmeasure_pairs 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,
SigmaSigmaSigmaSigmasigmasigma must not become larger than approx. 0.5 * Length1
(for Length1 see gen_measure_rectangle2gen_measure_rectangle2GenMeasureRectangle2GenMeasureRectangle2GenMeasureRectangle2gen_measure_rectangle2).
It should be kept in mind that measure_pairsmeasure_pairsMeasurePairsMeasurePairsMeasurePairsmeasure_pairs ignores the
domain of ImageImageImageImageimageimage 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
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
ImageImageImageImageimageimage (input_object) singlechannelimage → objectHImageHObjectHImageHobject (byte / uint2 / real)
Input image.
MeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandlemeasure_handle (input_control) measure → HMeasure, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Measure object handle.
SigmaSigmaSigmaSigmasigmasigma (input_control) number → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Sigma of gaussian smoothing.
Default value: 1.0
Suggested values: 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
sigma
≤
100 (lin)
Minimum increment: 0.01
Recommended increment: 0.1
Restriction: Sigma >= 0.4
ThresholdThresholdThresholdThresholdthresholdthreshold (input_control) number → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Minimum edge amplitude.
Default value: 30.0
Suggested values: 5.0, 10.0, 20.0, 30.0, 40.0, 50.0, 60.0, 70.0, 90.0, 110.0
Typical range of values: 1
≤
Threshold
Threshold
Threshold
Threshold
threshold
threshold
≤
255 (lin)
Minimum increment: 0.5
Recommended increment: 2
TransitionTransitionTransitionTransitiontransitiontransition (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Type of gray value transition that determines
how edges are grouped to edge pairs.
Default value:
'all'
"all"
"all"
"all"
"all"
"all"
List of values: 'all'"all""all""all""all""all", 'all_strongest'"all_strongest""all_strongest""all_strongest""all_strongest""all_strongest", 'negative'"negative""negative""negative""negative""negative", 'negative_strongest'"negative_strongest""negative_strongest""negative_strongest""negative_strongest""negative_strongest", 'positive'"positive""positive""positive""positive""positive", 'positive_strongest'"positive_strongest""positive_strongest""positive_strongest""positive_strongest""positive_strongest"
SelectSelectSelectSelectselectselect (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Selection of edge pairs.
Default value:
'all'
"all"
"all"
"all"
"all"
"all"
List of values: 'all'"all""all""all""all""all", 'first'"first""first""first""first""first", 'last'"last""last""last""last""last"
RowEdgeFirstRowEdgeFirstRowEdgeFirstRowEdgeFirstrowEdgeFirstrow_edge_first (output_control) point.y-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Row coordinate of the center of the first edge.
ColumnEdgeFirstColumnEdgeFirstColumnEdgeFirstColumnEdgeFirstcolumnEdgeFirstcolumn_edge_first (output_control) point.x-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Column coordinate of the center of the first edge.
AmplitudeFirstAmplitudeFirstAmplitudeFirstAmplitudeFirstamplitudeFirstamplitude_first (output_control) real-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Edge amplitude of the first edge (with sign).
RowEdgeSecondRowEdgeSecondRowEdgeSecondRowEdgeSecondrowEdgeSecondrow_edge_second (output_control) point.y-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Row coordinate of the center of the second edge.
ColumnEdgeSecondColumnEdgeSecondColumnEdgeSecondColumnEdgeSecondcolumnEdgeSecondcolumn_edge_second (output_control) point.x-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Column coordinate of the center of the second
edge.
AmplitudeSecondAmplitudeSecondAmplitudeSecondAmplitudeSecondamplitudeSecondamplitude_second (output_control) real-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Edge amplitude of the second edge (with sign).
IntraDistanceIntraDistanceIntraDistanceIntraDistanceintraDistanceintra_distance (output_control) real-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Distance between edges of an edge pair.
InterDistanceInterDistanceInterDistanceInterDistanceinterDistanceinter_distance (output_control) real-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Distance between consecutive edge pairs.
Result
If the parameter values are correct the operator measure_pairsmeasure_pairsMeasurePairsMeasurePairsMeasurePairsmeasure_pairs
returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.
Possible Predecessors
gen_measure_rectangle2gen_measure_rectangle2GenMeasureRectangle2GenMeasureRectangle2GenMeasureRectangle2gen_measure_rectangle2
Possible Successors
close_measureclose_measureCloseMeasureCloseMeasureCloseMeasureclose_measure
Alternatives
edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPixedges_sub_pix,
fuzzy_measure_pairsfuzzy_measure_pairsFuzzyMeasurePairsFuzzyMeasurePairsFuzzyMeasurePairsfuzzy_measure_pairs,
fuzzy_measure_pairingfuzzy_measure_pairingFuzzyMeasurePairingFuzzyMeasurePairingFuzzyMeasurePairingfuzzy_measure_pairing
See also
measure_posmeasure_posMeasurePosMeasurePosMeasurePosmeasure_pos,
fuzzy_measure_posfuzzy_measure_posFuzzyMeasurePosFuzzyMeasurePosFuzzyMeasurePosfuzzy_measure_pos
Module
1D Metrology