RegressionBaggedEnsemble
Package: classreg.learning.regr
Superclasses: RegressionEnsemble
Regression ensemble grown by resampling
Description
RegressionBaggedEnsemble
combines a set of trained
weak learner models and data on which these learners were trained. It can predict
ensemble response for new data by aggregating predictions from its weak learners.
Construction
Create a bagged regression ensemble object using fitrensemble
. Set the namevalue pair argument
'Method'
of fitrensemble
to
'Bag'
to use bootstrap aggregation (bagging, for example, random
forest).
Properties

Bin edges for numeric predictors, specified as a cell array of p numeric vectors, where p is the number of predictors. Each vector includes the bin edges for a numeric predictor. The element in the cell array for a categorical predictor is empty because the software does not bin categorical predictors. The software bins numeric predictors only if you specify the You can reproduce the binned predictor data X = mdl.X; % Predictor data
Xbinned = zeros(size(X));
edges = mdl.BinEdges;
% Find indices of binned predictors.
idxNumeric = find(~cellfun(@isempty,edges));
if iscolumn(idxNumeric)
idxNumeric = idxNumeric';
end
for j = idxNumeric
x = X(:,j);
% Convert x to array if x is a table.
if istable(x)
x = table2array(x);
end
% Group x into bins by using the Xbinned
contains the bin indices, ranging from 1 to the number of bins, for numeric predictors.
Xbinned values are 0 for categorical predictors. If
X contains NaN s, then the corresponding
Xbinned values are NaN s.


Categorical predictor
indices, specified as a vector of positive integers. 

A character vector describing how the ensemble combines learner predictions. 

Expanded predictor names, stored as a cell array of character vectors. If the model uses encoding for categorical variables, then


A numeric array of fit information. The


Character vector describing the meaning of the 

A numeric scalar between 

Description of the crossvalidation optimization of hyperparameters,
stored as a


Cell array of character vectors with names of the weak learners in the
ensemble. The name of each learner appears just once. For example, if you
have an ensemble of 100 trees, 

A character vector with the name of the algorithm 

Parameters used in training 

Numeric scalar containing the number of observations in the training data. 

Number of trained learners in the ensemble, a positive scalar. 

A cell array of names for the predictor variables, in the order in which
they appear in 

A character vector describing the reason 

A structure containing the result of the 

Boolean flag indicating if training data for weak learners in this
ensemble were sampled with replacement. 

A character vector with the name of the response variable


Function handle for transforming scores, or character vector representing
a builtin transformation function. Add or change a ens.ResponseTransform = @function 

The trained learners, a cell array of compact regression models. 

A numeric vector of weights the ensemble assigns to its learners. The ensemble computes predicted response by aggregating weighted predictions from its learners. 

A logical matrix of size


The scaled 

The matrix or table of predictor values that trained the ensemble. Each
column of 

The numeric column vector with the same number of rows as

Object Functions
compact  Create compact regression ensemble 
crossval  Cross validate ensemble 
cvshrink  Crossvalidate shrinking (pruning) ensemble 
gather  Gather properties of Statistics and Machine Learning Toolbox object from GPU 
lime  Local interpretable modelagnostic explanations (LIME) 
loss  Regression error 
oobLoss  Outofbag regression error 
oobPermutedPredictorImportance  Predictor importance estimates by permutation of outofbag predictor observations for random forest of regression trees 
oobPredict  Predict outofbag response of ensemble 
partialDependence  Compute partial dependence 
plotPartialDependence  Create partial dependence plot (PDP) and individual conditional expectation (ICE) plots 
predict  Predict responses using ensemble of regression models 
predictorImportance  Estimates of predictor importance for regression ensemble 
regularize  Find weights to minimize resubstitution error plus penalty term 
removeLearners  Remove members of compact regression ensemble 
resubLoss  Regression error by resubstitution 
resubPredict  Predict response of ensemble by resubstitution 
resume  Resume training ensemble 
shapley  Shapley values 
shrink  Prune ensemble 
Copy Semantics
Value. To learn how value classes affect copy operations, see Copying Objects.
Examples
Tips
For a bagged ensemble of regression trees, the Trained
property
of ens
stores a cell vector of ens.NumTrained
CompactRegressionTree
model objects. For a textual or graphical display of
tree t
in the cell vector,
enter
view(ens.Trained{t})
Extended Capabilities
Version History
Introduced in R2011a