read_deep_matching_3dT_read_deep_matching_3dReadDeepMatching3dReadDeepMatching3dread_deep_matching_3d (Operator)
Name
read_deep_matching_3dT_read_deep_matching_3dReadDeepMatching3dReadDeepMatching3dread_deep_matching_3d — Read a Deep 3D Matching model from a file.
Signature
def read_deep_matching_3d(file_name: str) -> HHandle
Description
The operator read_deep_matching_3dread_deep_matching_3dReadDeepMatching3dReadDeepMatching3dread_deep_matching_3d reads a Deep 3D Matching model.
Such models have to be in the HALCON format.
As a result, the handle Deep3DMatchingModelDeep3DMatchingModelDeep3DMatchingModeldeep3DMatchingModeldeep_3dmatching_model is returned.
The model is loaded from the file FileNameFileNameFileNamefileNamefile_name.
The default HALCON file extension for Deep 3D Matching models is
'.dm3'.
Please note that the values of runtime specific parameters are not written
to file, see write_deep_matching_3dwrite_deep_matching_3dWriteDeepMatching3dWriteDeepMatching3dwrite_deep_matching_3d.
As a consequence when reading a model these parameters are initialized with
their default value, see get_deep_matching_3d_paramget_deep_matching_3d_paramGetDeepMatching3dParamGetDeepMatching3dParamget_deep_matching_3d_param.
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
FileNameFileNameFileNamefileNamefile_name (input_control) filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Filename
File extension:
.dm3
Deep3DMatchingModelDeep3DMatchingModelDeep3DMatchingModeldeep3DMatchingModeldeep_3dmatching_model (output_control) deep_matching_3d → HDeepMatching3D, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the Deep 3D Matching model.
Result
If the parameters are valid, the operator read_deep_matching_3dread_deep_matching_3dReadDeepMatching3dReadDeepMatching3dread_deep_matching_3d
returns the value 2 (
H_MSG_TRUE)
. If necessary, an exception is raised.
Possible Successors
set_deep_matching_3d_paramset_deep_matching_3d_paramSetDeepMatching3dParamSetDeepMatching3dParamset_deep_matching_3d_param,
get_deep_matching_3d_paramget_deep_matching_3d_paramGetDeepMatching3dParamGetDeepMatching3dParamget_deep_matching_3d_param,
apply_deep_matching_3dapply_deep_matching_3dApplyDeepMatching3dApplyDeepMatching3dapply_deep_matching_3d
Module
3D Metrology