write_metrology_modelwrite_metrology_modelWriteMetrologyModelwrite_metrology_modelWriteMetrologyModelWriteMetrologyModel (Operator)

Name

write_metrology_modelwrite_metrology_modelWriteMetrologyModelwrite_metrology_modelWriteMetrologyModelWriteMetrologyModel — Write a metrology model to a file.

Signature

write_metrology_model( : : MetrologyHandle, FileName : )

Description

write_metrology_modelwrite_metrology_modelWriteMetrologyModelwrite_metrology_modelWriteMetrologyModelWriteMetrologyModel writes a metrology model to the file FileNameFileNameFileNameFileNameFileNamefileName. The metrology model is defined by the handle MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle. The metrology model can be read with read_metrology_modelread_metrology_modelReadMetrologyModelread_metrology_modelReadMetrologyModelReadMetrologyModel. The default HALCON file extension for a metrology model is 'mtr'.

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

Attention

Note that only the input values are saved, i.e., no measure regions and no results obtained by the operator apply_metrology_modelapply_metrology_modelApplyMetrologyModelapply_metrology_modelApplyMetrologyModelApplyMetrologyModel are saved.

Parallelization

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle (input_control) metrology_model → (integer)

Handle of the metrology model.

FileNameFileNameFileNameFileNameFileNamefileName (input_control) filename.write → (string)

File name.

File extension: .mtr

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