Batch (Non-Interactive) Execution of S-PLUS
DESCRIPTION:
Executes a file of
S-PLUS expressions and places the
results
in another file or commands
window output
(stdout/stderr). This is
useful for simulations and other
computer-intensive but
predetermined tasks.
USAGE:
Splus BATCH in out
REQUIRED ARGUMENTS:
in: the name of a file containing
S-PLUS expressions to be
executed. The file
may contain source and sink commands,
etc. Interactive
graphics devices (tek4014, hpgl, etc.)
should specify
a file name for their output in
non-
interactive mode.
Interactive graphics functions such as
vga can not be used.
out: the name of a file which will receive all
of the output
from the run. The file
out will contain a listing of each
expression in in, followed by
any printed output produced
by the
expression. If you do not want the input printed
in out, put
options(echo=F)
as the first command in
in. The file out will contain any
printed output
produced by the expression. If you want
the input commands to be
printed in out along with the
output of the commands,
put
options(echo=T)
as the first command in in.
SIDE EFFECTS:
the out file is
created, and objects in S-PLUS
data
directories may be
changed.
WARNING:
Execution begins immediately
after BATCH is invoked. If
you are on a
UNIX system, you may want to put the BATCH
job in the background
or use the UNIX at (or
chron)
command to delay
execution.
Additionally for long running
simulations you should use
the "nice" command to change
the running priority of the
simulation. This allows
the simulation to run in the
background but still allow
adequate computer responsiveness
to a user at the console.
EXAMPLES:
nice +10 Splus BATCH
batch1.in batch1.out &
