Fit nonlinear mixed-effects model (requires Statistics and Machine Learning Toolbox software)
performs
nonlinear mixed-effects estimation using the SimBiology® model fitResults
= sbiofitmixed(sm
,grpData
,responseMap
,covEstiminfo
)sm
and
returns a NLMEResults
object fitResults
.
grpData
is a groupedData
object
specifying the data to fit.
responseMap
defines the mapping between the model
components and 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.
specifies whether to estimate parameters in parallel if Parallel Computing Toolbox™ is available.fitResults
= sbiofitmixed(_,'UseParallel',tf_parallel
)
specifies whether to show the progress of parameter estimation.fitResults
= sbiofitmixed(_,'ProgressPlot',tf_progress
)
[
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.
Note
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
| EstimatedInfo object
| groupedData
| NLMEResults object
| sbiofit
| sbiofitstatusplot
| nlmefit
(Statistics and Machine Learning Toolbox) | nlmefitsa
(Statistics and Machine Learning Toolbox)