ESMF

The Earth System Modeling Framework is a suite of software tools for developing high-performance, multi-component Earth science modeling applications.
https://github.com/esmf-org/esmf

Category: Climate Change
Sub Category: Earth and Climate Modeling

Keywords

earth-system-model earth-system-modeling earth-system-modeling-framework earth-system-modelling esmf esmx model-coupling numerical-weather-prediction nuopc nwp unified-forecast-system

Keywords from Contributors

climate climate-model numerical-modelling weather hydrology datamodeling mpi cesm ncar ecosystem

Last synced: about 22 hours ago
JSON representation

Repository metadata

The Earth System Modeling Framework (ESMF) is a suite of software tools for developing high-performance, multi-component Earth science modeling applications.

Host: GitHub
URL: https://github.com/esmf-org/esmf
Owner: esmf-org
License: other
Created: 2020-02-03T17:42:01.000Z (about 5 years ago)
Default Branch: develop
Last Pushed: 2025-04-16T22:34:40.000Z (11 days ago)
Last Synced: 2025-04-16T23:44:35.062Z (11 days ago)
Topics: earth-system-model, earth-system-modeling, earth-system-modeling-framework, earth-system-modelling, esmf, esmx, model-coupling, numerical-weather-prediction, nuopc, nwp, unified-forecast-system
Language: Fortran
Homepage: https://earthsystemmodeling.org/
Size: 149 MB
Stars: 181
Watchers: 19
Forks: 81
Open Issues: 97
Releases: 15
Metadata Files:
- Readme: README.md
- License: LICENSE
- Zenodo: .zenodo.json

Earth System Modeling Framework (ESMF)

Copyright (c) 2002-2025 University Corporation for Atmospheric Research, Massachusetts Institute of Technology, Geophysical Fluid Dynamics Laboratory, University of Michigan, National Centers for Environmental Prediction, Los Alamos National Laboratory, Argonne National Laboratory, NASA Goddard Space Flight Center. All rights reserved.

Hello and welcome to ESMF.

The ESMF User's Guide contains information on building and installing ESMF.
The ESMF Reference Manual contains information on the architecture of ESMF,
example code, and details of the API (Application Programming Interface).
Visit the ESMF Web Site for a general overview of the project.
Please contact [email protected] with any questions or problems.

Downloading ESMF

The ESMF library source code is available for download at GitHub:

https://github.com/esmf-org/esmf/releases

Building ESMF

To build ESMF from source:

Consult the Building ESMF section of the ESMF User's Guide.
For testing ESMF, see Testing makefile targets.

Pre-built ESMF

Pre-built binaries for ESMF and ESMPy are available through a number of channels:

Docker Hub: Under ESMF Organization. To install locally, run:
```
docker run -it --rm esmf/esmf-build-release:latest
```
Replace latest in the above command with a valid version, like 8.9.0, in order to access a specific ESMF version.
Anaconda Conda-Forge: Under conda-forge/esmpy. To install locally (note Windows is not supported), run:
```
conda create -n esmpy -c conda-forge esmpy
```

Running ESMF Command Line Tools

To use the ESMF command line tools follow the instructions located in Using Bundled ESMF Command Line Tools.

Linking to ESMF

To build your application against an ESMF installation follow the instructions located in Compiling and Linking User Code against an ESMF Installation.

Add-On Packages

Several add-on packages are included with ESMF under ./src/addon:

ESMPy - Python interface to ESMF.
ESMX - A layer providing the Earth System Model eXecutable.
The ESMX layer is built on top of ESMF and NUOPC.
NUOPC - Interoperability layer developed under the National Unified Operational Prediction Capability (NUOPC) program.

See each addon package for a specific README file.

More Help

Information about the ESMF project can be found at the ESMF web site:

https://www.earthsystemmodeling.org/

Software documentation for the last release:

http://earthsystemmodeling.org/doc/

Software documentation for all releases:

http://earthsystemmodeling.org/static/releases.html

Support:

http://earthsystemmodeling.org/support/

Owner metadata

Name: Earth System Modeling Framework
Login: esmf-org
Email: [email protected]
Kind: organization
Description:
Website:
Location:
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/60195040?v=4
Repositories: 26
Last ynced at: 2023-03-04T11:37:13.944Z
Profile URL: https://github.com/esmf-org

GitHub Events

Total

Fork event: 6
Create event: 55
Commit comment event: 1
Release event: 2
Issues event: 66
Watch event: 24
Delete event: 30
Issue comment event: 259
Push event: 173
Pull request review comment event: 35
Pull request review event: 55
Gollum event: 16
Pull request event: 56

Last Year

Fork event: 6
Create event: 55
Commit comment event: 1
Release event: 2
Issues event: 66
Watch event: 24
Delete event: 30
Issue comment event: 259
Push event: 173
Pull request review comment event: 35
Pull request review event: 55
Gollum event: 16
Pull request event: 56

Committers metadata

Last synced: 4 days ago

Total Commits: 26,218
Total Committers: 80
Avg Commits per committer: 327.725
Development Distribution Score (DDS): 0.76

Commits in past year: 387
Committers in past year: 10
Avg Commits per committer in past year: 38.7
Development Distribution Score (DDS) in past year: 0.491

Name	Email	Commits
Gerhard Theurich	t**h@s**t	6298
Nancy Collins	n**y@u**u	3448
Silverio Vasquez	s**z@n**v	2123
Walter Spector	w**r@h**m	1970
Ryan O'Kuinghttons	r**s@n**v	1821
Earl Schwab	e**f@g**m	1620
Robert Oehmke	o**e@u**u	1616
John Wolfe	j**e@u**u	1469
Cecelia DeLuca	c**a@n**v	955
Fei Liu	F**u@g**m	876
Peggy Li	p**i@j**v	592
Joseph Jacob	j**b@j**v	302
Rocky Dunlap	d**p@u**u	299
David Neckels	d**s@u**u	278
Ben Koziol	b**l@n**v	277
Dennis Flanigan	d**f@u**u	251
Samson Cheung	c**g@m**u	219
Rosalinda de Fainchtein	r**n@c**t	204
Bill Sacks	s**s@u**u	197
Donald Stark	s**k@u**u	145
cpboulder	c****r	130
Jim Edwards	j**s@u**u	93
Chris Hill	c**h@m**u	92
Kathy Saint	k**t@m**m	87
Raffaele Montuoro	r**o@n**v	83
Sylvia Murphy	s**y@n**v	78
Mathew Rothstein	m**n@n**v	70
Leonid Zaslavski	l**i@g**v	49
Steve Goldhaber	g**y@u**u	48
Daniel Rosen	d**n@u**u	47
and 50 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 2 days ago

Total issues: 195
Total pull requests: 186
Average time to close issues: 3 months
Average time to close pull requests: about 2 months
Total issue authors: 35
Total pull request authors: 35
Average comments per issue: 2.72
Average comments per pull request: 4.48
Merged pull request: 141
Bot issues: 0
Bot pull requests: 0

Past year issues: 88
Past year pull requests: 49
Past year average time to close issues: about 1 month
Past year average time to close pull requests: 14 days
Past year issue authors: 17
Past year pull request authors: 9
Past year average comments per issue: 2.57
Past year average comments per pull request: 3.53
Past year merged pull request: 40
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/esmf-org/esmf

Top Issue Authors

billsacks (47)
tclune (28)
danrosen25 (24)
oehmke (22)
theurich (22)
rsdunlapiv (6)
mathomp4 (6)
uturuncoglu (3)
thebaptiste (3)
anntsay (3)
climbfuji (2)
MuellerSeb (2)
jkrasting (2)
waarmond (2)
darianboggs (2)

Top Pull Request Authors

billsacks (34)
theurich (30)
danrosen25 (26)
uturuncoglu (14)
bekozi (11)
jedwards4b (9)
rsdunlapiv (9)
tclune (7)
mathomp4 (6)
DWesl (4)
oehmke (3)
rokuingh (3)
him-28 (3)
bena-nasa (3)
Chrismarsh (2)

Top Issue Labels

who: unknown (95)
bug (36)
enhancement (30)
feature/enhancement (19)
NUOPC (15)
I/O (12)
who: NASA (12)
ESMX (8)
source: discussions (8)
ESMPy (7)
documentation (6)
CRB (5)
closed: wontfix (4)
TimeMgr (3)
who: NOAA (3)
question (3)
porting (2)
closed: duplicate (2)
performance (2)
who: NCAR (2)
closed: can't reproduce (1)
who: ESMF_Core (1)
32-bit limit (1)
investigation (1)
scalability: StateReconcile() (1)
threading & resource control (1)

Top Pull Request Labels

enhancement (12)
bug (8)
documentation (7)
ESMX (5)
who: NASA (5)
NUOPC (3)
who: NOAA (3)
performance (2)
feature/enhancement (2)
MBMesh (1)
porting (1)
who: NCAR (1)
who: unknown (1)

Package metadata

Total packages: 2
Total downloads: unknown
Total dependent packages: 20 (may contain duplicates)
Total dependent repositories: 83 (may contain duplicates)
Total versions: 17

conda-forge.org: esmpy

Homepage: http://earthsystemmodeling.org/esmpy/
Licenses: NCSA
Latest release: 8.2.0 (published over 3 years ago)
Last Synced: 2025-04-25T13:35:42.108Z (2 days ago)
Versions: 8
Dependent Packages: 15
Dependent Repositories: 61
Rankings:
- Dependent packages count: 4.202%
- Average: 4.364%
- Dependent repos count: 4.526%

conda-forge.org: esmf

Homepage: http://earthsystemmodeling.org/
Licenses: NCSA
Latest release: 8.4.0 (published over 2 years ago)
Last Synced: 2025-04-25T13:35:43.993Z (2 days ago)
Versions: 9
Dependent Packages: 5
Dependent Repositories: 22
Rankings:
- Dependent repos count: 7.61%
- Average: 9.012%
- Dependent packages count: 10.415%

Dependencies

.github/workflows/api-change.yml actions

actions/checkout v3 composite
actions/upload-artifact v3 composite

.github/workflows/build-esmf-docs.yml actions

actions/checkout v3 composite
actions/upload-artifact v3 composite

.github/workflows/build-esmpy-docs.yml actions

actions/checkout v3 composite
actions/upload-artifact v3 composite

.github/workflows/test-build-spack.yml actions

actions/cache v3 composite
actions/checkout v3 composite

.github/workflows/test-coverage.yml actions

actions/checkout v3 composite
actions/upload-artifact v3 composite

src/addon/esmpy/pyproject.toml pypi

importlib-metadata python_version < "3.8"
numpy *
setuptools-git-versioning python_version >= "3.10"

Score: 14.644376736594154

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology