...
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. To share your grid:
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
...