Skip to content
forked from MPP-LSM/MPP

Multi-Physics Problem (MPP) library is a standalone library that solves biophysics problems relevant to global land surface models (LSMs).

License

Notifications You must be signed in to change notification settings

E3SM-Project/MPP

 
 

Repository files navigation

MPP

License DOI Build Status Code Coverage

Multi-Physics Problem (MPP) library is a standalone library that solves biophysics problems relevant to global land surface models (LSMs).

Installation

Requirements

  • Mac
  • Git
  • C and Fortran compiler
  • CMake
  • PETSc
  • Message Passing Interface

Installation instructions

Install PETSc

  1. Clone PETSc and check out the supported version.
cd <directory-of-choice>
git clone https://bitbucket.org/petsc/petsc petsc
cd petsc
git checkout v3.16.2
  1. Configure PETSc. (Detailed PETSc installation instructions are available here)

2.1. Set PETSc installation location and architecture

export PETSC_DIR=$PWD
export PETSC_ARCH=<user-defined>

2.2. Set compilers

# Set compilers
export CC=<Parallel-C-compiler>
export CXX=<Parallel-C++-compiler>
export FC=<Parallel-Fortran-compiler>
export MPIEXCE=<Path-to-mpiexec>
export BLAS_DIR=<Path-to-BLAS-dir>

On Mac OS X, one can set BLAS_DIR to /System/Library/Frameworks/Accelerate.framework/Versions/Current/Accelerate

2.3. Run configure

./configure \
--with-cc=$CC   \
--with-cxx=$CXX \
--with-fc=$FC \
--with-mpiexec=$MPIEXEC \
--with-blas-lapack-lib=$BLAS_DIR
  1. Build PETSc
make PETSC_DIR=$PETSC_DIR PETSC_ARCH=$PETSC_ARCH all
  1. Test PETSc installation
make PETSC_DIR=$PETSC_DIR PETSC_ARCH=$PETSC_ARCH test

Install MPP

  1. Clone MPP repository from github.com.
cd <directory-of-choice>
git clone https://github.com/MPP-LSM/MPP
  1. Configure MPP
cd MPP
make CC=$CC CXX=$CXX FC=$FC config
  1. Build MPP (add SKIP_PETSC_TESTS=yes if building on a node that cannot run tests)
make CC=$CC CXX=$CXX FC=$FC install
  1. Run MPP tests
make CC=$CC CXX=$CXX FC=$FC test

Publication

Bisht, G., Riley, W. J., Hammond, G. E., and Lorenzetti, D. M., Development and evaluation of a variably saturated flow model in the global E3SM Land Model (ELM) version 1.0, Geosci. Model Dev., 11, 4085-4102, https://doi.org/10.5194/gmd-11-4085-2018, 2018

Bisht, G., & Riley, W. J. (2019). Development and verification of a numerical library for solving global terrestrial multi‐physics problems. Journal of Advances in Modeling Earth Systems, 11. https://doi.org/10.1029/2018MS001560

About

Multi-Physics Problem (MPP) library is a standalone library that solves biophysics problems relevant to global land surface models (LSMs).

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Fortran 97.0%
  • CMake 1.7%
  • Python 1.1%
  • Other 0.2%