New URL for NEMO forge!   http://forge.nemo-ocean.eu

Since March 2022 along with NEMO 4.2 release, the code development moved to a self-hosted GitLab.
This present forge is now archived and remained online for history.
Changeset 10115 for NEMO/branches/2018/dev_r5003_MERCATOR6_CRS/NEMOGCM/TOOLS/SIREN/src/docsrc/2_quickstart.md – NEMO

Ignore:
Timestamp:
2018-09-12T15:59:13+02:00 (6 years ago)
Author:
cbricaud
Message:

phase 3.6 coarsening branch with nemo_3.6_rev9192

File:
1 edited

Legend:

Unmodified
Added
Removed

  • NEMO/branches/2018/dev_r5003_MERCATOR6_CRS/NEMOGCM/TOOLS/SIREN/src/docsrc/2_quickstart.md

    r7261 r10115  
    5959&namcfg 
    6060   cn_varcfg = "PATH/NEMOGCM/TOOLS/SIREN/cfg/variable.cfg" 
     61   cn_dimcfg = "PATH/NEMOGCM/TOOLS/SIREN/cfg/dimension.cfg" 
    6162/ 
    6263 
    … …  
    8384/ 
    8485~~~~~~~~~~~ 
     86 
     87@note you could define sub domain with coarse grid indices or with coordinates. 
    8588 
    8689Let's get describe this namelist.<br/> 
    … …  
    9093empty, as done here.<br/> This will create a log file named *create_coord.log* 
    9194 
    92 The **namcfg** sub-namelist defines where found SIREN configuration file.<br/> 
    93 This configuration file defines standard name, default interpolation method, 
     95The **namcfg** sub-namelist defines where found SIREN configuration files.<br/> 
     96- The variable configuration file defines standard name, default interpolation method, 
    9497axis,... to be used for some known variables.<br/> 
    9598Obviously, you could add other variables to those already list, in this file. 
    96  
    97 @note You could find the generic version of *variable.cfg* in the directory *NEMOGCM/TOOLS/SIREN/cfg*. 
     99- The dimension configuration file defines dimensions allowed. 
     100 
     101@note You could find the generic version of those configuration files in the directory *NEMOGCM/TOOLS/SIREN/cfg*. 
    98102 
    99103The **namcrs** sub-namelist set parameters of the wide 
    100 coordinates file,<br/> as path to find it, and NEMO periodicity of the wide grid.<br/> 
     104coordinates file, as path to find it, and NEMO periodicity of the wide grid.<br/> 
    101105 
    102106@note the NEMO periodicity could be choose between 0 to 6: 
    … …  
    130134 
    131135The **namnst** sub-namelist defines the subdomain to be used as well as refinment factor.<br/> 
    132 @note Subdomain is defined by indices of the coarse/wide grid.<br/> 
    133136 
    134137<ul> 
    135 <li>you can select area quite every where (excepted too close from the North 
    136 pole), and use the refinment factor you want.</li> 
    137  
    138 ~~~~~~~~~~~ 
    139 &namvar 
     138<li> you could define sub domain with coarse grid indices</li>  
     139 
     140~~~~~~~~~~~ 
     141&namnst 
    140142   in_imin0 = 1070 
    141143   in_imax0 = 1072 
    142144   in_jmin0 = 607 
    143145   in_jmax0 = 609 
     146/ 
     147~~~~~~~~~~~ 
     148 
     149<li>or with coordinates</li> 
     150 
     151~~~~~~~~~~~ 
     152&namnst 
     153   rn_lonmin0 = -97.9  
     154   rn_lonmax0 = -62.3  
     155   rn_latmin0 =   7.7 
     156   rn_latmax0 =  30.8 
     157/ 
     158~~~~~~~~~~~ 
     159 
     160<li>you can select area quite every where (excepted too close from the North 
     161pole), and use the refinment factor you want.</li> 
     162 
     163~~~~~~~~~~~ 
     164&namnst 
     165   in_imin0 = 1070 
     166   in_imax0 = 1072 
     167   in_jmin0 = 607 
     168   in_jmax0 = 609 
    144169 
    145170   in_rhoi = 2 
    … …  
    148173~~~~~~~~~~~ 
    149174@image html grid_zoom_60.png 
    150 @image latex grid_zoom_40.png 
     175<center>@image latex grid_zoom_40.png 
     176</center> 
    151177<!-- @note ghost cells all around the grid are not shown here. --> 
    152178 
     179 
     180 
    153181<li>you can select area crossing the east-west overlap of the global ORCA grid.</li> 
    154182 
    155183~~~~~~~~~~~ 
    156 &namvar           
     184&namnst           
    157185   in_imin0 = 1402  
    158186   in_imax0 = 62 
    … …  
    165193~~~~~~~~~~~ 
    166194@image html grid_glob_over_30.png 
    167 @image latex grid_glob_over_20.png 
     195<center>@image latex grid_glob_over_20.png 
     196</center> 
    168197<!-- @note in blue, the east-west overlap band of ORCA grid. --> 
    169198 
    … …  
    171200 
    172201~~~~~~~~~~~ 
    173 &namvar 
     202&namnst 
    174203   in_imin0 = 0 
    175204   in_imax0 = 0 
    … …  
    182211~~~~~~~~~~~ 
    183212@image html grid_glob_band_30.png 
    184 @image latex grid_glob_band_20.png 
     213<center>@image latex grid_glob_band_20.png 
     214</center> 
    185215 
    186216</ul> 
    … …  
    215245&namcfg 
    216246   cn_varcfg = "PATH/NEMOGCM/TOOLS/SIREN/cfg/variable.cfg" 
     247   cn_dimcfg = "PATH/NEMOGCM/TOOLS/SIREN/cfg/dimension.cfg" 
    217248/ 
    218249 
    … …  
    249280coordinates file.<br/> 
    250281@note in all SIREN namelist: <br/> 
    251 0 referred to the coarse/wide grid.<br/> 
    252 1 referred to the fine grid. 
     282**0** referred to the coarse/wide grid.<br/> 
     283**1** referred to the fine grid. 
    253284 
    254285In the same way, the **namfin** sub-namelist  set parameters of the fine 
    255286coordinates file.<br/> 
    256287@note in this namelist example, there is no need to set the variable *in_perio1* to define the NEMO 
    257 periodicity of the fine grid.<br/> Indeed, if this variable is not inform, SIREN tries to read it in the attributes of the file.<br/>  
    258 So if you created the fine coordinates with SIREN, you do not have to 
     288periodicity of the fine grid. Indeed, if this variable is not inform, SIREN tries to read it  
     289in the global attributes of the file. So if you created the fine coordinates with SIREN, you do not have to 
    259290fill it. In other case, you should add it to the namelist. 
    260291 
    … …  
    296327# Merge bathymetry file # {#merge} 
    297328 
    298 The Bathymetry you build differs from the wider one.<br/> 
     329The Bathymetry you build, may differ from the wider one.<br/> 
    299330To avoid issue with boundaries forcing fields, you should merge fine and coarse Bathymetry on boundaries.<br/> 
    300331SIREN allows you to do this.<br/> 
    … …  
    312343&namcfg 
    313344   cn_varcfg = "PATH/NEMOGCM/TOOLS/SIREN/cfg/variable.cfg" 
     345   cn_dimcfg = "PATH/NEMOGCM/TOOLS/SIREN/cfg/dimension.cfg" 
    314346/ 
    315347 
    … …  
    348380 
    349381The **nambdy** sub-namelist defines the subdomain boundaries.<br/> 
    350 By default SIREN tries to create boundaries for each side. Boundary exist if there is at least one sea point on the second row of each side.<br/> 
    351 So you could let this namelist empty. 
    352  
     382By default SIREN tries to create boundaries for each side. Boundary exist if there is at least one sea point on the second row of each side. So you could let this namelist empty. 
    353383@sa For more information about boundaries, see @ref boundary 
    354384 
    … …  
    365395time step). Or you could start from "partial" information about ocean state (Temperature and Salinity for example). 
    366396 
    367 Siren allows you to create both of those initial state.<br/> 
     397SIREN allows you to create both of those initial state.<br/> 
    368398To create the initial state, you have to run:<br/> 
    369399~~~~~~~~~~~~~~~~~~ 
    … …  
    372402 
    373403Here after is an example of namelist for *create_restart.exe*.<br/> 
    374 In this example, you create an initial state split on 81 "processors", and named restar_out.nc.<br/> 
     404In this example, you create an initial state split on 81 "processors", and named restart_out.nc.<br/> 
    375405The initial state is composed of temperature and salinity refined from an extraction of GLORYS fields. 
    376406~~~~~~~~~~~~~~~~~~ 
    … …  
    380410&namcfg 
    381411   cn_varcfg = "PATH/NEMOGCM/TOOLS/SIREN/cfg/variable.cfg" 
     412   cn_dimcfg = "PATH/NEMOGCM/TOOLS/SIREN/cfg/dimension.cfg" 
    382413/ 
    383414 
    … …  
    479510&namcfg 
    480511   cn_varcfg = "PATH/NEMOGCM/TOOLS/SIREN/cfg/variable.cfg" 
     512   cn_dimcfg = "PATH/NEMOGCM/TOOLS/SIREN/cfg/dimension.cfg" 
    481513/ 
    482514 
Note: See TracChangeset for help on using the changeset viewer.