Repository for MPAS models and shared framework releases.
  • Fortran 92.8%
  • Python 3.2%
  • C 1.4%
  • C++ 1.1%
  • Makefile 0.8%
  • Other 0.5%
Find a file
Michael Duda 91c5eac175 Merge branch 'hotfix-v8.4.1'
This merge release addresses several issues in the MPAS-Atmosphere model and in
the MPAS infrastructure. Specific changes include:

 * Fix crashes in the atm_srk3 routine when MPAS-A is compiled without defining
   DO_PHYSICS, as is done when the MPAS-A dynamical core is used in, e.g., CAM
   or CAM-SIMA. (PR #1448)

 * Limit the saturation vapor pressure, e_s, used in the Kessler microphysics to
   a value at or below 99% of the full pressure. Prior to this change, the
   saturation vapor pressure formula in Kessler could produce unphysically large
   values of e_s at very low pressures (high model tops) and cause the model to
   blow up. (PR #1452)

 * Fix an issue with multiple occurrences of the same namelist option in the
   specification for the optional active_when attribute for a Registry-defined
   package. With this fix, an active_when attribute may contain logic that uses
   a given namelist option more than once. (PR #1461)

 * Fix a bug that occurs when the number of soil layers in Noah-MP is not the
   default (4 layers), resulting in the model not conserving water. (PR #1459)

 * Fix broken builds with GEN_F90=true by adding missing include paths to the
   Makefile recipes that are used when MPAS is compiled with GEN_F90=true.
   (PR #1465)

 * Switch the allocation of surface arrays to be based on the choice of surface
   layer scheme rather than on the choice of PBL scheme. This change allows
   model simulations that use a surface layer scheme but no PBL scheme to run
   correctly, for example, real-data simulations that use LES options in MPAS-A.
   (PR #1460)
2026-06-09 18:24:03 -06:00
.github Add PR and Issue templates to help unify information 2016-06-06 13:58:11 -06:00
cmake Change the intel fortran preprocessing order. 2026-02-06 16:58:42 -07:00
docs Remove COMPASS from docs 2021-01-15 21:01:42 +01:00
src Merge branch 'sfclayfix' into hotfix-v8.4.1 (PR #1460) 2026-06-09 16:12:41 -06:00
testing_and_setup Copy streams.init_atmosphere in the setup_run_dir.py script for MPAS-A 2025-06-01 11:30:36 -06:00
.gitignore Implement new Makefile logic for sharing framework builds across cores 2024-06-13 14:57:34 -06:00
CMakeLists.txt Add support for building with the nvhpc toolchain via cmake. 2025-03-27 11:31:07 -06:00
INSTALL Updated INSTALL documentation with known problems on IBM Bluegene and Mac OSX 2017-02-07 08:31:32 +01:00
LICENSE Increment version number to 6.2 2019-02-21 16:46:11 -07:00
Makefile Add MPAS_ESMF to Makefile opts for external ESMF 2026-03-07 22:42:39 +00:00
README.md Update version number to 8.4.1 2026-06-04 22:41:59 +00:00

MPAS-v8.4.1

The Model for Prediction Across Scales (MPAS) is a collaborative project for developing atmosphere, ocean, and other earth-system simulation components for use in climate, regional climate, and weather studies. The primary development partners are the climate modeling group at Los Alamos National Laboratory (COSIM) and the National Center for Atmospheric Research. Both primary partners are responsible for the MPAS framework, operators, and tools common to the applications; LANL has primary responsibility for the ocean model, and NCAR has primary responsibility for the atmospheric model.

The MPAS framework facilitates the rapid development and prototyping of models by providing infrastructure typically required by model developers, including high-level data types, communication routines, and I/O routines. By using MPAS, developers can leverage pre-existing code and focus more on development of their model.

BUILDING

This README is provided as a brief introduction to the MPAS framework. It does not provide details about each specific model, nor does it provide building instructions.

For information about building and running each core, please refer to each core's user's guide, which can be found at the following web sites:

MPAS-Atmosphere

MPAS-Albany Land Ice

MPAS-Ocean

MPAS-Seaice

Code Layout

Within the MPAS repository, code is laid out as follows. Sub-directories are only described below the src directory.

MPAS-Model
├── src
│   ├── driver -- Main driver for MPAS in stand-alone mode (Shared)
│   ├── external -- External software for MPAS (Shared)
│   ├── framework -- MPAS Framework (Includes DDT Descriptions, and shared routines. Shared)
│   ├── operators -- MPAS Opeartors (Includes Operators for MPAS meshes. Shared)
│   ├── tools -- Empty directory for include files that Registry generates (Shared)
│   │   ├── registry -- Code for building Registry.xml parser (Shared)
│   │   └── input_gen -- Code for generating streams and namelist files (Shared)
│   └── core_* -- Individual model cores.
│       └── inc -- Empty directory for include files that Registry generates
├── testing_and_setup -- Tools for setting up configurations and test cases (Shared)
└── default_inputs -- Copies of default stream and namelists files (Shared)

Model cores are typically developed independently. For information about building and running a particular core, please refer to that core's user's guide.