read_nm_table: Read NONMEM table files produced.

Description Usage Arguments Details Value


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")



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).


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.

ncappc documentation built on May 1, 2019, 7:31 p.m.