fuzzy_measure_pairsfuzzy_measure_pairsFuzzyMeasurePairsFuzzyMeasurePairsfuzzy_measure_pairsT_fuzzy_measure_pairs
Short description
fuzzy_measure_pairsfuzzy_measure_pairsFuzzyMeasurePairsFuzzyMeasurePairsfuzzy_measure_pairsT_fuzzy_measure_pairs — Extract straight edge pairs perpendicular to a rectangle or an annular arc.
Signature
fuzzy_measure_pairs( image Image, measure MeasureHandle, number Sigma, number AmpThresh, number FuzzyThresh, string Transition, out point.y RowEdgeFirst, out point.x ColumnEdgeFirst, out real AmplitudeFirst, out point.y RowEdgeSecond, out point.x ColumnEdgeSecond, out real AmplitudeSecond, out point.y RowEdgeCenter, out point.x ColumnEdgeCenter, out real FuzzyScore, out real IntraDistance, out real InterDistance )fuzzy_measure_pairs( Image : : MeasureHandle, Sigma, AmpThresh, FuzzyThresh, Transition : RowEdgeFirst, ColumnEdgeFirst, AmplitudeFirst, RowEdgeSecond, ColumnEdgeSecond, AmplitudeSecond, RowEdgeCenter, ColumnEdgeCenter, FuzzyScore, IntraDistance, InterDistance )void FuzzyMeasurePairs( const HObject& Image, const HTuple& MeasureHandle, const HTuple& Sigma, const HTuple& AmpThresh, const HTuple& FuzzyThresh, const HTuple& Transition, HTuple* RowEdgeFirst, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* RowEdgeCenter, HTuple* ColumnEdgeCenter, HTuple* FuzzyScore, HTuple* IntraDistance, HTuple* InterDistance )static void HOperatorSet.FuzzyMeasurePairs( HObject image, HTuple measureHandle, HTuple sigma, HTuple ampThresh, HTuple fuzzyThresh, HTuple transition, out HTuple rowEdgeFirst, out HTuple columnEdgeFirst, out HTuple amplitudeFirst, out HTuple rowEdgeSecond, out HTuple columnEdgeSecond, out HTuple amplitudeSecond, out HTuple rowEdgeCenter, out HTuple columnEdgeCenter, out HTuple fuzzyScore, out HTuple intraDistance, out HTuple interDistance )def fuzzy_measure_pairs( image: HObject, measure_handle: HHandle, sigma: float, amp_thresh: float, fuzzy_thresh: float, transition: str ) -> Tuple[Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float]]
Herror T_fuzzy_measure_pairs( const Hobject Image, const Htuple MeasureHandle, const Htuple Sigma, const Htuple AmpThresh, const Htuple FuzzyThresh, const Htuple Transition, Htuple* RowEdgeFirst, Htuple* ColumnEdgeFirst, Htuple* AmplitudeFirst, Htuple* RowEdgeSecond, Htuple* ColumnEdgeSecond, Htuple* AmplitudeSecond, Htuple* RowEdgeCenter, Htuple* ColumnEdgeCenter, Htuple* FuzzyScore, Htuple* IntraDistance, Htuple* InterDistance )
void HMeasure::FuzzyMeasurePairs( const HImage& Image, double Sigma, double AmpThresh, double FuzzyThresh, const HString& Transition, HTuple* RowEdgeFirst, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* RowEdgeCenter, HTuple* ColumnEdgeCenter, HTuple* FuzzyScore, HTuple* IntraDistance, HTuple* InterDistance ) const
void HMeasure::FuzzyMeasurePairs( const HImage& Image, double Sigma, double AmpThresh, double FuzzyThresh, const char* Transition, HTuple* RowEdgeFirst, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* RowEdgeCenter, HTuple* ColumnEdgeCenter, HTuple* FuzzyScore, HTuple* IntraDistance, HTuple* InterDistance ) const
void HMeasure::FuzzyMeasurePairs( const HImage& Image, double Sigma, double AmpThresh, double FuzzyThresh, const wchar_t* Transition, HTuple* RowEdgeFirst, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* RowEdgeCenter, HTuple* ColumnEdgeCenter, HTuple* FuzzyScore, HTuple* IntraDistance, HTuple* InterDistance ) const (Windows only)
void HImage::FuzzyMeasurePairs( const HMeasure& MeasureHandle, double Sigma, double AmpThresh, double FuzzyThresh, const HString& Transition, HTuple* RowEdgeFirst, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* RowEdgeCenter, HTuple* ColumnEdgeCenter, HTuple* FuzzyScore, HTuple* IntraDistance, HTuple* InterDistance ) const
void HImage::FuzzyMeasurePairs( const HMeasure& MeasureHandle, double Sigma, double AmpThresh, double FuzzyThresh, const char* Transition, HTuple* RowEdgeFirst, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* RowEdgeCenter, HTuple* ColumnEdgeCenter, HTuple* FuzzyScore, HTuple* IntraDistance, HTuple* InterDistance ) const
void HImage::FuzzyMeasurePairs( const HMeasure& MeasureHandle, double Sigma, double AmpThresh, double FuzzyThresh, const wchar_t* Transition, HTuple* RowEdgeFirst, HTuple* ColumnEdgeFirst, HTuple* AmplitudeFirst, HTuple* RowEdgeSecond, HTuple* ColumnEdgeSecond, HTuple* AmplitudeSecond, HTuple* RowEdgeCenter, HTuple* ColumnEdgeCenter, HTuple* FuzzyScore, HTuple* IntraDistance, HTuple* InterDistance ) const (Windows only)
void HMeasure.FuzzyMeasurePairs( HImage image, double sigma, double ampThresh, double fuzzyThresh, string transition, out HTuple rowEdgeFirst, out HTuple columnEdgeFirst, out HTuple amplitudeFirst, out HTuple rowEdgeSecond, out HTuple columnEdgeSecond, out HTuple amplitudeSecond, out HTuple rowEdgeCenter, out HTuple columnEdgeCenter, out HTuple fuzzyScore, out HTuple intraDistance, out HTuple interDistance )
void HImage.FuzzyMeasurePairs( HMeasure measureHandle, double sigma, double ampThresh, double fuzzyThresh, string transition, out HTuple rowEdgeFirst, out HTuple columnEdgeFirst, out HTuple amplitudeFirst, out HTuple rowEdgeSecond, out HTuple columnEdgeSecond, out HTuple amplitudeSecond, out HTuple rowEdgeCenter, out HTuple columnEdgeCenter, out HTuple fuzzyScore, out HTuple intraDistance, out HTuple interDistance )
Description
fuzzy_measure_pairsFuzzyMeasurePairs serves to extract straight edge
pairs which lie perpendicular to the major axis of a
rectangle or an annular arc. In addition to measure_pairsMeasurePairs it uses
fuzzy functions to evaluate and select the edge pairs.
For an explanation of the concept of 1D measuring see the introduction of
chapter 1D Measuring.
The extraction algorithm of fuzzy_measure_pairsFuzzyMeasurePairs
is identical to fuzzy_measure_posFuzzyMeasurePos. In
addition, neighboring edges are grouped to pairs. To extract pairs that
intersect or include each other, use fuzzy_measure_pairingFuzzyMeasurePairing.
If Transitiontransitiontransition =
'positive'"positive", the edge points with a dark-to-light transition in the
direction of the major axis of the rectangle or annular arc are returned in
RowEdgeFirstrowEdgeFirstrow_edge_first and ColumnEdgeFirstcolumnEdgeFirstcolumn_edge_first. In this case, the
corresponding edges with a light-to-dark transition are returned in
RowEdgeSecondrowEdgeSecondrow_edge_second and ColumnEdgeSecondcolumnEdgeSecondcolumn_edge_second. If Transitiontransitiontransition
= 'negative'"negative", the behavior is exactly opposite. If
Transitiontransitiontransition = 'all'"all", the first detected edge defines the
transition for RowEdgeFirstrowEdgeFirstrow_edge_first and ColumnEdgeFirstcolumnEdgeFirstcolumn_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.
Having extracted subpixel edge locations, the edges are paired. The
pairing algorithm groups the edges such that
interleavings and inclusions of pairs are prohibited. The features
of an edge pair
are evaluated by a fuzzy function, which can be set by
set_fuzzy_measureSetFuzzyMeasure or set_fuzzy_measure_norm_pairSetFuzzyMeasureNormPair.
Which edge pairs are selected can be
determined with the parameter FuzzyThreshfuzzyThreshfuzzy_thresh, which constitutes a
threshold on the weight over all fuzzy sets, i.e., the geometric
mean of the weights of the defined fuzzy functions.
The selected edges are returned as single points, which lie on the
major axis of the rectangle or annular arc. The corresponding edge
amplitudes are
returned in AmplitudeFirstamplitudeFirstamplitude_first and AmplitudeSecondamplitudeSecondamplitude_second, the
fuzzy scores in FuzzyScorefuzzyScorefuzzy_score.
In addition, the distance between each edge pair is returned in
IntraDistanceintraDistanceintra_distance and the distance between consecutive edge
pairs is returned in InterDistanceinterDistanceinter_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
InterDistanceinterDistanceinter_distance contains one element less than the tuples of
the edge pairs.
Attention
fuzzy_measure_pairsFuzzyMeasurePairs only returns meaningful results if the
assumptions that the edges are straight and perpendicular to the
major axis of the rectangle or annular arc are fulfilled. Thus, it
should not be used to extract edges from curved objects, for
example. Furthermore, the user should ensure that the rectangle or
a annular arc is as close to perpendicular as possible to the edges
in the image. Additionally, Sigmasigmasigma must not become larger
than approx. 0.5 * Length1 (for Length1 see
gen_measure_rectangle2GenMeasureRectangle2).
It should be kept in mind that fuzzy_measure_pairsFuzzyMeasurePairs ignores
the domain of Imageimageimage 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
Imageimageimage (input_object) singlechannelimage → object (byte / uint2 / real)object (byte / uint2 / real)HObject (byte / uint2 / real)HImage (byte / uint2 / real)HObject (byte / uint2 / real)Hobject (byte / uint2 / real)
Input image.
MeasureHandlemeasureHandlemeasure_handle (input_control) measure → (handle)(handle)HTuple (HHandle)HMeasure, HTuple (IntPtr)HHandleHtuple (handle)
Measure object handle.
Sigmasigmasigma (input_control) number → (real)(real)HTuple (double)HTuple (double)floatHtuple (double)
Sigma of Gaussian smoothing.
Default: 1.01.0
Suggested values: 0.4, 0.6, 0.8, 1.0, 1.5, 2.0, 3.0, 4.0, 5.0, 7.0, 10.00.4, 0.6, 0.8, 1.0, 1.5, 2.0, 3.0, 4.0, 5.0, 7.0, 10.0
Value range: 0.4 ≤ Sigma ≤ 100 (lin)
Minimum increment: 0.01
Recommended increment: 0.1
AmpThreshampThreshamp_thresh (input_control) number → (real)(real)HTuple (double)HTuple (double)floatHtuple (double)
Minimum edge amplitude.
Default: 30.030.0
Suggested values: 5.0, 10.0, 20.0, 30.0, 40.0, 50.0, 60.0, 70.0, 90.0, 110.05.0, 10.0, 20.0, 30.0, 40.0, 50.0, 60.0, 70.0, 90.0, 110.0
Value range: 1 ≤ AmpThresh ≤ 255 (lin)
Minimum increment: 0.5
Recommended increment: 2
FuzzyThreshfuzzyThreshfuzzy_thresh (input_control) number → (real)(real)HTuple (double)HTuple (double)floatHtuple (double)
Minimum fuzzy value.
Default: 0.50.5
Suggested values: 0.1, 0.3, 0.5, 0.7, 0.90.1, 0.3, 0.5, 0.7, 0.9
Value range: 0.0 ≤ FuzzyThresh ≤ 1.0 (lin)
Recommended increment: 0.1
Transitiontransitiontransition (input_control) string → (string)(string)HTuple (HString)HTuple (string)strHtuple (char*)
Select the first gray value transition of the edge pairs.
Default: 'all'"all"
List of values: 'all', 'negative', 'positive'"all", "negative", "positive"
RowEdgeFirstrowEdgeFirstrow_edge_first (output_control) point.y-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
Row coordinate of the first edge point.
ColumnEdgeFirstcolumnEdgeFirstcolumn_edge_first (output_control) point.x-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
Column coordinate of the first edge point.
AmplitudeFirstamplitudeFirstamplitude_first (output_control) real-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
Edge amplitude of the first edge (with sign).
RowEdgeSecondrowEdgeSecondrow_edge_second (output_control) point.y-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
Row coordinate of the second edge point.
ColumnEdgeSecondcolumnEdgeSecondcolumn_edge_second (output_control) point.x-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
Column coordinate of the second edge point.
AmplitudeSecondamplitudeSecondamplitude_second (output_control) real-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
Edge amplitude of the second edge (with sign).
RowEdgeCenterrowEdgeCenterrow_edge_center (output_control) point.y-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
Row coordinate of the center of the edge pair.
ColumnEdgeCentercolumnEdgeCentercolumn_edge_center (output_control) point.x-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
Column coordinate of the center of the edge pair.
FuzzyScorefuzzyScorefuzzy_score (output_control) real-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
Fuzzy evaluation of the edge pair.
IntraDistanceintraDistanceintra_distance (output_control) real-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
Distance between edges of an edge pair.
InterDistanceinterDistanceinter_distance (output_control) real-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
Distance between consecutive edge pairs.
Result
If the parameter values are correct the operator
fuzzy_measure_pairsFuzzyMeasurePairs returns the value 2 (H_MSG_TRUE). Otherwise an
exception is raised.
Combinations with other operators
Combinations
Possible predecessors
gen_measure_rectangle2GenMeasureRectangle2, gen_measure_arcGenMeasureArc, set_fuzzy_measureSetFuzzyMeasure
Possible successors
close_measureCloseMeasure
Alternatives
edges_sub_pixEdgesSubPix, fuzzy_measure_pairingFuzzyMeasurePairing, measure_pairsMeasurePairs
See also
fuzzy_measure_posFuzzyMeasurePos, measure_posMeasurePos
Module
1D Metrology