Exponenta Banner

sbionlmefitsa

Оцените нелинейные смешанные эффекты со стохастическим алгоритмом EM (требует программного обеспечения Statistics and Machine Learning Toolbox),

sbionlmefitsa будет удален в будущем релизе. Использование sbiofitmixed вместо этого.

Синтаксис

results = sbionlmefitsa(modelObj, pkModelMapObject, pkDataObject, InitEstimates)
results = sbionlmefitsa(modelObj, pkModelMapObject, pkDataObject, CovModelObj)
results = sbionlmefitsa(..., Name,Value)
results = sbionlmefitsa(..., optionStruct)
[results, SimDataI, SimDataP] = sbionlmefitsa(...)

Описание

results = sbionlmefitsa(modelObj, pkModelMapObject, pkDataObject, InitEstimates) выполняет оценки с помощью алгоритма Стохастической максимизации ожидания приближения (SAEM) для подходящих данных о населении с моделью SimBiology®, modelObj, и возвращает предполагаемые результаты в results структура.

results = sbionlmefitsa(modelObj, pkModelMapObject, pkDataObject, CovModelObj) задает отношение между параметрами и ковариантами с помощью CovModelObj, CovariateModel объект. CovariateModel объект также обеспечивает преобразование параметра.

results = sbionlmefitsa(..., Name,Value) выполняет оценки с помощью алгоритма SAEM, с дополнительными опциями, заданными одним или несколькими Name,Value парные аргументы.

Следующее является альтернативой предыдущему синтаксису:

results = sbionlmefitsa(..., optionStruct) задает optionStruct, структура, содержащая поля и значения, которые являются аргументами пары "имя-значение", принятыми nlmefitsa. Значения по умолчанию для optionStruct совпадают со значениями по умолчанию для аргументов пары "имя-значение", используемых nlmefitsa, за исключениями, объясненными во Входных параметрах.

[results, SimDataI, SimDataP] = sbionlmefitsa(...) возвращает данные моделирования модели SimBiology, modelObj, использование ориентировочных стоимостей параметров.

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

modelObject

Объект модели SimBiology раньше соответствовал наблюдаемым данным.

Примечание

При использовании объекта модели, содержащего активные дозы (то есть, содержа объекты дозы создал использование adddose метод, и заданный как активное использование Active свойство объекта дозы), иметь в виду, что эти активные дозы проигнорированы sbionlmefitsa функция.

pkModelMapObject

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

Примечание

При использовании PKModelMap объект, который задает несколько доз, гарантирует каждый элемент в Dosed свойство уникально.

pkDataObject

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

Примечание

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

  • Эти точки данных не усреднены, но адаптированы индивидуально.

  • Различные количества наблюдений в разное время заставляют некоторые моменты времени быть взвешенными больше.

InitEstimates

Вектор из первоначальных оценок для фиксированных эффектов. Первый P элементы InitEstimates соответствуйте фиксированным эффектам для каждого P элемент pkModelMapObject.Estimated. Дополнительные элементы соответствуют фиксированным эффектам для ковариационных факторов. Первый P элементы InitEstimates преобразовываются, как задано ParamTransform аргумент пары "имя-значение" (журнал, преобразованный по умолчанию).

CovModelObj

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

optionStruct

Структура, содержащая поля и значения, которые являются аргументами пары "имя-значение", принятыми nlmefitsa функция. Значения по умолчанию для optionStruct совпадают со значениями по умолчанию для аргументов, используемых nlmefitsa, за исключениями, отмеченными в Аргументах в виде пар имя-значение.

Если у вас есть Parallel Computing Toolbox™, можно включить параллельные вычисления для более быстрых данных, соответствующих путем установки аргумента пары "имя-значение" 'UseParallel' к true в statset структура опций можно следующим образом:

parpool; % Open a parpool for parallel computing
opt = statset(...,'UseParallel',true); % Enable parallel computing
results = sbionlmefitsa(...,'Options',opt); % Perform data fitting

Совет

Программное обеспечение SimBiology включает sbiofitstatusplot функция, которую можно задать в OutputFcn поле Options поле . Эта функция позволяет вам контролировать состояние подбора кривой.

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

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

sbionlmefitsa функционируйте использует аргументы пары "имя-значение", поддержанные nlmefitsa функция.

Они nlmefitsa аргументы пары "имя-значение" трудно закодированы в sbionlmefitsa, и поэтому, вы не можете установить их:

  • FEParamsSelect

  • FEConstDesign

  • FEGroupDesign

  • FEObsDesign

  • REConstDesign

  • REGroupDesign

  • REObsDesign

  • Vectorization

Если вы обеспечиваете CovariateModel возразите, как введено против sbionlmefitsa, затем они nlmefitsa пары "имя-значение" вычисляются из ковариационной модели, и поэтому, вы не можете установить их:

  • FEGroupDesign

  • ParamTransform

  • REParamsSelect

Можно установить все другой nlmefitsa аргументы в виде пар имя-значение. Для получения дополнительной информации на этих аргументах, смотрите nlmefitsa (Statistics and Machine Learning Toolbox) страница с описанием.

Следует иметь в виду что значения по умолчанию для них nlmefitsa аргументы пары "имя-значение" отличаются, когда используется sbionlmefitsa:

'FEGroupDesign'

Числовой массив, задающий матрицу проекта для каждой группы.

Значение по умолчанию: repmat(eye(P),[1 1 nGroups]), где P = количество предполагаемых параметров и nGroups = количество групп в наблюдаемых данных.

'ParamTransform'

Вектор из целых чисел, задающих, как параметры распределяются.

Примечание

Не используйте ParamTransform опция, чтобы задать преобразования параметра при обеспечении a CovariateModel возразите против подходящей функции. CovariateModel объект обеспечивает преобразование параметра.

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

'OptimFun'

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

Значение по умолчанию: fminunc, если вам установили Optimization Toolbox™. В противном случае значением по умолчанию является fminsearch.

'Options'

Структура, содержащая несколько полей, включая DerivStep, скаляр или вектор, задающий относительную разницу, используемую в вычислении градиента конечной разности и FunValCheck, логическое определение, проверять ли на недопустимые значения, такие как NaN или Inf, от modelfun.

Значение по умолчанию: значение по умолчанию для DerivStep меньший из 1e-4, или значение SolverOptions.RelativeTolerance свойство конфигурации модели сопоставлено с modelObj, с минимумом eps^(1/3). Значение по умолчанию для FunValCheck off.

Совет

Программное обеспечение SimBiology включает sbiofitstatusplot функция, которую можно задать в OutputFcn поле Options входной параметр пары "имя-значение". Эта функция позволяет вам контролировать состояние подбора кривой.

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

results

Структура, содержащая эти поля:

  • FixedEffects — dataset (Statistics and Machine Learning Toolbox) массив, содержащий оцененные зафиксированные эффекты, включая стандартные погрешности.

  • RandomEffects — dataset массив, содержащий, произвел случайные эффекты для каждой группы в наблюдаемых данных в pkDataObject.

  • IndividualParametereEstimates — dataset массив, содержащий оцененные значения параметров для индивидуумов, включая случайные эффекты.

  • PopulationParameterEstimates — dataset массив, содержащий оцененные значения параметров для населения, без случайных эффектов.

  • RandomEffectCovarianceMatrix — dataset массив, содержащий предполагаемую ковариационную матрицу случайных эффектов.

  • EstimatedParameterNames — Массив ячеек из символьных векторов, задающий имена предполагаемых параметров.

  • CovariateNames — Массив ячеек из символьных векторов, задающий имена ковариантов в CovModelObj.

  • FixedEffectsStruct — Структура, содержащая значения предполагаемых фиксированных эффектов.

  • stats — Структура, содержащая информацию, такую как AIC, BIC, и взвешенные остаточные значения. Для получения дополнительной информации на полях в этой структуре, смотрите stats структура в nlmefitsa (Statistics and Machine Learning Toolbox) в документации Statistics and Machine Learning Toolbox™. Однако поля в stats структура возвращена sbionlmefitsa варьируйтесь немного от возвращенных nlmefitsa, а именно:

    • ires, pres, iwres, pwres, и cwres каждый содержит матрицу сырых данных или взвешенных остаточных значений с количеством столбцов, равных количеству ответов в модели.

    • stats структура возвращена sbionlmefit включает дополнительное поле, Observed. Это поле содержит вектор символов или массив ячеек из символьных векторов, задающий измеренные отклики, которые соответствуют столбцам в матрицах ires, pres, iwres, pwres, и cwres поля . Observed поле эквивалентно Observed свойство PKModelMap входной параметр.

SimDataI

SimData object содержа данные из симуляции модели с помощью предполагаемых значений параметров для индивидуумов. Этот объект включает наблюдаемые состояния и регистрируемые состояния.

SimDataP

SimData object содержа данные из симуляции модели с помощью предполагаемых значений параметров для населения. Этот объект включает наблюдаемые состояния и регистрируемые состояния.

Смотрите также

| | | | | | | | (Statistics and Machine Learning Toolbox)

Темы

Введен в R2010a

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

Поддержка