EAMxx User's Guide

Here you can find information on how to configure and run EAMxx, E3SM’s convection-permitting atmosphere model, which is written in performance-portable C++ and will become the ATM component for E3SMv4.

EAMxx has a high-resolution configuration called “SCREAM (Simple Cloud-Resolving E3SM Atmosphere Model)”. In fact, EAMxx was originally named SCREAM, so several of the resources below refer to SCREAM instead of EAMxx, but the two actually refer to the same atmospheric model.

Concepts

• Conservative Multi-Moment Tracer Transport

• EAMxx Vertical Coordinate

• The Dynamics Equations Solved by the HOMME Dycore

• The Finite-Volume “PG2” Physics Grid and Its Relationship to the Spectral Element Dynamics Grid

Platform-Specific Instructions and Issues

• Running SCREAM(EAMxx)v1 on Summit w/ ne30

• SCREAM(EAMxx)v1 runs on LC Quartz

• Running EAMxx’s C++ Unit Tests/Standalone Executables

• Running EAMxx on Summit, May 2022

• Running EAMxx on Frontier and Crusher

• Summary of testing screamv0 on Perlmutter

• Running EAMxx on Crusher V1, August 2022

• Setting up a Spack environment for SCREAM(EAMxx)

Creating Cases and Running Coupled Simulations

• ATM Grid Resolution Summary

• E3SM Input Data Servers

• Running E3SM on New Atmosphere Grids

• Generate NetCDF file containing initial conditions for HOMME

• How to Run SCREAM(EAMxx)v1

• Available EAMxx Output Variables

• Coupled SCREAM(EAMxx)v1 Configuration

• Choosing a v1 timestep

Debugging Coupled Simulations

• Debugging threading issues

Model Evaluation

• EAMxx Simulation Campaigns

  • Previous (SCREAM) Simulation Campaigns

• E3SM Intensive Observation Period (IOP) Case Library

• COSP in EAMxx

• Performance archive: GitHub - E3SM-Project/perf-data

Evaluation Tools

• e3smplot

• ncvis

Documentation for Specific Atmospheric Processes

• EAMxx's HOMMExx Dycore (includes info about EAM’s HOMME dycore)

  • Planar (doubly-periodic) HOMME

• The RRTMGP Radiation Process

  • How to run the RRTMGP standalone test

References

• EAMxx Reading List

• 2018: Prior Work in Cloud-Resolving Models

• 2023: Latest work in cloud-resolving models, used for the SCREAM https://acme-climate.atlassian.net/wiki/spaces/EP/pages/3668344920