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.

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

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

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.

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)
#> $theta
#>     THETA1     THETA2     THETA3     THETA4     THETA5     THETA6     THETA7 
#>  27.732200 112.773000  98.247800  20.808500   0.168248   0.938162   1.000000 
#>     THETA8     THETA9    THETA10    THETA11    THETA12    THETA13    THETA14 
#>  15.604500   9.696140  44.518300   5.559610   0.145536   1.656860   1.077060 
#>    THETA15 
#>   1.958350 
#> 
#> $theta.sd
#>      THETA1      THETA2      THETA3      THETA4      THETA5      THETA6 
#> 1.80881e+00 1.06615e+01 6.39463e+00 2.39101e+00 8.68468e-03 7.13432e-02 
#>      THETA7      THETA8      THETA9     THETA10     THETA11     THETA12 
#> 1.00000e+10 5.80057e-01 4.09002e-01 2.24989e+00 3.89094e-01 7.43010e-03 
#>     THETA13     THETA14     THETA15 
#> 1.64017e-01 1.60450e-01 1.88874e-01 
#> 
#> $omega
#>           OMEGA1    OMEGA2    OMEGA3 OMEGA4   OMEGA5 OMEGA6    OMEGA7
#> OMEGA1 0.0704585 0.0000000 0.0000000      0 0.000000      0 0.0000000
#> OMEGA2 0.0000000 0.0386847 0.0000000      0 0.000000      0 0.0000000
#> OMEGA3 0.0000000 0.0000000 0.0430261      0 0.000000      0 0.0000000
#> OMEGA4 0.0000000 0.0000000 0.0000000      0 0.000000      0 0.0000000
#> OMEGA5 0.0000000 0.0000000 0.0000000      0 0.146879      0 0.0000000
#> OMEGA6 0.0000000 0.0000000 0.0000000      0 0.000000      0 0.0000000
#> OMEGA7 0.0000000 0.0000000 0.0000000      0 0.000000      0 0.0506769
#> 
#> $omega.sd
#>             OMEGA1      OMEGA2      OMEGA3 OMEGA4      OMEGA5 OMEGA6
#> OMEGA1 3.09649e-02 1.00000e+10 1.00000e+10  1e+10 1.00000e+10  1e+10
#> OMEGA2 1.00000e+10 1.38764e-02 1.00000e+10  1e+10 1.00000e+10  1e+10
#> OMEGA3 1.00000e+10 1.00000e+10 1.16588e-02  1e+10 1.00000e+10  1e+10
#> OMEGA4 1.00000e+10 1.00000e+10 1.00000e+10  1e+10 1.00000e+10  1e+10
#> OMEGA5 1.00000e+10 1.00000e+10 1.00000e+10  1e+10 3.37885e-02  1e+10
#> OMEGA6 1.00000e+10 1.00000e+10 1.00000e+10  1e+10 1.00000e+10  1e+10
#> OMEGA7 1.00000e+10 1.00000e+10 1.00000e+10  1e+10 1.00000e+10  1e+10
#>             OMEGA7
#> OMEGA1 1.00000e+10
#> OMEGA2 1.00000e+10
#> OMEGA3 1.00000e+10
#> OMEGA4 1.00000e+10
#> OMEGA5 1.00000e+10
#> OMEGA6 1.00000e+10
#> OMEGA7 1.85393e-02
#> 
#> $sigma
#>        sigma1
#> sigma1      1
#> 
#> $sigma.sd
#>        sigma1
#> sigma1  1e+10
#> 
#> $ofv
#> [1] 6130.993
#> 
#> $fix
#>  [1] "THETA7"     "SIGMA.1.1." "OMEGA.2.1." "OMEGA.3.1." "OMEGA.3.2."
#>  [6] "OMEGA.4.1." "OMEGA.4.2." "OMEGA.4.3." "OMEGA.4.4." "OMEGA.5.1."
#> [11] "OMEGA.5.2." "OMEGA.5.3." "OMEGA.5.4." "OMEGA.6.1." "OMEGA.6.2."
#> [16] "OMEGA.6.3." "OMEGA.6.4." "OMEGA.6.5." "OMEGA.6.6." "OMEGA.7.1."
#> [21] "OMEGA.7.2." "OMEGA.7.3." "OMEGA.7.4." "OMEGA.7.5." "OMEGA.7.6."
#>