ensemble.evolvingLabels

Set or return labels for an evolving ensemble


Syntax



Description

labels = obj.evolvingLabels
labels = obj.evolvingLabels(-1)
labels = obj.evolvingLabels(e)

Returns the labels for the specified ensembles in an evolving ensemble. If ensembles are not specified or -1, returns the labels for all ensembles in the evolving set. Note that evolving labels are distinct from any global label for the ensemble object. These evolving labels reference the individual ensembles in an evolving set. Global labels – accessed via the “ensemble.label” command – refer instead to the ensemble object.

obj = obj.evolvingLabels(newLabels)

Applies new labels to each of the ensembles in the evolving set.

obj = obj.evolvingLabels(-1, newLabels)
obj = obj.evolvingLabels(e, newLabels)
obj = obj.evolvingLabels(labels, newLabels)

Applies new labels to the specified ensembles in an evolving ensemble.


Input Arguments

newLabels

string vector
The new labels to apply to the specified ensembles. Must have one element per indicated ensemble.

e

-1 | logical vector | vector, linear indices
-1): The indices specific ensembles within an evolving ensemble. If -1, selects all ensembles within the evolving set. If a logical vector, must have one element per ensemble in the evolving set. If using linear indices and applying new labels, then e cannot contain duplicate values.

labels

string vector
The current labels of ensembles in the evolving set. Cannot contain duplicate values. You can only use current labels to reference ensemble that have unique labels in the evolving set. If multiple ensembles share the same label, reference them using indices instead.

Output Arguments

labels

string vector
The labels of the specified ensembles in the evolving set.

obj

scalar ensemble object
The ensemble object with updated labels for the ensembles in the evolving set.