Changeset 11435 for NEMO/trunk/doc/latex/NEMO/subfiles/chap_CONFIG.tex
- Timestamp:
- 2019-08-14T14:45:08+02:00 (5 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
NEMO/trunk/doc/latex/NEMO/subfiles/chap_CONFIG.tex
r11214 r11435 8 8 \label{chap:CFG} 9 9 10 \ minitoc10 \chaptertoc 11 11 12 12 \newpage … … 18 18 \label{sec:CFG_intro} 19 19 20 The purpose of this part of the manual is to introduce the NEMOreference configurations.20 The purpose of this part of the manual is to introduce the \NEMO\ reference configurations. 21 21 These configurations are offered as means to explore various numerical and physical options, 22 22 thus allowing the user to verify that the code is performing in a manner consistent with that we are running. … … 24 24 The reference configurations also provide a sense for some of the options available in the code, 25 25 though by no means are all options exercised in the reference configurations. 26 Configuration is defined manually through the \ textit{namcfg} namelist variables.26 Configuration is defined manually through the \nam{cfg} namelist variables. 27 27 28 28 %------------------------------------------namcfg---------------------------------------------------- … … 38 38 \label{sec:CFG_c1d} 39 39 40 The 1D model option simulates a stand alone water column within the 3D NEMOsystem.40 The 1D model option simulates a stand alone water column within the 3D \NEMO\ system. 41 41 It can be applied to the ocean alone or to the ocean-ice system and can include passive tracers or a biogeochemical model. 42 42 It is set up by defining the position of the 1D water column in the grid 43 (see \ textit{cfgs/SHARED/namelist\_ref}).43 (see \path{./cfgs/SHARED/namelist\_ref}). 44 44 The 1D model is a very useful tool 45 45 \textit{(a)} to learn about the physics and numerical treatment of vertical mixing processes; … … 54 54 55 55 The 1D model has some specifies. First, all the horizontal derivatives are assumed to be zero, 56 and second, the two components of the velocity are moved on a $T$-point. 57 Therefore, defining \key{c1d} changes some things in the code behaviour: 56 and second, the two components of the velocity are moved on a $T$-point. 57 Therefore, defining \key{c1d} changes some things in the code behaviour: 58 58 \begin{description} 59 59 \item[(1)] … … 68 68 \end{description} 69 69 All the relevant \textit{\_c1d} modules can be found in the src/OCE/C1D directory of 70 the NEMOdistribution.70 the \NEMO\ distribution. 71 71 72 72 % to be added: a test case on the yearlong Ocean Weather Station (OWS) Papa dataset of Martin (1985) … … 80 80 The ORCA family is a series of global ocean configurations that are run together with 81 81 the SI3 model (ORCA-ICE) and possibly with PISCES biogeochemical model (ORCA-ICE-PISCES). 82 An appropriate namelist is available in \path{ cfgs/ORCA2_ICE_PISCES/EXPREF/namelist_cfg} for ORCA2.82 An appropriate namelist is available in \path{./cfgs/ORCA2_ICE_PISCES/EXPREF/namelist_cfg} for ORCA2. 83 83 The domain of ORCA2 configuration is defined in \ifile{ORCA\_R2\_zps\_domcfg} file, 84 this file is available in tar file on the NEMOcommunity zenodo platform: \\84 this file is available in tar file on the \NEMO\ community zenodo platform: \\ 85 85 https://doi.org/10.5281/zenodo.2640723 86 86 87 In this namelist\_cfg the name of domain input file is set in \n gn{namcfg} block of namelist.87 In this namelist\_cfg the name of domain input file is set in \nam{cfg} block of namelist. 88 88 89 89 %>>>>>>>>>>>>>>>>>>>>>>>>>>>> … … 118 118 (\autoref{fig:MISC_ORCA_msh}). 119 119 The resulting mesh presents no loss of continuity in either the mesh lines or the scale factors, 120 or even the scale factor derivatives over the whole ocean domain, as the mesh is not a composite mesh. 120 or even the scale factor derivatives over the whole ocean domain, as the mesh is not a composite mesh. 121 121 %>>>>>>>>>>>>>>>>>>>>>>>>>>>> 122 122 \begin{figure}[!tbp] … … 137 137 %>>>>>>>>>>>>>>>>>>>>>>>>>>>> 138 138 139 The method is applied to Mercator grid (\ie same zonal and meridional grid spacing) poleward of 20\deg{N},139 The method is applied to Mercator grid (\ie\ same zonal and meridional grid spacing) poleward of 20\deg{N}, 140 140 so that the Equator is a mesh line, which provides a better numerical solution for equatorial dynamics. 141 141 The choice of the series of embedded ellipses (position of the foci and variation of the ellipses) … … 146 146 a half a degree grid (ORCA\_R05). 147 147 The smallest ocean scale factor is found in along Antarctica, 148 while the ratio of anisotropy remains close to one except near the Victoria Island in the Canadian Archipelago. 148 while the ratio of anisotropy remains close to one except near the Victoria Island in the Canadian Archipelago. 149 149 150 150 % ------------------------------------------------------------------------------------------------------------- … … 154 154 \label{subsec:CFG_orca_resolution} 155 155 156 The NEMOsystem is provided with five built-in ORCA configurations which differ in the horizontal resolution.156 The \NEMO\ system is provided with five built-in ORCA configurations which differ in the horizontal resolution. 157 157 The value of the resolution is given by the resolution at the Equator expressed in degrees. 158 158 Each of configuration is set through the \textit{domain\_cfg} domain configuration file, 159 159 which sets the grid size and configuration name parameters. 160 The NEMOSystem Team provides only ORCA2 domain input file "\ifile{ORCA\_R2\_zps\_domcfg}" file161 ( Tab.\autoref{tab:ORCA}).160 The \NEMO\ System Team provides only ORCA2 domain input file "\ifile{ORCA\_R2\_zps\_domcfg}" file 161 (\autoref{tab:ORCA}). 162 162 163 163 %--------------------------------------------------TABLE-------------------------------------------------- … … 165 165 \begin{center} 166 166 \begin{tabular}{p{4cm} c c c c} 167 Horizontal Grid & \np{ORCA\_index} & \np{jpiglo} & \np{jpjglo} & \\ 168 \hline 169 \hline 170 \~4\deg & 4 & 92 & 76 & \\ 171 \~2\deg & 2 & 182 & 149 & \\ 172 \~1\deg & 1 & 362 & 292 & \\ 173 \~0.5\deg & 05 & 722 & 511 & \\ 174 \~0.25\deg & 025 & 1442 & 1021 & \\ 175 % \key{orca\_r8} & 8 & 2882 & 2042 & \\ 176 % \key{orca\_r12} & 12 & 4322 & 3062 & \\ 177 \hline 178 \hline 167 Horizontal Grid & \jp{ORCA\_index} & \jp{jpiglo} & \jp{jpjglo} \\ 168 \hline \hline 169 % 4 \deg & 4 & 92 & 76 \\ 170 2 \deg & 2 & 182 & 149 \\ 171 1 \deg & 1 & 362 & 292 \\ 172 0.5 \deg & 05 & 722 & 511 \\ 173 0.25\deg & 025 & 1442 & 1021 \\ 174 \hline \hline 179 175 \end{tabular} 180 176 \caption{ … … 198 194 Note that the tropical mesh refinements in ORCA\_R2 and R1 strongly increases the mesh anisotropy there. 199 195 200 The ORCA\_R05 and higher global configurations do not incorporate any regional refinements. 196 The ORCA\_R05 and higher global configurations do not incorporate any regional refinements. 201 197 202 198 For ORCA\_R1 and R025, setting the configuration key to 75 allows to use 75 vertical levels, otherwise 46 are used. … … 204 200 (see \autoref{tab:orca_zgr}). %\sfcomment{HERE I need to put new table for ORCA2 values} and \autoref{fig:zgr}). 205 201 206 Only the ORCA\_R2 is provided with all its input files in the NEMOdistribution.202 Only the ORCA\_R2 is provided with all its input files in the \NEMO\ distribution. 207 203 %It is very similar to that used as part of the climate model developed at IPSL for the 4th IPCC assessment of 208 204 %climate change (Marti et al., 2009). 209 %It is also the basis for the \NEMO contribution to the Coordinate Ocean-ice Reference Experiments (COREs)210 %documented in \citet{griffies.biastoch.ea_OM09}. 205 %It is also the basis for the \NEMO\ contribution to the Coordinate Ocean-ice Reference Experiments (COREs) 206 %documented in \citet{griffies.biastoch.ea_OM09}. 211 207 212 208 This version of ORCA\_R2 has 31 levels in the vertical, with the highest resolution (10m) in the upper 150m 213 (see \autoref{tab:orca_zgr} and \autoref{fig:zgr}). 214 The bottom topography and the coastlines are derived from the global atlas of Smith and Sandwell (1997). 215 The default forcing uses the boundary forcing from \citet{large.yeager_rpt04} (see \autoref{subsec:SBC_blk_core}), 209 (see \autoref{tab:orca_zgr} and \autoref{fig:zgr}). 210 The bottom topography and the coastlines are derived from the global atlas of Smith and Sandwell (1997). 211 The default forcing uses the boundary forcing from \citet{large.yeager_rpt04} (see \autoref{subsec:SBC_blk_core}), 216 212 which was developed for the purpose of running global coupled ocean-ice simulations without 217 213 an interactive atmosphere. 218 214 This \citet{large.yeager_rpt04} dataset is available through 219 215 the \href{http://nomads.gfdl.noaa.gov/nomads/forms/mom4/CORE.html}{GFDL web site}. 220 The "normal year" of \citet{large.yeager_rpt04} has been chosen of the NEMO distribution since release v3.3. 221 222 ORCA\_R2 pre-defined configuration can also be run with multiply online nested zooms (\ie with AGRIF, \key{agrif} defined). This is available as the AGRIF\_DEMO configuration that can be found in the \path{cfgs/AGRIF_DEMO/} directory. 216 The "normal year" of \citet{large.yeager_rpt04} has been chosen of the \NEMO\ distribution since release v3.3. 217 218 ORCA\_R2 pre-defined configuration can also be run with multiply online nested zooms (\ie\ with AGRIF, \key{agrif} defined). 219 This is available as the AGRIF\_DEMO configuration that can be found in the \path{./cfgs/AGRIF_DEMO/} directory. 223 220 224 221 A regional Arctic or peri-Antarctic configuration is extracted from an ORCA\_R2 or R05 configurations using 225 sponge layers at open boundaries. 222 sponge layers at open boundaries. 226 223 227 224 % ------------------------------------------------------------------------------------------------------------- … … 236 233 \citet{hazeleger.drijfhout_JPO98, hazeleger.drijfhout_JPO99, hazeleger.drijfhout_JGR00, hazeleger.drijfhout_JPO00}, 237 234 over which an analytical seasonal forcing is applied. 238 This allows to investigate the spontaneous generation of a large number of interacting, transient mesoscale eddies 239 and their contribution to the large scale circulation. 235 This allows to investigate the spontaneous generation of a large number of interacting, transient mesoscale eddies 236 and their contribution to the large scale circulation. 240 237 241 238 The GYRE configuration run together with the PISCES biogeochemical model (GYRE-PISCES). … … 245 242 The configuration is meant to represent an idealized North Atlantic or North Pacific basin. 246 243 The circulation is forced by analytical profiles of wind and buoyancy fluxes. 247 The applied forcings vary seasonally in a sinusoidal manner between winter and summer extrema \citep{levy.klein.ea_OM10}. 244 The applied forcings vary seasonally in a sinusoidal manner between winter and summer extrema \citep{levy.klein.ea_OM10}. 248 245 The wind stress is zonal and its curl changes sign at 22\deg{N} and 36\deg{N}. 249 246 It forces a subpolar gyre in the north, a subtropical gyre in the wider part of the domain and … … 257 254 258 255 The GYRE configuration is set like an analytical configuration. 259 Through \np{ln\_read\_cfg}\forcode{ = .false.} in \ textit{namcfg} namelist defined in260 the reference configuration \path{ cfgs/GYRE_PISCES/EXPREF/namelist_cfg}256 Through \np{ln\_read\_cfg}\forcode{ = .false.} in \nam{cfg} namelist defined in 257 the reference configuration \path{./cfgs/GYRE_PISCES/EXPREF/namelist_cfg} 261 258 analytical definition of grid in GYRE is done in usrdef\_hrg, usrdef\_zgr routines. 262 259 Its horizontal resolution (and thus the size of the domain) is determined by 263 setting \np{nn\_GYRE} in \n gn{namusr\_def}: \\264 265 \ np{jpiglo} $= 30 \times$ \np{nn\_GYRE} + 2 \\266 267 \ np{jpjglo} $= 20 \times$ \np{nn\_GYRE} + 2 \\260 setting \np{nn\_GYRE} in \nam{usr\_def}: \\ 261 262 \jp{jpiglo} $= 30 \times$ \np{nn\_GYRE} + 2 \\ 263 264 \jp{jpjglo} $= 20 \times$ \np{nn\_GYRE} + 2 \\ 268 265 269 266 Obviously, the namelist parameters have to be adjusted to the chosen resolution, 270 see the Configurations pages on the NEMO web site (NEMOConfigurations).267 see the Configurations pages on the \NEMO\ web site (\NEMO\ Configurations). 271 268 In the vertical, GYRE uses the default 30 ocean levels (\jp{jpk}\forcode{ = 31}) (\autoref{fig:zgr}). 272 269 … … 275 272 For example, keeping a same model size on each processor while increasing the number of processor used is very easy, 276 273 even though the physical integrity of the solution can be compromised. 277 Benchmark is activate via \np{ln\_bench}\forcode{ = .true.} in \n gn{namusr\_def} in278 namelist \path{ cfgs/GYRE_PISCES/EXPREF/namelist_cfg}.274 Benchmark is activate via \np{ln\_bench}\forcode{ = .true.} in \nam{usr\_def} in 275 namelist \path{./cfgs/GYRE_PISCES/EXPREF/namelist_cfg}. 279 276 280 277 %>>>>>>>>>>>>>>>>>>>>>>>>>>>> … … 299 296 The AMM, Atlantic Margins Model, is a regional model covering the Northwest European Shelf domain on 300 297 a regular lat-lon grid at approximately 12km horizontal resolution. 301 The appropriate \textit{\&namcfg} namelist is available in \ textit{cfgs/AMM12/EXPREF/namelist\_cfg}.298 The appropriate \textit{\&namcfg} namelist is available in \path{./cfgs/AMM12/EXPREF/namelist\_cfg}. 302 299 It is used to build the correct dimensions of the AMM domain. 303 300 304 This configuration tests several features of NEMOfunctionality specific to the shelf seas.301 This configuration tests several features of \NEMO\ functionality specific to the shelf seas. 305 302 In particular, the AMM uses $s$-coordinates in the vertical rather than $z$-coordinates and 306 303 is forced with tidal lateral boundary conditions using a Flather boundary condition from the BDY module.
Note: See TracChangeset
for help on using the changeset viewer.