get_metrology_object_measures — Get the measure regions and the results of the edge location for the metrology objects of a metrology model.
get_metrology_object_measures allows to access the measure regions of the metrology objects that were created with add_metrology_object_generic, add_metrology_object_circle_measure, etc. as XLD contours and the results of the edge location in image coordinates that was performed by apply_metrology_model.
For an explanation of the concept of 2D metrology see the introduction of chapter 2D Metrology.
The metrology model is defined by the handle MetrologyHandle. The parameter Index determines for which metrology objects the information is accessed. With Index set to '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' of the operator set_metrology_object_param), with the parameter Transition the desired edges (positive or negative) can be selected. If Transition is set to 'positive', only positive edges are returned. If Transition is set to 'negative', only negative edges are returned. All edges are returned if the parameter Transition ist set to 'all'.
The operator get_metrology_object_measures returns for each measure region one rectangular XLD contour with the boundary of the measure region in the parameter Contours. After calling apply_metrology_model, additionally the image coordinates of the results of the edge location are returned as single points in the parameters Row and Column. 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_measures is called before apply_metrology_model, the parameters Row and Column remain empty.
Rectangular XLD Contours of measure regions.
Handle of the metrology model.
Index of the metrology objects.
Default value: 'all'
Suggested values: 'all', 0, 1, 2
Select light/dark or dark/light edges.
Default value: 'all'
List of values: 'all', 'negative', 'positive'
Row coordinates of the measured edges.
Column coordinates of the measured edges.
If the parameters are valid, the operator get_metrology_object_measures returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.
add_metrology_object_generic, add_metrology_object_ellipse_measure, add_metrology_object_line_measure, add_metrology_object_rectangle2_measure, add_metrology_object_circle_measure