MAPL

A foundation layer of the GEOS architecture, whose original purpose is to supplement the Earth System Modeling Framework.
https://github.com/GEOS-ESM/MAPL

Category: Climate Change
Sub Category: Earth and Climate Modeling

Keywords from Contributors

earth-system-model atmospheric-modeling esmf run-directory geos-chem cloud-computing atmospheric-composition regridding masks hemco

Last synced: less than a minute ago
JSON representation

Repository metadata

MAPL is a foundation layer of the GEOS architecture, whose original purpose is to supplement the Earth System Modeling Framework (ESMF)

README.md

MAPL Repository

GEOS-ESM

DOI

Ask DeepWiki

MAPL (Modeling Analysis and Prediction Layer) is a foundation layer of the GEOS architecture, whose original purpose is to supplement the Earth System Modeling Framework (ESMF). MAPL fills in missing capabilities of ESMF, provides higher-level interfaces for common boiler-plate logic, and enforces various componentization conventions across ESMF gridded components within GEOS.

MAPL has 10 primary subdirectories for Fortran source code:

  1. shared - low level utilities that are used throughout the remainder of MAPL.
  2. profiler - time and memory profiling utility
  3. pfio - high-performance client-server I/O layer
  4. base (formerly MAPL_Base) - legacy core of MAPL. This layer will gradually evaporate under further refactoring.
  5. generic (under construction) - new home for MAPL extension of ESMF framework.
  6. oomph - next gen generic will eventually disappear
  7. gridcomps - Cap, History, and ExtData gridcomps used by all GEOS configurations.
  8. MAPL_cfio - this is a deprecated lower-level I/O layer that is generally replaced by GMAO_pFIO. Not all of the strings have been cut yet. Sometime soon, this directory will be eliminated.
  9. griddedio - layer between ESMF container and pfio library
  10. field_utils - utilities for manipulating data on ESMF fields in a rank- and typekind-agnostic way

MAPL also has a variety of other auxiliary directories:

  1. include - include files used by external gridded components.
  2. Apps - various Python and Perl scripts used by gridded components.
  3. Python - beginnings of a run-time scripting framework for GEOS configurations
  4. cmake - CMake build macros
  5. Tests - miscellaneous standalone drivers.
  6. pflogger_stub - workaround for apps that wish to avoid a dependency on pFlogger
  7. pfunit - pFUnit (unit testing framework) extensions for ESMF components
  8. benchmarks - miscellaneous benchmarking scripts
  9. docs - documentation

Installing MAPL

Please see the INSTALL.md file for instructions on how to install
MAPL. This also contains information on how to install the required dependencies
including subrepositories MAPL expects.

Using MAPL

You can find simple examples on how to use MAPL components in ESMF applications at:

MAPL Tutorial

A MAPL User's Guide is also available to have an in depth description of MAPL components.

Contributing

Please check out our contributing guidelines.

License

All files are currently licensed under the Apache-2.0 license, see LICENSE.

Previously, the code was licensed under the NASA Open Source Agreement, Version 1.3.


Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: about 21 hours ago

Total Commits: 3,839
Total Committers: 47
Avg Commits per committer: 81.681
Development Distribution Score (DDS): 0.652

Commits in past year: 224
Committers in past year: 15
Avg Commits per committer in past year: 14.933
Development Distribution Score (DDS) in past year: 0.482

Name Email Commits
Matthew Thompson m****n@n****v 1336
Benjamin Auer b****r@n****v 706
Weiyuan Jiang w****g@n****v 417
Tom Clune t****e@n****v 275
Darian Boggs w****s@n****v 262
Yonggang Yu y****u@n****v 209
Atanas Trayanov a****v@n****v 156
Amidu Oloso a****o@n****v 70
Gian Villamil-Otero g****o@n****v 48
dependabot[bot] 4****] 45
Jules Kouatchou J****1@n****v 45
Raffaele Montuoro r****o@n****v 39
Natalie Patten n****n@g****m 39
William Jamieson w****n@n****v 34
Peter Norris p****s@n****v 21
Yonggang Yu y****u@c****u 20
Lizzie Lundgren e****n@s****u 19
Benjamin Michael Auer b****r@g****l 17
Elliot Sherman e****n@n****v 9
Tom Clune T****e@n****v 8
Liam Bindle l****e@g****m 6
William Putman W****n@n****v 6
Florian Deconinck d****n@g****m 4
Atanas Trayanov A****v 4
Arlindo da Silva a****a@n****v 4
Patricia Castellanos p****s@n****v 3
Sebastian David Eastham s****m@m****u 3
bzhao B****o@n****v 3
Mike Manyin m****n@n****v 3
Benjamin Michael Auer b****r@G****v 3
and 17 more...

Committer domains:


Issue and Pull Request metadata

Last synced: about 5 hours ago

Total issues: 669
Total pull requests: 1,976
Average time to close issues: 3 months
Average time to close pull requests: 4 days
Total issue authors: 30
Total pull request authors: 23
Average comments per issue: 1.92
Average comments per pull request: 0.63
Merged pull request: 1,501
Bot issues: 2
Bot pull requests: 445

Past year issues: 129
Past year pull requests: 137
Past year average time to close issues: about 1 month
Past year average time to close pull requests: 4 days
Past year issue authors: 11
Past year pull request authors: 11
Past year average comments per issue: 1.36
Past year average comments per pull request: 0.4
Past year merged pull request: 79
Past year bot issues: 0
Past year bot pull requests: 34

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/GEOS-ESM/MAPL

Top Issue Authors

  • tclune (297)
  • bena-nasa (103)
  • mathomp4 (83)
  • pchakraborty (55)
  • darianboggs (52)
  • metdyn (14)
  • lizziel (12)
  • atrayano (10)
  • yuanjianz (6)
  • weiyuan-jiang (5)
  • GeorgeVandenberghe-NOAA (4)
  • aoloso (3)
  • rtodling (3)
  • amdasilva (2)
  • mmanyin (2)

Top Pull Request Authors

  • mathomp4 (531)
  • github-actions[bot] (426)
  • tclune (298)
  • bena-nasa (199)
  • darianboggs (133)
  • pchakraborty (133)
  • metdyn (64)
  • weiyuan-jiang (60)
  • JulesKouatchou (40)
  • atrayano (28)
  • dependabot[bot] (19)
  • aoloso (12)
  • rtodling (8)
  • sdrabenh (8)
  • mmanyin (3)

Top Issue Labels

  • :chart_with_upwards_trend: MAPL3 (269)
  • :snowflake: Stale (141)
  • :gift: New Feature (90)
  • 0 Diff (68)
  • :hourglass: Long Term (54)
  • :hammer_and_wrench: Refactor (50)
  • :beetle: Bug (45)
  • bug (31)
  • :exclamation: High Priority (30)
  • :question: Question (26)
  • long term (18)
  • :beetle: Bugfix (14)
  • 0 diff (10)
  • new feature (9)
  • stale (9)
  • Changelog Skip (8)
  • 0 Diff Trivial (8)
  • refactor (7)
  • MAPL3 (5)
  • question (5)
  • high priority (3)
  • :wrench: Github Actions (2)
  • MAPL2 (2)
  • :memo: Documentation (2)
  • 0 diff trivial (2)
  • 😖 Shutdown (2)
  • :astonished: Non 0 Diff (2)
  • documentation (1)
  • bugfix (1)
  • Skip Changelog (1)

Top Pull Request Labels

  • 0 Diff (918)
  • :chart_with_upwards_trend: MAPL3 (859)
  • Changelog Skip (813)
  • :wrench: Github Actions (328)
  • :gift: New Feature (249)
  • 0 Diff Trivial (244)
  • 0 diff (211)
  • Skip Changelog (201)
  • MAPL3 (197)
  • automatic (140)
  • :beetle: Bugfix (93)
  • :hammer_and_wrench: Refactor (88)
  • 0 diff trivial (85)
  • :beetle: Bug (64)
  • bugfix (40)
  • new feature (38)
  • github_actions (33)
  • 0 diff structural (21)
  • dependencies (19)
  • :no_entry_sign: Contingent - DNA (16)
  • 😖 Shutdown (15)
  • refactor (14)
  • :memo: Documentation (14)
  • :astonished: Non 0 Diff (13)
  • documentation (11)
  • :exclamation: High Priority (8)
  • :snowflake: Stale (7)
  • bug (5)
  • Non 0-diff (5)
  • :hourglass: Long Term (5)

Package metadata

proxy.golang.org: github.com/GEOS-ESM/MAPL

  • Homepage:
  • Documentation: https://pkg.go.dev/github.com/GEOS-ESM/MAPL#section-documentation
  • Licenses: apache-2.0
  • Latest release: v2.70.0+incompatible (published about 1 month ago)
  • Last Synced: 2026-08-10T08:04:10.349Z (about 3 hours ago)
  • Versions: 219
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Rankings:
    • Dependent packages count: 5.395%
    • Average: 5.576%
    • Dependent repos count: 5.758%
proxy.golang.org: github.com/geos-esm/mapl

  • Homepage:
  • Documentation: https://pkg.go.dev/github.com/geos-esm/mapl#section-documentation
  • Licenses: apache-2.0
  • Latest release: v2.70.0+incompatible (published about 1 month ago)
  • Last Synced: 2026-08-10T08:04:09.222Z (about 3 hours ago)
  • Versions: 219
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Rankings:
    • Dependent packages count: 5.395%
    • Average: 5.576%
    • Dependent repos count: 5.758%
spack.io: mapl

MAPL is a foundation layer of the GEOS architecture, whose original purpose is to supplement the Earth System Modeling Framework (ESMF). MAPL fills in missing capabilities of ESMF, provides higher-level interfaces for common boiler-plate logic, and enforces various componentization conventions across ESMF gridded components within GEOS.

  • Homepage: https://github.com/GEOS-ESM/MAPL
  • Licenses: []
  • Latest release: (published about 2 hours ago)
  • Last Synced: 2026-08-10T08:20:01.697Z (about 2 hours ago)
  • Versions: 0
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Rankings:
    • Dependent repos count: 0.0%
    • Forks count: 23.926%
    • Average: 27.413%
    • Stargazers count: 27.785%
    • Dependent packages count: 57.941%
  • Maintainers (6)

Dependencies

.github/workflows/changelog-enforcer.yml actions
  • dangoslen/changelog-enforcer v3 composite
.github/workflows/enforce-labels.yml actions
  • mheap/github-action-required-labels v3 composite
.github/workflows/push-to-develop.yml actions
  • actions/checkout v3.2.0 composite
  • devops-infra/action-pull-request v0.5.3 composite
.github/workflows/push-to-main.yml actions
  • actions/checkout v3.2.0 composite
  • devops-infra/action-pull-request v0.5.3 composite
.github/workflows/release-tarball.yml actions
  • actions/checkout v3.2.0 composite
.github/workflows/trigger-circleci-pipeline-on-release.yml actions
  • CircleCI-Public/trigger-circleci-pipeline-action v1.0.6 composite
.github/workflows/validate_yaml_files.yml actions
  • actions/checkout v3.2.0 composite
  • actions/upload-artifact v3 composite
  • ibiqlik/action-yamllint v3 composite
.github/workflows/workflow.yml actions
  • actions/checkout v3.2.0 composite
  • styfle/cancel-workflow-action 0.11.0 composite
.docker/Dockerfile docker
  • ${BASE_IMAGE} latest build
.github/actions/deploy-ford-docs/action.yml actions
  • JamesIves/github-pages-deploy-action v4 composite
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
.github/workflows/docs.yml actions
  • ./.github/actions/deploy-ford-docs * composite
  • actions/checkout v3 composite
.github/workflows/spack-ci.yml actions
.github/workflows/nag_build_discover.yml actions
.github/workflows/scheduled_workflows.yml actions
.github/workflows/cdash-nightly.yml actions
  • actions/checkout v6 composite
.github/workflows/cron-stale.yml actions
  • actions/stale v10 composite
.github/actions/ci-build-and-test-mapl/action.yml actions
.github/workflows/markup-link-checker.yml actions
  • Wandalen/wretry.action v3.8.0 composite
  • actions/checkout v6 composite

Score: 11.362218847545526