Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 10 Next »

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

Instructions for Adding Grids:

  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.

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

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)
ocean/ice: 14 km

atm/land: 100 km (ne30)
ocean/ice: 60 km

See figures in the paper

Described in Tang et al., (GMDD 2022)

Qi Tang

v2 Antarctic RRM

atm/land: 25 km (ne120)

atm/land: 100 km (ne30)

/wiki/spaces/ED/pages/934314314

TBD

Qi TangWuyin Lin

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

Paul Ullrich

arcticx4v1pg2

atm/land: 25 km (ne120)

atm/land: 100 km (ne30)

TBD

Ben Hillman

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

Paul Ullrich

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)

Paul Ullrich

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)
Tang et al. (2023; in prep)

Peter BogenschutzQi Tang

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

Paul Ullrich

GoAmazon

TRACER

COMBLE

CACTI

MAGIC

  • No labels