NAME

       run-escript - a launcher for programs and scripts using the escript libraries.

SYNOPSIS

       run-escript [-n nn ] [-p np ] [-t nt ] [-f hostfile ] [-x ] [-V ] [-e ] [-h ] [-v ] [-o ] [-c ] [-i ] [-b
       ] [ file ] [ ARGS ]

OPTIONS

       file  is  the  name  of  a  script,  ARGS are arguments for the script.  escript 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  Specify  the  number  of  compute  nodes  nn to be used.  This option overwrites the value of the
              ESCRIPT_NUM_NODES environment variable. If nn > 1 but escript was not compiled  for  MPI,  then  a
              warning is printed but execution is continued with nn = 1. The default value is 1.

       -p np Specify the number of MPI processes per node.  The total number of processes to be used is nn times
              ns.  This option overwrites the value of the ESCRIPT_NUM_PROCS environment variable. If np > 1 but
              escript  is  not compiled for MPI a warning is printed but execution is continued with np = 1. The
              default value is 1.

       -t  nt  The  number  of  threads  used  per  processes.  This  option  overwrites  the   value   of   the
              ESCRIPT_NUM_THREADS environment variable. If nt
               >  1  but escript is not compiled for OpenMP a warning is printed but execution is continued with
              nt = 1. The default value is 1.

       -f hostfile Specify 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. In order to avoid
              oversubsription 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 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 than one
              process ( nn * np > 1) is used or if -b is used.

       -b Do not invoke python. This is used to run non-python programs.

       -e  Outputs  export  statements for the 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_CREATESTDFILES environment variable.

       -v Prints some diagonstic information.

                                                                                                  run-escript(1)