Name
add_metrology_object_generic T_add_metrology_object_generic AddMetrologyObjectGeneric add_metrology_object_generic AddMetrologyObjectGeneric AddMetrologyObjectGeneric — Add a metrology object to a metrology model.
Herror add_metrology_object_generic (const HTuple& MetrologyHandle , const HTuple& Shape , const HTuple& ShapeParam , const HTuple& MeasureLength1 , const HTuple& MeasureLength2 , const HTuple& MeasureSigma , const HTuple& MeasureThreshold , const HTuple& GenParamName , const HTuple& GenParamValue , Hlong* Index )
Hlong HMetrologyModel ::AddMetrologyObjectGeneric (const HTuple& Shape , const HTuple& ShapeParam , const HTuple& MeasureLength1 , const HTuple& MeasureLength2 , const HTuple& MeasureSigma , const HTuple& MeasureThreshold , const HTuple& GenParamName , const HTuple& GenParamValue ) const
void AddMetrologyObjectGeneric (const HTuple& MetrologyHandle , const HTuple& Shape , const HTuple& ShapeParam , const HTuple& MeasureLength1 , const HTuple& MeasureLength2 , const HTuple& MeasureSigma , const HTuple& MeasureThreshold , const HTuple& GenParamName , const HTuple& GenParamValue , HTuple* Index )
Hlong HMetrologyModel ::AddMetrologyObjectGeneric (const HTuple& Shape , const HTuple& ShapeParam , const HTuple& MeasureLength1 , const HTuple& MeasureLength2 , const HTuple& MeasureSigma , const HTuple& MeasureThreshold , const HTuple& GenParamName , const HTuple& GenParamValue ) const
Hlong HMetrologyModel ::AddMetrologyObjectGeneric (const HString& Shape , const HTuple& ShapeParam , double MeasureLength1 , double MeasureLength2 , double MeasureSigma , double MeasureThreshold , const HString& GenParamName , double GenParamValue ) const
Hlong HMetrologyModel ::AddMetrologyObjectGeneric (const char* Shape , const HTuple& ShapeParam , double MeasureLength1 , double MeasureLength2 , double MeasureSigma , double MeasureThreshold , const char* GenParamName , double GenParamValue ) const
void HOperatorSetX .AddMetrologyObjectGeneric ( [in] VARIANT MetrologyHandle , [in] VARIANT Shape , [in] VARIANT ShapeParam , [in] VARIANT MeasureLength1 , [in] VARIANT MeasureLength2 , [in] VARIANT MeasureSigma , [in] VARIANT MeasureThreshold , [in] VARIANT GenParamName , [in] VARIANT GenParamValue , [out] VARIANT* Index )
Hlong HMetrologyModelX .AddMetrologyObjectGeneric ( [in] VARIANT Shape , [in] VARIANT ShapeParam , [in] VARIANT MeasureLength1 , [in] VARIANT MeasureLength2 , [in] VARIANT MeasureSigma , [in] VARIANT MeasureThreshold , [in] VARIANT GenParamName , [in] VARIANT GenParamValue )
static void HOperatorSet .AddMetrologyObjectGeneric (HTuple metrologyHandle , HTuple shape , HTuple shapeParam , HTuple measureLength1 , HTuple measureLength2 , HTuple measureSigma , HTuple measureThreshold , HTuple genParamName , HTuple genParamValue , out HTuple index )
int HMetrologyModel .AddMetrologyObjectGeneric (HTuple shape , HTuple shapeParam , HTuple measureLength1 , HTuple measureLength2 , HTuple measureSigma , HTuple measureThreshold , HTuple genParamName , HTuple genParamValue )
int HMetrologyModel .AddMetrologyObjectGeneric (string shape , HTuple shapeParam , double measureLength1 , double measureLength2 , double measureSigma , double measureThreshold , string genParamName , double genParamValue )
add_metrology_object_generic add_metrology_object_generic AddMetrologyObjectGeneric add_metrology_object_generic AddMetrologyObjectGeneric AddMetrologyObjectGeneric adds a metrology object
of type Shape Shape Shape Shape Shape shape to a metrology model and prepares the
rectangular measure regions (see create_metrology_model create_metrology_model CreateMetrologyModel create_metrology_model CreateMetrologyModel CreateMetrologyModel for
the basic principle of 2D metrology). The handle of the model is
passed in MetrologyHandle MetrologyHandle MetrologyHandle MetrologyHandle MetrologyHandle metrologyHandle .
Shape Shape Shape Shape Shape shape specifies which type of object is added to the
metrology model. The operator add_metrology_object_generic add_metrology_object_generic AddMetrologyObjectGeneric add_metrology_object_generic AddMetrologyObjectGeneric AddMetrologyObjectGeneric
returns the index of the added metrology object in the parameter
Index Index Index Index Index index .
Note that add_metrology_object_generic add_metrology_object_generic AddMetrologyObjectGeneric add_metrology_object_generic AddMetrologyObjectGeneric AddMetrologyObjectGeneric provides the
functionality of the operators add_metrology_object_circle_measure add_metrology_object_circle_measure AddMetrologyObjectCircleMeasure add_metrology_object_circle_measure AddMetrologyObjectCircleMeasure AddMetrologyObjectCircleMeasure ,
add_metrology_object_ellipse_measure add_metrology_object_ellipse_measure AddMetrologyObjectEllipseMeasure add_metrology_object_ellipse_measure AddMetrologyObjectEllipseMeasure AddMetrologyObjectEllipseMeasure ,
add_metrology_object_rectangle2_measure add_metrology_object_rectangle2_measure AddMetrologyObjectRectangle2Measure add_metrology_object_rectangle2_measure AddMetrologyObjectRectangle2Measure AddMetrologyObjectRectangle2Measure and
add_metrology_object_line_measure add_metrology_object_line_measure AddMetrologyObjectLineMeasure add_metrology_object_line_measure AddMetrologyObjectLineMeasure AddMetrologyObjectLineMeasure in one operator.
Possible shapes
Depending on the object specified in Shape Shape Shape Shape Shape shape the following values
are expected:
'circle' "circle" "circle" "circle" "circle" "circle" :
The geometric shape of the metrology object of type circle is
specified by its center (Row, Column) and radius.
ShapeParam ShapeParam ShapeParam ShapeParam ShapeParam shapeParam =[Row, Column, Radius]
'rectangle2' "rectangle2" "rectangle2" "rectangle2" "rectangle2" "rectangle2" :
The geometric shape of the metrology object of type rectangle is
specified by its center (Row, Column), the orientation
of the main axis Phi, and the half edge lengths Length1
and Length2. The input value for Phi is mapped
automatically to the interval
.
ShapeParam ShapeParam ShapeParam ShapeParam ShapeParam shapeParam =[Row, Column, Phi, Length1, Length2]
'ellipse' "ellipse" "ellipse" "ellipse" "ellipse" "ellipse" :
The geometric shape of the metrology object of type ellipse is specified
by its center (Row, Column), the orientation of the
main axis Phi, the length of the larger half axis
Radius1, and the length of the smaller half axis
Radius2. The input value for Phi is mapped
automatically to the interval
.
ShapeParam ShapeParam ShapeParam ShapeParam ShapeParam shapeParam =[Row, Column, Phi, Radius1, Radius2]
'line' "line" "line" "line" "line" "line" :
The geometric shape of the metrology object of type line is described
by the coordinates of its start point (RowBegin, ColumnBegin) and the
coordinates of its end point (RowEnd, ColumnEnd).
ShapeParam ShapeParam ShapeParam ShapeParam ShapeParam shapeParam =[RowBegin, ColumnBegin, RowEnd, ColumnEnd]
Definition of measure regions
add_metrology_object_generic add_metrology_object_generic AddMetrologyObjectGeneric add_metrology_object_generic AddMetrologyObjectGeneric AddMetrologyObjectGeneric also prepares the
rectangular measure regions. The rectangular measure regions lie
perpendicular to the boundary of the object. The half edge lengths of
the measure regions perpendicular and tangential to the boundary of the
object are set in MeasureLength1 MeasureLength1 MeasureLength1 MeasureLength1 MeasureLength1 measureLength1 and
MeasureLength2 MeasureLength2 MeasureLength2 MeasureLength2 MeasureLength2 measureLength2 . The centers of the measure regions lie on
the boundary of the object. The parameter MeasureSigma MeasureSigma MeasureSigma MeasureSigma MeasureSigma measureSigma
specifies a standard deviation that is used by the operator
apply_metrology_model apply_metrology_model ApplyMetrologyModel apply_metrology_model ApplyMetrologyModel ApplyMetrologyModel to smooth the gray values of the
image. Salient edges can be selected with the parameter
MeasureThreshold MeasureThreshold MeasureThreshold MeasureThreshold MeasureThreshold measureThreshold , which constitutes a threshold on the
amplitude, i.e., the absolute value of the first derivative of
the edge.
Generic parameters
Generic parameters and their values can be specified using
GenParamName GenParamName GenParamName GenParamName GenParamName genParamName und GenParamValue GenParamValue GenParamValue GenParamValue GenParamValue genParamValue .
All generic parameters that are available in the operator
set_metrology_object_param set_metrology_object_param SetMetrologyObjectParam set_metrology_object_param SetMetrologyObjectParam SetMetrologyObjectParam can also be set in
add_metrology_object_generic add_metrology_object_generic AddMetrologyObjectGeneric add_metrology_object_generic AddMetrologyObjectGeneric AddMetrologyObjectGeneric . But note that
for a lot of applications the default values are sufficient and
no adjustment is necessary. Furthermore, the following values for
GenParamName GenParamName GenParamName GenParamName GenParamName genParamName and GenParamValue GenParamValue GenParamValue GenParamValue GenParamValue genParamValue are
available only for Shape Shape Shape Shape Shape shape =
'circle' "circle" "circle" "circle" "circle" "circle" and 'ellipse' "ellipse" "ellipse" "ellipse" "ellipse" "ellipse" :
'start_phi' "start_phi" "start_phi" "start_phi" "start_phi" "start_phi" :
The parameter specifies the angle at
the start point of a circular or elliptic arc.
For an ellipse, the angle at the start point
is measured relative to the positive main axis
and corresponds to the smallest surrounding circle
of the ellipse. The actual start point of the ellipse is the
intersection of the ellipse with the orthogonal projection of the
corresponding circle point onto the main axis. To create a
closed circle or ellipse the value of the parameter 'start_phi' "start_phi" "start_phi" "start_phi" "start_phi" "start_phi" is
set to 0 and the value of the parameter 'end_phi' "end_phi" "end_phi" "end_phi" "end_phi" "end_phi"
is set to
(with positive point order).
The input value is mapped automatically
to the interval
.
List of values: 0.0 , 0.78 ,
6.28318
Default value: 0.0
'end_phi' "end_phi" "end_phi" "end_phi" "end_phi" "end_phi" :
The parameter
specifies the angle at the end point of a circular or elliptic arc.
For an ellipse, the angle at the end point
is measured relative to the positive main axis
and corresponds to the smallest surrounding circle
of the ellipse. The actual end point of the ellipse is the
intersection of the ellipse with the orthogonal projection of the
corresponding circle point onto the main axis.
To create a closed circle or ellipse the value of the parameter
'start_phi' "start_phi" "start_phi" "start_phi" "start_phi" "start_phi"
is set to 0 and the value of the parameter
'end_phi' "end_phi" "end_phi" "end_phi" "end_phi" "end_phi" is set to
(with positive
point order). The input value is mapped internally
automatically to the interval
.
List of values: 0.0 , 0.78 ,
6.28318
Default value: 6.28318
'point_order' "point_order" "point_order" "point_order" "point_order" "point_order" :
The parameter specifies the direction
of the circular or elliptic arc. For the value 'positive' "positive" "positive" "positive" "positive" "positive" ,
the arc is defined between 'start_phi' "start_phi" "start_phi" "start_phi" "start_phi" "start_phi" and 'end_phi' "end_phi" "end_phi" "end_phi" "end_phi" "end_phi"
in mathematically positive direction (counterclockwise).
For the value 'negative' "negative" "negative" "negative" "negative" "negative" , the arc is defined
between 'start_phi' "start_phi" "start_phi" "start_phi" "start_phi" "start_phi" and 'end_phi' "end_phi" "end_phi" "end_phi" "end_phi" "end_phi" in
mathematically negative direction (clockwise).
List of values: 'positive' "positive" "positive" "positive" "positive" "positive" , 'negative' "negative" "negative" "negative" "negative" "negative"
Default value: 'positive' "positive" "positive" "positive" "positive" "positive"
Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.
This operator modifies the state of the following input parameter:
The value of this parameter may not be shared across multiple threads without external synchronization.
Handle of the metrology model.
Type of the metrology object to be added.
Default value:
'circle'
"circle"
"circle"
"circle"
"circle"
"circle"
List of values: 'circle' "circle" "circle" "circle" "circle" "circle" , 'ellipse' "ellipse" "ellipse" "ellipse" "ellipse" "ellipse" , 'line' "line" "line" "line" "line" "line" , 'rectangle2' "rectangle2" "rectangle2" "rectangle2" "rectangle2" "rectangle2"
Parameters of the metrology object to be added.
Half length of the measure regions perpendicular
to the boundary.
Default value: 20.0
Suggested values: 10.0, 20.0, 30.0
Typical range of values: 1.0
≤
MeasureLength1
MeasureLength1
MeasureLength1
MeasureLength1
MeasureLength1
measureLength1
≤
511.0 (lin)
Minimum increment: 1.0
Recommended increment: 10.0
Half length of the measure regions tangetial
to the boundary.
Default value: 5.0
Suggested values: 3.0, 5.0, 10.0
Typical range of values: 1.0
≤
MeasureLength2
MeasureLength2
MeasureLength2
MeasureLength2
MeasureLength2
measureLength2
≤
511.0 (lin)
Minimum increment: 1.0
Recommended increment: 10.0
Sigma of the Gaussian function for the 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
≤
MeasureSigma
MeasureSigma
MeasureSigma
MeasureSigma
MeasureSigma
measureSigma
≤
100 (lin)
Minimum increment: 0.01
Recommended increment: 0.1
Restriction: 0.4 <= MeasureSigma && MeasureSigma <= 100
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
≤
MeasureThreshold
MeasureThreshold
MeasureThreshold
MeasureThreshold
MeasureThreshold
measureThreshold
≤
255 (lin)
Minimum increment: 0.5
Recommended increment: 2
Names of the generic parameters.
Default value: []
List of values: 'distance_threshold' "distance_threshold" "distance_threshold" "distance_threshold" "distance_threshold" "distance_threshold" , 'end_phi' "end_phi" "end_phi" "end_phi" "end_phi" "end_phi" , 'instances_outside_measure_regions' "instances_outside_measure_regions" "instances_outside_measure_regions" "instances_outside_measure_regions" "instances_outside_measure_regions" "instances_outside_measure_regions" , 'max_num_iterations' "max_num_iterations" "max_num_iterations" "max_num_iterations" "max_num_iterations" "max_num_iterations" , 'measure_distance' "measure_distance" "measure_distance" "measure_distance" "measure_distance" "measure_distance" , 'measure_interpolation' "measure_interpolation" "measure_interpolation" "measure_interpolation" "measure_interpolation" "measure_interpolation" , 'measure_select' "measure_select" "measure_select" "measure_select" "measure_select" "measure_select" , 'measure_transition' "measure_transition" "measure_transition" "measure_transition" "measure_transition" "measure_transition" , 'min_score' "min_score" "min_score" "min_score" "min_score" "min_score" , 'num_instances' "num_instances" "num_instances" "num_instances" "num_instances" "num_instances" , 'num_measures' "num_measures" "num_measures" "num_measures" "num_measures" "num_measures" , 'point_order' "point_order" "point_order" "point_order" "point_order" "point_order" , 'rand_seed' "rand_seed" "rand_seed" "rand_seed" "rand_seed" "rand_seed" , 'start_phi' "start_phi" "start_phi" "start_phi" "start_phi" "start_phi"
Values of the generic parameters.
Default value: []
Suggested values: 1, 2, 3, 4, 5, 10, 20, 'all' "all" "all" "all" "all" "all" , 'true' "true" "true" "true" "true" "true" , 'false' "false" "false" "false" "false" "false" , 'first' "first" "first" "first" "first" "first" , 'last' "last" "last" "last" "last" "last" , 'positive' "positive" "positive" "positive" "positive" "positive" , 'negative' "negative" "negative" "negative" "negative" "negative" , 'uniform' "uniform" "uniform" "uniform" "uniform" "uniform" , 'nearest_neighbor' "nearest_neighbor" "nearest_neighbor" "nearest_neighbor" "nearest_neighbor" "nearest_neighbor" , 'bilinear' "bilinear" "bilinear" "bilinear" "bilinear" "bilinear" , 'bicubic' "bicubic" "bicubic" "bicubic" "bicubic" "bicubic"
Index of the created metrology object.
create_metrology_model (MetrologyHandle)
read_image (Image, 'fabrik')
get_image_size (Image, Width, Height)
set_metrology_model_image_size (MetrologyHandle, Width, Height)
LinePar := [45,360,415,360]
RectPar1 := [270,232,rad(0),30,25]
RectPar2 := [360,230,rad(0),30,25]
LinePar := [45,360,415,360]
RectPar3 := [245,320,rad(-90),70,35]
* Add two rectangles
add_metrology_object_generic (MetrologyHandle, 'rectangle2', [RectPar1,RectPar2], \
20, 5, 1, 30, [], [], Indices)
* Add a rectangle and a line
add_metrology_object_generic (MetrologyHandle, ['rectangle2','line'], \
[RectPar3,LinePar], 20, 5, 1, 30, [], [], Index)
get_metrology_object_model_contour (Contour, MetrologyHandle, 'all', 1.5)
apply_metrology_model (Image, MetrologyHandle)
get_metrology_object_result_contour (Contour1, MetrologyHandle, 'all', \
'all', 1.5)
clear_metrology_model (MetrologyHandle)
If the parameters are valid, the operator
add_metrology_object_generic add_metrology_object_generic AddMetrologyObjectGeneric add_metrology_object_generic AddMetrologyObjectGeneric AddMetrologyObjectGeneric returns the value 2 (H_MSG_TRUE).
If necessary, an exception is raised.
set_metrology_model_image_size set_metrology_model_image_size SetMetrologyModelImageSize set_metrology_model_image_size SetMetrologyModelImageSize SetMetrologyModelImageSize ,
set_metrology_model_param set_metrology_model_param SetMetrologyModelParam set_metrology_model_param SetMetrologyModelParam SetMetrologyModelParam
align_metrology_model align_metrology_model AlignMetrologyModel align_metrology_model AlignMetrologyModel AlignMetrologyModel ,
apply_metrology_model apply_metrology_model ApplyMetrologyModel apply_metrology_model ApplyMetrologyModel ApplyMetrologyModel ,
set_metrology_model_param set_metrology_model_param SetMetrologyModelParam set_metrology_model_param SetMetrologyModelParam SetMetrologyModelParam
get_metrology_object_model_contour get_metrology_object_model_contour GetMetrologyObjectModelContour get_metrology_object_model_contour GetMetrologyObjectModelContour GetMetrologyObjectModelContour
2D Metrology