CWRES {MIfuns} | R Documentation |
CWRES is a function to generate CWRES diagnostic plots following a successful NONMEM run. It can be called as a standalone function following a successful NONMEM run to generate CWRES plots. Plots are the same as those generated by PLOTR or via NONR.
CWRES(ProjectDir, b, dvname, exportas = 0, logtrans = 0, grp = NULL, grpnames = NULL, covplt, cont.cov = NULL, cat.cov = NULL, missing = -99, epilog = NULL)
ProjectDir |
System path to the directory containing the NONMEM control (*.ctl) streams. |
b |
Vector of control stream numbers to run in NONMEM. Should be numeric with no placeholder zeros to left of number, i.e., "1" not "001".
Example: b=c(1,2,5) |
dvname |
Name of the dependent variable to use as a label for the diagnostic plots. |
exportas |
Flag to choose pdf (0) or png (1) output for plots with default being "0" for pdf output. |
logtrans |
Flag to log transform (1) or not (0) the NONMEM output variables DV, PRED, and IPRED with the default being "0" to NOT transform the variables. |
grp |
Item in NONMEM datafile or output table file that can be used to condition plots generated by PLOTR.
Default value is NULL. Example: grp=c("SEX") |
grpnames |
Optional vector of names for grp item. Vector length must equal number of conditions in grp .
Default value is NULL. Example: grpnames=c("Male","Female") |
covplt |
Flag to generate (1) or not (0) covariate diagnostic plots with default value being "0" to not routinely create covariate plots. |
cont.cov |
Vector of continuous covariate names. Names must match those used as column headers in DataFile . Values
are retrieved from DataFile so they do not need to be part of the NONMEM $TABLE step. Default value is NULL.
Example: cont.cov=c("AGE","WT","CRCL") |
cat.cov |
Vector of categorical covariate names. Names must match those used as column headers in DataFile . Values
are retrieved from DataFile so they do not need to be part of the NONMEM $TABLE step. Default value is NULL.
Example: cat.cov=c("SEX","FOOD") |
missing |
Numeric item that defines value used to represent missing items in the NONMEM data file. Default value is "-99". |
epilog |
Path to user-defined script that will be sourced at completion of NONMEM run. Default value is NULL. |
CWRES values for each observation are attached to NONMEM "*.TAB" file as part of this function. Multiple runs of this function on the same "*.TAB" file are likely to create errors.
Developed by Metrum Institute (Bill Knebel, Tim Bergsma, and others).
MIfuns package available from Metrum Institute website (http://metruminstitute.org/
).