get_metrology_object_result_contourget_metrology_object_result_contourGetMetrologyObjectResultContourGetMetrologyObjectResultContour (Operator)

Name

get_metrology_object_result_contourget_metrology_object_result_contourGetMetrologyObjectResultContourGetMetrologyObjectResultContour — Query the result contour of a metrology object.

Signature

get_metrology_object_result_contour( : Contour : MetrologyHandle, Index, Instance, Resolution : )

get_metrology_object_result_contourget_metrology_object_result_contourGetMetrologyObjectResultContourGetMetrologyObjectResultContourGetMetrologyObjectResultContour returns for the chosen metrology objects and object instances, the result contours of a measurement performed by apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModel in image coordinates.

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 specifies for which metrology objects the result contours are queried. For IndexIndexIndexIndexindex set to 'all'"all""all""all""all", the result contours of all metrology objects are returned. If for a metrology object several results (instances) were computed, then the parameter InstanceInstanceInstanceInstanceinstance specifies, for which instances the result contours are returned in ContourContourContourContourcontour. The result contours for all instances are obtained by setting InstanceInstanceInstanceInstanceinstance to 'all'"all""all""all""all".

The resolution of the resulting contour ContourContourContourContourcontour is controlled via ResolutionResolutionResolutionResolutionresolution containing the Euclidean distance between neighboring contour points in pixel. If the input value falls below the minimal possible value (1.192e-7), then the resolution is set internally to the smallest valid value.

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

ContourContourContourContourcontour (output_object) xld_cont(-array) → object

Result contour for the given metrology object.

MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle (input_control) metrology_model → (integer)

Handle of the metrology model.

IndexIndexIndexIndexindex (input_control) integer(-array) → (integer / string)

Index of the metrology object.

Default value: 'all' "all" "all" "all" "all"

Suggested values: 'all'"all""all""all""all", 0, 1, 2

InstanceInstanceInstanceInstanceinstance (input_control) integer(-array) → (integer / string)

Instance of the metrology object.

Default value: 'all' "all" "all" "all" "all"

Suggested values: 'all'"all""all""all""all", 0, 1, 2

ResolutionResolutionResolutionResolutionresolution (input_control) real → (real)

Distance between neighboring contour points.

Default value: 1.5

Restriction: Resolution >= 1.192e-7

Result

If the parameters are valid, the operator get_metrology_object_result_contourget_metrology_object_result_contourGetMetrologyObjectResultContourGetMetrologyObjectResultContourGetMetrologyObjectResultContour returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Predecessors

apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModel

Module

2D Metrology

Operators