statset

Создайте структуру опций статистики

Синтаксис

statset
statset(statfun)
options = statset(...)
options = statset(fieldname1,val1,fieldname2,val2,...)
options = statset(oldopts,fieldname1,val1,fieldname2,val2,...)
options = statset(oldopts,newopts)

Описание

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

statset(statfun) отображает поля и значения по умолчанию, используемые функцией Statistics and Machine Learning Toolbox™ statfun. Задайте statfun использование вектора символов, строкового скаляра или указателя на функцию.

options = statset(...) создает структуру опций статистики options. Без входных параметров все поля структуры опций являются пустым массивом ([]). С заданным statfun, специфичные для функции поля являются значениями по умолчанию, а оставшиеся поля []. Для функциональных полей задано значение [] укажите, что функция должна использовать значение по умолчанию для этого параметра. Для доступных options, см. «Входы».

options = statset(fieldname1,val1,fieldname2,val2,...) создает структуру опций, в которой именованные поля имеют заданные значения. Любые неопределенные значения []. Используйте векторы символов или строковые скаляры для имен полей. Для именованных значений необходимо ввести полный вектор символов или строковый скаляр значения. Если вы задаете недопустимый вектор символов или строковый скаляр для значения, statset использует значение по умолчанию.

options = statset(oldopts,fieldname1,val1,fieldname2,val2,...) создает копию oldopts с именованными параметрами, измененными на заданные значения.

options = statset(oldopts,newopts) объединяет существующую структуру опций, oldopts, с новой структурой опций, newopts. Любые параметры в newopts с непустыми значениями перезаписывают соответствующие параметры в oldopts.

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

DerivStep

Относительное различие, используемая в вычислениях производного различия. Положительная скалярная величина или вектор положительных скалярных величин того же размера, что и вектор параметров, оцененных функцией Statistics and Machine Learning Toolbox с использованием структуры опций.

Display

Количество информации, отображаемой алгоритмом.

  • 'off' - Информация не отображается.

  • 'final' - Отображает окончательный выход.

  • 'iter' - Отображает итерационный выход в командное окно для некоторых функций; в противном случае отображается окончательный выход.

FunValCheck

Проверьте недопустимые значения, такие как NaN или Inf, от целевой функции.

  • 'off'

  • 'on'

GradObj

Помечает, возвращает ли целевая функция вектор градиента в качестве второго выхода.

  • 'off'

  • 'on'

Jacobian

Помечает, возвращает ли целевая функция якобиан в качестве второго выхода.

  • 'off'

  • 'on'

MaxFunEvals

Максимально допустимое количество вычислений целевой функции. Положительное целое число.

MaxIter

Максимально допустимое количество итераций. Положительное целое число.

OutputFcn

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

  • Указатель на функцию задается как @

  • массив ячеек с указателями на функцию

  • пустой массив (по умолчанию)

Robust

(Не рекомендуемый) Активировать опция робастной подгонки.

  • 'off'

  • 'on'

Robust не рекомендуется. Использование RobustWgtFun для робастного подбора кривой.

RobustWgtFun

Функция веса для робастного подбора кривой. Может также быть указателем на функцию, который принимает нормированную невязку как вход и возвращает устойчивые веса как выход. Если вы используете указатель на функцию, дайте Tune константа. См. «Робастные опции».

Streams

Один образец файла RandStream класс или массив ячеек RandStream образцы. Опция Streams принимается некоторыми функциями, чтобы управлять тем, какие потоки использовать при генерации случайных чисел в функции. Если 'UseSubstreams' является true, значение Streams должно быть скаляром или должно быть пустым. Если 'UseParallel' является true и 'UseSubstreams' является false, тогда аргумент Streams должен быть либо пустым, либо его длина должна совпадать с количеством процессоров, используемых в расчете: равным parpool размеру, если parpool открыто, скаляром в противном случае.

TolBnd

Допуск, связанный с параметром. Положительная скалярная величина.

TolFun

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

TolTypeFun

Использование TolFun для абсолютных или относительных допусков целевой функции.

  • 'abs'

  • 'rel'

TolTypeX

Использование TolX для абсолютных или относительных допусков параметра.

  • 'abs'

  • 'rel'

TolX

Допуск завершения для параметров. Положительная скалярная величина.

Tune

Константа настройки, используемая в устойчивом подборе кривой, чтобы нормализовать невязки перед применением функции веса. Значение по умолчанию зависит от функции weight. Этот параметр необходим, если вы задаете функцию веса как указатель на функцию. Положительная скалярная величина. См. «Робастные опции».

UseParallel

Флаг, указывающий, должны ли подходящие функции использовать возможности Parallel Computing Toolbox™ (PCT), если эти возможности доступны. То есть, если PCT установлен, и PCT parpool находится в эффекте. Допустимые значения false (по умолчанию), для последовательных расчетов и true, для параллельных расчетов.

UseSubstreams

Флаг, указывающий, должен ли генератор случайных чисел в подходящих функциях использовать Substream свойство RandStream класс. false (по умолчанию) или true. Когда true, итерации высокого уровня внутри функции установят Substream свойство значению итерации. Это поведение помогает генерировать воспроизводимые потоки случайных чисел в параллельных и/или последовательных режимах расчета.

WgtFun

(Не рекомендуемый) Функция веса для устойчивого подбора кривой. Действителен только при Robust является 'on'. Может также быть указателем на функцию, который принимает нормированную невязку как вход и возвращает устойчивые веса как выход. См. «Робастные опции».

WgtFun не рекомендуется. Использование RobustWgtFun вместо этого.

Примеры

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

statset('evfit')
ans = 
          Display: 'off'
      MaxFunEvals: []
          MaxIter: []
           TolBnd: []
           TolFun: []
       TolTypeFun: []
             TolX: 1.0000e-06
         TolTypeX: []
          GradObj: []
         Jacobian: []
        DerivStep: []
      FunValCheck: []
           Robust: []
     RobustWgtFun: []
           WgtFun: []
             Tune: []
      UseParallel: []
    UseSubstreams: []
          Streams: []
        OutputFcn: []

Единственные параметры, которые evfit используются Display и TolX. Чтобы создать структуру опций со значением TolX установлено на 1e-8, введите:

options = statset('TolX',1e-8)
% Pass options to evfit:
mu = 1;
sigma = 1;
data = evrnd(mu,sigma,1,100);

paramhat = evfit(data,[],[],[],options)

Подробнее о

свернуть все

Робастные опции

Функция весаУравнениеКонстанта настройки по умолчанию
'andrews'w = (abs(r)<pi) .* sin(r) ./ r1.339
'bisquare' (по умолчанию)w = (abs(r)<1) .* (1 - r.^2).^24.685
'cauchy'w = 1 ./ (1 + r.^2)2.385
'fair'w = 1 ./ (1 + abs(r))1.400
'huber'w = 1 ./ max(1, abs(r))1.345
'logistic'w = tanh(r) ./ r1.205
'talwar'w = 1 * (abs(r)<1)2.795
'welsch'w = exp(-(r.^2))2.985
[]Нет устойчивого подбора кривой

См. также

Представлено до R2006a