rlog: Generate a Combined Run Log from Multiple NONMEM Runs
In metrumrg: Pharmacometric Tools for Data Preparation, Modeling, Simulation, and Reporting

Description Usage Arguments Details Value Note Author(s) References See Also

Generates a combined run log across specified runs. Appends/overwrites existing file. Attempts to purge certain files in run directory.

rlog(
	run, 
	project = getwd(), 
	append = TRUE,
	tool = 'nm7',
	file = filename(project,'CombRunLog.csv'),
	rundir = filename(project, run),
	nmlog = file.path(rundir,'NonmemRunLog.csv'),
	nmout = filename(rundir,run,'.lst'),
        purge=TRUE,
 	...
)
purgeRunDir(
	dirs, 
	debug = FALSE, 
	standard = c(
		"^F[ISRCMP]", "^OU", "^nonmem", "^nul$", 
		"WK", "LNK$", "fort", "^nm", "lnk$", 
		"set$", "^gar", "^temp", "^tr", "^new", 
		"^Run\\d+\\.o\\d+$", "^prsizes", "log$",
		"worker",
		if (!debug) c("^FD", "^PR")
	), 
	extra = character(0), 
	pattern = c(standard, extra), 
	...
)

`run`	vector of run names (numbers)
`project`	path to the directory containing run subdirectories
`append`	`TRUE`: append file; `FALSE`: overwrite file
`tool`	‘nm6’ or ‘nm7’: controls methodology. Defaults to 'nm7' as of version 5.18.
`file`	The run-generic output file to write. See details.
`rundir`	path to run subdirectory
`nmlog`	The run-specific input file to read (nm6 only). See details.
`nmout`	The run-specific NONMEM output file to read (nm7 only). See details.
`purge`	whether to remove files as defined in purgeRunDir
`dirs`	character vector: run directories to purge
`debug`	if TRUE, do not delete FDATA and PREDERR by default
`standard`	default files to purge
`extra`	other files to purge
`pattern`	files to purge: trumps `standard` and `extra` if specified
`...`	passed to other functions, such as `runstate` and `purgeRunDir`

rundir, nmlog, and nmout can be vector; or scalar, in which case they may contain ‘*’, to be replaced with run names on a per-run basis.

To suppress file deletion, supply FALSE for purge.

To suppress log creation on disk, supply a zero length argument for file.

Combined runlog is returned invisibly in the unilog format. Side effect: if file is specified, runlog format is written to disk.

As of version 5.18, if the attempt to create a unilog for the run fails, rlog generates a surrogate entry for parameter "min" with value "-1" (moment: "status"). Formerly, the error was converted to a warning and reported at the console.

written by Bill Knebel; modified by Tim Bergsma.

http://metrumrg.googlecode.com