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_circle_measure, add_metrology_object_ellipse_measure, add_metrology_object_line_measure, or add_metrology_object_rectangle2_measure as XLD contours and the results of the edge location that was performed by apply_metrology_model (see create_metrology_model for the basic principle of 2D metrology). The metrology model is defined by the handle MetrologyHandle. The parameter Indices determines for which metrology objects the information is accessed. With Indices 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 Contour. Additionally, the 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.
A metrology model 'MetrologyHandle' cannot be shared between two or more user's threads. Different metrology models can be used independently and safely in different threads.
Rectangular XLD Contours of measure regions.
Handle of the metrology model.
Indices 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.