resubMargin

Resubstitution classification margins for discriminant analysis classifier

Syntax

m = resubMargin(Mdl)

Description

m = resubMargin(Mdl) returns the resubstitution classification margins values m for the trained discriminant analysis classifier Mdl using the training data stored in Mdl.X and the corresponding true class labels stored in Mdl.Y. m is returned as a numeric column vector with the same length as Mdl.Y. The software estimates each entry of m using the trained discriminant analysis classifier Mdl, the corresponding row of Mdl.X, and the true class label Mdl.Y.

Examples

Estimate Resubstitution Margins for Discriminant Analysis Classifiers

Find the margins for a discriminant analysis classifier for Fisher's iris data by resubstitution. Examine several entries.

Load Fisher's iris data set.

load fisheriris

Train a discriminant analysis classifier.

Mdl = fitcdiscr(meas,species);

Compute the resubstitution margins, and display several of them.

m = resubMargin(Mdl);
m(1:25:end)

ans = 6×1

    1.0000
    1.0000
    0.9998
    0.9998
    1.0000
    0.9946

Input Arguments

Mdl — Discriminant analysis classifier

ClassificationDiscriminant model object

Discriminant analysis classifier, specified as a ClassificationDiscriminant model object trained with fitcdiscr.

More About

Classification Margin

The classification margin is the difference between the classification score for the true class and maximal classification score for the false classes.

The classification margin is a column vector with the same number of rows as in the matrix X. A high value of margin indicates a more reliable prediction than a low value.

Score

For discriminant analysis, the score of a classification is the posterior probability of the classification. For the definition of posterior probability in discriminant analysis, see Posterior Probability.

Version History

Introduced in R2011b

R2023b: Observations with missing predictor values are used in resubstitution and cross-validation computations

Starting in R2023b, the following classification model object functions use observations with missing predictor values as part of resubstitution ("resub") and cross-validation ("kfold") computations for classification edges, losses, margins, and predictions.

Model Type	Model Objects	Object Functions
Discriminant analysis classification model	ClassificationDiscriminant	resubEdge, resubLoss, resubMargin, resubPredict
	ClassificationPartitionedModel	kfoldEdge, kfoldLoss, kfoldMargin, kfoldPredict
Ensemble of discriminant analysis learners for classification	ClassificationEnsemble	resubEdge, resubLoss, resubMargin, resubPredict
	ClassificationPartitionedEnsemble	kfoldEdge, kfoldLoss, kfoldMargin, kfoldPredict
Gaussian kernel classification model	ClassificationPartitionedKernel	kfoldEdge, kfoldLoss, kfoldMargin, kfoldPredict
	ClassificationPartitionedKernelECOC	kfoldEdge, kfoldLoss, kfoldMargin, kfoldPredict
Linear classification model	ClassificationPartitionedLinear	kfoldEdge, kfoldLoss, kfoldMargin, kfoldPredict
	ClassificationPartitionedLinearECOC	kfoldEdge, kfoldLoss, kfoldMargin, kfoldPredict
Neural network classification model	ClassificationNeuralNetwork	resubEdge, resubLoss, resubMargin, resubPredict
	ClassificationPartitionedModel	kfoldEdge, kfoldLoss, kfoldMargin, kfoldPredict
Support vector machine (SVM) classification model	ClassificationSVM	resubEdge, resubLoss, resubMargin, resubPredict
	ClassificationPartitionedModel	kfoldEdge, kfoldLoss, kfoldMargin, kfoldPredict

In previous releases, the software omitted observations with missing predictor values from the resubstitution and cross-validation computations.