...
Add a row for your new grid in the appropriate table below
Add the grid files to inputdata/share/meshes following the directions at /wiki/spaces/ED/pages/707002387.
Create a pull request making your grid available. The changes should be limited to what is needed to support the new grid as outlined below.
Modify
cime_config/config_grids.xml
to define the new gridModify
cime_config/config_grids.xml
to specify domain file pathsModify
cime_config/config_grids.xml
to specify mapping file paths (only for bi- and tri-grid)Modify
components/eam/bld/config_files/horiz_grid.xml
to specify the number of columnsModify
components/eam/bld/namelist_files/namelist_defaults_eam.xml
to specify namelist defaults specific to the new grid. Typically values that need new defaults are:ncdata
- the atmospheric initial conditionbnd_topo
- topographydrydep_srf_file
surface dry deposition of aerosols (MAM)mesh_file
- grid definition file in exodus formatse_ne
- set to zero for RRMdtime
- dynamics/physics coupling interval
For certain configurations, especially the older
preqx
dycor option, you may need to modify the following parameters incomponents/eam/bld/namelist_files/namelist_defaults_eam.xml
se_tstep
nu
nu_top
nu_div
hypervis_scaling
hypervis_subcycle_tom
hypervis_subcycle
Modify
components/clm/bld/namelist_files/namelist_defaults_clm4_5.xml
to specify land input files needed for the new grid (may not be needed for scenarios that do modify the land grid)finidat
- land model initial conditionfsurdat
- input data describing surface types
Optional - modify
cime/config/e3sm/allactive/config_pesall.xml
to add a new PE layout for your gridOptional - modify
cime_config/tests.py
to add a test for the new grid. RRM tests should only be added to specific test suites, such ase3sm_rrm
.
Quasi-Uniform cubed-sphere grids (for reference)
Grid | Grid metrics |
---|---|
1 degree (NE=30) | Max Dinv-based element distortion: 1.73 |
1/4 degree (NE=120) | Max Dinv-based element distortion: 1.73 |
3.25 km (NE=1024) | Max Dinv-based element distortion: 1.73 |
Conventional High-Resolution Grids
Grid Name | Target Fine Resolution | Target Coarse Resolution | Goals in mesh creation | Link to mesh graphic | Grid metrics | Validation | Contact Person |
---|---|---|---|---|---|---|---|
v2 North American RRM northamericax4v1.g | atm/land: 25 km (ne120) | atm/land: 100 km (ne30) | See figures in the paper | Max Dinv-based elem distortion: 3.76 | Described in Tang et al., (GMDD 2022) | ||
v2 Antarctic RRM antarcticax4v1.g | atm/land: 25 km (ne120) | atm/land: 100 km (ne30) | TBD | ||||
CONUS Extremes-Optimized RRM (HyperFACETS) | atm/land: 25 km (ne120) | atm/land: 100 km (ne30) | 28km over CONUS and Atlantic TC region; 55km over eastern Pacific to better capture ARs | TBD | |||
arcticx4v1pg2 | atm/land: 25 km (ne120) | atm/land: 100 km (ne30) | elem distortion: 4.26 | TBD |
...