The function reads in NONMEM table files. The files can be created from the
$EST line or from the $SIM line in a NONMEM model file.
read_nm_table(nm_table, only_obs = FALSE, method = "default",
quiet = TRUE, sim_num = FALSE, sim_name = "NSIM")Returns a data frame of the simulated table with an added column for
the simulation number. The data frame is given class c("tbl_df",
"tbl", "data.frame") for easy use with dplyr.
The NONMEM table file to read. A text string. If dplyr
and readr are available and method="default" or
method="readr_*" then nm_table can either a path to a file, a
connection, or literal data (either a single string or a raw vector). Files
ending in .gz, .bz2, .xz, or .zip will be automatically uncompressed. Files
starting with http://, https://, ftp://, or ftps:// will be automatically
downloaded. Remote gz files can also be automatically downloaded &
decompressed.
Should the non-observation lines in the data set be removed?
Currently filtered using the expected MDV column. TRUE or
FALSE.
Can be one of default, readr_1, readr_2,
readr_3, slow. readr_1 should be fastest. All but
slow require dplyr and
readr (version >= 0.2.2).
Should there be verbose messages about what the function is doing?
Should the function add a column to the returned data frame that identifies the simulation number (if present)?
The name of the resulting column in the returned data frame if sim_num is true.
Currently the function searches the $TABLE for multiple header lines,
and uses that to identify multiple simulations. The function expects at least
one header line (NOHEADER option is not allowed in NONMEM table
files).