get_metrology_object_measuresT_get_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures (Operator)
Name
get_metrology_object_measuresT_get_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures — Get the measure regions and the results of the edge location for the
metrology objects of a metrology model.
Signature
void GetMetrologyObjectMeasures(HObject* Contours, const HTuple& MetrologyHandle, const HTuple& Index, const HTuple& Transition, HTuple* Row, HTuple* Column)
HXLDCont HMetrologyModel::GetMetrologyObjectMeasures(const HTuple& Index, const HString& Transition, HTuple* Row, HTuple* Column) const
HXLDCont HMetrologyModel::GetMetrologyObjectMeasures(const HString& Index, const HString& Transition, HTuple* Row, HTuple* Column) const
HXLDCont HMetrologyModel::GetMetrologyObjectMeasures(const char* Index, const char* Transition, HTuple* Row, HTuple* Column) const
HXLDCont HMetrologyModel::GetMetrologyObjectMeasures(const wchar_t* Index, const wchar_t* Transition, HTuple* Row, HTuple* Column) const
(Windows only)
static void HOperatorSet.GetMetrologyObjectMeasures(out HObject contours, HTuple metrologyHandle, HTuple index, HTuple transition, out HTuple row, out HTuple column)
HXLDCont HMetrologyModel.GetMetrologyObjectMeasures(HTuple index, string transition, out HTuple row, out HTuple column)
HXLDCont HMetrologyModel.GetMetrologyObjectMeasures(string index, string transition, out HTuple row, out HTuple column)
Description
get_metrology_object_measuresget_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures allows to access the measure regions
of the metrology objects that were created with
add_metrology_object_genericadd_metrology_object_genericAddMetrologyObjectGenericAddMetrologyObjectGenericAddMetrologyObjectGeneric,
add_metrology_object_circle_measureadd_metrology_object_circle_measureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasure, etc. as XLD contours and the
results of the edge location in image coordinates that was performed by
apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModel.
For an explanation of the concept of 2D metrology see the
introduction of chapter 2D Metrology.
The metrology model is defined by the handle MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle. The
parameter IndexIndexIndexIndexindex determines for which metrology objects the
information is accessed. With IndexIndexIndexIndexindex set to 'all'"all""all""all""all", the
measure regions and the results of the edge location for all metrology
objects are accessed.
If positive and negative edges are available in the measure regions
(see the generic parameter value 'measure_transition'"measure_transition""measure_transition""measure_transition""measure_transition" of
the operator set_metrology_object_paramset_metrology_object_paramSetMetrologyObjectParamSetMetrologyObjectParamSetMetrologyObjectParam), with the
parameter TransitionTransitionTransitionTransitiontransition the desired edges (positive or
negative) can be selected. If TransitionTransitionTransitionTransitiontransition is
set to 'positive'"positive""positive""positive""positive", only positive edges are returned. If
TransitionTransitionTransitionTransitiontransition is set to 'negative'"negative""negative""negative""negative", only negative edges
are returned. All edges are returned if the parameter
TransitionTransitionTransitionTransitiontransition ist set to 'all'"all""all""all""all".
The operator get_metrology_object_measuresget_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures returns for each measure
region one rectangular XLD contour with the boundary of the measure
region in the parameter ContoursContoursContoursContourscontours. After calling
apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModel, additionally the image coordinates
of the results of the edge location are returned as single points in
the parameters RowRowRowRowrow and ColumnColumnColumnColumncolumn. Note that the order
for the values of these points is not defined. Furthermore, there is no
possibility to assign the results of the edge location to specific
measure regions. If get_metrology_object_measuresget_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures is called before
apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModel, the parameters RowRowRowRowrow and
ColumnColumnColumnColumncolumn remain empty.
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
ContoursContoursContoursContourscontours (output_object) xld_cont-array → objectHXLDContHXLDContHobject *
Rectangular XLD Contours of measure regions.
MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle (input_control) metrology_model → HMetrologyModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the metrology model.
IndexIndexIndexIndexindex (input_control) integer(-array) → HTupleHTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Index of the metrology objects.
Default value:
'all'
"all"
"all"
"all"
"all"
Suggested values: 'all'"all""all""all""all", 0, 1, 2
TransitionTransitionTransitionTransitiontransition (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Select light/dark or dark/light edges.
Default value:
'all'
"all"
"all"
"all"
"all"
List of values: 'all'"all""all""all""all", 'negative'"negative""negative""negative""negative", 'positive'"positive""positive""positive""positive"
RowRowRowRowrow (output_control) point.y-array → HTupleHTupleHtuple (real) (double) (double) (double)
Row coordinates of the measured edges.
ColumnColumnColumnColumncolumn (output_control) point.x-array → HTupleHTupleHtuple (real) (double) (double) (double)
Column coordinates of the measured edges.
Result
If the parameters are valid, the operator
get_metrology_object_measuresget_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures returns the value 2 (H_MSG_TRUE). If
necessary, an exception is raised.
Possible Predecessors
apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModel
See also
add_metrology_object_genericadd_metrology_object_genericAddMetrologyObjectGenericAddMetrologyObjectGenericAddMetrologyObjectGeneric,
add_metrology_object_ellipse_measureadd_metrology_object_ellipse_measureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasure,
add_metrology_object_line_measureadd_metrology_object_line_measureAddMetrologyObjectLineMeasureAddMetrologyObjectLineMeasureAddMetrologyObjectLineMeasure,
add_metrology_object_rectangle2_measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measure,
add_metrology_object_circle_measureadd_metrology_object_circle_measureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasure
Module
2D Metrology