| Customize Help
| Save Settings

MclassPreprocess



Function Map
Synopsis
Preprocess a classification context.
Syntax
void MclassPreprocess(
MIL_ID ContextClassId, //in
MIL_INT64 ControlFlag //in
)
Description

This function prepares a classification context for training (MclassTrain()) or prediction (MclassPredict()). During preprocessing, for M_CLASSIFIER_CNN_PREDEFINED and M_CLASSIFIER_TREE_ENSEMBLE contexts, MIL compiles and analyzes the content of the context and makes internal refinements to execute an optimized and robust operation. You must call MclassPreprocess() before the first call to MclassPredict().

For M_TRAIN_CNN and M_TRAIN_TREE_ENSEMBLE, you must call MclassPreprocess() before the first call to MclassTrain().

Changes to a context or any of its content often require preprocessing the context again. To inquire whether you should preprocess the context, call MclassInquire() with M_PREPROCESSED. The context must be in a preprocessed state before calling the training or prediction operation.

Saving a context does not save preprocessing changes. Upon restoration, you must preprocess the context again before calling MclassPredict() or MclassTrain().

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see which MIL system’s documentation you should use in its place and any possible differences.
Parameters
This function is not supported on the selected boards.
This function reference has not been updated for the selected MIL system. To show the content of this page, choose a second MIL system; refer to the MIL system's release note to see which MIL system’s documentation to choose and any possible differences.
Parameters
ContextClassId

Specifies the identifier of the classification context to preprocess. The classification context must have been previously allocated on the required system using MclassAlloc() with M_TRAIN_CNN, M_TRAIN_TREE_ENSEMBLE, M_CLASSIFIER_TREE_ENSEMBLE, or M_CLASSIFIER_TREE_ENSEMBLE.

ControlFlag

Specifies whether to preprocess the classification context. Set this parameter to one of the following values:

function map For specifying whether to preprocess the context
Click to summarizeValue Description
Click to summarize M_DEFAULT

Preprocesses the context.

Click to summarize M_RESET

Un-preprocesses the context.

Un-preprocessing the context can be useful if you want to conserve system memory within an application and preserve context settings.

(summarize)
Compilation information
Header Include mil.h.
Library Use mil.lib; milclass.lib.
DLL Requires mil.dll; milclass.dll.
DEFAULT RESET