Note: This page has been translated by MathWorks. Please click here

To view all translated materials including this page, select Japan from the country navigator on the bottom of this page.

To view all translated materials including this page, select Japan from the country navigator on the bottom of this page.

Fit nonlinear mixed-effects model (requires Statistics and Machine Learning Toolbox software)

`fitResults = sbiofitmixed(sm,grpData,responseMap,covEstiminfo)`

`fitResults = sbiofitmixed(sm,grpData,responseMap,covEstiminfo,dosing)`

`fitResults = sbiofitmixed(sm,grpData,responseMap,covEstiminfo,dosing,functionName)`

`fitResults = sbiofitmixed(sm,grpData,responseMap,covEstiminfo,dosing,functionName,opt)`

`fitResults = sbiofitmixed(sm,grpData,responseMap,covEstiminfo,dosing,functionName,opt,variants)`

`fitResults = sbiofitmixed(_,'UseParallel',tf)`

```
[fitResults,simDataI,simDataP]
= sbiofitmixed(_)
```

performs
nonlinear mixed-effects estimation using the SimBiology`fitResults`

= sbiofitmixed(`sm`

,`grpData`

,`responseMap`

,`covEstiminfo`

)^{®} model `sm`

and
returns a `NLMEResults`

object `fitResults`

.

`grpData`

is a ```
groupedData
object
```

specifying the data to fit. `responseMap`

is
a character vector or cell array of character vectors that maps model
components to response data in `grpData`

. `covEstiminfo`

is
a `CovariateModel object`

or
an array of `estimatedInfo`

objects that defines
the parameters to be estimated.

If the model contains active doses and variants, they are applied during the simulation.

uses
the dosing information specified by a matrix of SimBiology dose objects `fitResults`

= sbiofitmixed(`sm`

,`grpData`

,`responseMap`

,`covEstiminfo`

,`dosing`

)`dosing`

instead
of using the active doses of the model `sm`

if
there are any.

uses
the estimation function specified by `fitResults`

= sbiofitmixed(`sm`

,`grpData`

,`responseMap`

,`covEstiminfo`

,`dosing`

,`functionName`

)`functionName`

that
must be either `'nlmefit'`

or `'nlmefitsa'`

.

uses
the additional options specified by `fitResults`

= sbiofitmixed(`sm`

,`grpData`

,`responseMap`

,`covEstiminfo`

,`dosing`

,`functionName`

,`opt`

)`opt`

for the
estimation function `functionName`

.

applies
variant objects specified as `fitResults`

= sbiofitmixed(`sm`

,`grpData`

,`responseMap`

,`covEstiminfo`

,`dosing`

,`functionName`

,`opt`

,`variants`

)`variants`

instead
of using any active variants of the model.

provides
an option to estimate parameters in parallel if Parallel
Computing Toolbox™ is
available.`fitResults`

= sbiofitmixed(_,'UseParallel',`tf`

)

`[`

returns a vector of results objects `fitResults`

,`simDataI`

,`simDataP`

]
= sbiofitmixed(_)`fitResults`

,
vector of simulation results `simDataI`

using individual-specific
parameter estimates, and vector of simulation results `simDataP`

using
population parameter estimates.

`sbiofitmixed`

unifies`sbionlmefit`

and`sbionlmefitsa`

estimation functions. Use`sbiofitmixed`

to perform nonlinear mixed-effects modeling and estimation.`sbiofitmixed`

simulates the model using a`SimFunction object`

, which automatically accelerates simulations by default. Hence it is not necessary to run`sbioaccelerate`

before you call`sbiofitmixed`

.

[1] Grasela Jr, T.H., Donn, S.M. (1985) Neonatal population pharmacokinetics of phenobarbital derived from routine clinical data. Dev Pharmacol Ther. 8(6), 374–83.

`CovariateModel object`

| `NLMEResults object`

| ```
estimatedInfo
object
```

| `groupedData`

| `nlmefit`

| `nlmefitsa`

| `sbiofit`

| `sbiofitstatusplot`

Was this topic helpful?