write_metrology_modelT_write_metrology_modelWriteMetrologyModelWriteMetrologyModel (Operator)

Name

write_metrology_modelT_write_metrology_modelWriteMetrologyModelWriteMetrologyModel — Write a metrology model to a file.

Signature

write_metrology_model( : : MetrologyHandle, FileName : )

Description

write_metrology_modelwrite_metrology_modelWriteMetrologyModelWriteMetrologyModelWriteMetrologyModel writes a metrology model to the file FileNameFileNameFileNameFileNamefileName. The metrology model is defined by the handle MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle. The metrology model can be read with read_metrology_modelread_metrology_modelReadMetrologyModelReadMetrologyModelReadMetrologyModel. 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_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModel are saved.

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

MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle (input_control) metrology_model → (handle)

Handle of the metrology model.

FileNameFileNameFileNameFileNamefileName (input_control) filename.write → (string)

File name.

File extension: .mtr

Result

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

Possible Predecessors

apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModel

Possible Successors

clear_metrology_modelclear_metrology_modelClearMetrologyModelClearMetrologyModelClearMetrologyModel

Module

2D Metrology

Operators