This page collects well-tested RRM configurations produced for E3SM which others might want to use.
...
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) | Max Dinv-based elem distortion: 3.25 | TBD | |||
CONUS Extremes-Optimized RRM (HyperFACETS) ne0np4natlanticref.ne30x4.g (???) Not on E3SM inputdata server | 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 | elem distortion: 3.35 | TBD | ||
arcticx4v1pg2 | atm/land: 25 km (ne120) | atm/land: 100 km (ne30) | elem distortion: 4.26 | TBD |
Storm-Resolving Grids
Grid Name | Target Fine Resolution | Target Coarse Resolution | Goals in mesh creation | Link to mesh graphic | grid quality metric | Validation | Contact Person |
---|---|---|---|---|---|---|---|
CONUS ref(100W,40N) CONUS_ne32x4_lon100W_lat40N.g (no on E3SM inputdata server) | 28 km (ne128), 14 km (ne256), 7km (ne512), 3.5 km (ne1024) | 111km (ne32), 28 km (ne128) | Refinement region with complete coverage of CONUS using several coarse and fine resolutions | Max Dinv elem distortion: 3.00, 3.00, 3.01, 3.02 area based dx: | TBD | ||
2012 North American Derecho derecho_ne512.g (not on E3SM inputdata server) | 7 km (ne512), 3.5 km (ne1024), 1.75 km (ne2048) | 100 km (ne32) | Include the region important for the 2012 North American Derecho | Max Dinv elem distortion: 2.89, 2.89, 2.97 area based dx: | Liu et al. (2023; under review) | ||
California CA_ne32_x32_v1.g (not on E3SM inputdata server) | 3.25 km (ne1024) | 100 km (ne32) | High resolution over CA to capture topographic effects of precipitation, but small enough HR domain so that climate length simulations can be performed. Note that other experimental variants of this grid exist (contact Peter Bogenschutz for details). | Max Dinv-based element distortion: 3.02, 3.02, 5.45, 3.04, 3.05 area based dx: | Zhang et al. (2023; in prep); Bogenschutz et al. (2023; in prep) | Jishi Zhang (zhang73@llnl.gov) | |
Amazon ref(60W,5S) (not on E3SM inputdata server) | 14 km (ne256), 7 km (ne512), 3.5 km (ne1024) | 28 km (ne128) | Large high resolution region over Amazon | TBD | |||
ARM GoAmazon GoAmazon_ne32_x32_v1.g (not on E3SM inputdata server) | 3.25 km (ne1024) | 100 km (ne32) | For ARM GoAmazon field campaign | Max Dinv-based element distortion: 2.88 | TBD | ||
ARM TRACER | 3.25 km (ne1024) | 100 km (ne32) | For ARM TRACER field campaign | Max Dinv-based element distortion: 3.06 | TBD | ||
ARM COMBLE | 3.25 km (ne1024) | 100 km (ne32) | For ARM COMBLE field campaign | Max Dinv-based element distortion: 2.98 | TBD | ||
ARM CACTI | 3.25 km (ne1024) | 100 km (ne32) | For ARM CACTI field campaign | Max Dinv-based element distortion: 2.98 | TBD | ||
ARM MAGIC | 3.25 km (ne1024) | 100 km (ne32) | For ARM MAGIC field campaign | Max Dinv-based element distortion: 3.05 | TBD | ||
ARM EPCAPE | 3.25 km (ne1024) | 100 km (ne32) | For ARM EPCAPE field campaign | Max Dinv-based element distortion: 2.88 | TBD | ||
ARM CONUS | 3.25km (ne1024) | 100 km (ne32) | For SGP, SEUS, TRACER | Max Dinv-based element distortion: 2.98 | TBD | ||
Indian Ocean, Maritime Continent | 3.25km (ne1024) | 100 km (ne32) | For MJO study | Max Dinv-based element distortion: 3.40 | TBD | ||