[10598] | 1 | ***** |
---|
| 2 | Tools |
---|
| 3 | ***** |
---|
[10279] | 4 | |
---|
[11736] | 5 | .. todo:: |
---|
| 6 | |
---|
[11751] | 7 | The 'Tools' chapter needs to be enriched |
---|
[11736] | 8 | |
---|
[10279] | 9 | .. contents:: |
---|
[11736] | 10 | :local: |
---|
[11751] | 11 | :depth: 1 |
---|
[10279] | 12 | |
---|
[10561] | 13 | A set of tools is provided with NEMO to setup user own configuration and (pre|post)process data. |
---|
[10279] | 14 | |
---|
[11751] | 15 | How to compile a tool |
---|
| 16 | ===================== |
---|
[10279] | 17 | |
---|
[10561] | 18 | The tool can be compiled using the maketools script in the tools directory as follows: |
---|
[10279] | 19 | |
---|
[10561] | 20 | .. code-block:: console |
---|
[10563] | 21 | |
---|
[11751] | 22 | $ ./maketools -m 'my_arch' -n '<TOOL_NAME>' |
---|
[10279] | 23 | |
---|
[11751] | 24 | where ``my_arch`` can be selected among available architecture files or providing a user defined one. |
---|
[10279] | 25 | |
---|
[11751] | 26 | List of tools |
---|
| 27 | ============= |
---|
| 28 | |
---|
[10565] | 29 | BDY_TOOLS |
---|
| 30 | --------- |
---|
| 31 | |
---|
[11751] | 32 | It contains the utility *bdy_reorder* used to reorder old BDY data files used with |
---|
| 33 | previous versions of the model (before 3.4) to make them compatible with NEMO 3.4. |
---|
[10565] | 34 | |
---|
[10561] | 35 | DMP_TOOLS |
---|
| 36 | --------- |
---|
[10279] | 37 | |
---|
[11751] | 38 | Used to create a netcdf file called :file:`resto.nc` containing |
---|
| 39 | restoration coefficients for use with the :file:`tra_dmp` module in NEMO |
---|
| 40 | (see :download:`DMP_TOOLS README <../../../tools/DMP_TOOLS/README>`). |
---|
[10279] | 41 | |
---|
[10561] | 42 | DOMAINcfg |
---|
| 43 | --------- |
---|
[13246] | 44 | A toolbox allowing the creation of regional configurations from curvilinear grid |
---|
| 45 | (see :download:`DOMAINcfg README <../../../tools/DOMAINcfg/README.rst>`). |
---|
[10279] | 46 | |
---|
[13246] | 47 | GRIDGEN |
---|
| 48 | ------- |
---|
[11751] | 49 | This tool allows the creation of a domain configuration file (``domain_cfg.nc``) containing |
---|
| 50 | the ocean domain information required to define an ocean configuration from scratch. |
---|
| 51 | (see :download:`GRIDGEN documentation <../../../tools/GRIDGEN/doc_cfg_tools.pdf>`). |
---|
[10279] | 52 | |
---|
[10561] | 53 | MISCELLANEOUS |
---|
| 54 | ------------- |
---|
[10279] | 55 | |
---|
[11751] | 56 | The tool allows to create alternative configurations to the community without |
---|
| 57 | having to rely on system team sponsorship and support. |
---|
[10279] | 58 | |
---|
[10561] | 59 | MPP_PREP |
---|
| 60 | -------- |
---|
[10279] | 61 | |
---|
[10561] | 62 | This tool provides the user with information to choose the best domain decomposition. |
---|
[11751] | 63 | The tool computes the number of water processors for all possible decompositions, |
---|
| 64 | up to a maximum number of processors |
---|
| 65 | (see :download:`MPP_PREP documentation <../../../tools/MPP_PREP/mpp_nc.pdf>` and |
---|
| 66 | :download:`MPP_PREP archive <../../../tools/MPP_PREP/mpp_prep-1.0.tar.gz>`). |
---|
[10279] | 67 | |
---|
[10561] | 68 | NESTING |
---|
| 69 | ------- |
---|
[10279] | 70 | |
---|
[11751] | 71 | AGRIF nesting tool allows for the seamless two-way coupling of nested sub-models within |
---|
| 72 | the NEMO framework as long as these are defined on subsets of the original root grid. |
---|
| 73 | It allows to create the grid coordinates, the surface forcing and the initial conditions required by |
---|
| 74 | each sub-model when running a NEMO/AGRIF embedded mode |
---|
| 75 | (see :download:`NESTING README <../../../tools/NESTING/README>`). |
---|
[10279] | 76 | |
---|
[10561] | 77 | OBSTOOLS |
---|
| 78 | -------- |
---|
[10279] | 79 | |
---|
[11751] | 80 | A series of Fortran utilities which are helpful in handling observation files and |
---|
| 81 | the feedback file output from the NEMO observation operator. |
---|
| 82 | Further info are available in the :doc:`Nemo manual <cite>`. |
---|
[10561] | 83 | |
---|
| 84 | REBUILD_NEMO |
---|
| 85 | ------------ |
---|
| 86 | |
---|
[11751] | 87 | REBUILD_NEMO is a tool to rebuild NEMO output files from multiple processors |
---|
| 88 | (mesh_mask, restart or XIOS output files) into one file |
---|
| 89 | (see :download:`REBUILD_NEMO README <../../../tools/REBUILD_NEMO/README.rst>`). |
---|
[10561] | 90 | |
---|
| 91 | REBUILD |
---|
| 92 | ------- |
---|
| 93 | |
---|
| 94 | It contains the old version of REBUILD_NEMO tool based on the IOIPSL code. |
---|
| 95 | |
---|
| 96 | SCOORD_GEN |
---|
| 97 | ---------- |
---|
| 98 | |
---|
[11751] | 99 | Offline tool to generate a vertical coordinates input file for use with S coordinates. |
---|
| 100 | This has been carried out by copying the model code to an offline tool and then |
---|
| 101 | modifying it to suppress the use of 3D arrays (to reduce memory usage). |
---|
| 102 | The tool has been created in preparation for the removal of the vertical grid definition from |
---|
| 103 | the code. |
---|
| 104 | The output file should contain all variables that are necessary to restart the model. |
---|
[10561] | 105 | |
---|
| 106 | SECTIONS_DIADCT |
---|
| 107 | --------------- |
---|
| 108 | |
---|
[11751] | 109 | When the Transport across sections diagnostic is activated (``key_diadct``), |
---|
| 110 | this tool is used to build the binary file containing the pathways between |
---|
| 111 | the extremities of each section. |
---|
| 112 | Further info are available in the :doc:`Nemo manual <cite>`. |
---|
[10561] | 113 | |
---|
| 114 | SIREN |
---|
| 115 | ----- |
---|
| 116 | |
---|
[11751] | 117 | SIREN is a configuration management tool to set up regional configurations with NEMO |
---|
| 118 | (see :download:`SIREN README <../../../tools/SIREN/README>`). |
---|
[10561] | 119 | |
---|
| 120 | WEIGHTS |
---|
| 121 | ------- |
---|
| 122 | |
---|
[11751] | 123 | This directory contains software for generating and manipulating interpolation weights for use with |
---|
| 124 | the Interpolation On the Fly (IOF) option in NEMO v3 onwards |
---|
| 125 | (see :download:`WEIGHTS README <../../../tools/WEIGHTS/README>`). |
---|
[10619] | 126 | |
---|
| 127 | TOYATM |
---|
| 128 | ------ |
---|
| 129 | |
---|
[13246] | 130 | 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. |
---|
[11751] | 131 | This toy requires OASIS3-MCT to be installed and properly defined in the arch file. |
---|
[13246] | 132 | (see :download:`CPL_OASIS README <../../../tests/CPL_OASIS/README.md>`). |
---|
[13203] | 133 | |
---|
| 134 | ABL_TOOLS |
---|
| 135 | --------- |
---|
| 136 | |
---|
| 137 | 3 steps to generate atmospheric forcings from ECMWF products for ABL1d model with NEMO: |
---|
| 138 | - main_uvg_hpg (optional): geostrophic wind or horizontal pressure gradient computation on ECMWF eta-levels (to force ABL dynamics) |
---|
| 139 | - main_vinterp: vertical interpolation from ECWMF vertical eta-levels to ABL Z-levels |
---|
| 140 | - main_hdrown: 3D-fields horizontal drowning (extrapolation over land totally inspired from SOSIE by L. Brodeau) |
---|
| 141 | (more details available in Lemarie et al. 2020 GMD) |
---|