Page Comparison

...

1. Instructions for creating new grids are at Running E3SM on New Grids

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

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

4. To share your 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. Files to add: <make list>

   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.

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

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

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

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

      5. Modify components/eam/bld/namelist_files/namelist_defaults_eam.xml<what else???> 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

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

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

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

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

Conventional High-Resolution Grids

...