Generate crossvalidation indices
___ = crossvalind(___,
specifies additional options using one or more namevalue pair arguments in addition
to the arguments in previous syntaxes. For example, Name,Value
)cvIndices =
crossvalind('Kfold',Groups,10,'Class',{'Cancer','Control'})
specifies
to use observations from the Cancer
and
Control
groups when generating indices using the 10fold
crossvalidation.
Create indices for the 10fold crossvalidation and classify measurement data for the Fisher iris data set. The Fisher iris data set contains width and length measurements of petals and sepals from three species of irises.
Load the data set.
load fisheriris
Create indices for the 10fold crossvalidation.
indices = crossvalind('Kfold',species,10);
Initialize an object to measure the performance of the classifier.
cp = classperf(species);
Perform the classification using the measurement data and report the error rate, which is the ratio of the number of incorrectly classified samples divided by the total number of classified samples.
for i = 1:10 test = (indices == i); train = ~test; class = classify(meas(test,:),meas(train,:),species(train,:)); classperf(cp,class,test); end cp.ErrorRate
ans = 0.0200
Suppose you want to use the observation data from the setosa
and virginica
species only and exclude the versicolor
species from crossvalidation.
labels = {'setosa','virginica'}; indices = crossvalind('Kfold',species,10,'Classes',labels);
indices
now contains zeros for the rows that belong to the versicolor
species.
Perform the classification again.
for i = 1:10 test = (indices == i); train = ~test; class = classify(meas(test,:),meas(train,:),species(train,:)); classperf(cp,class,test); end cp.ErrorRate
ans = 0.0160
Load the carbig data set.
load carbig;
x = Displacement;
y = Acceleration;
N = length(x);
Train a second degree polynomial model with the leaveoneout crossvalidation, and evaluate the averaged crossvalidation error.
sse = 0; % Initialize the sum of squared error. for i = 1:100 [train,test] = crossvalind('LeaveMOut',N,1); yhat = polyval(polyfit(x(train),y(train),2),x(test)); sse = sse + sum((yhat  y(test)).^2); end CVerr = sse / 100
CVerr = 3.5310
cvMethod
— Crossvalidation methodCrossvalidation method, specified as a character vector or string.
This table describes the valid crossvalidation methods. Depending on the
method, the third input argument (M
) has different
meanings and requirements.
cvMethod  M  Description 


 The method uses Kfold
crossvalidation to generate indices. This method uses


 The method randomly selects approximately


 The method randomly selects 

 The method randomly selects

Example: 'Kfold'
Data Types: char
 string
N
— Total number of observations or grouping informationTotal number of observations or grouping information, specified as a positive integer, vector of positive integers, logical vector, or cell array of character vectors.
N
can be a positive integer specifying the total
number of samples in your data set, for instance.
N
can also be a vector of positive integers or
logical values, or a cell array of character vectors, containing grouping
information or labels for your samples. The partition of the groups depends
on the type of crossvalidation. For 'Kfold'
, each group
is divided into M
subsets, approximately equal in size.
For all other methods, approximately equal numbers of observations from each
group are selected for the evaluation (test) set. The training set contains
at least one observation from each group regardless of the crossvalidation
method you use.
Example: 100
Data Types: double
 cell
M
— Crossvalidation parameterCrossvalidation parameter, specified as a positive scalar between 0 and
1, positive integer, or twoelement vector. Depending on the
crossvalidation method, the requirements for M
differ.
For details, see cvMethod
.
Example: 5
Data Types: double
Specify optional
commaseparated pairs of Name,Value
arguments. Name
is
the argument name and Value
is the corresponding value.
Name
must appear inside quotes. You can specify several name and value
pair arguments in any order as
Name1,Value1,...,NameN,ValueN
.
[train,test] =
crossvalind('LeaveMOut',groups,1,'Min',3)
specifies to have at least
three observations in each group in the training set when performing the
leaveoneout crossvalidation.'Classes'
— Class or group informationClass or group information, specified as the commaseparated pair
consisting of 'Classes'
and a vector of positive
integers, character vector, string, string vector, or cell array of
character vectors. This option lets you restrict the observations to
only the specified groups.
This namevalue pair argument is applicable only when you specify
N
as a grouping variable. The data type of
'Classes'
must match that of
N
. For example, if you specify
N
as a cell array of character vectors
containing class labels, you must use a cell array of character vectors
to specify 'Classes'
. The output arguments you
specify contain the value 0
for observations
belonging to excluded classes.
Example: 'Classes',{'Cancer','Control'}
Data Types: double
 cell
'Min'
— Minimum number of observations1
(default)  positive integerMinimum number of observations for each group in the training set,
specified as the commaseparated pair consisting of
'Min'
and a positive integer. Setting a large
value can help to balance the training groups, but causes partial
resubstitution when there are not enough observations.
This namevalue pair argument is not applicable for the
'Kfold'
method.
Example: 'Min',3
Data Types: double
cvIndices
— Crossvalidation indicesCrossvalidation indices, returned as a vector.
If you are using 'Kfold'
as the crossvalidation
method, cvIndices
contains equal (or approximately
equal) proportions of the integers 1 through M
, which
define a partition of the N
observations into
M
disjointed subsets.
For other crossvalidation methods, cvIndices
is a
logical vector containing 1s for observations that belong to the training
set and 0s for observations that belong to the test (evaluation) set.
train
— Training setTraining set, returned as a logical vector. This argument specifies which observations belong to the training set.
test
— Test setTest set, returned as a logical vector. This argument specifies which observations belong to the test set.
A modified version of this example exists on your system. Do you want to open this version instead? (es)
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
Select web siteYou can also select a web site from the following list:
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.