Skip to content
opencv-wasm

face_FisherFaceRecognizer_create

facefunctionOpenCV 5.0.0
import { face_FisherFaceRecognizer_create } from '@banou/opencv-wasm'

Use after await initOpenCV(). See the initialization and named imports guide.

ARGUMENTSnum_components, threshold
FUNCTIONface_FisherFaceRecognizer_create
RETURN TYPEface_FisherFaceRecognizer | null
Call structure. A void return can still write to destination arguments. The parameter descriptions define inputs, outputs and ownership.

Create an owned face_FisherFaceRecognizer instance with the supplied configuration.

face_FisherFaceRecognizer_create(num_components: number, threshold: number): face_FisherFaceRecognizer | null;
3 available overloads
face_FisherFaceRecognizer_create(): face_FisherFaceRecognizer | null;
face_FisherFaceRecognizer_create(num_components: number): face_FisherFaceRecognizer | null;
face_FisherFaceRecognizer_create(num_components: number, threshold: number): face_FisherFaceRecognizer | null;
num_components

The number of components (read: Fisherfaces) kept for this Linear Discriminant Analysis with the Fisherfaces criterion. It's useful to keep all components, that means the number of your classes c (read: subjects, persons you want to recognize). If you leave this at the default (0) or set it to a value less-equal 0 or greater (c-1), it will be set to the correct number (c-1) automatically.

threshold

The threshold applied in the prediction. If the distance to the nearest neighbor is larger than the threshold, this method returns -1.

Notes:

  • Training and prediction must be done on grayscale images, use cvtColor to convert between the color spaces.
  • THE FISHERFACES METHOD MAKES THE ASSUMPTION, THAT THE TRAINING AND TEST IMAGES ARE OF EQUAL SIZE. (caps-lock, because I got so many mails asking for this). You have to make sure your input data has the correct shape, else a meaningful exception is thrown. Use resize to resize the images.
  • This model does not support updating.

Model internal data:

  • num_components see FisherFaceRecognizer::create.
  • threshold see FisherFaceRecognizer::create.
  • eigenvalues The eigenvalues for this Linear Discriminant Analysis (ordered descending).
  • eigenvectors The eigenvectors for this Linear Discriminant Analysis (ordered by their eigenvalue).
  • mean The sample mean calculated from the training data.
  • projections The projections of the training data.
  • labels The labels corresponding to the projections.
Returns

The face_FisherFaceRecognizer | null result.

Upstream declaration ↗

These signatures describe this package. Upstream documentation can mention optional backends that are absent from this build. Check runtime compatibility before choosing a backend or file format.