read_metrology_model — Read a metrology model from a file.
read_metrology_model reads a metrology model, which has been written to file with write_metrology_model, from the file FileName (see create_metrology_model for the basic principle of 2D metrology). 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 MetrologyHandle. Access to the parameters of the metrology model is possible, e.g., with the operator get_metrology_object_param or get_metrology_object_fuzzy_param.
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.
File extension: .mtr
Handle of the metrology model.
If the parameters are valid, the operator read_metrology_model returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.