The general form of the escript launcher is as follows:
escript
-n nn
-p np
-t nt
-f hostfile
-x
-V
-e
-h
-v
-o
-c
-i
-b
file
ARGS
where file is the name of a script, ARGS are arguments for the script.
The escript program will import your current environment variables.
If no file is given, then you will be given a python prompt (see -i for restrictions).
The options are used as follows:
- -n nn
- the number of compute nodes nn to be used. The total number of process being used is
. This option overwrites the value of the ESCRIPT_NUM_NODES environment variable.
If a hostfile is given, the number of nodes needs to match the number hosts given in the host file.
If
but escript is not compiled for MPI a warning is printed but execution is continued with
. If -n is not set the
number of hosts in the host file is used. The default value is 1.
- -p np
- the number of MPI processes per node. The total number of processes to be used is
. This option overwrites the value of the ESCRIPT_NUM_PROCS environment variable. If
but escript is not compiled for MPI a warning is printed but execution is continued with
. The default value is 1.
- -t nt
- the number of threads used per processes.
The option overwrites the value of the ESCRIPT_NUM_THREADS environment variable.
If
but escript is not compiled for OpenMP a warning is printed but execution is continued with
. The default value is 1.
- -f hostfile
- the name of a file with a list of host names. Some systems require to specify the addresses or names of the compute nodes where MPI process should be spawned. The list of addresses or names of the compute nodes is listed in the file with the name hostfile. If -n is set the
the number of different
hosts defined in hostfile must be equal to the number of requested compute nodes nn. The option overwrites the value of the ESCRIPT_HOSTFILE environment variable. By default value no host file is used.
- -c
- prints the information about the settings used to compile escript and stops execution..
- -V
- prints the version of escript and stops execution.
- -h
- prints a help message and stops execution.
- -i
- executes the script file and switches to interactive mode after the execution is finished or an exception has occurred. This option is useful for debugging a script. The option cannot be used if more then one process (
) is used.
- -b
- do not invoke python. This is used to run non-python programs.
- -e
- shows additional environment variables and commands used during escript execution. This option is useful if users wish to execute scripts without using the escript command.
- -o
- switches on the redirection of output of processors with MPI rank greater than zero to the files stdout_r.out and stderr_r.out where r is the rank of the processor. The option overwrites the value of the ESCRIPT_STDFILES environment variable
- -v
- prints some diagnostic information.
Subsections
esys@esscc.uq.edu.au