source: utils/tools

Name Size Rev Age Author Last Change
../
ABL_TOOLS 13203   5 months smasson tools: update with tools_ticket2362
BDY_TOOLS 3294   9 years rblod Merge of 3.4beta into the trunk
DIAMLR 12414   9 months smueller Reintegration of 2019 development branch /utils/tools_MERGE_2019 into the …
DMP_TOOLS 10567   22 months nicolasmartin Transfer specific documentation of DMP_TOOL into its own directory
DOMAINcfg 13585   7 weeks cbricaud bugfix in tools/DOMAINcfg for ticket #2547
GRIDGEN 2281   10 years smasson set proper svn properties to all files…
MISCELLANEOUS 9598   3 years nicolasmartin Reorganisation plan for NEMO repository: changes to make compilation …
MPP_PREP 11751   13 months nicolasmartin Review README for tools
NESTING 12273   12 months clem debug: make sure bathymetry at the boundaries of the child domain is the …
NESTING_AGRIF 12414   9 months smueller Reintegration of 2019 development branch /utils/tools_MERGE_2019 into the …
OBSTOOLS 10841   20 months cbricaud fix for ticket #2268
REBUILD 9691   3 years smasson trunk: finish [9684]
REBUILD_NEMO 10338   2 years mathiot Add deflation/chunking to rebuild_nemo tool. Fix #2165
SCOORD_GEN 6140   5 years timgraham Merge of branches/2015/dev_merge_2015 back into trunk. Merge excludes …
SECTIONS_DIADCT 8126   3 years cbricaud fix in trunk ticket #1906
SIREN 13369   4 months jpaul update: cf changelog inside documentation
TOYATM 13201   5 months smasson tools: update with tools_CPL_OASIS_ticket2379_2020
WEIGHTS 13204   5 months smasson tools: update with tools_dev_r12970_AGRIF_CMEMS
maketools 4.7 KB 13204   5 months smasson tools: update with tools_dev_r12970_AGRIF_CMEMS
README.rst 4.8 KB 13246   5 months clevy Update rst files

README.rst

*****
Tools
*****

.. todo::

   The 'Tools' chapter needs to be enriched

.. contents::
   :local:
   :depth: 1

A set of tools is provided with NEMO to setup user own configuration and (pre|post)process data.

How to compile a tool
=====================

The tool can be compiled using the maketools script in the tools directory as follows:

.. code-block:: console

   $ ./maketools -m 'my_arch' -n '<TOOL_NAME>'

where ``my_arch`` can be selected among available architecture files or providing a user defined one.

List of tools
=============

BDY_TOOLS
---------

It contains the utility *bdy_reorder* used to reorder old BDY data files used with
previous versions of the model (before 3.4) to make them compatible with NEMO 3.4.

DMP_TOOLS
---------

Used to create a netcdf file called :file:`resto.nc` containing
restoration coefficients for use with the :file:`tra_dmp` module in NEMO
(see :download:`DMP_TOOLS README <../../../tools/DMP_TOOLS/README>`).

DOMAINcfg
---------
A toolbox allowing the creation of regional configurations from curvilinear grid
(see :download:`DOMAINcfg README <../../../tools/DOMAINcfg/README.rst>`).

GRIDGEN
-------
This tool allows the creation of a domain configuration file (``domain_cfg.nc``) containing
the ocean domain information required to define an ocean configuration from scratch.
(see :download:`GRIDGEN documentation <../../../tools/GRIDGEN/doc_cfg_tools.pdf>`).

MISCELLANEOUS
-------------

The tool allows to create alternative configurations to the community without
having to rely on system team sponsorship and support.

MPP_PREP
--------

This tool provides the user with information to choose the best domain decomposition.
The tool computes the number of water processors for all possible decompositions,
up to a maximum number of processors
(see :download:`MPP_PREP documentation <../../../tools/MPP_PREP/mpp_nc.pdf>` and
:download:`MPP_PREP archive <../../../tools/MPP_PREP/mpp_prep-1.0.tar.gz>`).

NESTING
-------

AGRIF nesting tool allows for the seamless two-way coupling of nested sub-models within
the NEMO framework as long as these are defined on subsets of the original root grid.
It allows to create the grid coordinates, the surface forcing and the initial conditions required by
each sub-model when running a NEMO/AGRIF embedded mode
(see :download:`NESTING README <../../../tools/NESTING/README>`).

OBSTOOLS
--------

A series of Fortran utilities which are helpful in handling observation files and
the feedback file output from the NEMO observation operator.
Further info are available in the :doc:`Nemo manual <cite>`.

REBUILD_NEMO
------------

REBUILD_NEMO is a tool to rebuild NEMO output files from multiple processors
(mesh_mask, restart or XIOS output files) into one file
(see :download:`REBUILD_NEMO README <../../../tools/REBUILD_NEMO/README.rst>`).

REBUILD
-------

It contains the old version of REBUILD_NEMO tool based on the IOIPSL code.

SCOORD_GEN
----------

Offline tool to generate a vertical coordinates input file for use with S coordinates.
This has been carried out by copying the model code to an offline tool and then
modifying it to suppress the use of 3D arrays (to reduce memory usage).
The tool has been created in preparation for the removal of the vertical grid definition from
the code.
The output file should contain all variables that are necessary to restart the model.

SECTIONS_DIADCT
---------------

When the Transport across sections diagnostic is activated (``key_diadct``),
this tool is used to build the binary file containing the pathways between
the extremities of each section.
Further info are available in the :doc:`Nemo manual <cite>`.

SIREN
-----

SIREN is a configuration management tool to set up regional configurations with NEMO
(see :download:`SIREN README <../../../tools/SIREN/README>`).

WEIGHTS
-------

This directory contains software for generating and manipulating interpolation weights for use with
the Interpolation On the Fly (IOF) option in NEMO v3 onwards
(see :download:`WEIGHTS README <../../../tools/WEIGHTS/README>`).

TOYATM
------

This directory contains a simplified model that send/receive atmospheric fields to/from NEMO, for use in the CPL_OASIS sed to test case of the NEMO-OASIS coupling interface.
This toy requires OASIS3-MCT to be installed and properly defined in the arch file.
(see :download:`CPL_OASIS README <../../../tests/CPL_OASIS/README.md>`).

ABL_TOOLS
---------

3 steps to generate atmospheric forcings from ECMWF products for ABL1d model with NEMO:
- main_uvg_hpg (optional): geostrophic wind or horizontal pressure gradient computation on ECMWF eta-levels (to force ABL dynamics)
- main_vinterp: vertical interpolation from ECWMF vertical eta-levels to ABL Z-levels
- main_hdrown: 3D-fields horizontal drowning (extrapolation over land totally inspired from SOSIE by L. Brodeau)
(more details available in Lemarie et al. 2020 GMD)
Note: See TracBrowser for help on using the repository browser.