Документация

h = testckfold(C1,C2,X1,X2) возвращает тестовое решение, которое следует из проведения 5 2 парного теста перекрестной проверки F. Нулевая гипотеза является моделями C1 и C2 классификации, имеют равную точность в предсказании истинных меток класса с помощью предиктора и данных об ответе в таблицах X1 и X2. h = 1 указывает, чтобы отклонить нулевую гипотезу на 5%-м уровне значения.

testckfold проводит тест перекрестной проверки путем применения C1 и C2 ко всем переменным прогноза в X1 и X2, соответственно. Истинные метки класса в X1 и X2 должны быть тем же самым. Имена переменной отклика в X1, X2, C1.ResponseName и C2.ResponseName должны быть тем же самым.

Для примеров способов сравнить модели, смотрите Советы.

h = testckfold(C1,C2,X1,X2,Y) применяет полную модель классификации, или классификация обрабатывает по шаблону C1 и C2 ко всем переменным прогноза в таблицах или матрицах данных X1 и X2, соответственно. Y является именем табличной переменной, соответствующим истинным меткам класса или массиву истинных меток класса.

h = testckfold(___,Name,Value) использование любой из входных параметров в предыдущих синтаксисах и дополнительных опциях задано одним или несколькими аргументами пары Name,Value. Например, можно задать тип альтернативной гипотезы, тип теста или использование параллельных вычислений.

[h,p,e1,e2] = testckfold(___) также возвращает p - значение для теста гипотезы (p) и соответствующие потери классификации для каждой запущенной перекрестной проверки и сгиб (e1 и e2).

Примеры

Сравните алгоритмы выбора предиктора дерева классификации

В каждом узле fitctree выбирает лучший предиктор, чтобы разделить использование исчерпывающего поиска по умолчанию. Также можно принять решение разделить предиктор, который приводит большую часть доказательства зависимости с ответом путем проведения тестов искривления. Этот пример статистически сравнивает деревья классификации, выращенные через исчерпывающий поиск лучших разделений и выращенные путем проведения тестов искривления со взаимодействием.

Загрузите набор данных census1994.

load census1994.mat
rng(1) % For reproducibility

Вырастите дерево классификации по умолчанию использование набора обучающих данных, adultdata, который является таблицей. Именем переменной отклика является 'salary'.

C1 = fitctree(adultdata,'salary')

C1 = 
  ClassificationTree
           PredictorNames: {1x14 cell}
             ResponseName: 'salary'
    CategoricalPredictors: [2 4 6 7 8 9 10 14]
               ClassNames: [<=50K    >50K]
           ScoreTransform: 'none'
          NumObservations: 32561


  Properties, Methods

C1 является полной моделью ClassificationTree. Его свойством ResponseName является 'salary'. C1 использует исчерпывающий поиск, чтобы найти, что лучший предиктор разделяет на на основе максимального усиления разделения.

Вырастите другое дерево классификации использование того же набора данных, но задайте, чтобы найти, что лучший предиктор разделяет использование теста искривления со взаимодействием.

C2 = fitctree(adultdata,'salary','PredictorSelection','interaction-curvature')

C2 = 
  ClassificationTree
           PredictorNames: {1x14 cell}
             ResponseName: 'salary'
    CategoricalPredictors: [2 4 6 7 8 9 10 14]
               ClassNames: [<=50K    >50K]
           ScoreTransform: 'none'
          NumObservations: 32561


  Properties, Methods

C2 также является полной моделью ClassificationTree с ResponseName, равным 'salary'.

Проведите 5 2 парный тест F, чтобы сравнить точность этих двух моделей с помощью набора обучающих данных. Поскольку имена переменной отклика в наборах данных и свойствах ResponseName все равны, и данные об ответе в обоих наборах равны, можно не использовать снабжение данными об ответе.

h = testckfold(C1,C2,adultdata,adultdata)

h = logical
   0

h = 0 указывает, чтобы не отклонить нулевую гипотезу, что C1 и C2 имеют ту же точность на 5%-м уровне.

Сравните точность двух различных моделей классификации

Проведите статистический тест, сравнивающий misclassification уровни этих двух моделей с помощью 5 2 парного теста F.

Загрузите ирисовый набор данных Фишера.

load fisheriris;

Создайте наивный шаблон Bayes и шаблон дерева классификации с помощью опций по умолчанию.

C1 = templateNaiveBayes;
C2 = templateTree;

C1 и C2 являются объектами шаблона, соответствующими наивному Бейесу и алгоритмам дерева классификации, соответственно.

Протестируйте, имеют ли эти две модели равную прогнозирующую точность. Используйте те же данные о предикторе для каждой модели. testckfold проводит 5 2, двухсторонний, соединенный тест F по умолчанию.

rng(1); % For reproducibility
h = testckfold(C1,C2,meas,meas,species)

h = logical
   0

h = 0 указывает, чтобы не отклонить нулевую гипотезу, что эти две модели имеют равную прогнозирующую точность.

Сравните точность классификации простых и сложных моделей

Проведите статистический тест, чтобы оценить, имеет ли более простая модель лучшую точность, чем более сложная модель с помощью 10 10 повторной перекрестной проверки t тест.

Загрузите ирисовый набор данных Фишера. Создайте матрицу стоимости, которая штрафует неправильную классификацию ирисовой диафрагмы setosa вдвое больше, чем неправильная классификация ирисовой диафрагмы virginica как versicolor.

load fisheriris;
tabulate(species)

       Value    Count   Percent
      setosa       50     33.33%
  versicolor       50     33.33%
   virginica       50     33.33%

Cost = [0 2 2;2 0 1;2 1 0];
ClassNames  = {'setosa' 'versicolor' 'virginica'};...
    % Specifies the order of the rows and columns in Cost

Эмпирическое распределение классов универсально, и стоимость классификации является немного неустойчивой.

Создайте два шаблона ECOC: тот, который использует линейных бинарных учеников SVM и того, который использует бинарных учеников SVM, снабженных ядром RBF.

tSVMLinear = templateSVM('Standardize',true); % Linear SVM by default
tSVMRBF = templateSVM('KernelFunction','RBF','Standardize',true);
C1 = templateECOC('Learners',tSVMLinear);
C2 = templateECOC('Learners',tSVMRBF);

C1 и C2 являются объектами шаблона ECOC. C1 подготовлен к линейному SVM. C2 подготовлен к SVM с обучением ядра RBF.

Протестируйте нулевую гипотезу, что более простая модель (C1) самое большее так же точна как более сложная модель (C2) с точки зрения затрат классификации. Проведите 10 10 повторный тест перекрестной проверки. Запросите возвратить затраты misclassification и p-значения.

rng(1); % For reproducibility
[h,p,e1,e2] = testckfold(C1,C2,meas,meas,species,...
    'Alternative','greater','Test','10x10t','Cost',Cost,...
    'ClassNames',ClassNames)

h = logical
   0

p = 0.1077

e1 = 10×10

         0         0         0    0.0667         0    0.0667    0.1333         0    0.1333         0
    0.0667    0.0667         0         0         0         0    0.0667         0    0.0667    0.0667
         0         0         0         0         0    0.0667    0.0667    0.0667    0.0667    0.0667
    0.0667    0.0667         0    0.0667         0    0.0667         0         0    0.0667         0
    0.0667    0.0667    0.0667         0    0.0667    0.0667         0         0         0         0
         0         0    0.1333         0         0    0.0667         0         0    0.0667    0.0667
    0.0667    0.0667         0         0    0.0667         0         0    0.0667         0    0.0667
    0.0667         0    0.0667    0.0667         0    0.1333         0    0.0667         0         0
         0    0.0667    0.1333    0.0667    0.0667         0         0         0         0         0
         0    0.0667    0.0667    0.0667    0.0667         0         0    0.0667         0         0

e2 = 10×10

         0         0         0    0.1333         0    0.0667    0.1333         0    0.2667         0
    0.0667    0.0667         0    0.1333         0         0         0    0.1333    0.1333    0.0667
    0.1333    0.1333         0         0         0    0.0667         0    0.0667    0.0667    0.0667
         0    0.1333         0    0.0667    0.1333    0.1333         0         0    0.0667         0
    0.0667    0.0667    0.0667         0    0.0667    0.1333    0.1333         0         0    0.0667
    0.0667         0    0.0667    0.0667         0    0.0667    0.1333         0    0.0667    0.0667
    0.2000    0.0667         0         0    0.0667         0         0    0.1333         0    0.0667
    0.2000         0         0    0.1333         0    0.1333         0    0.0667         0         0
         0    0.0667    0.0667    0.0667    0.1333         0    0.2000         0         0         0
    0.0667    0.0667         0    0.0667    0.1333         0         0    0.0667    0.1333    0.0667

P-значение немного больше, чем 0,10, который указывает, чтобы сохранить нулевую гипотезу, что более простая модель самое большее так же точна как более сложная модель. Этот результат сопоставим для любого уровня значения (Alpha), который является самое большее 0.10.

e1 и e2 являются 10 10 матрицами, содержащими misclassification затраты. Строка r соответствует запущенному r повторной перекрестной проверки. Столбец k соответствует сгибу набора тестов k в рамках конкретной запущенной перекрестной проверки. Например, элемент (2,4) из e2 0.1333. Это значение означает, что в перекрестной проверке запускаются 2, когда набор тестов является сгибом 4, предполагаемый набор тестов misclassification стоимость 0.1333.

Выберите Features Using Statistical Accuracy Comparison

Этот пример использование:

Уменьшайте сложность модели классификации путем выбора подмножества переменных прогноза (функции) от большего набора. Затем статистически сравните точность между этими двумя моделями.

Загрузите набор данных ionosphere.

load ionosphere;

Обучите ансамбль 100 повышенных деревьев классификации с помощью AdaBoostM1 и целого набора предикторов. Осмотрите меру по важности для каждого предиктора.

t = templateTree('MaxNumSplits',1); % Weak-learner template tree object
C = fitcensemble(X,Y,'Method','AdaBoostM1','Learners',t);
predImp = predictorImportance(C);

figure;
bar(predImp);
h = gca;
h.XTick = 1:2:h.XLim(2);
title('Predictor Importances');
xlabel('Predictor');
ylabel('Importance measure');

Идентифицируйте лучшие пять предикторов с точки зрения их важности.

[~,idxSort] = sort(predImp,'descend');
idx5 = idxSort(1:5);

Протестируйте, имеют ли эти две модели равную прогнозирующую точность. Задайте уменьшаемый набор данных и затем полные данные о предикторе. Используйте параллельные вычисления, чтобы ускорить вычисления.

s = RandStream('mlfg6331_64');
Options = statset('UseParallel',true,'Streams',s,'UseSubstreams',true);

[h,p,e1,e2] = testckfold(C,C,X(:,idx5),X,Y,'Options',Options)

Starting parallel pool (parpool) using the 'local' profile ...
Connected to the parallel pool (number of workers: 12).

h = logical
   0

p = 0.4161

e1 = 5×2

    0.0686    0.0795
    0.0800    0.0625
    0.0914    0.0568
    0.0400    0.0739
    0.0914    0.0966

e2 = 5×2

    0.0914    0.0625
    0.1257    0.0682
    0.0971    0.0625
    0.0800    0.0909
    0.0914    0.1193

testckfold обрабатывает обученные модели классификации как шаблоны, и таким образом, он игнорирует все приспособленные параметры в C. Таким образом, крест testckfold подтверждает C с помощью только заданные опции и данные о предикторе, чтобы оценить потери классификации из сгиба.

h = 0 указывает, чтобы не отклонить нулевую гипотезу, что эти две модели имеют равную прогнозирующую точность. Этот результат способствует более простому ансамблю.

Входные параметры

Модель `C1` — Classification обрабатывает по шаблону или обученная модель классификации
объект шаблона модели классификации | обученный объект модели классификации

Модель Classification обрабатывает по шаблону или обученная модель классификации, заданная как любой объект шаблона модели классификации или обученный объект модели классификации, описанный в этих таблицах.

Обработайте тип по шаблону	Возвращенный
Дерево классификации	`templateTree`
Дискриминантный анализ	`templateDiscriminant`
Ансамбль (повышение, укладывание в мешки и случайное подпространство)	`templateEnsemble`
Выходные коды с коррекцией ошибок (ECOC), модель классификации мультиклассов	`templateECOC`
k NN	`templateKNN`
Наивный байесов	`templateNaiveBayes`
Машина вектора поддержки (SVM)	`templateSVM`

Обученный тип модели	Объект модели	Возвращенный
Дерево классификации	`ClassificationTree`	`fitctree`
Дискриминантный анализ	`ClassificationDiscriminant`	`fitcdiscr`
Ансамбль сложенных в мешок моделей классификации	`ClassificationBaggedEnsemble`	`fitcensemble`
Ансамбль моделей классификации	`ClassificationEnsemble`	`fitcensemble`
Модель ECOC	`ClassificationECOC`	`fitcecoc`
k NN	`ClassificationKNN`	`fitcknn`
Наивный байесов	`ClassificationNaiveBayes`	`fitcnb`
SVM	`ClassificationSVM`	`fitcsvm`

Для эффективности предоставьте объект шаблона модели классификации вместо обученного объекта модели классификации.

Модель `C2` — Classification обрабатывает по шаблону или обученная модель
объект шаблона модели классификации | обученный объект модели классификации

Обработайте тип по шаблону	Возвращенный
Дерево классификации	`templateTree`
Дискриминантный анализ	`templateDiscriminant`
Ансамбль (повышение, укладывание в мешки и случайное подпространство)	`templateEnsemble`
Выходные коды с коррекцией ошибок (ECOC), модель классификации мультиклассов	`templateECOC`
k NN	`templateKNN`
Наивный байесов	`templateNaiveBayes`
Машина вектора поддержки (SVM)	`templateSVM`

Обученный тип модели	Объект модели	Возвращенный
Дерево классификации	`ClassificationTree`	`fitctree`
Дискриминантный анализ	`ClassificationDiscriminant`	`fitcdiscr`
Ансамбль сложенных в мешок моделей классификации	`ClassificationBaggedEnsemble`	`fitcensemble`
Ансамбль моделей классификации	`ClassificationEnsemble`	`fitcensemble`
Модель ECOC	`ClassificationECOC`	`fitcecoc`
k NN	`ClassificationKNN`	`fitcknn`
Наивный байесов	`ClassificationNaiveBayes`	`fitcnb`
SVM	`ClassificationSVM`	`fitcsvm`

`X1` Данные раньше применялись сначала к полной модели классификации или шаблону
числовая матрица | таблица

Данные раньше применялись к первой полной модели классификации или шаблону, C1, заданному как числовая матрица или таблица.

Каждая строка X1 соответствует одному наблюдению, и каждый столбец соответствует одной переменной. testckfold не поддерживает многостолбцовые переменные и массивы ячеек кроме массивов ячеек из символьных векторов.

X1 и X2 должны иметь совпадающий тип данных, и X1, X2, Y должен иметь то же количество наблюдений.

Если вы задаете Y как массив, то testckfold обрабатывает все столбцы X1 как отдельные переменные прогноза.

Типы данных: double | single | table

`X2` Данные раньше применялись к второй полной модели классификации или шаблону
числовая матрица | таблица

Данные раньше применялись к второй полной модели классификации или шаблону, C2, заданному как числовая матрица или таблица.

Каждая строка X2 соответствует одному наблюдению, и каждый столбец соответствует одной переменной. testckfold не поддерживает многостолбцовые переменные и массивы ячеек кроме массивов ячеек из символьных векторов.

X1 и X2 должны иметь совпадающий тип данных, и X1, X2, Y должен иметь то же количество наблюдений.

Если вы задаете Y как массив, то testckfold обрабатывает все столбцы X2 как отдельные переменные прогноза.

Типы данных: double | single | table

`Y` Истинные метки класса
категориальный массив | символьный массив | массив строк | логический вектор | числовой вектор | массив ячеек из символьных векторов | вектор символов | представляет скаляр в виде строки

Истинные метки класса, заданные как категориальное, символ, или массив строк, логический или числовой вектор, массив ячеек из символьных векторов, или вектор символов или скаляр строки.

Для вектора символов или скаляра строки, X1 и X2 должны быть таблицами, их переменные отклика должны иметь то же имя и значения, и Y должен быть общим именем переменной. Например, если X1.Labels и X2.Labels являются переменными отклика, то Y является 'Labels' и X1.Labels, и X2.Labels должен быть эквивалентным.
Для всех других поддерживаемых типов данных Y является массивом истинных меток класса.
- Если Y является символьным массивом, то каждый элемент должен соответствовать одной строке массива.
- X1, X2, Y должен иметь то же количество наблюдений (строки).
Если оба из этих операторов верны, то можно не использовать предоставление Y.
- X1 и X2 являются таблицами, содержащими ту же переменную отклика (значения и имя).
- C1 и C2 являются полными моделями классификации, содержащими свойства ResponseName, задающие имена переменной отклика в X1 и X2.
Следовательно, testckfold использует переменную распространенного ответа в таблицах. Например, если переменными отклика в таблицах является X1.Labels и X2.Labels, и значениями C1.ResponseName и C2.ResponseName является 'Labels', то вы не должны предоставлять Y.

Аргументы в виде пар имя-значение

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'Alternative','greater','Test','10x10t','Options',statsset('UseParallel',true) задает, чтобы протестировать, более ли первый набор первых предсказанных меток класса точен, чем второй набор, чтобы провести 10 10 t тест и использовать параллельные вычисления для перекрестной проверки.

`\alpha` Тестовый уровень значения гипотезы
`0.05` (значение по умолчанию) | скалярное значение в интервале (0,1)

Тестовый уровень значения гипотезы, заданный как пара, разделенная запятой, состоящая из 'Alpha' и скалярного значения в интервале (0,1).

Пример: 'Alpha',0.1

Типы данных: single | double

`'Alternative'` — Альтернативная гипотеза, чтобы оценить
`'unequal'` (значение по умолчанию) | `'greater'` | `'less'`

Альтернативная гипотеза, чтобы оценить, заданный как пара, разделенная запятой, состоящая из 'Alternative' и одно из перечисленных в таблице значений.

Значение	Альтернативное описание гипотезы	Поддерживаемые тесты
`'unequal'` (значение по умолчанию)	Для предсказания `Y` набор прогнозов, следующих `из C1`, применился `к X1`, и `C2` применился `к X2`, имеют неравную точность.	`'5x2F'`, `'5x2t'` и `'10x10t'`
`'greater'`	Для предсказания `Y` набор прогнозов, следующих `из C1`, применился `к X1`, более точно, чем `C2` применился `к X2`.	`'5x2t'` и `'10x10t'`
`'less'`	Для предсказания `Y` набор прогнозов, следующих `из C1`, применился `к X1`, менее точно, чем `C2` применился `к X2`.	`'5x2t'` и `'10x10t'`

Для получения дополнительной информации на поддерживаемых тестах, смотрите Test.

Пример: 'Alternative','greater'

`'X1CategoricalPredictors'` — Отметьте идентифицирующие категориальные предикторы
`[]` (значение по умолчанию) | логический вектор | числовой вектор | `'all'`

Отметьте идентифицирующие категориальные предикторы в первых данных о предикторе набора тестов (X1), заданный как пара, разделенная запятой, состоящая из 'X1CategoricalPredictors' и одно из следующего:

Числовой вектор с индексами от 1 до p, где p является количеством столбцов X1.
Логический вектор длины p, где запись true означает, что соответствующий столбец X1 является категориальной переменной.
'all', означая все предикторы является категориальным.

Спецификация X1CategoricalPredictors является соответствующей если:

По крайней мере один предиктор является категориальным, и C1 является деревом классификации, ансамблем деревьев классификации, модели ECOC или наивной модели классификации Бейеса.
Все предикторы являются категориальными, и C1 является моделью классификации NN k.

Если вы задаете X1CategoricalPredictors для какого-либо другого случая, то testckfold выдает ошибку. Например, функция не может обучить учеников SVM, использующих категориальные предикторы.

Значением по умолчанию является [], который указывает, что нет никаких категориальных предикторов.

Пример: 'X1CategoricalPredictors','all'

Типы данных: single | double | logical | char | string

`'X2CategoricalPredictors'` — Отметьте идентифицирующие категориальные предикторы
`[]` (значение по умолчанию) | логический вектор | числовой вектор | `'all'`

Отметьте идентифицирующие категориальные предикторы во вторых данных о предикторе набора тестов (X2), заданный как пара, разделенная запятой, состоящая из 'X2CategoricalPredictors' и одно из следующего:

Числовой вектор с индексами от 1 до p, где p является количеством столбцов X2.
Логический вектор длины p, где запись true означает, что соответствующий столбец X2 является категориальной переменной.
'all', означая все предикторы является категориальным.

Спецификация X2CategoricalPredictors является соответствующей если:

По крайней мере один предиктор является категориальным, и C2 является деревом классификации, ансамблем деревьев классификации, модели ECOC или наивной модели классификации Бейеса.
Все предикторы являются категориальными, и C2 является моделью классификации NN k.

Если вы задаете X2CategoricalPredictors для какого-либо другого случая, то testckfold выдает ошибку. Например, функция не может обучить учеников SVM, использующих категориальные предикторы.

Значением по умолчанию является [], который указывает, что нет никаких категориальных предикторов.

Пример: 'X2CategoricalPredictors','all'

Типы данных: single | double | logical | char | string

`'ClassNames'` — Имена классов
категориальный массив | символьный массив | массив строк | логический вектор | числовой вектор | массив ячеек из символьных векторов

Имена классов, заданные как пара, разделенная запятой, состоящая из 'ClassNames' и категориального, символа, или массива строк, логического или числового вектора или массива ячеек из символьных векторов. Необходимо установить ClassNames с помощью типа данных Y.

Если ClassNames является символьным массивом, то каждый элемент должен соответствовать одной строке массива.

Используйте ClassNames для:

Задайте порядок любой размерности входного параметра, которая соответствует порядку класса. Например, используйте ClassNames, чтобы задать порядок размерностей Cost.
Выберите подмножество классов для тестирования. Например, предположите, что набором всех отличных имен классов в Y является {'a','b','c'}. Чтобы обучаться и тестовые модели с помощью наблюдений от классов 'a' и 'c' только, задайте 'ClassNames',{'a','c'}.

Значением по умолчанию является набор всех отличных имен классов в Y.

Пример: 'ClassNames',{'b','g'}

`'Cost'` — Классификация стоится
квадратная матрица | массив структур

Стоимость классификации, заданная как пара, разделенная запятой, состоящая из 'Cost' и квадратной матрицы или массива структур.

Если вы задаете квадратную матрицу Cost, то Cost(i,j) является стоимостью классификации точки в класс j, если его истинным классом является i. Таким образом, строки соответствуют истинному классу, и столбцы соответствуют предсказанному классу. Чтобы задать порядок класса для соответствующих строк и столбцов Cost, дополнительно задайте аргумент пары "имя-значение" ClassNames.
Если вы задаете структуру S, то S должен иметь два поля:
- S.ClassNames, который содержит имена классов как переменную совпадающего типа данных как Y. Можно использовать это поле, чтобы задать порядок классов.
- S.ClassificationCosts, который содержит матрицу стоимости со строками и столбцами, упорядоченными как в S.ClassNames

Для чувствительного к стоимости использования тестирования, testcholdout.

Это - лучшая практика предоставить ту же матрицу стоимости, используемую, чтобы обучить модели классификации.

Значением по умолчанию является Cost(i,j) = 1 если i ~= j и Cost(i,j) = 0 если i = j.

Пример: 'Cost',[0 1 2 ; 1 0 2; 2 2 0]

Типы данных: double | single | struct

`'LossFun'` — Функция потерь
`'classiferror'` (значение по умолчанию) | `'binodeviance'` | `'exponential'` | `'hinge'` | указатель на функцию

Функция потерь, заданная как пара, разделенная запятой, состоящая из 'LossFun' и 'classiferror', 'binodeviance', 'exponential', 'hinge' или указателя на функцию.

В следующей таблице перечислены доступные функции потерь.

Значение	Функция потерь
`'binodeviance'`	Биномиальное отклонение
`'classiferror'`	Ошибка классификации
`'exponential'`	Экспоненциальная потеря
`'hinge'`	Потеря стержня

Задайте свою собственную функцию с помощью обозначения указателя на функцию.
Предположим, что n = size(X,1) является объемом выборки и существует K уникальные классы. Ваша функция должна иметь подпись lossvalue = lossfun(C,S,W,Cost), где:
- Выходным аргументом lossvalue является скаляр.
- lossfun является именем вашей функции.
- C является n-by-K логическая матрица со строками, указывающими, которые классифицируют соответствующее наблюдение, принадлежит. Порядок следования столбцов соответствует порядку класса в аргументе пары "имя-значение" ClassNames.
  Создайте C установкой C(p,q) = 1, если наблюдение p находится в классе q для каждой строки. Установите все другие элементы строки p к 0.
- S является n-by-K числовая матрица очков классификации. Порядок следования столбцов соответствует порядку класса в аргументе пары "имя-значение" ClassNames. S является матрицей очков классификации.
- W является n-by-1 числовой вектор весов наблюдения. Если вы передаете W, программное обеспечение нормирует веса, чтобы суммировать к 1.
- Cost является K-by-K числовая матрица затрат классификации. Например, Cost = ones(K) - eye(K) задает стоимость 0 для правильной классификации и стоимость 1 для misclassification.
Задайте свою функцию с помощью 'LossFun',@lossfun.

`Опции` Опции параллельных вычислений
`[]` (значение по умолчанию) | массив структур, возвращенный `statset`

Опции параллельных вычислений, заданные как пара, разделенная запятой, состоящая из 'Options' и массива структур, возвращенного statset. Эти опции требуют Parallel Computing Toolbox. testckfold использует 'Streams', 'UseParallel' и поля 'UseSubtreams'.

Эта таблица суммирует доступные параметры.

Опция Описание

Опция	Описание
`'Streams'`	Объектный массив `RandStream` или массив ячеек таких объектов. Если вы не задаете `Streams`, программное обеспечение использует поток по умолчанию или потоки. Если вы задаете `Streams`, используйте отдельный объект кроме тех случаев, когда следующее верно: У вас есть открытый параллельный пул. `UseParallel` является `true`. `UseSubstreams` является `false`. В этом случае используйте массив ячеек, одного размера в качестве параллельного пула. Если параллельный пул не открыт, то программное обеспечение пытается открыть одно (в зависимости от ваших настроек), и `Streams` должен предоставить один поток случайных чисел.
`'UseParallel'`	Если у вас есть Parallel Computing Toolbox, то можно вызвать пул рабочих установкой `'UseParallel',true`.
`'UseSubstreams'`	Установите на `true`, чтобы вычислить в параллели с помощью потока, заданного `'Streams'`. Значением по умолчанию является `false`. Например, установите `Streams` на тип, позволяющий подпотоки, такой as`'mlfg6331_64'` или `'mrg32k3a'`.

'Streams'

Объектный массив RandStream или массив ячеек таких объектов. Если вы не задаете Streams, программное обеспечение использует поток по умолчанию или потоки. Если вы задаете Streams, используйте отдельный объект кроме тех случаев, когда следующее верно:

У вас есть открытый параллельный пул.
UseParallel является true.
UseSubstreams является false.

В этом случае используйте массив ячеек, одного размера в качестве параллельного пула. Если параллельный пул не открыт, то программное обеспечение пытается открыть одно (в зависимости от ваших настроек), и Streams должен предоставить один поток случайных чисел.

'UseParallel' Если у вас есть Parallel Computing Toolbox, то можно вызвать пул рабочих установкой 'UseParallel',true.

'UseSubstreams' Установите на true, чтобы вычислить в параллели с помощью потока, заданного 'Streams'. Значением по умолчанию является false. Например, установите Streams на тип, позволяющий подпотоки, такой as'mlfg6331_64' или 'mrg32k3a'.

Пример: 'Options',statset('UseParallel',true)

Типы данных: struct

`'Prior'` — Априорные вероятности
`'empirical'` (значение по умолчанию) | `'uniform'` | числовой вектор | структура

Априорные вероятности для каждого класса, заданного как пара, разделенная запятой, состоящая из 'Prior' и 'empirical', 'uniform', числового вектора или структуры.

Эта таблица суммирует доступные параметры для установки априорных вероятностей.

Значение	Описание
`'empirical'`	Априорные вероятности класса являются частотами родственника класса в `Y`.
`'uniform'`	Все априорные вероятности класса равны 1/K, где K является количеством классов.
числовой вектор	Каждый элемент является априорной вероятностью класса. Задайте порядок с помощью аргумента пары "имя-значение" `ClassNames`. Программное обеспечение нормирует элементы, таким образом, что они суммируют к `1`.
структура	Структура `S` с двумя полями: `S.ClassNames` содержит имена классов как переменную того же типа как `Y`. `S.ClassProbs` содержит вектор соответствующих априорных вероятностей. Программное обеспечение нормирует элементы, таким образом, что они суммируют к `1`.

Пример: 'Prior',struct('ClassNames',{{'setosa','versicolor'}},'ClassProbs',[1,2])

Типы данных: char | string | single | double | struct

`Тест` Протестируйте, чтобы провести
`'5x2F'` (значение по умолчанию) | `'5x2t'` | `'10x10t'`

Протестируйте, чтобы провести, заданный как пара, разделенная запятой, состоящая из 'Test' и один из него следующее: '5x2F', '5x2t', '10x10t'.

Значение	Описание	Поддерживаемая альтернативная гипотеза
`'5x2F'` (значение по умолчанию)	5 2 парный тест F. Подходящий для двухстороннего тестирования только.	`'unequal'`
`'5x2t'`	5 2 парный тест t	`'unequal'`, `'less'`, `'greater'`
`'10x10t'`	10 10 повторная перекрестная проверка тест t	`'unequal'`, `'less'`, `'greater'`

Для получения дополнительной информации на доступных тестах, смотрите Повторные Тесты Перекрестной проверки. Для получения дополнительной информации на поддерживаемых альтернативных гипотезах, смотрите Alternative.

Пример: 'Test','10x10t'

`'Verbose'` — Уровень многословия
`0` (значение по умолчанию) | `1` | `2`

Уровень многословия, заданный как пара, разделенная запятой, состоящая из 'Verbose' и 0, 1 или 2. Verbose управляет суммой диагностической информации, которую программное обеспечение отображает в Командном окне во время обучения каждого сгиба перекрестной проверки.

Эта таблица суммирует доступные опции уровня многословия.

Значение	Описание
0	Программное обеспечение не отображает диагностическую информацию.
1	Программное обеспечение отображается, диагностика обменивается сообщениями каждый раз, когда это реализует новую запущенную перекрестную проверку.
2	Программное обеспечение отображается, диагностика обменивается сообщениями каждый раз, когда это реализует новую перекрестную проверку, запущенную, и каждый раз, когда это обучается на конкретном сгибе.

Пример: 'Verbose',1

Типы данных: double | single

`'Weights'` — Веса наблюдения
`ones(size(X,1),1)` (значение по умолчанию) | числовой вектор

Веса наблюдения, заданные как пара, разделенная запятой, состоящая из 'Weights' и числового вектора.

Размер Weights должен равняться количеству строк X1. Программное обеспечение взвешивает наблюдения в каждой строке X с соответствующим весом в Weights.

Программное обеспечение нормирует Weights, чтобы суммировать до значения априорной вероятности в соответствующем классе.

Типы данных: double | single

Примечания:

testckfold обрабатывает обученные модели классификации как шаблоны. Поэтому это игнорирует все приспособленные параметры в модели. Таким образом, крест testckfold подтверждает использование только опции, заданные в модели и данных о предикторе.
Повторные тесты перекрестной проверки зависят при условии, что тестовые статистические данные асимптотически нормальны по нулевой гипотезе. Очень неустойчивые матрицы стоимости (например, Cost = [0 100;1 0]) и очень дискретные дистрибутивы ответа (то есть, большинство наблюдений находится в небольшом количестве классов), может нарушить асимптотическое предположение нормальности. Для чувствительного к стоимости тестирования используйте testcholdout.
NaN s, значения <undefined>, пустые символьные вектора (''), пустые строки ("") и значения <missing> указывают на недостающие значения данных.
- Для обработки отсутствующих значений в X1 и X2, см. соответствующую модель классификации учебная страница ссылки на функцию: fitctree, fitcdiscr, fitcensemble, fitcecoc, fitcknn, fitcnb или fitcsvm.
- testckfold удаляет отсутствующие значения в Y и соответствующих строках X1 и X2.

Выходные аргументы

`h` Результат испытаний гипотезы
1 | 0

Результат испытаний гипотезы, возвращенный как логическое значение.

h = 1 указывает на отклонение нулевой гипотезы на уровне значения Alpha.

h = 0 указывает на отказ отклонить нулевую гипотезу на уровне значения Alpha.

Типы данных: логический

`p` — p - значение
скаляр в интервале [0,1]

p- теста, возвращенного как скаляр в интервале [0,1]. p является вероятностью, что случайная тестовая статистическая величина, по крайней мере, как экстремальное значение как наблюдаемая тестовая статистическая величина, учитывая, что нулевая гипотеза верна.

testckfold оценивает p с помощью распределения тестовой статистической величины, которая меняется в зависимости от типа теста. Для получения дополнительной информации на тестовой статистике, смотрите Повторные Тесты Перекрестной проверки.

`e1` — Потери классификации
числовая матрица

Потери классификации, возвращенные как числовая матрица. Строки e1 соответствуют запущенной перекрестной проверке, и столбцы соответствуют тестовому сгибу.

testckfold применяет первые данные о предикторе набора тестов (X1) к первой модели классификации (C1), чтобы оценить первый набор меток класса.

e1 обобщает точность первого набора меток класса, предсказывающих, что истинный класс маркирует (Y) для каждой перекрестной проверки запущенный, и свернуться. Значение элементов e1 зависит от типа потери классификации.

`e2` — Потери классификации
числовая матрица

Потери классификации, возвращенные как числовая матрица. Строки e2 соответствуют запущенной перекрестной проверке, и столбцы соответствуют тестовому сгибу.

testckfold применяет вторые данные о предикторе набора тестов (X2) к второй модели классификации (C2), чтобы оценить второй набор меток класса.

e2 обобщает точность второго набора меток класса, предсказывающих, что истинный класс маркирует (Y) для каждой перекрестной проверки запущенный, и свернуться. Значение элементов e2 зависит от типа потери классификации.

Больше о