CompactClassificationGAM

Compact generalized additive model (GAM) for binary classification

Since R2021a

Description

CompactClassificationGAM is a compact version of a ClassificationGAM model object (GAM for binary classification). The compact model does not include the data used for training the classifier. Therefore, you cannot perform some tasks, such as cross-validation, using the compact model. Use a compact model for tasks such as predicting the labels of new data.

Creation

Create a CompactClassificationGAM object from a full ClassificationGAM model object by using compact.

Properties

expand all

GAM Properties

`Interactions` — Interaction term indices
Read-only: two-column matrix of positive integers | `[]`

This property is read-only.

Interaction term indices, specified as a t-by-2 matrix of positive integers, where t is the number of interaction terms in the model. Each row of the matrix represents one interaction term and contains the column indexes of the predictor data X for the interaction term. If the model does not include an interaction term, then this property is empty ([]).

The software adds interaction terms to the model in the order of importance based on the p-values. Use this property to check the order of the interaction terms added to the model.

Data Types: double

`Intercept` — Intercept term of model
Read-only: numeric scalar

This property is read-only.

Intercept (constant) term of the model, which is the sum of the intercept terms in the predictor trees and interaction trees, specified as a numeric scalar.

Data Types: single | double

Other Classification Properties

`CategoricalPredictors` — Categorical predictor indices
Read-only: vector of positive integers | `[]`

This property is read-only.

Categorical predictor indices, specified as a vector of positive integers. CategoricalPredictors contains index values indicating that the corresponding predictors are categorical. The index values are between 1 and p, where p is the number of predictors used to train the model. If none of the predictors are categorical, then this property is empty ([]).

Data Types: double

`ClassNames` — Unique class labels
Read-only: categorical array | character array | logical vector | numeric vector | cell array of character vectors

This property is read-only.

Unique class labels used in training, specified as a categorical or character array, logical or numeric vector, or cell array of character vectors. ClassNames has the same data type as the class labels Y. (The software treats string arrays as cell arrays of character vectors.) ClassNames also determines the class order.

`Cost` — Misclassification costs
2-by-2 numeric matrix

Misclassification costs, specified as a 2-by-2 numeric matrix.

Cost(i,j) is the cost of classifying a point into class j if its true class is i. The order of the rows and columns of Cost corresponds to the order of the classes in ClassNames.

The software uses the Cost value for prediction, but not training. You can change the value by using dot notation.

Example: Mdl.Cost = C;

Data Types: double

`ExpandedPredictorNames` — Expanded predictor names
Read-only: cell array of character vectors

This property is read-only.

Expanded predictor names, specified as a cell array of character vectors.

ExpandedPredictorNames is the same as PredictorNames for a generalized additive model.

Data Types: cell

`PredictorNames` — Predictor variable names
Read-only: cell array of character vectors

This property is read-only.

Predictor variable names, specified as a cell array of character vectors. The order of the elements in PredictorNames corresponds to the order in which the predictor names appear in the training data.

Data Types: cell

`Prior` — Prior class probabilities
Read-only: numeric vector

This property is read-only.

Prior class probabilities, specified as a numeric vector with two elements. The order of the elements corresponds to the order of the elements in ClassNames.

Data Types: double

`ResponseName` — Response variable name
Read-only: character vector

This property is read-only.

Response variable name, specified as a character vector.

Data Types: char

`ScoreTransform` — Score transformation
character vector | function handle

Score transformation, specified as a character vector or function handle. ScoreTransform represents a built-in transformation function or a function handle for transforming predicted classification scores.

To change the score transformation function to function, for example, use dot notation.

For a built-in function, enter a character vector.

Mdl.ScoreTransform = 'function';

This table describes the available built-in functions.

Value	Description
`'doublelogit'`	1/(1 + e^–2x)
`'invlogit'`	log(x / (1 – x))
`'ismax'`	Sets the score for the class with the largest score to 1, and sets the scores for all other classes to 0
`'logit'`	1/(1 + e^–x)
`'none'` or `'identity'`	x (no transformation)
`'sign'`	–1 for x < 0 0 for x = 0 1 for x > 0
`'symmetric'`	2x – 1
`'symmetricismax'`	Sets the score for the class with the largest score to 1, and sets the scores for all other classes to –1
`'symmetriclogit'`	2/(1 + e^–x) – 1

For a MATLAB^® function or a function that you define, enter its function handle.
```
Mdl.ScoreTransform = @function;
```
function must accept a matrix (the original scores) and return a matrix of the same size (the transformed scores).

This property determines the output score computation for object functions such as predict, margin, and edge. Use 'logit' to compute posterior probabilities, and use 'none' to compute the logit of posterior probabilities.

Data Types: char | function_handle

Object Functions

expand all

Interpret Prediction

`lime`	Local interpretable model-agnostic explanations (LIME)
`partialDependence`	Compute partial dependence
`plotLocalEffects`	Plot local effects of terms in generalized additive model (GAM)
`plotPartialDependence`	Create partial dependence plot (PDP) and individual conditional expectation (ICE) plots
`shapley`	Shapley values

Assess Predictive Performance on New Observations

`predict`	Classify observations using generalized additive model (GAM)
`loss`	Classification loss for generalized additive model (GAM)
`margin`	Classification margins for generalized additive model (GAM)
`edge`	Classification edge for generalized additive model (GAM)

Compare Accuracies

compareHoldout Compare accuracies of two classification models using new data

Examples

collapse all

Reduce Size of Generalized Additive Model

Open Live Script

Reduce the size of a full generalized additive model (GAM) by removing the training data. Full models hold the training data. You can use a compact model to improve memory efficiency.

Load the ionosphere data set. This data set has 34 predictors and 351 binary responses for radar returns, either bad ('b') or good ('g').

load ionosphere

Train a GAM using the predictors X and class labels Y. A recommended practice is to specify the class names.

Mdl = fitcgam(X,Y,'ClassNames',{'b','g'})

Mdl = 
  ClassificationGAM
             ResponseName: 'Y'
    CategoricalPredictors: []
               ClassNames: {'b'  'g'}
           ScoreTransform: 'logit'
                Intercept: 2.2715
          NumObservations: 351


  Properties, Methods

Mdl is a ClassificationGAM model object.

Reduce the size of the classifier.

CMdl = compact(Mdl)

CMdl = 
  CompactClassificationGAM
             ResponseName: 'Y'
    CategoricalPredictors: []
               ClassNames: {'b'  'g'}
           ScoreTransform: 'logit'
                Intercept: 2.2715


  Properties, Methods

CMdl is a CompactClassificationGAM model object.

Display the amount of memory used by each classifier.

whos('Mdl','CMdl')

  Name      Size              Bytes  Class                                                 Attributes

  CMdl      1x1             1064155  classreg.learning.classif.CompactClassificationGAM              
  Mdl       1x1             1265674  ClassificationGAM

The full classifier (Mdl) is larger than the compact classifier (CMdl).

To efficiently label new observations, you can remove Mdl from the MATLAB® Workspace, and then pass CMdl and new predictor values to predict.

Version History

Introduced in R2021a

CompactClassificationGAM

Description

Creation

Properties

GAM Properties

`Interactions` — Interaction term indices
Read-only: two-column matrix of positive integers | `[]`

`Intercept` — Intercept term of model
Read-only: numeric scalar

Other Classification Properties

`CategoricalPredictors` — Categorical predictor indices
Read-only: vector of positive integers | `[]`

`ClassNames` — Unique class labels
Read-only: categorical array | character array | logical vector | numeric vector | cell array of character vectors

`Cost` — Misclassification costs
2-by-2 numeric matrix

`ExpandedPredictorNames` — Expanded predictor names
Read-only: cell array of character vectors

`PredictorNames` — Predictor variable names
Read-only: cell array of character vectors

`Prior` — Prior class probabilities
Read-only: numeric vector

`ResponseName` — Response variable name
Read-only: character vector

`ScoreTransform` — Score transformation
character vector | function handle

Object Functions

Interpret Prediction

Assess Predictive Performance on New Observations

Compare Accuracies

Examples

Reduce Size of Generalized Additive Model

Version History

See Also

Topics

CompactClassificationGAM

Description

Creation

Properties

GAM Properties

Interactions — Interaction term indices Read-only: two-column matrix of positive integers | []

Intercept — Intercept term of model Read-only: numeric scalar

Other Classification Properties

CategoricalPredictors — Categorical predictor indices Read-only: vector of positive integers | []

ClassNames — Unique class labels Read-only: categorical array | character array | logical vector | numeric vector | cell array of character vectors

Cost — Misclassification costs 2-by-2 numeric matrix

ExpandedPredictorNames — Expanded predictor names Read-only: cell array of character vectors

PredictorNames — Predictor variable names Read-only: cell array of character vectors

Prior — Prior class probabilities Read-only: numeric vector

ResponseName — Response variable name Read-only: character vector

ScoreTransform — Score transformation character vector | function handle

Object Functions

Interpret Prediction

Assess Predictive Performance on New Observations

Compare Accuracies

Examples

Reduce Size of Generalized Additive Model

Version History

See Also

Topics

`Interactions` — Interaction term indices
Read-only: two-column matrix of positive integers | `[]`

`Intercept` — Intercept term of model
Read-only: numeric scalar

`CategoricalPredictors` — Categorical predictor indices
Read-only: vector of positive integers | `[]`

`ClassNames` — Unique class labels
Read-only: categorical array | character array | logical vector | numeric vector | cell array of character vectors

`Cost` — Misclassification costs
2-by-2 numeric matrix

`ExpandedPredictorNames` — Expanded predictor names
Read-only: cell array of character vectors

`PredictorNames` — Predictor variable names
Read-only: cell array of character vectors

`Prior` — Prior class probabilities
Read-only: numeric vector

`ResponseName` — Response variable name
Read-only: character vector

`ScoreTransform` — Score transformation
character vector | function handle