ClassesClassesClassesClasses | | | | Operators

set_fuzzy_measure_norm_pairT_set_fuzzy_measure_norm_pairSetFuzzyMeasureNormPairset_fuzzy_measure_norm_pairSetFuzzyMeasureNormPairSetFuzzyMeasureNormPair (Operator)

Name

set_fuzzy_measure_norm_pairT_set_fuzzy_measure_norm_pairSetFuzzyMeasureNormPairset_fuzzy_measure_norm_pairSetFuzzyMeasureNormPairSetFuzzyMeasureNormPair — Specify a normalized fuzzy function for edge pairs.

Signature

set_fuzzy_measure_norm_pair( : : MeasureHandle, PairSize, SetType, Function : )

Herror T_set_fuzzy_measure_norm_pair(const Htuple MeasureHandle, const Htuple PairSize, const Htuple SetType, const Htuple Function)

Herror set_fuzzy_measure_norm_pair(const HTuple& MeasureHandle, const HTuple& PairSize, const HTuple& SetType, const HTuple& Function)

void HMeasure::SetFuzzyMeasureNormPair(const HTuple& PairSize, const HTuple& SetType, const HTuple& Function) const

void SetFuzzyMeasureNormPair(const HTuple& MeasureHandle, const HTuple& PairSize, const HTuple& SetType, const HTuple& Function)

void HMeasure::SetFuzzyMeasureNormPair(const HTuple& PairSize, const HString& SetType, const HFunction1D& Function) const

void HMeasure::SetFuzzyMeasureNormPair(double PairSize, const HString& SetType, const HFunction1D& Function) const

void HMeasure::SetFuzzyMeasureNormPair(double PairSize, const char* SetType, const HFunction1D& Function) const

void HOperatorSetX.SetFuzzyMeasureNormPair(
[in] VARIANT MeasureHandle, [in] VARIANT PairSize, [in] VARIANT SetType, [in] VARIANT Function)

void HMeasureX.SetFuzzyMeasureNormPair(
[in] VARIANT PairSize, [in] BSTR SetType, [in] IHFunction1DX* Function)

static void HOperatorSet.SetFuzzyMeasureNormPair(HTuple measureHandle, HTuple pairSize, HTuple setType, HTuple function)

void HMeasure.SetFuzzyMeasureNormPair(HTuple pairSize, string setType, HFunction1D function)

void HMeasure.SetFuzzyMeasureNormPair(double pairSize, string setType, HFunction1D function)

Description

set_fuzzy_measure_norm_pairset_fuzzy_measure_norm_pairSetFuzzyMeasureNormPairset_fuzzy_measure_norm_pairSetFuzzyMeasureNormPairSetFuzzyMeasureNormPair specifies a normalized fuzzy function passed in FunctionFunctionFunctionFunctionFunctionfunction. The specified fuzzy functions enables fuzzy_measure_posfuzzy_measure_posFuzzyMeasurePosfuzzy_measure_posFuzzyMeasurePosFuzzyMeasurePos, fuzzy_measure_pairsfuzzy_measure_pairsFuzzyMeasurePairsfuzzy_measure_pairsFuzzyMeasurePairsFuzzyMeasurePairs and fuzzy_measure_pairingfuzzy_measure_pairingFuzzyMeasurePairingfuzzy_measure_pairingFuzzyMeasurePairingFuzzyMeasurePairing to evaluate and select the detected candidates of edges and edge pairs. For this purpose, weighting characteristics for different edge features can be defined by one function each. Such a specified feature is called fuzzy set. Specifying no function for a fuzzy set means not to use this feature for the final edge evaluation. Setting a second fuzzy function to a fuzzy set means to discard the first defined function and replace it by the second one. In difference to set_fuzzy_measureset_fuzzy_measureSetFuzzyMeasureset_fuzzy_measureSetFuzzyMeasureSetFuzzyMeasure, the abscissa x of these functions must be defined relative to the desired size s of the edge pairs (passed in PairSizePairSizePairSizePairSizePairSizepairSize). This enables a generalized usage of the defined functions. A previously defined normalized fuzzy function can be discarded completely by reset_fuzzy_measurereset_fuzzy_measureResetFuzzyMeasurereset_fuzzy_measureResetFuzzyMeasureResetFuzzyMeasure.

Functions for three different fuzzy set types selected by the SetTypeSetTypeSetTypeSetTypeSetTypesetType parameter can be defined, the sub types of a set being mutual exclusive:

A normalized fuzzy function is defined as a piecewise linear function by at least two pairs of values, sorted in an ascending order by their x value. The y values of the fuzzy function represent the weight of the corresponding feature value and must satisfy the range of 0.0 <= y <= 1.0. Outside of the function's interval, defined by the smallest and the greatest x value, the y values of the interval borders are continued constantly. Such Fuzzy functions can be generated by create_funct_1d_pairscreate_funct_1d_pairsCreateFunct1dPairscreate_funct_1d_pairsCreateFunct1dPairsCreateFunct1dPairs.

If more than one set is defined, fuzzy_measure_posfuzzy_measure_posFuzzyMeasurePosfuzzy_measure_posFuzzyMeasurePosFuzzyMeasurePos / fuzzy_measure_pairsfuzzy_measure_pairsFuzzyMeasurePairsfuzzy_measure_pairsFuzzyMeasurePairsFuzzyMeasurePairs / fuzzy_measure_pairingfuzzy_measure_pairingFuzzyMeasurePairingfuzzy_measure_pairingFuzzyMeasurePairingFuzzyMeasurePairing yield the overall fuzzy weighting by the geometric mean of the weights of each set.

Attention

A measure object 'MeasureHandle'"MeasureHandle""MeasureHandle""MeasureHandle""MeasureHandle""MeasureHandle" cannot be shared between two or more user's threads. Different measure objects can be used independently and safely in different threads.

Parallelization

Parameters

MeasureHandleMeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandle (input_control)  measure_id HMeasure, HTupleHTupleHMeasure, HTupleHMeasureX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Measure object handle.

PairSizePairSizePairSizePairSizePairSizepairSize (input_control)  number HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Favored width of edge pairs.

Default value: 10.0

List of values: 4.0, 6.0, 8.0, 10.0, 15.0, 20.0, 30.0

Typical range of values: 0.0 ≤ PairSize PairSize PairSize PairSize PairSize pairSize

Minimum increment: 0.1

Recommended increment: 1.0

SetTypeSetTypeSetTypeSetTypeSetTypesetType (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Selection of the fuzzy set.

Default value: 'size_abs_diff' "size_abs_diff" "size_abs_diff" "size_abs_diff" "size_abs_diff" "size_abs_diff"

List of values: 'position'"position""position""position""position""position", 'position_center'"position_center""position_center""position_center""position_center""position_center", 'position_end'"position_end""position_end""position_end""position_end""position_end", 'position_first_edge'"position_first_edge""position_first_edge""position_first_edge""position_first_edge""position_first_edge", 'position_first_pair'"position_first_pair""position_first_pair""position_first_pair""position_first_pair""position_first_pair", 'position_last_edge'"position_last_edge""position_last_edge""position_last_edge""position_last_edge""position_last_edge", 'position_last_pair'"position_last_pair""position_last_pair""position_last_pair""position_last_pair""position_last_pair", 'position_pair_center'"position_pair_center""position_pair_center""position_pair_center""position_pair_center""position_pair_center", 'position_pair_end'"position_pair_end""position_pair_end""position_pair_end""position_pair_end""position_pair_end", 'size'"size""size""size""size""size", 'size_abs_diff'"size_abs_diff""size_abs_diff""size_abs_diff""size_abs_diff""size_abs_diff", 'size_diff'"size_diff""size_diff""size_diff""size_diff""size_diff"

FunctionFunctionFunctionFunctionFunctionfunction (input_control)  function_1d HFunction1D, HTupleHTupleHFunction1D, HTupleHFunction1DX, VARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Fuzzy function.

Example (HDevelop)

* how to use a fuzzy function
* ...
gen_measure_rectangle2 (50, 100, 0, 200, 100, 512, 512, 'nearest_neighbor', \
                        MeasureHandle)
* create a generalized fuzzy function to evaluate edge pairs
* * (30% uncertainty).
create_funct_1d_pairs ([0.7,1.0,1.3], [0.0,1.0,0.0], SizeFunction)
* and set it for an expected pair size of 13.45 pixels
set_fuzzy_measure_norm_pair (MeasureHandle, 13.45, 'size', SizeFunction)

fuzzy_measure_pairs (Image, MeasureHandle, 1, 30, 0.5, 'all', RowEdgeFirst, \
                     ColumnEdgeFirst, AmplitudeFirst, RowEdgeSecond, \
                     ColumnEdgeSecond, AmplitudeSecond, RowEdgeCenter, \
                     ColumnEdgeCenter, FuzzyScore, IntraDistance, \
                     InterDistance)

Possible Predecessors

gen_measure_arcgen_measure_arcGenMeasureArcgen_measure_arcGenMeasureArcGenMeasureArc, gen_measure_rectangle2gen_measure_rectangle2GenMeasureRectangle2gen_measure_rectangle2GenMeasureRectangle2GenMeasureRectangle2, create_funct_1d_pairscreate_funct_1d_pairsCreateFunct1dPairscreate_funct_1d_pairsCreateFunct1dPairsCreateFunct1dPairs

Possible Successors

fuzzy_measure_pairsfuzzy_measure_pairsFuzzyMeasurePairsfuzzy_measure_pairsFuzzyMeasurePairsFuzzyMeasurePairs, fuzzy_measure_pairingfuzzy_measure_pairingFuzzyMeasurePairingfuzzy_measure_pairingFuzzyMeasurePairingFuzzyMeasurePairing

Alternatives

transform_funct_1dtransform_funct_1dTransformFunct1dtransform_funct_1dTransformFunct1dTransformFunct1d, set_fuzzy_measureset_fuzzy_measureSetFuzzyMeasureset_fuzzy_measureSetFuzzyMeasureSetFuzzyMeasure

See also

reset_fuzzy_measurereset_fuzzy_measureResetFuzzyMeasurereset_fuzzy_measureResetFuzzyMeasureResetFuzzyMeasure

Module

1D Metrology


ClassesClassesClassesClasses | | | | Operators