Home| Installation| Control Streams| Bootstrap|
Randomization Test | Commands
| References
The Commands page provides a brief description of all key WFN commands.
Nick Holford,
n.holford@auckland.ac.nz,
Department of Pharmacology & Clinical Pharmacology,
Last updated 30 May 2011 [Note: The latest changes to WFN are recorded in wfndown.htm]
WFN is a set of DOS batch command files and awk scripts to help NONMEM users be more productive. The first version of WFN (Wheels for NONMEM) was written in 1989 at UC San Francisco. The unix csh and awk scripts evolved and were eventually ported to DOS in order to support NONMEM as part of the RIDO (Right Dose First Time) project.
Please see license.txt and gpl.txt. WFN is distributed under the terms of the GNU General Public License. It uses gawk.exe which is also distributed under the same terms.
A key concept in WFN is the idea of a run. A run is based on an NM-TRAN control stream. The control stream filename (without its extension) defines the runname. NONMEM is invoked using the nmgo batch command file with the runname as its essential argument e.g. using the theopd.ctl control stream file:
nmgo theopd
You can execute nmgo from any directory you wish but the NMTRAN control stream file (e.g. theopd.ctl) must be in the current directory.
Note: Do not attempt to use a path to point to a control stream in another directory. Long file names are supported but cannot contain embedded blank characters.
nmgo creates a run directory for working files and the final run results, processes the control stream then invokes NM-TRAN, compiles, links and executes NONMEM. The NONMEM output listing is then processed to provide a run summary of the results.
Typical use of NONMEM involves several runs and comparison of the objective function value (obj). The nmobj command provides a simple table of runnames and obj values sorted in ascending obj order to make it easy to compare the overall goodness of fit of each run. The output of nmobj is stored in a file nmobj.txt.
Additional details can be obtained using the nmlst command which presents the summaries for all the runs in the same order as nmobj. These details are stored in a file nmlst.txt. Similar information is presented one line per run using the nmmbt command. Results are stored in nmmbt.txt in tab delimited format.
The results of the theopd run are presented in summary form. The first 3 lines are column headings that display the parameter names aligned with the estimates underneath. The 4th line contains the run name (and nmout extension) followed by the objective function value, estimation method, number of function evaluations, significant digits, number of subjects, and number of observations. Finally the NONMEM version number and PREDPP version number (if used) are displayed.
Note that the ETASD and EPSSD are used to indicate that the square root of the OMEGA and SIGMA values is displayed. In this example a proportional model has been used for the variability of each parameter so that an ETASD for E0 of 0.0414729 can be interpreted as an approximate CV of 4.1%. Empirical Bayes estimate diagnostics test if the ETA average is 0 (ETAPval) and the percent shrinkage of ETA (ETAshr%) and EPS (EPSshr%). The relative standard error of the random effect estimates (OMEGA and SIGMA) are expressed relative to ETASD and EPSD. The format can be modified using NMRAW.
THETA: POP_E0
POP_EMAX POP_EC50
ETA:
PPV_E0 PPV_EMAX PPV_EC50
ERR:
RUV_SD
theopd.lst
5802.085 FO eval=313 sig=+3.1 sub=153 obs=574
MOD(NONMEM)7.2.0
THETA =
146 165 6.57
ETASD =
0.0414729 0.487852 1.2083
EPSSD =
81.1788
THETA:se% = 7.6 12.5 30.0
OMEGA:se% = 4296.5 42.9 78.8
SIGMA:se% = 10.6
MINIMIZATION SUCCESSFUL
Ttot 0:1.95
Test 0:0.42 Tcov 0:0.08 Ttcl 0:1.45
The last line of the
run summary shows the total execution time (Ttot), NONMEM estimation time
(Test), covariance time (Tcov) and the time for the control stream translation,
compile and link part of the run (Tcl). Times are formatted as minutes:seconds
for on-screen display and minutes and fractions of minutes in the run.smy file and the output of nmmbt.
The
run directory is used as a working directory for NM-TRAN and NONMEM temporary
files. These files are deleted at the end of a run unless the Windows Commmand
environment variable nmclean is set to "n". The run directory
name is made up from the runname and an extension which by default is .nm7 e.g.
theopd.nm7.
Note: If the WFN compilation size system is used then the run directory name will reflect the compilation size e.g. if the regular size is used the run directory will be theopd.reg.
The run results files saved at the end of each run are:
|
Runname.lst |
NONMEM output listing (see nmout) |
|
Runname.smy |
Run summary (one line per problem or sub-problem) |
|
Runname.smr |
Run summary with control stream appended |
|
Runname.log |
A log file which may contain information about errors if a problem arises |
|
Runname.ctl |
The control stream used by NM-TRAN (see nmctl) |
|
Runname.fit |
Table file if $TABLE NOPRINT is specified (see nmtbl) |
|
Runname.msf |
MSFO file if MSFO is specified |
|
Runname_mpi.log |
message
passing interface log file if mpi is used |
A list of WFN commands and how to use them can be found in Commands.
Home| Installation| Control Streams| Bootstrap|
Randomization Test | Commands
| References