write_data_code_2d_model ( : : DataCodeHandle, FileName : )

Writes a 2D data code model into a file.

The operator write_data_code_2d_model writes a 2D data code model, which was created by create_data_code_2d_model, into a file with the name FileName. This facilitates creating an identical copy of the saved model in a later session with the operator read_data_code_2d_model. The handle of the model to write is passed in DataCodeHandle.


Parameters

DataCodeHandle (input_control)
datacode_2d -> integer
Handle of the 2D data code model.

FileName (input_control)
string -> string
Name of the 2D data code model file.
Default value: 'data_code_model.dcm'


Example
* This example demonstrates how a trained model can be saved for
* a future session

* Create a model for reading Data matrix ECC 200 codes
create_data_code_2d_model ('Data Matrix ECC 200', [], [], DataCodeHandle)
* Read a training image
read_image (Image, 'datacode/ecc200/ecc200_cpu_008')
* Train the model with the symbol in the image
find_data_code_2d (Image, SymbolXLDs, DataCodeHandle, 'train', 'all',
                   ResultHandles, DecodedDataStrings)
* Write the model into a file
write_data_code_2d_model (DataCodeHandle, 'ecc200_trained_model.dcm')
* Clear the model
clear_data_code_2d_model (DataCodeHandle)

Result

The operator write_data_code_2d_model returns the value 2 (H_MSG_TRUE) if the passed handle is valid and if the model can be written into the named file. Otherwise, an exception will be raised.


Parallelization Information

write_data_code_2d_model is reentrant and processed without parallelization.


Possible Predecessors

set_data_code_2d_param, find_data_code_2d


Alternatives

get_data_code_2d_param


See also

create_data_code_2d_model, set_data_code_2d_param, find_data_code_2d


Module

Data Code



Copyright © 1996-2008 MVTec Software GmbH