Skip to content

read_metrology_modelReadMetrologyModelReadMetrologyModelread_metrology_modelT_read_metrology_model🔗

Short description🔗

read_metrology_modelReadMetrologyModelReadMetrologyModelread_metrology_modelT_read_metrology_model — Read a metrology model from a file.

Signature🔗

read_metrology_model( filename.read FileName, out metrology_model MetrologyHandle )void ReadMetrologyModel( const HTuple& FileName, HTuple* MetrologyHandle )static void HOperatorSet.ReadMetrologyModel( HTuple fileName, out HTuple metrologyHandle )def read_metrology_model( file_name: str ) -> HHandle

Herror T_read_metrology_model( const Htuple FileName, Htuple* MetrologyHandle )

void HMetrologyModel::HMetrologyModel( const HString& FileName )

void HMetrologyModel::HMetrologyModel( const char* FileName )

void HMetrologyModel::HMetrologyModel( const wchar_t* FileName ) (Windows only)

public HMetrologyModel( string fileName )

void HMetrologyModel::ReadMetrologyModel( const HString& FileName )

void HMetrologyModel::ReadMetrologyModel( const char* FileName )

void HMetrologyModel::ReadMetrologyModel( const wchar_t* FileName ) (Windows only)

void HMetrologyModel.ReadMetrologyModel( string fileName )

Description🔗

read_metrology_modelReadMetrologyModel reads a metrology model, which has been written to file with write_metrology_modelWriteMetrologyModel, from the file FileNamefileNamefile_name. The default HALCON file extension for a metrology model is 'mtr'. The values contained in the read metrology model are stored in a metrology model with the handle MetrologyHandlemetrologyHandlemetrology_handle. Access to the parameters of the metrology model is possible, e.g., with the operator get_metrology_object_paramGetMetrologyObjectParam or get_metrology_object_fuzzy_paramGetMetrologyObjectFuzzyParam.

For an explanation of the concept of 2D metrology see the introduction of chapter 2D Metrology.

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.

This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.

Parameters🔗

FileNamefileNamefile_name (input_control) filename.read → (string)HTuple (HString)HTuple (string)strHtuple (char*)

File name.

File extension: .mtr

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

Handle of the metrology model.

Result🔗

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

Combinations with other operators🔗

Combinations

Possible successors

get_metrology_object_indicesGetMetrologyObjectIndices, apply_metrology_modelApplyMetrologyModel

See also

write_metrology_modelWriteMetrologyModel

Module🔗

2D Metrology