Tools

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:

$ ./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 resto.nc containing restoration coefficients for use with the tra_dmp module in NEMO (see DMP_TOOLS README).

DOMAINcfg

A toolbox allowing the creation of regional configurations from curvilinear grid (see DOMAINcfg README).

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 GRIDGEN documentation).

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 MPP_PREP documentation and MPP_PREP archive).

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 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 Nemo manual.

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 REBUILD_NEMO README).

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 Nemo manual.

SIREN

SIREN is a configuration management tool to set up regional configurations with NEMO (see 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 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 CPL_OASIS README).

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)