nonmem2R (version 0.2.5)

extload: Load final parameter values from a nonmem .ext output file.

Description

Load parameter values from a nonmem .ext output file. For output files from FO, FOCE and IMP only the final parameter values are loaded. For output tables of MCMC and SAEM all parameter values from ITERATIONS>0 will be loaded unless positive.iterations=FALSE in case all the output from all iterations are loaded.

For ext-files with multiple table results either only the last table result is loaded (last.table.only=TRUE, default) or all table result are loaded (last.table.only=FALSE). All but the last table results are then returned as sub-lists to the last table result.

Usage

extload(
  model,
  use.model.path = TRUE,
  positive.iterations.only = TRUE,
  last.table.only = TRUE
)

Value

Named list including theta, theta.sd, omega, omega.sd, sigma, sigma.sd, and ofv. Here .sd is the vector(matrix) with standard errors estimated parameter values in theta(omega & sigma).

For MCMC output files each object are matrixes.

Arguments

model

name of the ext file with or without the .ext extension. model may include full or relative path to the ext file. See examples.

use.model.path

Load file from a global defined model library (TRUE=default). If so will look for a global character vector named model.path

positive.iterations.only

Include only rows with ITERATIONS>0 from MCMC and SEAM table results (default=TRUE)

last.table.only

Include only the last table result for ext files with multiple table results

Examples

##### Load the .ext file "run001.ext"
# 1) Get path to the example file included in nonmem2R package
file1 <- system.file("extdata", "run001.ext", package = "nonmem2R")
# 2) Load the file using the extload function
extload(file1)