Skip to main content
v2026.11,986 entries · CC-BY 4.0

E3SM: DOE Earth System Model, Data and Code Access

What E3SM is, which DOE labs run it, where its simulation data and code are, how to use the official docs, and how to acknowledge it in publications.

Written and maintained by CASRAI Editorial Board

Published

On this page

E3SM (the Energy Exascale Earth System Model) is the U.S. Department of Energy’s ongoing Earth system modeling, simulation and prediction project, and also the name of its open-source, fully coupled model code. Researchers use it in two ways: they run the model on supported machines, or they download output from archived simulations. This guide explains what E3SM is, which laboratories run it, where its data and documentation sit, and how to acknowledge it in a paper.

What E3SM is

The project’s own site describes E3SM as “an ongoing, state-of-the-science Earth system modeling, simulation, and prediction project” (e3sm.org/about, read 2026-11-14). The model repository on GitHub, titled “Energy Exascale Earth System Model source code”, describes the model as a fully coupled Earth system model that includes biogeochemical and cryospheric processes. The code is released under a BSD 3-clause license.

The name covers three things that are easy to conflate: the project (a DOE research program), the model (the code, versioned as v1, v2, v3 and so on) and the archived simulation output (datasets produced with those versions). Which one a searcher needs decides which official page to open, and the sections below keep them apart.

Who runs it and what it covers

E3SM is carried out by eight U.S. national laboratories, listed on the project’s about page: Argonne (ANL), Brookhaven (BNL), Los Alamos (LANL), Lawrence Berkeley (LBNL), Lawrence Livermore (LLNL), Oak Ridge (ORNL), Pacific Northwest (PNNL) and Sandia (SNL). The page links the project to the Office of Science Exascale Computing systems and Leadership Computing Facilities, which is why the model is built for very large machines.

Phases and versions

Phase Years What the about page says
Phase 1 2014-2018 Developed the first version (v1) of the model.
Phase 2 2018-2022 Expanded v1 and developed v2, with groundwork for v3 and v4.
Phase 3 2023-2026 Parallel tracks to develop and release v3 in 2023 and v4 in 2026.

The same page names three science themes: Water Cycle Changes and Impacts; Human-Earth System Feedbacks; and Polar Processes, Sea-Level Change and Coastal Impacts. It also states that v1.0 introduced the MPAS (Model for Prediction Across Scales) Ocean, Sea Ice and Land Ice components, and that Phase 1 delivered regional refinement in all of its component models, meaning resolution can be increased over a region of interest instead of everywhere. A link to a Phase 4 plan appears on the page without dates or content, so this guide does not describe it.

Where the data and code live

E3SM output is archived rather than served from a single portal. The project’s data page (e3sm.org/e3sm-data-locations-and-policies, read 2026-11-14) states that over 4 PB of simulation data are archived. It lists datasets for v1, v2, v2.1 and v3.LR, the SCREAM versions v0 and v1, and AI training datasets, and says a v3 Large Ensemble of about 600 TB is to be added. Each entry in the E3SM Data Docs lists the data size and the HPSS path (the tape-archive location), and, depending on version and campaign, an ESGF link as well.

Two access routes are named: ESGF links and HPSS URLs, both open to the general public for download. The page notes that downloading directly on the machine where the data sit on HPSS is much faster for users who have an account there. It also says the project intends to focus storage on DOE HPSS systems and to work with BER data management projects to make data available in the American Science Cloud. For readers who know the CMIP ecosystem, the ESGF route is the same federated infrastructure described in Earth System Grid Federation (ESGF): federated access to CMIP climate model data.

Code is separate. The model source is on GitHub in the E3SM-Project organization. Its README tells users to work from the “maint” branches and states that the head of master is not validated. The docs index also lists the supporting software described in the table further down.

How to find and use E3SM data and code

These steps follow the project’s own pages as read on 2026-11-14; the interface terms are theirs.

  1. Open the documentation index at docs.e3sm.org. It is the entry point for model documentation, data documentation, analysis tools and user guides.
  2. Select DataDocs, which the index describes as “Output from major E3SM simulations”, to browse simulations by version and campaign.
  3. Open the entry for the simulation you need and note its data size and HPSS path, plus any ESGF link.
  4. Choose a route: download through the ESGF link or HPSS URL, or, if you hold an account on the hosting machine, read directly from HPSS there.
  5. For the model code, go to the GitHub repository and check out a “maint” branch, not the head of master.
  6. To run the model, use the pages under e3sm.org/model/running-e3sm: the Quick Start and the Supported Machines list. The docs index also links a “Step-by-step guide to running E3SM” under User Guides.
  7. Analyze output with the tools the docs index lists: E3SM_diags for atmosphere and land, MPAS-Analysis for ocean and sea ice, and zppy for the post-processing workflow.
  8. Ask code questions in the repository’s GitHub Discussions, which the README names for questions about the model.

Output files you download are usually read with standard climate-data tooling; two general CASRAI references are NetCDF for the file format and Climate Data Operators for command-line processing. Neither page is part of E3SM; they are background on common formats and tools.

Citing and acknowledging E3SM

The README says E3SM should be acknowledged in publications as the origin of the model, following the project’s acknowledgement guidelines at e3sm.org/resources/policies/acknowledge-e3sm. It also asks users to cite the software and supplies a BibTeX entry carrying a DOI. The README page shows two different DOIs, 10.11578/E3SM/dc.20240301.3 in the BibTeX entry and 10.11578/E3SM/dc.20240930.1 in its header, so copy the entry from the current README when you cite rather than from a paper that quotes it. Background on how DOIs are issued is in DOI registration agencies.

The data page lists four policy pages as links: Data Policy, Support Policy, Acknowledge E3SM and Open Source License. Check the Data Policy before reusing simulation output in a publication or a derived dataset, because that page, not this guide, is the authority on the terms.

Strengths and limits

Strengths

  • Open code and open archive. The model is BSD 3-clause licensed and the data routes (ESGF links and HPSS URLs) are open to the public.
  • Documented ecosystem. Diagnostics, archiving, post-processing, testing and I/O have named tools, collected on one documentation index.
  • Multiple output families. The data page lists several model versions, the SCREAM configurations and AI training datasets.
  • Regional refinement. The project reports multi-resolution capability across its component models.

Limits

  • Scale. With over 4 PB archived and a roughly 600 TB ensemble planned, bulk download is practical mainly where you can read from HPSS directly.
  • Branch discipline. The head of master is not validated, so reproducible work needs a “maint” branch and a recorded version.
  • Moving locations. The project says storage will concentrate on DOE HPSS and the American Science Cloud, so check the Data Docs entry for the current location before building a pipeline around a path.
  • Machine support. The project documents running the model on the systems named on its Supported Machines page.

E3SM is one source of climate model output among several. The table lists CASRAI guides to other routes into climate data; each row says only what the guide is about.

Resource What it is Use it when
ESGF and CMIP data Federated access to CMIP climate model output You need multi-model CMIP archives, which E3SM data can also appear alongside on ESGF nodes
NOAA NCEI climate and ocean data Access routes to NOAA climate and ocean datasets You need observational or archive data rather than model simulations
Climate Data Operators Command-line tools for processing climate data files You already hold E3SM or other output and need to process it

The data table below lists the E3SM project tools named on the official documentation index, grouped by role.

Frequently asked questions

What does E3SM stand for?

E3SM stands for Energy Exascale Earth System Model, the name given to the model’s source repository on GitHub and to the DOE project behind it.

Is E3SM open source?

The model code is available under a BSD 3-clause license, according to the GitHub README read on 2026-11-14. Data reuse is governed separately by the project’s Data Policy.

Where can I download E3SM simulation output?

Start from the E3SM Data Docs linked on docs.e3sm.org. Entries give the HPSS path and, depending on the campaign, an ESGF link. The data page says both routes are open to the public.

Which branch of the E3SM repository should I use?

Use a “maint” branch. The README states that the head of master is not validated.

How do I cite E3SM?

Acknowledge E3SM as the origin of the model following the project’s acknowledgement guidelines and cite the software with the BibTeX entry in the README. Take the DOI from the current README, since the page shows two.

Sources

  • E3SM, About: https://e3sm.org/about/ (read 2026-11-14)
  • E3SM, Data locations and policies: https://e3sm.org/e3sm-data-locations-and-policies/ (read 2026-11-14)
  • E3SM documentation index: https://docs.e3sm.org/ (read 2026-11-14)
  • E3SM-Project/E3SM repository README: https://github.com/E3SM-Project/E3SM (read 2026-11-14)

Data: E3SM project tools and resources named on the official documentation index

Compiled from the E3SM documentation index (docs.e3sm.org): each named tool or resource with a role category assigned by CASRAI and the short description the index gives for it, quoted as listed.

Period covered: 2026.

E3SM project tools and resources named on the official documentation index
Tool or resourceFunctionRole group (CASRAI grouping)Description on docs.e3sm.org
E3SM (model and components)Model and componentsModelModel and Components
EmulatorsAI emulatorsModelAvailable AI emulators of E3SM and how to get started
SCMlibSingle column model case libraryModelSingle Column Model Case Library
DataDocsData documentationDataOutput from major E3SM simulations
HICCUPInitial conditionsData preparationInitial conditions from Reanalysis
E3SM_diagsDiagnosticsAnalysisAtmosphere and Land
MPAS-AnalysisDiagnosticsAnalysisOcean and Sea Ice
ChemDiagDiagnosticsAnalysisAtmospheric chemistry diagnostics
zstashArchivingWorkflowFor HPSS data archiving
zppyPost-processingWorkflowFor postprocessing workflow
e3sm-unifiedPackagingWorkflowConda metapackage for all tools
COMPASSTesting and meshesTestingOcean testing and mesh creation
EVV4ESMTestingTestingTests for non-BFB climate sameness
SCORPIOI/O librarySoftware libraryThe SCORPIO I/O library

Sources

Compiled by CASRAI from the sources above. Free to reuse under CC BY 4.0 with attribution.

Follow CASRAI

Research-administration guidance, standards updates and independent tool reviews.

Ask CASRAI · full access

Ask about E3SM: DOE Earth System Model, Data and Code Access

Full access: large monthly usage, up to 10 source passages behind each answer, and MCP and API access for Claude Code, Codex and other CLIs. Cancel any time.

An AI assistant for research: funder rules, compliance, methods and publishing. It links the sources behind its answers and labels answers that come from a web search.

Answers draw on CASRAI's guides and dictionary plus the federal and funder documents we index: Federal Register, Grants.gov, Regulations.gov and UKRI.

Works on this site and inside Claude, Cursor and the AI tools you already use.

Everything CASRAI publishes — this page, the dictionary, the guides and the news — stays open to read, with no account and no card.

Referenced across the research world

University of Cambridge logoColumbia University logoCrossref logoUniversity of Edinburgh logoHarvard University logoUniversity of Oxford logoPrinceton University logoStanford School of Medicine logoUniversity College London logoORCID logoUniversity of Cambridge logoColumbia University logoCrossref logoUniversity of Edinburgh logoHarvard University logoUniversity of Oxford logoPrinceton University logoStanford School of Medicine logoUniversity College London logoORCID logo
  • University of Cambridge logo
  • Columbia University logo
  • Crossref logo
  • University of Edinburgh logo
  • Harvard University logo
  • University of Oxford logo
  • Princeton University logo
  • Stanford School of Medicine logo
  • University College London logo
  • ORCID logo

View CASRAI adoption →