diff --git a/VERSION b/VERSION index a84947d6f..4404a17ba 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -4.5.0 +4.5.1 diff --git a/docs/source/scripting.rst b/docs/source/scripting.rst index ed727107e..5d017df24 100644 --- a/docs/source/scripting.rst +++ b/docs/source/scripting.rst @@ -77,6 +77,46 @@ the --help command line option where possible. +Example: Creating a runfile +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +A runfile is a simple text file, where each line in this file can be executed, for example using +bash in a serial fashion. If each line is independant from all others, they can be executed in parallel using +``gnu parallel`` or ``sbatch`` (a common HPC batch queue system). For example the following command +in NEMO produces a runfile with 4 lines: + +.. code-block:: + + mkrunfile.py progname a=1,2 b=2,4 c=10 > example1.run + + progname a=1 b=2 c=10 + progname a=2 b=2 c=10 + progname a=1 b=4 c=10 + progname a=2 b=4 c=10 + +where the ``example1.run`` file can be executed with any of the following commands. Depending on your +resources of course. Memory, number of cores etc. + +.. code-block:: + + bash example1.run + parallel -j 4 < example1.run + sbatch_nemo.sh example1.run + +in particular the last ``sbatch_nemo.sh`` example will likely need to be tailored for your HPC system. + +.. note:: + Unless the parameters take care of this, you will need to ensure data are written to files that do not + collide with each other. For example a directory or file that encodes the values of the parameters, + or are numerically sorted (e.g. run010, run011) + Currently ``mkrunfile.py`` does not have an automated way for this yet. + +And here is an example of creating a runfile from a table with values + +.. code-block:: + + awk '{printf("progname runfile=run_%s a=%s b=%s\n", $1,$2,$3) }' example1.tab + Example: Extracting results from run directories ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/docs/whatsnew.html b/docs/whatsnew.html index 9872891e7..fa0771bd8 100644 --- a/docs/whatsnew.html +++ b/docs/whatsnew.html @@ -22,13 +22,15 @@

What's New in NEMO

--> -

4.5.0: in git

+

4.5.0/4.5.1: in git

-

4.4.3/4.4.4/4.4.5 (a.k.a. Malta Release)

+

4.4.3/4.4.4/4.4.5: 22-dec-2024 (a.k.a. Malta Release)