Executes a file of S-PLUS expressions
and places the results in another file or the normal output destination.
This is useful for simulations and other computer-intensive but predetermined
tasks. This must be run from
a UNIX shell prompt,
and it replaces
.
USAGE:
Splus SBATCH [options] [inputfile]
OPTIONAL ARGUMENTS:
--help
prints this message and quits.
--cwd directory
change to this
directory before doing any processing.
--input inputfile
read input from
inputfile (or specify
inputfile as last argument).
--output file
send output to
file. The default is the
inputfile basename with
.txt.
--logfile file
write session log to
file. The default is the
inputfile basename with
.slg.
The
inputfile is stripped of any period extension.
--appendlog
append to log file. The default is to overwrite.
--nologfile
do not make a session log.
--work directory
use
directory for working database
(where=1), making it if needed.
If
directory is not specified, a new randomly named directory for working database is made.
--noclean
do not remove the new randomly named directory used for working database.
--newworkparent
directory in which to make the new randomly named working database. The default is the current working directory.
--echo
echo command lines to output (sets
options(echo=T)). This is the default.
--noecho
Do not set
options(echo=T).
--verbose
echo verbose logging information to output (sets
options(verbose=T)).
--quitonerror
terminate immediately on engine error. Default is to continue through error.
--background
run S-PLUS in the background (returning immediately).
--nobigdata
do not load bigdata library.
--bigdata
load bigdata library.
--vanilla
do not run user-defined startup scripts or functions. The
--work directory is ignored.
-j
Enable java.
--headless
do not use X Windows connection if running java. The DISPLAY variable does not need to be set.
name=value
will be added to environment so
getenv("name") returns
value.
DETAILS:
An input file must be specified either as a command line argument or following
the
--input option. The input file contains the
S-PLUS expressions to be executed.
NOTE:
The
Splus program is case sensitive, and the word
SBATCH needs to be in all
capital letters. This must be run from a
UNIX shell prompt
to execute.
WARNING:
Execution begins immediately after
SBATCH is invoked.
If you are on a UNIX system,
you may want to put the
SBATCH job in the background
or use the UNIX
at (or
chron) command to delay execution.
SEE ALSO:
,
,
.
EXAMPLES:
# Read input from file, write output and logfile
Splus SBATCH --input /homes/test/script1.ssc --output /homes/test/script1.txt --logfile /homes/test/script1.log