Skip to content
Snippets Groups Projects
Commit 964336df authored by Simon Mueller's avatar Simon Mueller
Browse files

Update file sette.rst

parent cfd38ac3
No related branches found
No related tags found
1 merge request!28Update related to the PHYOPTS and TRANSFORM SETTE-test description
This commit is part of merge request !28. Comments created here will be created in the context of that merge request.
...@@ -454,21 +454,23 @@ a basic report is presented to the user which lists the various successes or fai ...@@ -454,21 +454,23 @@ a basic report is presented to the user which lists the various successes or fai
The report shows the result of restartability and reproducibility tests on the whole range of test The report shows the result of restartability and reproducibility tests on the whole range of test
configurations. Passing these tests is a necessary and mandatory requirement for any official release configurations. Passing the default set of tests is a necessary and mandatory requirement for any official release
of NEMO. Note these tests are not sufficient to guarantee restartability and reproducibility in all of NEMO. Note these tests are not sufficient to guarantee restartability and reproducibility in all
user-defined configrations and anyone running configurations, which are not close variants of the user-defined configrations and anyone running configurations, which are not close variants of the
reference or test configurations, should conduct their own tests. reference or test configurations, should conduct their own tests.
``SETTE`` will also carry out tests on the PSyclone code transformation (if enabled) and tests with ``SETTE`` will also carry out tests with alternative physics options that are defined for some configurations,
alternative physics options that are defined for some configurations. The range of tests carried out and optionally tests on PSyclone-based code transformations. The range of tests carried out
can be varied via the ``-x`` command-line option to ``sette.sh``. The default behaviour is equivalent to can be varied via the ``-x`` command-line option to ``sette.sh``. The default set of tests is equivalent to
.. code-block:: bash .. code-block:: bash
sette.sh -x "COMPILE RESTART REPRO CORRUPT PHYOPTS TRANSFORM" sette.sh -x "COMPILE RESTART REPRO CORRUPT PHYOPTS"
This report ends by comparing the latest results against a reference set (as defined in and optionally the SETTE test option ``TRANSFORM`` can be included in the argument to enable the testing of
``param.cfg``). Only ``ORCA2_ICE_PISCES`` had been run on the alternative branch and the PSyclone-based code transformations (this includes a comparison of model results and runtimes between model
runs based on untransformed and transformed code). This report ends by comparing the latest results against
a reference set (as defined in ``param.cfg``). Only ``ORCA2_ICE_PISCES`` had been run on the alternative branch and the
missing comparisons have been omitted here. In this case the comparison is between missing comparisons have been omitted here. In this case the comparison is between
branches that were known to introduce numerical differences. This is confined by the branches that were known to introduce numerical differences. This is confined by the
comparsion but the report is most useful when numerical results are not expected to change comparsion but the report is most useful when numerical results are not expected to change
...@@ -548,13 +550,12 @@ are equivalent. As a point of interest, it is good practise to list tests in dec ...@@ -548,13 +550,12 @@ are equivalent. As a point of interest, it is good practise to list tests in dec
order of their expected execution time. This will enable compilation time to overlap order of their expected execution time. This will enable compilation time to overlap
run-time as much as possible and should minimise time to completion run-time as much as possible and should minimise time to completion
The default operation is to perform all ``RESTART``, ``REPRO`` and agrif-processed, The default operation is to perform all ``RESTART``, ``REPRO``, AGRIF-processing
``CORRUPT`` checks. The checks performed can be limited to a sub-set of these by supplying ``CORRUPT``, and ``PHYOPTS`` (optional physical schemes) checks. The checks performed can be
arguments to the ``-x`` option. The combination of ``-n`` and ``-x`` is particularly limited to a sub-set of these by supplying arguments to the ``-x`` option. The combination of
useful when working to solve a specific issue with a single configuration. There is also ``-n`` and ``-x`` is particularly useful when working to solve a specific issue with a single
a ``PHYOPTS`` check which is not currently used but has been implemented, as a configuration. The optional ``TRANSFORM`` test enables the testing of PSyclone-based source-code
demonstration, to run the ``OVERFLOW`` and ``LOCK_EXCHANGE`` test cases with a selection transformations. Any other string supplied as an argument to the ``-x``
of different physical schemes. Any other string supplied as an argument to the ``-x``
option will force a compilation only. This is useful for quickly checking for compile-time option will force a compilation only. This is useful for quickly checking for compile-time
errors. Although any non-recognised string will trigger this, it is good practise to be errors. Although any non-recognised string will trigger this, it is good practise to be
explicit, i.e.: explicit, i.e.:
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment