incrementalLearner

Преобразуйте линейную модель для двоичной классификации в инкрементную обучающуюся

Синтаксис

IncrementalMdl = incrementalLearner(Mdl)

IncrementalMdl = incrementalLearner(Mdl,Name,Value)

Описание

IncrementalMdl = incrementalLearner(Mdl) возвращает двоичную классификационную линейную модель для инкрементного обучения, IncrementalMdl, используя гиперпараметры и коэффициенты традиционно обученной линейной модели для двоичной классификации, Mdl. Потому что значения его свойств отражают знания, полученные от Mdl, IncrementalMdl может предсказывать метки, заданные новые наблюдения, и это warm, что означает, что его прогнозирующая эффективность отслеживается.

пример

IncrementalMdl = incrementalLearner(Mdl,Name,Value) использует дополнительные опции, заданные одним или несколькими аргументами пары "имя-значение". Некоторые опции требуют от вас обучения IncrementalMdl перед отслеживанием его прогнозирующей эффективности. Для примера, 'MetricsWarmupPeriod',50,'MetricsWindowSize',100 задает предварительный инкрементный период обучения 50 наблюдений перед отслеживанием показателей эффективности и определяет обработку 100 наблюдений перед обновлением показателей эффективности.

Примеры

свернуть все

Преобразуйте традиционно обученную модель в инкрементальное обучение

Открыть Live Script

Обучите линейную классификационную модель для двоичного обучения при помощи fitclinear, а затем преобразуйте его в пошагового ученика.

Загрузка и предварительная обработка данных

Загрузите набор данных о деятельности человека.

load humanactivity

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

Отклики могут быть одним из пяти классов: Sitting, Standing, Walking, Running, или Dancing. Дихотомизируйте ответ путем определения, движется ли субъект (actid > 2).

Y = actid > 2;

Обучите линейную модель классификации

Подбор линейной классификационной модели ко всему набору данных.

TTMdl = fitclinear(feat,Y)

TTMdl = 
  ClassificationLinear
      ResponseName: 'Y'
        ClassNames: [0 1]
    ScoreTransform: 'none'
              Beta: [60x1 double]
              Bias: -0.2005
            Lambda: 4.1537e-05
           Learner: 'svm'


  Properties, Methods

TTMdl является ClassificationLinear объект модели, представляющий традиционно обученную линейную классификационную модель.

Преобразуйте обученную модель

Преобразуйте традиционно обученную линейную классификационную модель в двоичную классификационную линейную модель для инкрементного обучения.

IncrementalMdl = incrementalLearner(TTMdl)

IncrementalMdl = 
  incrementalClassificationLinear

            IsWarm: 1
           Metrics: [1x2 table]
        ClassNames: [0 1]
    ScoreTransform: 'none'
              Beta: [60x1 double]
              Bias: -0.2005
           Learner: 'svm'


  Properties, Methods

IncrementalMdl является incrementalClassificationLinear объект модели, подготовленный для инкрементного обучения с использованием SVM.

The incrementalLearner Функция Инициализирует пошагового ученика путем передачи ему выученных коэффициентов вместе с другой информацией TTMdl извлечен из обучающих данных.
IncrementalMdl тепло (IsWarm является 1), что означает, что инкрементальные функции обучения могут начать отслеживать метрики эффективности.
The incrementalLearner функция обучает модель с помощью адаптивного решателя с инвариантным масштабом, тогда как fitclinear обученные TTMdl использование решателя BFGS.

Предсказание ответов

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

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

[~,ttscores] = predict(TTMdl,feat);
[~,ilscores] = predict(IncrementalMdl,feat);
compareScores = norm(ttscores(:,1) - ilscores(:,1))

compareScores = 0

Различие между счетами, сгенерированными моделями, равняется 0.

Задайте Решатель SGD и стандартизируйте данные предиктора

Открыть Live Script

Если вы обучаете линейную модель классификации с помощью решателя SGD или ASGD, incrementalLearner сохраняет решатель, тип линейной модели и соответствующие значения гиперзначений параметров, когда он преобразует линейную модель классификации.

Загрузите набор данных о деятельности человека.

load humanactivity

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

Ответы могут быть одним из пяти классов: Сидя, Стоя, Ходя, Бега или Танцы. Дихотомизируйте ответ путем определения, движется ли субъект (actid > 2).

Y = actid > 2;

Случайным образом разделите данные пополам: первая половина для настройки модели традиционно, и вторая половина для инкрементного обучения.

n = numel(Y);
rng(1) % For reproducibility
cvp = cvpartition(n,'Holdout',0.5);
idxtt = training(cvp);
idxil = test(cvp);

% First half of data 
Xtt = feat(idxtt,:);
Ytt = Y(idxtt);

% Second half of data
Xil = feat(idxil,:);
Yil = Y(idxil);

Создайте набор из 11 логарифмически разнесенных сильных сторон регуляризации $10^{- 6}$ через $10^{- 0.5}$ .

Lambda = logspace(-6,-0.5,11);

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

Xtt = (Xtt - mean(Xtt))./std(Xtt);

Настройте параметр регуляризации L2, применив 5-кратную перекрестную валидацию. Задайте стандартный решатель SGD.

TTCVMdl = fitclinear(Xtt,Ytt,'KFold',5,'Learner','logistic',...
    'Solver','sgd','Lambda',Lambda);

TTCVMdl является ClassificationPartitionedLinear модель, представляющая пять моделей, созданных во время перекрестной валидации (см TTCVMdl.Trained). Процедура перекрестной валидации включает обучение с каждым заданным значением регуляризации.

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

cvloss = kfoldLoss(TTCVMdl)

cvloss = 1×11

    0.0054    0.0039    0.0034    0.0033    0.0030    0.0027    0.0027    0.0031    0.0036    0.0056    0.0077

cvloss содержит потери классификации тестовой выборки для каждого значения регуляризации в Lamba.

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

[~,idxmin] = min(cvloss);
TTMdl = fitclinear(Xtt,Ytt,'Learner','logistic','Solver','sgd',...
    'Lambda',Lambda(idxmin));

TTMdl является ClassificationLinear модель.

Преобразуйте традиционно обученную линейную классификационную модель в двоичную классификационную линейную модель для инкрементного обучения. Задайте стандартный решатель SGD. Подготовьте функции инкрементного обучения, чтобы стандартизировать предикторы. Это действие требует начального периода для оценки предикторного средства и стандартных отклонений. Задайте период оценки 2000 наблюдения (по умолчанию это 1000 когда требуются моменты предиктора).

IncrementalMdl = incrementalLearner(TTMdl,'Standardize',true,'EstimationPeriod',2000);

IncrementalMdl является incrementalClassificationLinear объект модели. incrementalLearner передает решатель и силу регуляризации, среди другой информации, полученной из обучения TTMdl, в IncrementalMdl.

Подгонка инкрементальной модели ко второй половине данных с помощью fit функция. При каждой итерации:

Симулируйте поток данных путем обработки 10 наблюдений за раз.
Перезаписать предыдущую инкрементальную модель на новую, подобранную входящему наблюдению.
Магазин $β_{1}$ чтобы увидеть, как он развивается во время обучения.

% Preallocation
nil = numel(Yil);
numObsPerChunk = 10;
nchunk = floor(nil/numObsPerChunk);
learnrate = [IncrementalMdl.LearnRate; zeros(nchunk,1)];
beta1 = [IncrementalMdl.Beta(1); zeros(nchunk,1)];

% Incremental fitting
for j = 1:nchunk
    ibegin = min(nil,numObsPerChunk*(j-1) + 1);
    iend   = min(nil,numObsPerChunk*j);
    idx = ibegin:iend;
    IncrementalMdl = fit(IncrementalMdl,Xil(idx,:),Yil(idx));
    beta1(j + 1) = IncrementalMdl.Beta(1);
end

IncrementalMdl является incrementalClassificationLinear объект модели обучен на всех данных в потоке.

График $β_{1}$ чтобы увидеть, как он развивался.

plot(beta1)
ylabel('\beta_1') 
xline(IncrementalMdl.EstimationPeriod/numObsPerChunk,'r-.');
xlabel('Iteration')

Figure contains an axes. The axes contains 2 objects of type line, constantline.

Потому что fit не подгоняет модель к потоковым данным в течение периода оценки, $β_{1}$ является постоянным для первых 200 итераций (2000 наблюдений). Затем, $β_{1}$ резко изменяется во время инкрементного подборы кривой.

Настройте опции метрики эффективности

Открыть Live Script

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

Загрузите набор данных о деятельности человека.

load humanactivity

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

Ответы могут быть одним из пяти классов: Сидя, Стоя, Ходьба, Бег и Танцы. Дихотомизируйте ответ путем определения, движется ли субъект (actid > 2).

Y = actid > 2;

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

n = numel(Y);

rng(1) % For reproducibility
cvp = cvpartition(n,'Holdout',0.5);
idxtt = training(cvp);
idxil = test(cvp);
shuffidx = randperm(n);
X = feat(shuffidx,:);
Y = Y(shuffidx);

% First half of data
Xtt = X(idxtt,:);
Ytt = Y(idxtt);

% Second half of data
Xil = X(idxil,:);
Yil = Y(idxil);

Подбор линейной классификационной модели к первой половине данных.

TTMdl = fitclinear(Xtt,Ytt);

Преобразуйте традиционно обученную линейную классификационную модель в двоичную классификационную линейную модель для инкрементного обучения. Задайте следующее:

Период прогрева показателей эффективности 2000 наблюдений
Размер окна метрики 500 наблюдений
Использование классификационной ошибки и потерь шарнира для измерения эффективности модели

IncrementalMdl = incrementalLearner(TTMdl,'MetricsWarmupPeriod',2000,'MetricsWindowSize',500,...
    'Metrics',["classiferror" "hinge"]);

Подгонка инкрементальной модели ко второй половине данных с помощью updateMetricsAndFit функция. При каждой итерации:

Симулируйте поток данных, который обрабатывает фрагмент 20 наблюдений.
Перезаписать предыдущую инкрементальную модель на новую, подобранную входящему наблюдению.
Магазин $β_{1}$ , совокупные метрики и метрики окна, чтобы увидеть, как они развиваются во время инкрементного обучения.

% Preallocation
nil = numel(Yil);
numObsPerChunk = 20;
nchunk = ceil(nil/numObsPerChunk);
ce = array2table(zeros(nchunk,2),'VariableNames',["Cumulative" "Window"]);
hinge = array2table(zeros(nchunk,2),'VariableNames',["Cumulative" "Window"]);
beta1 = zeros(nchunk,1);    

% Incremental fitting
for j = 1:nchunk
    ibegin = min(nil,numObsPerChunk*(j-1) + 1);
    iend   = min(nil,numObsPerChunk*j);
    idx = ibegin:iend;    
    IncrementalMdl = updateMetricsAndFit(IncrementalMdl,Xil(idx,:),Yil(idx));
    ce{j,:} = IncrementalMdl.Metrics{"ClassificationError",:};
    hinge{j,:} = IncrementalMdl.Metrics{"HingeLoss",:};
    beta1(j + 1) = IncrementalMdl.Beta(1);
end

IncrementalMdl является incrementalClassificationLinear модель обучена на всех данных в потоке. Во время инкрементного обучения и после прогрева модели updateMetricsAndFit проверяет эффективность модели при входящем наблюдении, а затем подбирает модель к этому наблюдению.

Чтобы увидеть, как метрики эффективности и $β_{1}$ развивался во время обучения, строил их на отдельных подграфиках.

figure;
subplot(3,1,1)
plot(beta1)
ylabel('\beta_1')
xlim([0 nchunk]);
xline(IncrementalMdl.MetricsWarmupPeriod/numObsPerChunk,'r-.');
subplot(3,1,2)
h = plot(ce.Variables);
xlim([0 nchunk]);
ylabel('Classification Error')
xline(IncrementalMdl.MetricsWarmupPeriod/numObsPerChunk,'r-.');
legend(h,ce.Properties.VariableNames,'Location','northwest')
subplot(3,1,3)
h = plot(hinge.Variables);
xlim([0 nchunk]);
ylabel('Hinge Loss')
xline(IncrementalMdl.MetricsWarmupPeriod/numObsPerChunk,'r-.');
legend(h,hinge.Properties.VariableNames,'Location','northwest')
xlabel('Iteration')

Figure contains 3 axes. Axes 1 contains 2 objects of type line, constantline. Axes 2 contains 3 objects of type line, constantline. These objects represent Cumulative, Window. Axes 3 contains 3 objects of type line, constantline. These objects represent Cumulative, Window.

График предполагает, что updateMetricsAndFit делает следующее:

Подгонка $β_{1}$ во время всех итераций инкрементного обучения.
Вычислите метрики эффективности только после периода прогрева метрики.
Вычислите совокупные метрики во время каждой итерации.
Вычислите метрики окна после обработки 500 наблюдений (25 итераций).

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

свернуть все

`Mdl` - Традиционно обученная линейная модель для двоичной классификации
`ClassificationLinear` объект модели

Традиционно обученная линейная модель для двоичной классификации, заданная как ClassificationLinear объект модели, возвращенный fitclinear.

Примечание

Если Mdl.Lambda является числовым вектором, необходимо выбрать модель, соответствующую одному сопротивлению регуляризации в пути регуляризации при помощи selectModels.
Инкрементные функции обучения поддерживают только числовые входные данные предиктора. Если Mdl был подходит к категориальным данным, использование dummyvar чтобы преобразовать каждую категориальную переменную в числовую матрицу фиктивных переменных и объединить все фиктивные переменные матрицы и любые другие числовые предикторы. Для получения дополнительной информации см. Dummy Переменных.

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

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

Пример: 'Solver','scale-invariant','MetricsWindowSize',100 задает адаптивный масштабно-инвариантный решатель для объективной оптимизации и задает обработку 100 наблюдений перед обновлением показателей эффективности.

Общие опции

свернуть все

`'Solver'` - Метод минимизации целевой функции
`'scale-invariant'` (по умолчанию) | `'sgd'` | `'asgd'`

Метод минимизации целевой функции, заданный как разделенная разделенными запятой парами, состоящая из 'Solver' и значение в этой таблице.

Значение Описание Примечания

Значение	Описание	Примечания
`'scale-invariant'`	Адаптивный масштабно-инвариантный решатель для инкрементного обучения [1]	Этот алгоритм свободен от параметров и может адаптироваться к различиям в шкалах предиктора. Попробуйте этот алгоритм перед использованием SGD или ASGD. Чтобы перетасовать входящие пакеты перед `fit` функция подходит для модели, установите `Shuffle` на `true`.
`'sgd'`	Стохастический градиентный спуск (SGD) [3][2]	Чтобы эффективно обучаться с SGD, стандартизируйте данные и задайте адекватные значения для гиперпараметров, используя опции, перечисленные в SGD и ASGD Solver Options. The `fit` функция всегда тасует входящий пакет данных перед подгонкой модели.
`'asgd'`	Средний стохастический градиентный спуск (ASGD) [4]	Чтобы эффективно обучаться с ASGD, стандартизируйте данные и задайте адекватные значения для гиперпараметров, используя опции, перечисленные в SGD и ASGD Solver Options. The `fit` функция всегда тасует входящий пакет данных перед подгонкой модели.

'scale-invariant'

Адаптивный масштабно-инвариантный решатель для инкрементного обучения [1]

Этот алгоритм свободен от параметров и может адаптироваться к различиям в шкалах предиктора. Попробуйте этот алгоритм перед использованием SGD или ASGD.
Чтобы перетасовать входящие пакеты перед fit функция подходит для модели, установите Shuffle на true.

'sgd'

Стохастический градиентный спуск (SGD) [3][2]

Чтобы эффективно обучаться с SGD, стандартизируйте данные и задайте адекватные значения для гиперпараметров, используя опции, перечисленные в SGD и ASGD Solver Options.
The fit функция всегда тасует входящий пакет данных перед подгонкой модели.

'asgd'

Средний стохастический градиентный спуск (ASGD) [4]

Чтобы эффективно обучаться с ASGD, стандартизируйте данные и задайте адекватные значения для гиперпараметров, используя опции, перечисленные в SGD и ASGD Solver Options.
The fit функция всегда тасует входящий пакет данных перед подгонкой модели.

Пример: 'Solver','sgd'

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

`'EstimationPeriod'` - Количество наблюдений, обработанных для оценки гиперпараметров
неотрицательное целое число

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

Примечание

Если Mdl подготовлен к пошаговому обучению (указаны все гиперпараметры, необходимые для обучения), incrementalLearner силы 'EstimationPeriod' на 0.
Если Mdl не подготовлен к инкрементному обучению, incrementalLearner устанавливает 'EstimationPeriod' на 1000.

Для получения дополнительной информации смотрите Период оценки.

Пример: 'EstimationPeriod',100

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

`'Standardize'` - Флаг для стандартизации данных предиктора
`false` (по умолчанию) | `true`

Флаг для стандартизации данных предиктора, заданный как разделенная разделенными запятой парами, состоящая из 'Standardize' и значение в этой таблице.

Значение	Описание
`true`	Программное обеспечение стандартизирует данные предиктора. Для получения дополнительной информации см. раздел Стандартизация данных.
`false`	Программное обеспечение не стандартизирует данные предиктора.

Пример: 'Standardize',true

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

Опции SGD и решателя ASGD

свернуть все

`'BatchSize'` - Размер мини-партии
положительное целое число

Мини-пакет, заданный как разделенная разделенными запятой парами, состоящая из 'BatchSize' и положительное целое число. При каждой итерации во время обучения, incrementalLearner использует min(BatchSize,numObs) наблюдения для вычисления подградиента, где numObs количество наблюдений в обучающих данных, переданных fit или updateMetricsAndFit.

Если Mdl.ModelParameters.Solver является 'sgd' или 'asgd', вы не можете задать 'BatchSize'. Вместо этого, incrementalLearner устанавливает 'BatchSize' на Mdl.ModelParameters.BatchSize.
В противном случае BatchSize является 10.

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

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

`'Lambda'` - Коэффициент регуляризации гребня (L 2)
неотрицательный скаляр

Коэффициент регуляризации гребня (L 2), заданный как разделенная запятой пара, состоящий из 'Lambda' и неотрицательный скаляр.

Когда Mdl.Regularization является 'ridge (L2)':

Если Mdl.ModelParameters.Solver является 'sgd' или 'asgd', вы не можете задать 'Lambda'. Вместо этого, incrementalLearner устанавливает 'Lambda' на Mdl.Lambda.
В противном случае Lambda является 1e-5.

Примечание

incrementalLearner не поддерживает регуляризацию лассо. Если Mdl.Regularization является 'lasso (L1)', incrementalLearner использует вместо этого регуляризацию гребня и устанавливает 'Solver' аргумент пары "имя-значение" в 'scale-invariant' по умолчанию.

Пример: 'Lambda',0.01

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

`'LearnRate'` - Скорость обучения
`'auto'` | положительная скалярная величина

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

Если Mdl.ModelParameters.Solver является 'sgd' или 'asgd', вы не можете задать 'LearnRate'. Вместо этого, incrementalLearner устанавливает 'LearnRate' на Mdl.ModelParameters.LearnRate.
В противном случае LearnRate является 'auto'.

Для 'auto':

Если EstimationPeriod является 0, начальная скорость обучения 0.7.
Если EstimationPeriod > 0, начальная скорость обучения 1/sqrt(1+max(sum(X.^2,obsDim))), где obsDim является 1 если наблюдения составляют столбцы данных предиктора, и 2 в противном случае. fit и updateMetricsAndFit установите значение, когда вы передаете данные модели и обучающие данные любой функции.

Область аргумента пары "имя-значение" 'LearnRateSchedule' определяет скорость обучения для последующих циклов обучения.

Пример: 'LearnRate',0.001

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

`'LearnRateSchedule'` - График скорости обучения
`'decaying'` (по умолчанию) | `'constant'`

Расписание скорости обучения, заданное как разделенная разделенными запятой парами, состоящая из 'LearnRateSchedule' и значение в этой таблице, где LearnRate задает начальную скорость обучения ɣ 0 .

Значение Описание

'constant' Эта скорость обучения является ɣ 0 для всех циклов обучения.

Значение	Описание
`'constant'`	Эта скорость обучения является ɣ 0 для всех циклов обучения.
`'decaying'`	Это скорость обучения на t цикла обучения $γ_{t} = \frac{γ_{0}}{{(1 + λ γ_{0} t)}^{c}} .$ λ - значение `Lambda`. Если `Solver` является `'sgd'`, затем c = 1. Если `Solver` является `'asgd'`, тогда c равно 0,75 [4].

'decaying'

Это скорость обучения на t цикла обучения

$γ_{t} = \frac{γ_{0}}{{(1 + λ γ_{0} t)}^{c}} .$

λ - значение Lambda.
Если Solver является 'sgd', затем c = 1.
Если Solver является 'asgd', тогда c равно 0,75 [4].

Если Mdl.ModelParameters.Solver является 'sgd' или 'asgd', вы не можете задать 'LearnRateSchedule'.

Пример: 'LearnRateSchedule','constant'

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

Адаптивные опции решателя масштаба-инварианта

свернуть все

`'Shuffle'` - Флаг для тасования наблюдений в пакете
`true` (по умолчанию) | `false`

Флаг для тасования наблюдений в пакете при каждой итерации, заданный как разделенная разделенными запятой парами, состоящая из 'Shuffle' и значение в этой таблице.

Значение	Описание
`true`	Программа тасует наблюдения в каждом входящем пакете данных перед обработкой набора. Это действие уменьшает смещение, вызванное схемой дискретизации.
`false`	Программное обеспечение обрабатывает данные в полученном порядке.

Пример: 'Shuffle',false

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

Опции метрики эффективности

свернуть все

`'Metrics'` - Моделируйте метрики производительности для отслеживания во время инкрементного обучения
`"classiferror"` (дефолт) | натягивает вектор | указатель на функцию | вектор камеры | массив структур | `"binodeviance"` | `"exponential"` | `"hinge"` | `"logit"` | `"quadratic"` | ...

Моделируйте метрики производительности для отслеживания во время инкрементного обучения с updateMetrics или updateMetricsAndFit функция, заданная как встроенное имя функции потерь, строковый вектор имен, указатель на функцию (@metricName), массив структур указателей на функцию или вектор камер с именами, указатели на функцию или массивы структур.

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

Имя	Описание
`"binodeviance"`	Биномиальное отклонение
`"classiferror"`	Ошибка классификации
`"exponential"`	Экспоненциал
`"hinge"`	Стержень
`"logit"`	Логистический
`"quadratic"`	Квадратный

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

Пример: 'Metrics',["classiferror" "hinge"]

Чтобы задать пользовательскую функцию, которая возвращает метрику эффективности, используйте обозначение указателя на функцию. Функция должна иметь следующую форму:

metric = customMetric(C,S)

Выходной аргумент metric является n-на-1 числовым вектором, где каждый элемент является потерей соответствующего наблюдения в данных путем обработки инкрементных функций обучения во время цикла обучения.
Вы задаете имя функции (customMetric).
C является n -by-2 логической матрицей с строками, указывающими класс, к которому принадлежит соответствующее наблюдение. Порядок столбцов соответствует порядку классов в Mdl.ClassNames. Создание C путем установки C (p, q) = 1, если наблюдение p находится в q классов, для каждого наблюдения в заданных данных. Установите другой элемент в строку p на 0.
S является n -by-2 числовой матрицей предсказанных классификационных оценок. S аналогичен score выхода predict, где строки соответствуют наблюдениям в данных, а порядок столбцов соответствует порядку классов в Mdl.ClassNames. S (p, q) - классификационная оценка наблюдения p классифицируется в классах q.

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

Пример: 'Metrics',struct('Metric1',@customMetric1,'Metric2',@customMetric2)

Пример: 'Metrics',{@customMetric1 @customeMetric2 'logit' struct('Metric3',@customMetric3)}

updateMetrics и updateMetricsAndFit хранить указанные метрики в таблице в свойстве IncrementalMdl.Metrics. Тип данных Metrics определяет имена строк таблицы.

`'Metrics'` Тип данных значения	Описание `Metrics` Имя строки свойства	Пример
Строка или вектор символов	Имя соответствующей встроенной метрики	Имя строки для `"classiferror"` является `"ClassificationError"`
Массив структур	Имя поля	Имя строки для `struct('Metric1',@customMetric1)` является `"Metric1"`
Указатель на функцию для функции, сохраненной в программном файле	Имя функции	Имя строки для `@customMetric` является `"customMetric"`
Анонимная функция	`CustomMetric_<reservedrangesplaceholder0 >`, где `j` метрический `j` в `Metrics`	Имя строки для `@(C,S)customMetric(C,S)...` является `CustomMetric_1`

Для получения дополнительной информации о опциях показателей эффективности см. Раздел «Показатели эффективности».

Типы данных: char | string | struct | cell | function_handle

`'MetricsWarmupPeriod'` - Количество наблюдений перед отслеживанием показателей эффективности
`0` (по умолчанию) | неотрицательное целое число |...

Количество наблюдений, к которым должна соответствовать инкрементальная модель, прежде чем она отслеживает метрики эффективности в своей Metrics свойство, заданное как разделенная разделенными запятой парами, состоящая из 'MetricsWarmupPeriod' и неотрицательное целое число. Инкрементальная модель тепла после инкрементного аппроксимации функций подгонки MetricsWarmupPeriod наблюдения за инкрементальной моделью (EstimationPeriod + MetricsWarmupPeriod наблюдения).

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

`'MetricsWindowSize'` - Количество наблюдений, используемых для вычисления показателей эффективности окна
`200` (по умолчанию) | положительное целое число |...

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

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

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

свернуть все

`IncrementalMdl` - Двоичная классификационная линейная модель для инкрементного обучения
`incrementalClassificationLinear` объект модели

Двоичная классификационная линейная модель для инкрементного обучения, возвращенная как incrementalClassificationLinear объект модели. IncrementalMdl также сконфигурировано, чтобы сгенерировать предсказания, заданные новыми данными (см. predict).

Как инициализировать IncrementalMdl для инкрементного обучения, incrementalLearner передает значения Mdl свойства в этой таблице к конгруэнтным свойствам IncrementalMdl.

Свойство	Описание
`Beta`	Линейные коэффициенты модели, числовой вектор
`Bias`	Модель точки пересечения, числовой скаляр
`ClassNames`	Метки классов для двоичной классификации, двухэлементный список
`ModelParameters.FitBias`	Флаг включения линейной модели точки пересечения
`Learner`	Тип линейной классификационной модели
`Prior`	Предшествующее распределение меток классов, числовой вектор

Подробнее о

свернуть все

Инкрементальное обучение

Incremental learning, или online learning, является ветвью машинного обучения, связанная с обработкой входящих данных из потока данных, возможно, практически не учитывая распределения переменных предиктора, аспектов предсказания или целевой функции (включая настройку значений параметров) или того, помечены ли наблюдения. Инкрементальное обучение отличается от традиционного машинного обучения, где доступно достаточно маркированных данных, чтобы соответствовать модели, выполнить перекрестную валидацию, чтобы настроить гиперпараметры и вывести распределение предиктора.

Учитывая входящие наблюдения, модель инкрементного обучения обрабатывает данные любым из следующих способов, но обычно в этом порядке:

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

Адаптивный масштабно-инвариантный решатель для инкрементного обучения

Этот adaptive scale-invariant solver for incremental learning, введенный в [1], является основанным на градиенте-спуске целевым решателем для настройки линейных прогнозирующих моделей. Решатель свободен от гиперпараметра, нечувствителен к различиям в шкалах переменных предиктора и не требует предварительного знания распределения переменных предиктора. Эти характеристики делают его хорошо подходящим для инкрементного обучения.

Стандартные решатели SGD и ASGD чувствительны к различным шкалам среди переменных, что приводит к моделям, которые могут работать плохо. Чтобы достичь лучшей точности с помощью SGD и ASGD, можно стандартизировать данные предиктора, и настройка параметров регуляризации и скорости обучения может потребовать настройки. Для традиционного машинного обучения доступно достаточно данных, чтобы включить настройку гиперпараметра путем перекрестной валидации и стандартизации предиктора. Однако для инкрементного обучения достаточно данных может быть недоступно (для примера наблюдения могут быть доступны только по одному за раз), и распределение предикторов может быть неизвестным. Эти характеристики делают настройку параметров и стандартизацию предиктора трудной или невозможной во время инкрементного обучения.

Инкрементальные функции аппроксимации для классификации fit и updateMetricsAndFit используйте более агрессивную ScInOL2 версию алгоритма.

Алгоритмы

свернуть все

Расчетный период

В течение периода оценки, инкрементальные функции аппроксимации fit и updateMetricsAndFit использовать первый входящий EstimationPeriod наблюдения для оценки (настройки) гиперпараметров, необходимых для инкрементного обучения. Эта таблица описывает гиперпараметры и когда они оцениваются или настраиваются.

Гиперпараметр Свойство модели Использовать Оценка гиперпараметров

Предиктор означает и стандартные отклонения

Гиперпараметр	Свойство модели	Использовать	Оценка гиперпараметров
Предиктор означает и стандартные отклонения	`Mu` и `Sigma`	Стандартизируйте данные предиктора	Когда вы задаете `'Standardize',true` (см. Стандартизация данных)
Скорость обучения	`LearnRate`	Настройте размер шага решателя	Когда оба из этих условий применяются: Вы меняете решатель `Mdl` в SGD или ASGD (см. `Solver`). Вы не устанавливаете `'LearnRate'` аргумент пары "имя-значение".

Mu и Sigma

Стандартизируйте данные предиктора

Когда вы задаете 'Standardize',true (см. Стандартизация данных)

Скорость обучения

LearnRate

Настройте размер шага решателя

Когда оба из этих условий применяются:

Вы меняете решатель Mdl в SGD или ASGD (см. Solver).
Вы не устанавливаете 'LearnRate' аргумент пары "имя-значение".

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

Стандартизация данных

Если функции инкрементного обучения сконфигурированы для стандартизации переменных предиктора, они делают это с помощью средств и стандартных отклонений, хранящихся в Mu и Sigma свойства модели инкрементного обучения IncrementalMdl.

Когда вы задаете 'Standardize',true, и IncrementalMdl.Mu и IncrementalMdl.Sigma пусты, применяются следующие условия:
- Если период оценки положительный (см. EstimationPeriod свойство IncrementalMdl), средство оценки инкрементных функций аппроксимации и стандартные отклонения с использованием наблюдений за периодом оценки.
- Если период оценки равен 0, incrementalLearner заставляет период оценки 1000. Следовательно, инкрементальные функции аппроксимации оценивают новое средство переменной предиктора и стандартные отклонения в течение периода принудительной оценки.
Когда инкрементальные функции аппроксимации оценивают средства предиктора и стандартные отклонения, функции вычисляют взвешенные средства и взвешенные стандартные отклонения, используя наблюдения периода оценки. В частности, функции стандартизируют j предиктора (_xj), используя

$x_{j}^{*} = \frac{x_{j} - μ_{j}^{*}}{σ_{j}^{*}} .$
где
- _xj является предиктором j, а _xjk - k наблюдения предиктора j в периоде оценки.
- $μ_{j}^{*} = \frac{1}{\sum_{k} w_{k}^{*}} \sum_{k} w_{k}^{*} x_{j k} .$
- ${(σ_{j}^{*})}^{2} = \frac{1}{\sum_{k} w_{k}^{*}} \sum_{k} w_{k}^{*} {(x_{j k} - μ_{j}^{*})}^{2} .$
- $w_{j}^{*} = \frac{w_{j}}{\sum_{\forall j \in Класс k} w_{j}} p_{k},$ где
  - p k является априорной вероятностью k класса (Prior свойство инкрементальной модели).
  - _wj - j веса наблюдения.

Метрики эффективности

updateMetrics и updateMetricsAndFit функции являются инкрементальными функциями обучения, которые отслеживают метрики производительности модели ('Metrics') из новых данных, когда инкрементальная модель warm (IsWarm свойство). Инкрементальная модель тепла после fit или updateMetricsAndFit подгонка инкрементной модели к 'MetricsWarmupPeriod' наблюдения, что является metrics warm-up period.
Если 'EstimationPeriod' > 0, функции оценивают гиперпараметры перед подгонкой модели к данным. Поэтому функции должны обрабатывать дополнительное EstimationPeriod наблюдения перед началом модели периода прогрева метрики.
The Metrics свойство инкрементальной модели хранит две формы каждой метрики эффективности как переменные (столбцы) таблицы, Cumulative и Window, с отдельными метриками в строках. Когда инкрементальная модель теплая, updateMetrics и updateMetricsAndFit обновлять метрики на следующих частотах:
- Cumulative - Функции вычисляют совокупные метрики с начала отслеживания производительности модели. Функции обновляют метрики каждый раз, когда вы вызываете функции и основываете вычисление на целом поставленном наборе данных.
- Window - Функции вычисляют метрики на основе всех наблюдений в окне, определяемом 'MetricsWindowSize' аргумент пары "имя-значение". 'MetricsWindowSize' также определяет частоту обновления программного обеспечения Window метрики. Для примера, если MetricsWindowSize равен 20, функции вычисляют метрики на основе последних 20 наблюдений в предоставленных данных (X((end – 20 + 1):end,:) и Y((end – 20 + 1):end)).
  Инкрементальные функции, которые отслеживают метрики эффективности в окне, используют следующий процесс:
  1. Для каждой заданной метрики сохраните буфер длины MetricsWindowSize и буфер весов наблюдений.
  2. Заполните элементы буфера метриков производительностью модели на основе пакетов входящих наблюдений и сохраните соответствующие веса наблюдений в буфере весов.
  3. Когда буфер будет заполнен, перезаписайте IncrementalMdl.Metrics.Window со средневзвешенной эффективностью в окне метрики. Если буфер переполнен, когда функция обрабатывает пакет наблюдений, последний входящий MetricsWindowSize наблюдения заходят в буфер, и самые ранние наблюдения удаляются из буфера. Например, предположим MetricsWindowSize 20, буфер метрики имеет 10 значений из ранее обработанного пакета и 15 значений являются входящими. Чтобы составить окно длины 20, функции используют измерения из 15 входящих наблюдений и последние 5 измерений из предыдущей партии.

Ссылки

[1] Кемпка, Михал, Войцех Котловский и Манфред К. Вармут. Адаптивные онлайновые алгоритмы масштабирования-инвариантные для обучения линейным моделям. CoRR (февраль 2019). https://arxiv.org/abs/1902.07528.

[2] Лэнгфорд, Дж., Л. Ли, и Т. Чжан. «Разреженное онлайн-обучение через усеченный градиент». Дж. Мач. Учись. Рес., том 10, 2009, стр. 777-801.

[3] Шалев-Шварц, С., Я. Сингер, и Н. Сребру. Pegasos: Primal Estimated Sub-Gradient Solver for SVM (неопр.) (недоступная ссылка). Материалы 24-й Международной конференции по машинному обучению, ICML "07, 2007, стр. 807-814.

[4] Сюй, Вэй. «К оптимальной однопроходной большой Шкале обучению со средним стохастическим градиентным спуском». CoRR, abs/1107.2490, 2011.

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

incrementalLearner

Синтаксис

Описание

Примеры

Преобразуйте традиционно обученную модель в инкрементальное обучение

Задайте Решатель SGD и стандартизируйте данные предиктора

Настройте опции метрики эффективности

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

`Mdl` - Традиционно обученная линейная модель для двоичной классификации
`ClassificationLinear` объект модели

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

`'Solver'` - Метод минимизации целевой функции
`'scale-invariant'` (по умолчанию) | `'sgd'` | `'asgd'`

`'EstimationPeriod'` - Количество наблюдений, обработанных для оценки гиперпараметров
неотрицательное целое число

`'Standardize'` - Флаг для стандартизации данных предиктора
`false` (по умолчанию) | `true`

`'BatchSize'` - Размер мини-партии
положительное целое число

`'Lambda'` - Коэффициент регуляризации гребня (L 2)
неотрицательный скаляр

`'LearnRate'` - Скорость обучения
`'auto'` | положительная скалярная величина

`'LearnRateSchedule'` - График скорости обучения
`'decaying'` (по умолчанию) | `'constant'`

`'Shuffle'` - Флаг для тасования наблюдений в пакете
`true` (по умолчанию) | `false`

`'MetricsWarmupPeriod'` - Количество наблюдений перед отслеживанием показателей эффективности
`0` (по умолчанию) | неотрицательное целое число |...

`'MetricsWindowSize'` - Количество наблюдений, используемых для вычисления показателей эффективности окна
`200` (по умолчанию) | положительное целое число |...

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

`IncrementalMdl` - Двоичная классификационная линейная модель для инкрементного обучения
`incrementalClassificationLinear` объект модели

Подробнее о

Инкрементальное обучение

Адаптивный масштабно-инвариантный решатель для инкрементного обучения

Алгоритмы

Расчетный период

Стандартизация данных

Метрики эффективности

Ссылки

См. также

Объекты

Функции

Темы

Statistics and Machine Learning Toolbox документация

Поддержка

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

incrementalLearner

Синтаксис

Описание

Примеры

Преобразуйте традиционно обученную модель в инкрементальное обучение

Задайте Решатель SGD и стандартизируйте данные предиктора

Настройте опции метрики эффективности

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

Mdl - Традиционно обученная линейная модель для двоичной классификации ClassificationLinear объект модели

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

'Solver' - Метод минимизации целевой функции 'scale-invariant' (по умолчанию) | 'sgd' | 'asgd'

'EstimationPeriod' - Количество наблюдений, обработанных для оценки гиперпараметров неотрицательное целое число

'Standardize' - Флаг для стандартизации данных предиктора false (по умолчанию) | true

'BatchSize' - Размер мини-партии положительное целое число

'Lambda' - Коэффициент регуляризации гребня (L 2) неотрицательный скаляр

'LearnRate' - Скорость обучения 'auto' | положительная скалярная величина

'LearnRateSchedule' - График скорости обучения 'decaying' (по умолчанию) | 'constant'

'Shuffle' - Флаг для тасования наблюдений в пакете true (по умолчанию) | false

'MetricsWarmupPeriod' - Количество наблюдений перед отслеживанием показателей эффективности 0 (по умолчанию) | неотрицательное целое число |...

'MetricsWindowSize' - Количество наблюдений, используемых для вычисления показателей эффективности окна 200 (по умолчанию) | положительное целое число |...

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

IncrementalMdl - Двоичная классификационная линейная модель для инкрементного обучения incrementalClassificationLinear объект модели

Подробнее о

Инкрементальное обучение

Адаптивный масштабно-инвариантный решатель для инкрементного обучения

Алгоритмы

Расчетный период

Стандартизация данных

Метрики эффективности

Ссылки

См. также

Объекты

Функции

Темы

Statistics and Machine Learning Toolbox документация

Поддержка

`Mdl` - Традиционно обученная линейная модель для двоичной классификации
`ClassificationLinear` объект модели

`'Solver'` - Метод минимизации целевой функции
`'scale-invariant'` (по умолчанию) | `'sgd'` | `'asgd'`

`'EstimationPeriod'` - Количество наблюдений, обработанных для оценки гиперпараметров
неотрицательное целое число

`'Standardize'` - Флаг для стандартизации данных предиктора
`false` (по умолчанию) | `true`

`'BatchSize'` - Размер мини-партии
положительное целое число

`'Lambda'` - Коэффициент регуляризации гребня (L 2)
неотрицательный скаляр

`'LearnRate'` - Скорость обучения
`'auto'` | положительная скалярная величина

`'LearnRateSchedule'` - График скорости обучения
`'decaying'` (по умолчанию) | `'constant'`

`'Shuffle'` - Флаг для тасования наблюдений в пакете
`true` (по умолчанию) | `false`

`'MetricsWarmupPeriod'` - Количество наблюдений перед отслеживанием показателей эффективности
`0` (по умолчанию) | неотрицательное целое число |...

`'MetricsWindowSize'` - Количество наблюдений, используемых для вычисления показателей эффективности окна
`200` (по умолчанию) | положительное целое число |...

`IncrementalMdl` - Двоичная классификационная линейная модель для инкрементного обучения
`incrementalClassificationLinear` объект модели