convAD {PBSadmb}

Convert TPL Code to CPP Code

Description

Convert code in 'prefix'.tpl to C++ code in 'prefix'.cpp.

Usage

convAD(prefix, raneff=FALSE, safe=TRUE, dll=FALSE, debug=FALSE, 
   logfile=TRUE, add=TRUE, verbose=TRUE, pathfile=NULL)

Arguments

prefix

string name prefix of the ADMB project (e.g., "vonb").

raneff

logical: if TRUE, use the random effects model executable tpl2rem.exe, otherwise use the normal model executable tpl2cpp.exe.

safe

logical: if TRUE, use safe mode with bounds checking on all array objects, otherwise use optimized mode for fastest execution.

dll

create dll (rather than executable)

debug

compile with debug symbols

logfile

logical: if TRUE, create a log file of the messages from the shell call.

add

logical: if TRUE, append shell call messages to an exsiting log file.

verbose

logical: if TRUE, report the shell call an its messages to the R console.

pathfile

string name of 2-column text file that details the relevant paths for the R variables admbpath, gccpath, and editor.

Details

This function invokes the ADMB command tpl2cpp.exe or tpl2rem.exe, if raneff is FALSE or TRUE respectively. If logfile=TRUE, any errors will appear in 'prefix'.log. If verbose=TRUE, they will appear in R console.

Value

Invisibly returns the shell call and its messages.

Note

A wrapper function that can be called from a GUI exists as .win.convAD.

The optional pathfile is offered for use in command (non-GUI) functions. Users can easily create this file in a text editor. Note that on UNIX systems, only the admbpath (actually the path to ADMB's home directory) and text editor are used because the MinGW compiler (gccpath) and UNIX tools are already recognised.

Author(s)

Jon T. Schnute, Scientist Emeritus
Pacific Biological Station (PBS), Fisheries & Oceans Canada (DFO), Nanaimo BC
Last modified Rd: 2014-02-27

See Also

compAD, linkAD, makeAD, readADpaths