MclassPreprocess

Board	Supported
Host System	Yes
V4L2	Yes
Clarity UHD	Yes
Concord PoE	No
GenTL	Yes
GevIQ	Yes
GigE Vision	Yes
Indio	No
Iris GTX	Yes
Radient eV-CL	Yes
Rapixo CL	Yes
Rapixo CoF	Yes
Rapixo CXP	Yes
USB3 Vision	Yes

Preprocess a classification context.

Syntax

void MclassPreprocess(
    AIL_ID    ContextClassId,  //in
    AIL_INT64 ControlFlag      //in
)

Description

This function preprocesses a classification context for data preparation (MclassPrepareData), training (MclassTrain), statistics calculation (MclassStatCalculate), or prediction (MclassPredict). You must call MclassPreprocess before the first call to any of these functions.

During preprocessing, Aurora Imaging Library analyzes the content of the context and makes internal refinements to execute an optimized and robust operation. 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 data preparation, training, or prediction operation.

Saving a context does not save preprocessing changes. Upon restoration, you must preprocess the context again before calling MclassPrepareData, MclassTrain, MclassStatCalculate, orMclassPredict.

Parameters

ContextClassId (in, AIL_ID)

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_PREPARE_IMAGES_CNN, M_PREPARE_IMAGES_DET, M_PREPARE_IMAGES_SEG, M_TRAIN_CNN, M_TRAIN_DET, M_TRAIN_SEG, M_TRAIN_ANO, M_TRAIN_TREE_ENSEMBLE, M_CLASSIFIER_CNN_PREDEFINED, M_CLASSIFIER_DET_PREDEFINED, M_CLASSIFIER_SEG_PREDEFINED, M_CLASSIFIER_ANO_PREDEFINED, or M_CLASSIFIER_TREE_ENSEMBLE.

ControlFlag (in, AIL_INT64)

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

For specifying whether to preprocess the context

Value	Description
M_DEFAULT	Preprocesses the context.
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. |