Skip to main content

Mimetic INTerpolation on the Sphere

Project description

MINT - Mimetic INTerpolation on the Sphere

Cirrus-CI # contributors latest release Commits since last release


This project contains code to regrid edge centred fields from a source to a destination grid. The grid is stored as a collection of grid cells, which have four vertices (i.e. the cells are quadrilaterals). The edge field is stored as integrals of a vector field along each edge. The vertex coordinates are stored in longitude-latitude space.

The regridding method is mimetic in the sense that Stokes's theorem is satisfied to near machine precision. In particular, the loop integrals of an interpolated vector field deriving from a gradient is zero.


To build the MINT Python module:

  • C++ compiler with C++11 support
  • Cython
  • NetCDF library
  • NumPy
  • VTK

We recommend installing the above packages using conda.

To build the MINT C++ library and the tools:

  • C++ compiler with C++11 support
  • Fortran compiler (e.g., gfortran 6.4)
  • NetCDF library
  • Doxygen
  • VTK

How to Build the MINT Python Module

The MINT Python interface requires VTK, netCDF and the tbb libraries to be installed. This is most easily done in a conda environment:

conda env create --file requirements/mint.yml
conda activate mint-dev

In the root MINT directory then type:

pip install --no-deps --editable .

Check that you can import the mint module:

python -c "import mint"

To run the tests type:


How to Build the MINT C++ Library

Perform the following in order to call MINT from Fortran, C or C++:

mkdir build
cd build
cmake ..
make -j 8

You can specify the compiler with:

FC=mpif90 CXX=mpicxx cmake ..; make -j 8

You can check that the build was successful by typing:

make test

Binary Tools

The above CMake build will compile a number of tools. To run the tools, set MINT_SRC_DIR to the location of the MINT source directory (e.g. export MINT_SRC_DIR=..).

  1. Compute the interpolation weights from a lat-lon grid to the cubed sphere:
./tools/regrid_edges -s $MINT_SRC_DIR/data/ -S 0 \
                     -d $MINT_SRC_DIR/data/ -D 1 \
  1. Regrid field edge_integrated_velocity from lat-lon to cubed-sphere by loading the previously generated weights:
./tools/regrid_edges -s $MINT_SRC_DIR/data/ -S 0 \
                     -d $MINT_SRC_DIR/data/ -D 1 \
                     -v edge_integrated_velocity -W -o edge_integrated_velocity.vtk
  1. Compute the weights and regrid in one step:
./tools/regrid_edges -s $MINT_SRC_DIR/data/ -S 0 \
                     -d $MINT_SRC_DIR/data/ -D 1 \
                     -v edge_integrated_velocity -W -o edge_integrated_velocity.vtk
  1. Regrid a time dependent field with elevation:
./tools/regrid_edges -s $MINT_SRC_DIR/data/ -S 0 \
                    -d $MINT_SRC_DIR/data/ -D 1 \
                    -v u@$MINT_SRC_DIR/data/ \
                    -O -o regridedges_xyzt.vtk

API Documentation

This is useful if you would like to call MINT from C, Python or Fortran:

Conservation Error

The plot below shows the error of mimetic regridding error obtained by computing the closed line integral for each cell. alt Error of mimetic regridding

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-mint-1.15.4.tar.gz (86.9 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page