| Warning | ||
|---|---|---|
| ||
NERSC Directory Change Notice Due to project's name change at NERSC from 'ACME' to 'E3SM' and NERSC’s file system update, the directory ' |
...
The purpose of this page is to document the procedure for adding support for new atmosphere grids. The process should be the same for new uniform resolutions as well as for new regionally-refined meshes, although some settings will need to be changed for new regionally-refined mesh configurations. This page is a work in progress, and will be updated as this process is refined and (eventually) made more automated. This documentation is an update of a document written by Mark Taylor and Colin Zarzycki, available as a Google Doc here. Linking to a related page: /wiki/spaces/NGDNA/pages/915408074.
Similar page for MPAS grids: /wiki/spaces/ECG/pages/1479835665
| File | Tool | Type | Note |
|---|---|---|---|
| ncks, ncremap | NCO | ||
| mapping files and mesh template files | TempestRemap | C++ | GenerateCSMesh: make cubed sphere Exodus (.g) files (spectral element "np" grid) |
| RRM Exodus (.g) mesh files | SquadGen | C++ | |
| topo files | homme_tool | Fortran | Included with E3SM. Should build and run on any system which can run the HOMME_P24.f19_g16_rx1.A test Generate (obsolete) SCRIP files for the spectral element "np" dual grid Used for topo smoothing for both FV "pg" and SE "np" grids. Can also do parallel interpolation from SE np4 grid to any SCRIP grid |
| topo files | cube_to_target | Fortran | NCAR utility for generating unsmoothed topography from high-res USGF data, and generating surface roughness fields from smoothed topography |
| mapping files | ESMF_Regridweightgen | Make FV->FV mapping files from SCRIP grid template files Only tool which supports the montone 2nd order "bilin" map | |
| CIME and ELM tools |
For the purpose of this step-by-step guide, we will walk through each step using an example of regenerating the ne4 grid that is already currently supported. For a new grid (i.e., ne512), just replace ne4 with the desired grid identifier. This is determined in Step 1 Generate a new "grid" file below, and the rest should follow.
...
TempestRemap needs to be built from source from the Github repository. This is straightforward on Cori and Edison. Note that a parallel version of netCDF should be used. This can be accomplished on cori/edison be executing module swap cray-netcdf cray-netcdf-hdf5parallel or by sourcing an env_mach_specific.sh from a working case on the target machine before building. Then,
...
- land grid descriptor file in SCRIP format
- ESMF_RegridWeightGen
- geographic distribution for each land surface type along with grid descriptor files for each of those surface types
- mkmapdata.sh (found in components/clm/tools/shared/mkmapdata/)
- mksurfdata.pl (found in components/clm/tools/clm4_5/mksurfdata_map/)
...