get_sample_class_gmmT_get_sample_class_gmmGetSampleClassGmmget_sample_class_gmmGetSampleClassGmmGetSampleClassGmm (Operator)

Name

get_sample_class_gmmT_get_sample_class_gmmGetSampleClassGmmget_sample_class_gmmGetSampleClassGmmGetSampleClassGmm — Return a training sample from the training data of a Gaussian Mixture Models (GMM).

Signature

get_sample_class_gmm( : : GMMHandle, NumSample : Features, ClassID)

Description

get_sample_class_gmmget_sample_class_gmmGetSampleClassGmmget_sample_class_gmmGetSampleClassGmmGetSampleClassGmm reads out a training sample from the Gaussian Mixture Model (GMM) given by GMMHandleGMMHandleGMMHandleGMMHandleGMMHandleGMMHandle that was stored with add_sample_class_gmmadd_sample_class_gmmAddSampleClassGmmadd_sample_class_gmmAddSampleClassGmmAddSampleClassGmm or add_samples_image_class_gmmadd_samples_image_class_gmmAddSamplesImageClassGmmadd_samples_image_class_gmmAddSamplesImageClassGmmAddSamplesImageClassGmm. The index of the sample is specified with NumSampleNumSampleNumSampleNumSampleNumSamplenumSample. The index is counted from 0, i.e., NumSampleNumSampleNumSampleNumSampleNumSamplenumSample must be a number between 0 and NumSamplesNumSamplesNumSamplesNumSamplesNumSamplesnumSamples - 1, where NumSamplesNumSamplesNumSamplesNumSamplesNumSamplesnumSamples can be determined with get_sample_num_class_gmmget_sample_num_class_gmmGetSampleNumClassGmmget_sample_num_class_gmmGetSampleNumClassGmmGetSampleNumClassGmm. The training sample is returned in FeaturesFeaturesFeaturesFeaturesFeaturesfeatures and ClassIDClassIDClassIDClassIDClassIDclassID. FeaturesFeaturesFeaturesFeaturesFeaturesfeatures is a feature vector of length NumDimNumDimNumDimNumDimNumDimnumDim, while ClassIDClassIDClassIDClassIDClassIDclassID is its class (see add_sample_class_gmmadd_sample_class_gmmAddSampleClassGmmadd_sample_class_gmmAddSampleClassGmmAddSampleClassGmm and create_class_gmmcreate_class_gmmCreateClassGmmcreate_class_gmmCreateClassGmmCreateClassGmm).

get_sample_class_gmmget_sample_class_gmmGetSampleClassGmmget_sample_class_gmmGetSampleClassGmmGetSampleClassGmm can, for example, be used to reclassify the training data with classify_class_gmmclassify_class_gmmClassifyClassGmmclassify_class_gmmClassifyClassGmmClassifyClassGmm in order to determine which training samples, if any, are classified incorrectly.

Parallelization

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

GMMHandleGMMHandleGMMHandleGMMHandleGMMHandleGMMHandle (input_control) class_gmm → (integer)

GMM handle.

NumSampleNumSampleNumSampleNumSampleNumSamplenumSample (input_control) integer → (integer)

Index of the stored training sample.

FeaturesFeaturesFeaturesFeaturesFeaturesfeatures (output_control) real-array → (real)

Feature vector of the training sample.

ClassIDClassIDClassIDClassIDClassIDclassID (output_control) number → (integer)

Class of the training sample.

Example (HDevelop)

create_class_gmm (2, 2, [1,10], 'spherical', 'none', 2, 42, GMMHandle)
read_samples_class_gmm (GMMHandle, 'samples.gsf')
train_class_gmm (GMMHandle, 100, 1e-4, 'training', 1e-4, Centers, Iter)
* Reclassify the training samples
get_sample_num_class_gmm (GMMHandle, NumSamples)
for I := 0 to NumSamples-1 by 1
  get_sample_class_gmm (GMMHandle, I, Features, Class)
  classify_class_gmm (GMMHandle, Features, 2, ClassID, ClassProb,\
                      Density, KSigmaProb)
  if (not (Class == ClassProb[0]))
    * classified incorrectly
  endif
endfor
clear_class_gmm (GMMHandle)

Result

If the parameters are valid, the operator get_sample_class_gmmget_sample_class_gmmGetSampleClassGmmget_sample_class_gmmGetSampleClassGmmGetSampleClassGmm returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.

Possible Predecessors

add_sample_class_gmmadd_sample_class_gmmAddSampleClassGmmadd_sample_class_gmmAddSampleClassGmmAddSampleClassGmm, add_samples_image_class_gmmadd_samples_image_class_gmmAddSamplesImageClassGmmadd_samples_image_class_gmmAddSamplesImageClassGmmAddSamplesImageClassGmm, read_samples_class_gmmread_samples_class_gmmReadSamplesClassGmmread_samples_class_gmmReadSamplesClassGmmReadSamplesClassGmm, get_sample_num_class_gmmget_sample_num_class_gmmGetSampleNumClassGmmget_sample_num_class_gmmGetSampleNumClassGmmGetSampleNumClassGmm

Possible Successors

classify_class_gmmclassify_class_gmmClassifyClassGmmclassify_class_gmmClassifyClassGmmClassifyClassGmm, evaluate_class_gmmevaluate_class_gmmEvaluateClassGmmevaluate_class_gmmEvaluateClassGmmEvaluateClassGmm

Module

Foundation

Operators