importNm: Import a NONMEM run

Description Usage Arguments Value Note Author(s)

View source: R/importNm.R


Imports a NONMEM run based on a control file and an output list file. This function assumes that all of the input and output data tables are in the same directory as the control file, though the input and output tables are allowed to be missing. An object of class NMRun is returned#'


importNm(conFile, reportFile, path, dropInputColumns=TRUE, textReport=FALSE)



Single string with control file name


The name of the report file. In the future this parameter will be optional, in which case importNm will attempt' to deduce the file name on its own based on the name of the conFile and the list file extensions stored in the metadata.


The path where the files are located. Can be the name of a path stored with setNmPath if it is surrounded by round brackets


Logical flag. If TRUE, those columns of the input data flagged for dropping in the $INPUT statement will not be imported with the run


Logical flag. If TRUE, various standard text outputs will be logged to stdReport


An NMRun object that holds the information of the NONMEM run. If input data tables cannot be imported, a warninjg will ne emitted and the input data will be ignored. The same is true if any output table files cannot be found.


The behaviour of this function is fairly complex, due to the intricacies of NONMEM itself. Below we list key behaviours relating to various categories.

  • Input data:Input data is specified by the control file $INPUT and $DATA statements. Dropped columns will be managed according to the value of the dropInputColumns parameter. Aliased columns will be duplicated, once with their alias, and once with their alternative name (e.g. the column SEX=GEN would appear as a column SEX and once as GEN). If there are more columns in the input data than are referenced in the $DATA statement they will be attached with the names ExtraCol[x]. Ignored data (as specified by the IGNORE= directive) will not be available in the returned object.

  • Iterations (NONMEM 7 only):NONMEM 7-style iteration files (".ext") will be imported as the iterations for a NONMEM 7 run (if available). The name of the iterations file will be automatically deduced from the control file. They will be retrievable with the getIterations function.


Mango Solutions

RNMImport documentation built on May 21, 2017, 1:15 a.m.

Search within the RNMImport package
Search all R packages, documentation and source code

Questions? Problems? Suggestions? Tweet to @rdrrHQ or email at

Please suggest features or report bugs in the GitHub issue tracker.

All documentation is copyright its authors; we didn't write any of that.