From 5dbaf8304612f5617373ee01f88421fe07f47c34 Mon Sep 17 00:00:00 2001 From: Craig Warren Date: Thu, 15 Sep 2016 15:46:03 +0100 Subject: [PATCH] Added more description on job array. --- docs/source/openmp_mpi.rst | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/docs/source/openmp_mpi.rst b/docs/source/openmp_mpi.rst index 041eecbf..a8d92ab1 100644 --- a/docs/source/openmp_mpi.rst +++ b/docs/source/openmp_mpi.rst @@ -1,8 +1,8 @@ .. _openmp-mpi: -******************* -Parallel processing -******************* +****************** +Parallel execution +****************** OpenMP ====== @@ -61,12 +61,16 @@ Job array example :download:`gprmax_omp_jobarray.sh <../../tools/HPC scripts/gprmax_omp_jobarray.sh>` -Here is an example of a job script for running models, e.g. A-scans to make a B-scan, using the job array functionality of Open Grid Scheduler/Grid Engine. A job array is a method of using a single submit script to submit multiple similar jobs. It has similar functionality, for gprMax, to using the aforementioned MPI task farm. The behaviour of most of the variables is explained in the comments in the script. +Here is an example of a job script for running models, e.g. A-scans to make a B-scan, using the job array functionality of Open Grid Scheduler/Grid Engine. A job array is a single submit script that is run multiple times. It has similar functionality, for gprMax, to using the aforementioned MPI task farm. The behaviour of most of the variables is explained in the comments in the script. .. literalinclude:: ../../tools/HPC scripts/gprmax_omp_jobarray.sh :language: bash :linenos: +The ``-t`` tells Grid Engine that we are using a job array followed by a range of integers which will be the IDs for each individual task (model). Task IDs must start from 1, and the total number of tasks in the range should correspond to the number of models you want to run, i.e. the integer with the ``-n`` flag passed to gprMax. The ``-taskid`` flag is given to gprMax to tell it we are using a job array, along with the specific number of the task (model) with the environment variable ``$SGE_TASK_ID``. + +A job array means that exactly the same submit script is going to be run multiple times, the only difference between each run is the environment variable ``$SGE_TASK_ID``. + Eddie -----