[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 | --------- |
---|
[10279] | 44 | |
---|
[11751] | 45 | This tool allows the creation of a domain configuration file (``domain_cfg.nc``) containing |
---|
| 46 | the ocean domain information required to define an ocean configuration from scratch. |
---|
| 47 | (see :download:`DOMAINcfg README <../../../tools/DOMAINcfg/README>`). |
---|
[10279] | 48 | |
---|
[10561] | 49 | GRIDGEN |
---|
| 50 | ------- |
---|
[10279] | 51 | |
---|
[11751] | 52 | A toolbox allowing the creation of regional configurations from curvilinear grid |
---|
| 53 | (see :download:`GRIDGEN documentation <../../../tools/GRIDGEN/doc_cfg_tools.pdf>`). |
---|
[10279] | 54 | |
---|
[10561] | 55 | MISCELLANEOUS |
---|
| 56 | ------------- |
---|
[10279] | 57 | |
---|
[11751] | 58 | The tool allows to create alternative configurations to the community without |
---|
| 59 | having to rely on system team sponsorship and support. |
---|
[10279] | 60 | |
---|
[10561] | 61 | MPP_PREP |
---|
| 62 | -------- |
---|
[10279] | 63 | |
---|
[10561] | 64 | This tool provides the user with information to choose the best domain decomposition. |
---|
[11751] | 65 | The tool computes the number of water processors for all possible decompositions, |
---|
| 66 | up to a maximum number of processors |
---|
| 67 | (see :download:`MPP_PREP documentation <../../../tools/MPP_PREP/mpp_nc.pdf>` and |
---|
| 68 | :download:`MPP_PREP archive <../../../tools/MPP_PREP/mpp_prep-1.0.tar.gz>`). |
---|
[10279] | 69 | |
---|
[10561] | 70 | NESTING |
---|
| 71 | ------- |
---|
[10279] | 72 | |
---|
[11751] | 73 | AGRIF nesting tool allows for the seamless two-way coupling of nested sub-models within |
---|
| 74 | the NEMO framework as long as these are defined on subsets of the original root grid. |
---|
| 75 | It allows to create the grid coordinates, the surface forcing and the initial conditions required by |
---|
| 76 | each sub-model when running a NEMO/AGRIF embedded mode |
---|
| 77 | (see :download:`NESTING README <../../../tools/NESTING/README>`). |
---|
[10279] | 78 | |
---|
[10561] | 79 | OBSTOOLS |
---|
| 80 | -------- |
---|
[10279] | 81 | |
---|
[11751] | 82 | A series of Fortran utilities which are helpful in handling observation files and |
---|
| 83 | the feedback file output from the NEMO observation operator. |
---|
| 84 | Further info are available in the :doc:`Nemo manual <cite>`. |
---|
[10561] | 85 | |
---|
| 86 | REBUILD_NEMO |
---|
| 87 | ------------ |
---|
| 88 | |
---|
[11751] | 89 | REBUILD_NEMO is a tool to rebuild NEMO output files from multiple processors |
---|
| 90 | (mesh_mask, restart or XIOS output files) into one file |
---|
| 91 | (see :download:`REBUILD_NEMO README <../../../tools/REBUILD_NEMO/README.rst>`). |
---|
[10561] | 92 | |
---|
| 93 | REBUILD |
---|
| 94 | ------- |
---|
| 95 | |
---|
| 96 | It contains the old version of REBUILD_NEMO tool based on the IOIPSL code. |
---|
| 97 | |
---|
| 98 | SCOORD_GEN |
---|
| 99 | ---------- |
---|
| 100 | |
---|
[11751] | 101 | Offline tool to generate a vertical coordinates input file for use with S coordinates. |
---|
| 102 | This has been carried out by copying the model code to an offline tool and then |
---|
| 103 | modifying it to suppress the use of 3D arrays (to reduce memory usage). |
---|
| 104 | The tool has been created in preparation for the removal of the vertical grid definition from |
---|
| 105 | the code. |
---|
| 106 | The output file should contain all variables that are necessary to restart the model. |
---|
[10561] | 107 | |
---|
| 108 | SECTIONS_DIADCT |
---|
| 109 | --------------- |
---|
| 110 | |
---|
[11751] | 111 | When the Transport across sections diagnostic is activated (``key_diadct``), |
---|
| 112 | this tool is used to build the binary file containing the pathways between |
---|
| 113 | the extremities of each section. |
---|
| 114 | Further info are available in the :doc:`Nemo manual <cite>`. |
---|
[10561] | 115 | |
---|
| 116 | SIREN |
---|
| 117 | ----- |
---|
| 118 | |
---|
[11751] | 119 | SIREN is a configuration management tool to set up regional configurations with NEMO |
---|
| 120 | (see :download:`SIREN README <../../../tools/SIREN/README>`). |
---|
[10561] | 121 | |
---|
| 122 | WEIGHTS |
---|
| 123 | ------- |
---|
| 124 | |
---|
[11751] | 125 | This directory contains software for generating and manipulating interpolation weights for use with |
---|
| 126 | the Interpolation On the Fly (IOF) option in NEMO v3 onwards |
---|
| 127 | (see :download:`WEIGHTS README <../../../tools/WEIGHTS/README>`). |
---|
[10619] | 128 | |
---|
| 129 | TOYATM |
---|
| 130 | ------ |
---|
| 131 | |
---|
[11751] | 132 | This directory contains a simplified model that send/receive atmospheric fields to/from NEMO. |
---|
| 133 | Used to test the coupling interface. |
---|
| 134 | This toy requires OASIS3-MCT to be installed and properly defined in the arch file. |
---|