xpose_data functionThe function xpose_data() collects all model output
files and table and organizes them into an R object commonly called
xpdb for xpose data base.
To make full use of the functionality offered by xpose
the following NONMEM output files should be available:
.lst/.out/.res: used to collect information on the run
(template_titles) as well as the output table names.
Alternatively a model file (.mod/.ctl) can be used but some
of the information in template_titles may not be
available..ext: used to collect final parameter estimates and
residual standard error (RSE).phi: used for the random effects and iOFV.cov: used for the covariance matrix.cor: used for the correlation matrix.grd: used for the estimation gradients.shk: used to compute random effect shrinkage
template_titlesWhen importing the files, xpose will return messages to the console and inform of any issue encountered during the import.
xpdb <- xpose_data(runno = '001')
Looking for nonmem output tables
Reading: sdtab001, catab001, cotab001, patab001 [$prob no.1]
Looking for nonmem output files
Reading: run001.cor, run001.cov, run001.ext, run001.grd, run001.phiThese messages can be silenced with the option
quiet = TRUE.
FIRSTONLY tablesxpose is compatible with the $TABLE FIRSTONLY option of
NONMEM. The option FIRSTONLY only output the first record
for each ID and hence can be used to decrease the size of
output tables having no time-varying columns. During tables import xpose
will merge FIRSTONLY tables with regular tables allowing
seamless use of columns from FIRSTONLY in plots.
xpose makes use of the readr which offers the advantages of 1) rapidly import big tables and 2) automatically import compressed table (e.g. sdtab001.zip) to increase storage capacity.
Coming with future releases…
xpdb objectA typical xpdb object contains 8 levels namely:
code: the parsed model codesummary: contains key information regarding the model.
All the information contained in the summary can be used as part of the
template_titles.data: contains all output and simulation tables as well
as the column indexingfiles: contains all output filesspecial: contains post-processed datasets used by
functions like vpc()gg_theme: an attached ggplot2 themexp_theme: an attached xpose themeoptions: attached global options