fuzzy_measure_pairsT_fuzzy_measure_pairsFuzzyMeasurePairsFuzzyMeasurePairsfuzzy_measure_pairs (算子)
名称
fuzzy_measure_pairsT_fuzzy_measure_pairsFuzzyMeasurePairsFuzzyMeasurePairsfuzzy_measure_pairs — 提取垂直于矩形或环形弧的直边对。
签名
fuzzy_measure_pairs(Image : : MeasureHandle, Sigma, AmpThresh, FuzzyThresh, Transition : RowEdgeFirst, ColumnEdgeFirst, AmplitudeFirst, RowEdgeSecond, ColumnEdgeSecond, AmplitudeSecond, RowEdgeCenter, ColumnEdgeCenter, FuzzyScore, IntraDistance, InterDistance)
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 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)
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)
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)
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)
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]]
描述
fuzzy_measure_pairsfuzzy_measure_pairsFuzzyMeasurePairsFuzzyMeasurePairsFuzzyMeasurePairsfuzzy_measure_pairs serves to extract straight edge
pairs which lie perpendicular to the major axis of a
rectangle or an annular arc. In addition to measure_pairsmeasure_pairsMeasurePairsMeasurePairsMeasurePairsmeasure_pairs 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 一维测量。
The extraction algorithm of fuzzy_measure_pairsfuzzy_measure_pairsFuzzyMeasurePairsFuzzyMeasurePairsFuzzyMeasurePairsfuzzy_measure_pairs
is identical to fuzzy_measure_posfuzzy_measure_posFuzzyMeasurePosFuzzyMeasurePosFuzzyMeasurePosfuzzy_measure_pos。In
addition, neighboring edges are grouped to pairs. To extract pairs that
intersect or include each other, use fuzzy_measure_pairingfuzzy_measure_pairingFuzzyMeasurePairingFuzzyMeasurePairingFuzzyMeasurePairingfuzzy_measure_pairing。
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 or annular arc 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.
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_measureset_fuzzy_measureSetFuzzyMeasureSetFuzzyMeasureSetFuzzyMeasureset_fuzzy_measure or set_fuzzy_measure_norm_pairset_fuzzy_measure_norm_pairSetFuzzyMeasureNormPairSetFuzzyMeasureNormPairSetFuzzyMeasureNormPairset_fuzzy_measure_norm_pair。Which edge pairs are selected can be
determined with the parameter FuzzyThreshFuzzyThreshFuzzyThreshFuzzyThreshfuzzyThreshfuzzy_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 AmplitudeFirstAmplitudeFirstAmplitudeFirstAmplitudeFirstamplitudeFirstamplitude_first and AmplitudeSecondAmplitudeSecondAmplitudeSecondAmplitudeSecondamplitudeSecondamplitude_second, the
fuzzy scores in FuzzyScoreFuzzyScoreFuzzyScoreFuzzyScorefuzzyScorefuzzy_score.
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.
注意
fuzzy_measure_pairsfuzzy_measure_pairsFuzzyMeasurePairsFuzzyMeasurePairsFuzzyMeasurePairsfuzzy_measure_pairs 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, 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 fuzzy_measure_pairsfuzzy_measure_pairsFuzzyMeasurePairsFuzzyMeasurePairsFuzzyMeasurePairsfuzzy_measure_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.
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
参数
ImageImageImageImageimageimage (输入对象) singlechannelimage → objectHImageHObjectHImageHobject (byte / uint2 / real)
输入图像。
MeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandlemeasure_handle (输入控制) measure → HMeasure, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Measure object handle.
SigmaSigmaSigmaSigmasigmasigma (输入控制) number → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Sigma of Gaussian smoothing.
默认值：
1.0
建议值：
0.4, 0.6, 0.8, 1.0, 1.5, 2.0, 3.0, 4.0, 5.0, 7.0, 10.0
值范围：
0.4
≤
Sigma
Sigma
Sigma
Sigma
sigma
sigma
≤
100 (lin)
最小增量：
0.01
建议增量：
0.1
AmpThreshAmpThreshAmpThreshAmpThreshampThreshamp_thresh (输入控制) number → HTuplefloatHTupleHtuple (real) (double) (double) (double)
最小边缘振幅。
默认值：
30.0
建议值：
5.0, 10.0, 20.0, 30.0, 40.0, 50.0, 60.0, 70.0, 90.0, 110.0
值范围：
1
≤
AmpThresh
AmpThresh
AmpThresh
AmpThresh
ampThresh
amp_thresh
≤
255 (lin)
最小增量：
0.5
建议增量：
2
FuzzyThreshFuzzyThreshFuzzyThreshFuzzyThreshfuzzyThreshfuzzy_thresh (输入控制) number → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Minimum fuzzy value.
默认值：
0.5
建议值：
0.1, 0.3, 0.5, 0.7, 0.9
值范围：
0.0
≤
FuzzyThresh
FuzzyThresh
FuzzyThresh
FuzzyThresh
fuzzyThresh
fuzzy_thresh
≤
1.0 (lin)
建议增量：
0.1
TransitionTransitionTransitionTransitiontransitiontransition (输入控制) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Select the first gray value transition of the edge pairs.
默认值：
'all'
"all"
"all"
"all"
"all"
"all"
值列表：
'all'"all""all""all""all""all", 'negative'"negative""negative""negative""negative""negative", 'positive'"positive""positive""positive""positive""positive"
RowEdgeFirstRowEdgeFirstRowEdgeFirstRowEdgeFirstrowEdgeFirstrow_edge_first (输出控制) point.y-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Row coordinate of the first edge point.
ColumnEdgeFirstColumnEdgeFirstColumnEdgeFirstColumnEdgeFirstcolumnEdgeFirstcolumn_edge_first (输出控制) point.x-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Column coordinate of the first edge point.
AmplitudeFirstAmplitudeFirstAmplitudeFirstAmplitudeFirstamplitudeFirstamplitude_first (输出控制) real-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Edge amplitude of the first edge (with sign).
RowEdgeSecondRowEdgeSecondRowEdgeSecondRowEdgeSecondrowEdgeSecondrow_edge_second (输出控制) point.y-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Row coordinate of the second edge point.
ColumnEdgeSecondColumnEdgeSecondColumnEdgeSecondColumnEdgeSecondcolumnEdgeSecondcolumn_edge_second (输出控制) point.x-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Column coordinate of the second edge point.
AmplitudeSecondAmplitudeSecondAmplitudeSecondAmplitudeSecondamplitudeSecondamplitude_second (输出控制) real-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Edge amplitude of the second edge (with sign).
RowEdgeCenterRowEdgeCenterRowEdgeCenterRowEdgeCenterrowEdgeCenterrow_edge_center (输出控制) point.y-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Row coordinate of the center of the edge pair.
ColumnEdgeCenterColumnEdgeCenterColumnEdgeCenterColumnEdgeCentercolumnEdgeCentercolumn_edge_center (输出控制) point.x-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Column coordinate of the center of the edge pair.
FuzzyScoreFuzzyScoreFuzzyScoreFuzzyScorefuzzyScorefuzzy_score (输出控制) real-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Fuzzy evaluation of the edge pair.
IntraDistanceIntraDistanceIntraDistanceIntraDistanceintraDistanceintra_distance (输出控制) real-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Distance between edges of an edge pair.
InterDistanceInterDistanceInterDistanceInterDistanceinterDistanceinter_distance (输出控制) real-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Distance between consecutive edge pairs.
结果
如果参数值正确，算子 fuzzy_measure_pairsfuzzy_measure_pairsFuzzyMeasurePairsFuzzyMeasurePairsFuzzyMeasurePairsfuzzy_measure_pairs 返回值 2 ( H_MSG_TRUE )。否则将抛出异常。
可能的前趋
gen_measure_rectangle2gen_measure_rectangle2GenMeasureRectangle2GenMeasureRectangle2GenMeasureRectangle2gen_measure_rectangle2,
gen_measure_arcgen_measure_arcGenMeasureArcGenMeasureArcGenMeasureArcgen_measure_arc,
set_fuzzy_measureset_fuzzy_measureSetFuzzyMeasureSetFuzzyMeasureSetFuzzyMeasureset_fuzzy_measure
可能的后继
close_measureclose_measureCloseMeasureCloseMeasureCloseMeasureclose_measure
替代
edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPixedges_sub_pix,
fuzzy_measure_pairingfuzzy_measure_pairingFuzzyMeasurePairingFuzzyMeasurePairingFuzzyMeasurePairingfuzzy_measure_pairing,
measure_pairsmeasure_pairsMeasurePairsMeasurePairsMeasurePairsmeasure_pairs
另见
fuzzy_measure_posfuzzy_measure_posFuzzyMeasurePosFuzzyMeasurePosFuzzyMeasurePosfuzzy_measure_pos,
measure_posmeasure_posMeasurePosMeasurePosMeasurePosmeasure_pos
模块
一维计量