Required dependencies

For plotting on geographical maps:

To open Natural Earth datasets (shapefiles):


regionmask itself is a pure Python package, but its dependencies are not. The easiest way to get them installed is to use conda. The package is avilable on the conda-forge channel.

conda install -c conda-forge regionmask

If you don’t use conda, be sure you have the required dependencies. You can then install regionmask via pip:

pip install regionmask

To run the test suite, install py.test and run py.test regionmask.

To install the development version (master), do:

pip install git+