exponenta event banner

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) отображает поля и значения по умолчанию, используемые функцией 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

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

UseParallel

Флаг, указывающий, должны ли подходящие функции использовать возможности 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