1 | ***** |
---|
2 | Tools |
---|
3 | ***** |
---|
4 | |
---|
5 | .. todo:: |
---|
6 | |
---|
7 | The 'Tools' chapter needs to be enriched |
---|
8 | |
---|
9 | .. contents:: |
---|
10 | :local: |
---|
11 | :depth: 1 |
---|
12 | |
---|
13 | A set of tools is provided with NEMO to setup user own configuration and (pre|post)process data. |
---|
14 | |
---|
15 | How to compile a tool |
---|
16 | ===================== |
---|
17 | |
---|
18 | The tool can be compiled using the maketools script in the tools directory as follows: |
---|
19 | |
---|
20 | .. code-block:: console |
---|
21 | |
---|
22 | $ ./maketools -m 'my_arch' -n '<TOOL_NAME>' |
---|
23 | |
---|
24 | where ``my_arch`` can be selected among available architecture files or providing a user defined one. |
---|
25 | |
---|
26 | List of tools |
---|
27 | ============= |
---|
28 | |
---|
29 | BDY_TOOLS |
---|
30 | --------- |
---|
31 | |
---|
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. |
---|
34 | |
---|
35 | DMP_TOOLS |
---|
36 | --------- |
---|
37 | |
---|
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>`). |
---|
41 | |
---|
42 | DOMAINcfg |
---|
43 | --------- |
---|
44 | A toolbox allowing the creation of regional configurations from curvilinear grid |
---|
45 | (see :download:`DOMAINcfg README <../../../tools/DOMAINcfg/README.rst>`). |
---|
46 | |
---|
47 | GRIDGEN |
---|
48 | ------- |
---|
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>`). |
---|
52 | |
---|
53 | MISCELLANEOUS |
---|
54 | ------------- |
---|
55 | |
---|
56 | The tool allows to create alternative configurations to the community without |
---|
57 | having to rely on system team sponsorship and support. |
---|
58 | |
---|
59 | MPP_PREP |
---|
60 | -------- |
---|
61 | |
---|
62 | This tool provides the user with information to choose the best domain decomposition. |
---|
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>`). |
---|
67 | |
---|
68 | NESTING |
---|
69 | ------- |
---|
70 | |
---|
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>`). |
---|
76 | |
---|
77 | OBSTOOLS |
---|
78 | -------- |
---|
79 | |
---|
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>`. |
---|
83 | |
---|
84 | REBUILD_NEMO |
---|
85 | ------------ |
---|
86 | |
---|
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>`). |
---|
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 | |
---|
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. |
---|
105 | |
---|
106 | SECTIONS_DIADCT |
---|
107 | --------------- |
---|
108 | |
---|
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>`. |
---|
113 | |
---|
114 | SIREN |
---|
115 | ----- |
---|
116 | |
---|
117 | SIREN is a configuration management tool to set up regional configurations with NEMO |
---|
118 | (see :download:`SIREN README <../../../tools/SIREN/README>`). |
---|
119 | |
---|
120 | WEIGHTS |
---|
121 | ------- |
---|
122 | |
---|
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>`). |
---|
126 | |
---|
127 | TOYATM |
---|
128 | ------ |
---|
129 | |
---|
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. |
---|
131 | This toy requires OASIS3-MCT to be installed and properly defined in the arch file. |
---|
132 | (see :download:`CPL_OASIS README <../../../tests/CPL_OASIS/README.md>`). |
---|
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) |
---|