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
-
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