simulate.SaemixObject: Perform simulations under the model for an saemixObject...

In saemix: Stochastic Approximation Expectation Maximization (SAEM) Algorithm

Perform simulations under the model for an saemixObject object

Description

This function is used to simulate data under the empirical design, using the model and estimated parameters from a fit.

Usage

## S3 method for class 'SaemixObject'
simulate(
  object,
  nsim,
  seed,
  predictions,
  outcome = "continuous",
  res.var = TRUE,
  uncertainty = FALSE,
  ...
)

Arguments

object	an saemixObject object returned by the saemix function
nsim	Number of simulations to perform. Defaults to the nb.sim element in options
seed	if non-null, seed used to initiate the random number generator (defaults to NULL)
predictions	Whether the simulated parameters should be used to compute predictions. Defaults to TRUE for continuous data, and to FALSE for non-Gaussian data models. If FALSE, only individual parameters are simulated.
outcome	the type of outcome (used to specify TTE or RTTE models)
res.var	Whether residual variability should be added to the predictions. Defaults to TRUE
uncertainty	Uses uncertainty (currently not implemented). Defaults to FALSE
...	additional arguments, unused (included for compatibility with the generic)

Details

The simulated data can then be used to produce Visual Predictive Check graphs, as well as to compute the normalised prediction distribution errors (npde).

This function replaces the previous function (simul.saemix), which will be deprecated in future versions but can still be called as previously for compatibility purposes.

Author(s)

Emmanuelle Comets [e-mail], Audrey Lavenu, Marc Lavielle.

References

Brendel, K, Comets, E, Laffont, C, Laveille, C, Mentre, F. Metrics for external model evaluation with an application to the population pharmacokinetics of gliclazide, Pharmaceutical Research 23 (2006), 2036-2049.

Holford, N. The Visual Predictive Check: superiority to standard diagnostic (Rorschach) plots (Abstract 738), in: 14th Meeting of the Population Approach Group in Europe, Pamplona, Spain, 2005.

See Also

SaemixObject,saemix, saemix.plot.data, saemix.plot.convergence, saemix.plot.llis, saemix.plot.randeff, saemix.plot.obsvspred, saemix.plot.fits, saemix.plot.parcov, saemix.plot.distpsi, saemix.plot.scatterresiduals, saemix.plot.vpc

saemix documentation built on May 29, 2024, 10:43 a.m.