tips.rst

Tips and tricks
===============

Working with ORCA1
------------------

If you plan to run diagnostics for ORCA1 resolution, be aware that your workstation will be more than capable to run
them. At this resolution, memory and CPU consumption is low enough to allow you keep using the machine while running,
specially if you reserve a pair of cores for other uses.

Configuring core usage
----------------------

By default, the Earth Diagnostics creates a thread for each available core for the execution. If you are using a queueing
system, the diagnostics will always use the number of cores that you reserved. If you are running outside a queueing
system, the diagnostics will try to use all the cores on the machine. To avoid this, add the MAX_CORES parameter to the
DIAGNOSTICS section inside the diags.conf file that you are using.

NEMO files
----------

Unlike the bash version of the ocean diagnostics, this program keeps the NEMO files in the scratch folder so you can
launch different configurations for the same experiment with reduced start time. You will need to remove the experiment's
folder in the scratch directory at the end of the experiment to avoid wasting resources. To do this, just use

.. code-block:: bash

    earthdiags -f PATH_TO_CONF --clean

If you plan to run the earthdiagnostics only once, you can add this line after the execution