Skip to content

get_metrology_object_result_contourget_metrology_object_result_contourGetMetrologyObjectResultContourGetMetrologyObjectResultContourget_metrology_object_result_contourT_get_metrology_object_result_contour🔗

Short description🔗

get_metrology_object_result_contourget_metrology_object_result_contourGetMetrologyObjectResultContourGetMetrologyObjectResultContourget_metrology_object_result_contourT_get_metrology_object_result_contour — Query the result contour of a metrology object.

Signature🔗

get_metrology_object_result_contour( out xld_cont Contour, metrology_model MetrologyHandle, integer Index, integer Instance, real Resolution )get_metrology_object_result_contour( : Contour : MetrologyHandle, Index, Instance, Resolution : )void GetMetrologyObjectResultContour( HObject* Contour, const HTuple& MetrologyHandle, const HTuple& Index, const HTuple& Instance, const HTuple& Resolution )static void HOperatorSet.GetMetrologyObjectResultContour( out HObject contour, HTuple metrologyHandle, HTuple index, HTuple instance, HTuple resolution )def get_metrology_object_result_contour( metrology_handle: HHandle, index: MaybeSequence[Union[int, str]], instance: MaybeSequence[Union[int, str]], resolution: float ) -> HObject

Herror T_get_metrology_object_result_contour( Hobject* Contour, const Htuple MetrologyHandle, const Htuple Index, const Htuple Instance, const Htuple Resolution )

HXLDCont HMetrologyModel::GetMetrologyObjectResultContour( const HTuple& Index, const HTuple& Instance, double Resolution ) const

HXLDCont HMetrologyModel::GetMetrologyObjectResultContour( Hlong Index, const HString& Instance, double Resolution ) const

HXLDCont HMetrologyModel::GetMetrologyObjectResultContour( Hlong Index, const char* Instance, double Resolution ) const

HXLDCont HMetrologyModel::GetMetrologyObjectResultContour( Hlong Index, const wchar_t* Instance, double Resolution ) const (Windows only)

HXLDCont HMetrologyModel.GetMetrologyObjectResultContour( HTuple index, HTuple instance, double resolution )

HXLDCont HMetrologyModel.GetMetrologyObjectResultContour( int index, string instance, double resolution )

Description🔗

get_metrology_object_result_contourGetMetrologyObjectResultContour returns for the chosen metrology objects and object instances, the result contours of a measurement performed by apply_metrology_modelApplyMetrologyModel 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 MetrologyHandlemetrologyHandlemetrology_handle. The parameter Indexindexindex specifies for which metrology objects the result contours are queried. For Indexindexindex set to 'all'"all", the result contours of all metrology objects are returned. If for a metrology object several results (instances) were computed, then the parameter Instanceinstanceinstance specifies, for which instances the result contours are returned in Contourcontourcontour. The result contours for all instances are obtained by setting Instanceinstanceinstance to 'all'"all".

The resolution of the resulting contour Contourcontourcontour is controlled via Resolutionresolutionresolution 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🔗

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🔗

Contourcontourcontour (output_object) xld_cont(-array) → objectobjectHObjectHXLDContHObjectHobject *

Result contour for the given metrology object.

MetrologyHandlemetrologyHandlemetrology_handle (input_control) metrology_model → (handle)(handle)HTuple (HHandle)HMetrologyModel, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the metrology model.

Indexindexindex (input_control) integer(-array) → (integer / string)(integer / string)HTuple (Hlong / HString)HTuple (int / long / string)MaybeSequence[Union[int, str]]Htuple (Hlong / char*)

Index of the metrology object.

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

Instanceinstanceinstance (input_control) integer(-array) → (string / integer)(string / integer)HTuple (HString / Hlong)HTuple (string / int / long)MaybeSequence[Union[int, str]]Htuple (char* / Hlong)

Instance of the metrology object.

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

Resolutionresolutionresolution (input_control) real → (real)(real)HTuple (double)HTuple (double)floatHtuple (double)

Distance between neighboring contour points.

Default: 1.51.5
Restriction: Resolution >= 1.192e-7

Result🔗

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

Combinations with other operators🔗

Combinations

Possible predecessors

apply_metrology_modelApplyMetrologyModel

See also

get_metrology_object_resultGetMetrologyObjectResult, get_metrology_object_measuresGetMetrologyObjectMeasures

Module🔗

2D Metrology