Back to FabImage Library website

You are here: Start » Function Reference » Data Classification » Principal Component Analysis » ApplyPCATransform

ApplyPCATransform


Header: FIL.h
Namespace: fil
Module: FoundationPro

Applies previously obtained Principal Component Analysis (PCA) transformation coefficients to new data.

Syntax

C++
C#
 
void fil::ApplyPCATransform
(
	const fil::Matrix& inMatrix,
	const fil::PCAModel& inPCAModel,
	fil::Matrix& outTransformedMatrix
)

Parameters

Name Type Default Description
Input value inMatrix const Matrix& Input data with variables in columns and examples in rows.
Input value inPCAModel const PCAModel& Previously created PCA model to apply to data provided in inMatrix.
Output value outTransformedMatrix Matrix& Transformed inMatrix.

Errors

List of possible exceptions:

Error type Description
DomainError Malformed inPCAModel - MeanVector and StandardDeviationVector are not row-vectors in ApplyPCATransform.
DomainError Malformed inPCAModel - MeanVector and StandardDeviationVector have to have the same length in ApplyPCATransform.
DomainError PCAModel does not match - inMatrix column count does not match in ApplyPCATransform.
DomainError PCAModel does not match - PCAFeatureVector dimensions does not correspond to inMatrix dimensions in ApplyPCATransform.
DomainError PCAModel does not match - StandardDeviationVector length is different then inMatrix column count in ApplyPCATransform.