Adding Support for New Grids

The purpose of this guide is to outline all the necessary steps for running E3SM on a new grid for the atmosphere and land components. The process is similar for uniform and regionally refined grids, although regionally refined cases will likely require some special considerations which will be noted where appropriate.

If you wish to add a new ocean and sea-ice mesh you will need to use the compass tool to generate the mesh and dynamically adjusted initial condition. This procedure is detailed in a separate tutorial: https://mpas-dev.github.io/compass/latest/tutorials/dev_add_rrm.html

Step-by-Step Guide

1. Generate a new grid
   1. Generate a uniform grid file
   2. Generate a RRM grid file
2. Generate mapping files
3. Generate domain files
4. Generate a topography file
5. Generate atmospheric initial condition
6. Generate land input data (fsurdat)
7. Generate land initial condition (finidat)
8. Generate a dry deposition file (depends on use case)
9. Add new grid configuration to E3SM