Name
add_metrology_object_ellipse_measure T_add_metrology_object_ellipse_measure AddMetrologyObjectEllipseMeasure add_metrology_object_ellipse_measure AddMetrologyObjectEllipseMeasure AddMetrologyObjectEllipseMeasure — Add an ellipse or an elliptic arc to a metrology model.
add_metrology_object_ellipse_measure ( : : MetrologyHandle , Row , Column , Phi , Radius1 , Radius2 , MeasureLength1 , MeasureLength2 , MeasureSigma , MeasureThreshold , GenParamName , GenParamValue : Index )
Herror T_add_metrology_object_ellipse_measure (const Htuple MetrologyHandle , const Htuple Row , const Htuple Column , const Htuple Phi , const Htuple Radius1 , const Htuple Radius2 , const Htuple MeasureLength1 , const Htuple MeasureLength2 , const Htuple MeasureSigma , const Htuple MeasureThreshold , const Htuple GenParamName , const Htuple GenParamValue , Htuple* Index )
Herror add_metrology_object_ellipse_measure (const HTuple& MetrologyHandle , const HTuple& Row , const HTuple& Column , const HTuple& Phi , const HTuple& Radius1 , const HTuple& Radius2 , const HTuple& MeasureLength1 , const HTuple& MeasureLength2 , const HTuple& MeasureSigma , const HTuple& MeasureThreshold , const HTuple& GenParamName , const HTuple& GenParamValue , Hlong* Index )
Hlong HMetrologyModel ::AddMetrologyObjectEllipseMeasure (const HTuple& Row , const HTuple& Column , const HTuple& Phi , const HTuple& Radius1 , const HTuple& Radius2 , const HTuple& MeasureLength1 , const HTuple& MeasureLength2 , const HTuple& MeasureSigma , const HTuple& MeasureThreshold , const HTuple& GenParamName , const HTuple& GenParamValue ) const
void AddMetrologyObjectEllipseMeasure (const HTuple& MetrologyHandle , const HTuple& Row , const HTuple& Column , const HTuple& Phi , const HTuple& Radius1 , const HTuple& Radius2 , const HTuple& MeasureLength1 , const HTuple& MeasureLength2 , const HTuple& MeasureSigma , const HTuple& MeasureThreshold , const HTuple& GenParamName , const HTuple& GenParamValue , HTuple* Index )
Hlong HMetrologyModel ::AddMetrologyObjectEllipseMeasure (const HTuple& Row , const HTuple& Column , const HTuple& Phi , const HTuple& Radius1 , const HTuple& Radius2 , const HTuple& MeasureLength1 , const HTuple& MeasureLength2 , const HTuple& MeasureSigma , const HTuple& MeasureThreshold , const HTuple& GenParamName , const HTuple& GenParamValue ) const
Hlong HMetrologyModel ::AddMetrologyObjectEllipseMeasure (double Row , double Column , double Phi , double Radius1 , double Radius2 , double MeasureLength1 , double MeasureLength2 , double MeasureSigma , double MeasureThreshold , const HTuple& GenParamName , const HTuple& GenParamValue ) const
void HOperatorSetX .AddMetrologyObjectEllipseMeasure ( [in] VARIANT MetrologyHandle , [in] VARIANT Row , [in] VARIANT Column , [in] VARIANT Phi , [in] VARIANT Radius1 , [in] VARIANT Radius2 , [in] VARIANT MeasureLength1 , [in] VARIANT MeasureLength2 , [in] VARIANT MeasureSigma , [in] VARIANT MeasureThreshold , [in] VARIANT GenParamName , [in] VARIANT GenParamValue , [out] VARIANT* Index )
Hlong HMetrologyModelX .AddMetrologyObjectEllipseMeasure ( [in] VARIANT Row , [in] VARIANT Column , [in] VARIANT Phi , [in] VARIANT Radius1 , [in] VARIANT Radius2 , [in] VARIANT MeasureLength1 , [in] VARIANT MeasureLength2 , [in] VARIANT MeasureSigma , [in] VARIANT MeasureThreshold , [in] VARIANT GenParamName , [in] VARIANT GenParamValue )
static void HOperatorSet .AddMetrologyObjectEllipseMeasure (HTuple metrologyHandle , HTuple row , HTuple column , HTuple phi , HTuple radius1 , HTuple radius2 , HTuple measureLength1 , HTuple measureLength2 , HTuple measureSigma , HTuple measureThreshold , HTuple genParamName , HTuple genParamValue , out HTuple index )
int HMetrologyModel .AddMetrologyObjectEllipseMeasure (HTuple row , HTuple column , HTuple phi , HTuple radius1 , HTuple radius2 , HTuple measureLength1 , HTuple measureLength2 , HTuple measureSigma , HTuple measureThreshold , HTuple genParamName , HTuple genParamValue )
int HMetrologyModel .AddMetrologyObjectEllipseMeasure (double row , double column , double phi , double radius1 , double radius2 , double measureLength1 , double measureLength2 , double measureSigma , double measureThreshold , HTuple genParamName , HTuple genParamValue )
add_metrology_object_ellipse_measure add_metrology_object_ellipse_measure AddMetrologyObjectEllipseMeasure add_metrology_object_ellipse_measure AddMetrologyObjectEllipseMeasure AddMetrologyObjectEllipseMeasure adds a metrology object
of type ellipse or elliptic arc to a metrology model and prepares the
rectangular measure regions. The handle of the model is passed in
MetrologyHandle MetrologyHandle MetrologyHandle MetrologyHandle MetrologyHandle metrologyHandle .
For an explanation of the concept of 2D metrology see the
introduction of chapter 2D Metrology .
The geometric shape of the metrology object of type ellipse is specified
by its center (Row Row Row Row Row row , Column Column Column Column Column column ), the orientation of the
main axis Phi Phi Phi Phi Phi phi , the length of the larger half axis
Radius1 Radius1 Radius1 Radius1 Radius1 radius1 , and the length of the smaller half axis
Radius2 Radius2 Radius2 Radius2 Radius2 radius2 . The input value for Phi Phi Phi Phi Phi phi is mapped
automatically to the interval
.
The rectangular measure regions lie perpendicular to the
boundary of the ellipse. The half edge lengths of the measure
regions perpendicular and tangential to the boundary of the ellipse
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
geometric shape. The parameter MeasureSigma MeasureSigma MeasureSigma MeasureSigma MeasureSigma measureSigma specifies the
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. The operator
add_metrology_object_ellipse_measure add_metrology_object_ellipse_measure AddMetrologyObjectEllipseMeasure add_metrology_object_ellipse_measure AddMetrologyObjectEllipseMeasure AddMetrologyObjectEllipseMeasure returns the index of the
added metrology object in the parameter Index Index Index Index Index index .
Furthermore, you can adjust some generic parameters within
GenParamName GenParamName GenParamName GenParamName GenParamName genParamName and GenParamValue GenParamValue GenParamValue GenParamValue GenParamValue genParamValue . The following
values for GenParamName GenParamName GenParamName GenParamName GenParamName genParamName and GenParamValue GenParamValue GenParamValue GenParamValue GenParamValue genParamValue are
available:
'start_phi' "start_phi" "start_phi" "start_phi" "start_phi" "start_phi" :
The parameter specifies the angle at
the start point of an elliptic arc. The angle at the start point
is measured relative to the positive main axis specified with
Phi Phi Phi Phi Phi phi 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. The angle refers
to the coordinate system of the ellipse, i.e., it is specified
relative to the main axis and in a mathematical positive
direction. Thus, the two main poles correspond to the
angles 0 and
, the two minor poles to the
angle
and
. To create a
closed 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: 0.0
'end_phi' "end_phi" "end_phi" "end_phi" "end_phi" "end_phi" :
The parameter specifies the angle at
the end point of an elliptic arc. The angle at the end point are
measured relative to the positive main axis specified with
Phi Phi Phi Phi Phi phi 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. The angle refers
to the coordinate system of the ellipse, i.e., it is specified
relative to the main axis and in a mathematical positive direction.
Thus, the two main poles correspond to the
angles 0 and
, the two minor poles to the
angle
and
. To create a
closed 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: 6.28318
'point_order' "point_order" "point_order" "point_order" "point_order" "point_order" :
The parameter specifies the direction
of the elliptic arc. For the value 'positive' "positive" "positive" "positive" "positive" "positive" , the elliptic
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 elliptic 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"
Additionally, all generic parameters that are available for the
operator set_metrology_object_param set_metrology_object_param SetMetrologyObjectParam set_metrology_object_param SetMetrologyObjectParam SetMetrologyObjectParam can be set. But note
that for a lot of applications the default values are sufficient
and no adjustment is necessary.
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.
Row Row Row Row Row row (input_control) ellipse.center.y(-array) → HTuple HTuple HTuple VARIANT Htuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)
Row (or Y) coordinate of the center of the ellipse.
Column (or X) coordinate of the center of the ellipse.
Phi Phi Phi Phi Phi phi (input_control) ellipse.angle.rad(-array) → HTuple HTuple HTuple VARIANT Htuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)
Orientation of the main axis [rad].
Length of the larger half axis.
Length of the smaller half axis.
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
Minimum increment: 1.0
Recommended increment: 10.0
Restriction: MeasureLength1 < Radius1 && MeasureLength1 < Radius2
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
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
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.
If the parameters are valid, the operator
add_metrology_object_ellipse_measure add_metrology_object_ellipse_measure AddMetrologyObjectEllipseMeasure add_metrology_object_ellipse_measure AddMetrologyObjectEllipseMeasure AddMetrologyObjectEllipseMeasure 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
align_metrology_model align_metrology_model AlignMetrologyModel align_metrology_model AlignMetrologyModel AlignMetrologyModel ,
apply_metrology_model apply_metrology_model ApplyMetrologyModel apply_metrology_model ApplyMetrologyModel ApplyMetrologyModel
add_metrology_object_generic add_metrology_object_generic AddMetrologyObjectGeneric add_metrology_object_generic AddMetrologyObjectGeneric AddMetrologyObjectGeneric
get_metrology_object_model_contour get_metrology_object_model_contour GetMetrologyObjectModelContour get_metrology_object_model_contour GetMetrologyObjectModelContour GetMetrologyObjectModelContour ,
set_metrology_model_param set_metrology_model_param SetMetrologyModelParam set_metrology_model_param SetMetrologyModelParam SetMetrologyModelParam ,
add_metrology_object_circle_measure add_metrology_object_circle_measure AddMetrologyObjectCircleMeasure add_metrology_object_circle_measure AddMetrologyObjectCircleMeasure AddMetrologyObjectCircleMeasure ,
add_metrology_object_line_measure add_metrology_object_line_measure AddMetrologyObjectLineMeasure add_metrology_object_line_measure AddMetrologyObjectLineMeasure AddMetrologyObjectLineMeasure ,
add_metrology_object_rectangle2_measure add_metrology_object_rectangle2_measure AddMetrologyObjectRectangle2Measure add_metrology_object_rectangle2_measure AddMetrologyObjectRectangle2Measure AddMetrologyObjectRectangle2Measure
2D Metrology