Page Comparison

This page collects well-tested RRM configurations produced for E3SM which others might want to use.

Instructions for Adding Grids:

...

Adding a New Grid to a Branch

General instructions for creating new grids are at Running E3SM on New Grids

...

, which also include specific instructions for RRM.

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.

New grids require many modified input files, most crucially is the initial condition files. Ideally, these files should be created from a a very long run (several decades) to allow full adjustment of things like soil moisture and ozone. spun-up land conditions can be generated efficiently using the ICRUELM compset.

Creating a Pull Request

...

to Add a New Grid to the Master Branch

The steps below are for making grids available to other users, which is especially important if your RRM grid was used in a publication. Do not create a PR if you have not thoroughly tested your new RRM grid.

1. Add a row for your new grid in the appropriate table below

2. Add the grid files to inputdata/share/meshes following the directions at /wiki/spaces/ED/pages/707002387.

3. 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.

4. Modify cime_config/config_grids.xml to define the new grid

5. Modify cime_config/config_grids.xml to specify domain file paths

6. Modify cime_config/config_grids.xml to specify mapping file paths (only for bi- and tri-grid)

7. Modify components/eam/bld/config_files/horiz_grid.xml to specify the number of columns

8. Modify 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:

   1. ncdata - the atmospheric initial condition

   2. bnd_topo - topography

   3. drydep_srf_file surface dry deposition of aerosols (MAM)

   4. mesh_file - grid definition file in exodus format

   5. se_ne - set to zero for RRM

   6. dtime - dynamics/physics coupling interval

9. For certain configurations, especially the older preqx dycor option, you may need to modify the following parameters in components/eam/bld/namelist_files/namelist_defaults_eam.xml

   1. se_tstep

   2. nu

   3. nu_top

   4. nu_div

   5. hypervis_scaling

   6. hypervis_subcycle_tom

   7. hypervis_subcycle

10. 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)

    1. finidat - land model initial condition

    2. fsurdat - input data describing surface types

11. Optional - modify cime/config/e3sm/allactive/config_pesall.xml to add a new PE layout for your grid

12. Optional - modify cime_config/tests.py to add a test for the new grid. RRM tests should only be added to specific test suites, such as e3sm_rrm.

...