This page collects well-tested RRM configurations produced for E3SM which others might want to use.
Instructions for Adding Grids:
Instructions for creating new grids are at Running E3SM on New Grids
The steps below are for making grids available to other users. Stop now if you’ve never tried out your new RRM grid or it has problems. Definitely continue if your RRM grid was used in a publication.
Atmosphere grids have a grid quality metric which measure the element distortion (see Running E3SM on New Grids). A high quality RRM grid with smooth transition region will have a value <= 4.
Creating a Pull Request for New RRM grids
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
.
Conventional High-Resolution Grids
Grid Name | Target Fine Resolution | Target Coarse Resolution | Goals in mesh creation | Link to mesh graphic | Grid quality metric | Validation | Contact Person |
---|---|---|---|---|---|---|---|
v2 North American RRM | atm/land: 25 km (ne120) | atm/land: 100 km (ne30) | See figures in the paper | Described in Tang et al., (GMDD 2022) | |||
v2 Antarctic RRM | 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) | 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) | 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 | TBD | |||
2012 North American Derecho | 7 km (ne512), 3.5 km (ne1024), 1.75 km (ne2048) | 100 km (ne32) | Include the region important for the 2012 North American Derecho | Liu et al. (2023; under review) | |||
California | 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 | Zhang et al. (2023; in prep); Bogenschutz et al. (2023; in prep) | Jishi Zhang (zhang73@llnl.gov) | |
Amazon ref(60W,5S) | 14 km (ne256), 7 km (ne512), 3.5 km (ne1024) | 28 km (ne128) | Large high resolution region over Amazon | TBD | |||
GoAmazon | |||||||
TRACER | |||||||
COMBLE | |||||||
CACTI | |||||||
MAGIC | |||||||