Skip to main content

Python Geoscience Modelling and Interpretation

Project description

PyGMI stands for Python Geoscience Modelling and Interpretation. It is a modelling and interpretation suite aimed at magnetic, gravity and other datasets.

PyGMI is developed at the Council for Geoscience (Geological Survey of South Africa).

It includes:

  • Magnetic and Gravity 3D forward modelling.
  • Cluster Analysis, including use of scikit-learn libraries.
  • Routines for cutting, reprojecting and doing simple modifications to data.
  • Convenient display of data using pseudo-color, ternary and sunshaded representation.
  • MT processing and 1D inversion using MTpy.
  • Gravity processing.
  • Seismological functions for SEISAN data.
  • Remote sensing ratios and improved imports.

It is released under the Gnu General Public License version 3.0

The PyGMI Wiki pages, include installation and full usage!

The latest release version can be found here.

You may need to install the Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017 and 2019.

If you have any comments or queries, you can contact the author either through GitHub or via email at


PyGMI will run on both Windows and Linux. It should be noted that the main development is done in Python 3.9 on Windows.

PyGMI should still work with Python 3.8.

PyGMI is developed and has been tested with the following libraries in order to function:

  • python 3.9.10
  • discretize 0.7.2
  • fiona 1.8.20
  • geopandas 0.10.2
  • llvmlite 0.38.0
  • matplotlib 3.5.1
  • mtpy 1.1.5
  • numba 0.55.0
  • numexpr 2.8.1
  • numpy 1.21.5+mkl
  • pandas 1.4.0
  • pillow 9.0.0
  • psutil 5.9.0
  • pymatsolver 0.2.0
  • pyopengl 3.1.5
  • PyQt5 5.15.1
  • pytest 6.2.5
  • rasterio 1.2.10
  • scikit-image 0.19.1
  • scikit-learn 1.0.2
  • scipy 1.7.3
  • shapely 1.8.0
  • SimPEG 0.16.0
  • sphinx 4.4.0


General (Not Anaconda)

The easiest way to install pygmi if you are working in a python environment is to use the pip command as follows:

pip install pygmi

This will download pygmi from PyPI and install it within your python repository. Please note the use of pip when installing PyGMI may cause Anaconda installations to break. Anaconda users should follow the instructions below.

Alternatively, if you satisfy the requirements, you can download pygmi either from Github or PyPI, extract it and run the following command from within the extracted directory:

python install

In either case, running pygmi can be now done at the command prompt as follows:


If you are in python, you can run PyGMI by using the following commands:

import pygmi


If you prefer not to install pygmi as a library, or if there is a problem with running it in that matter, you can simply execute the following command to run it manually:


Windows Users

Installers are available in 64-bit

Alternatively, you can use the instructions above to run PyGMI with your local python installation. You may need to install some dependencies using downloaded binaries, because of compilation requirements. Therefore, if you do get an error, you can try installing precompiled binaries before installing PyGMI.

Examples of binaries you may need to get are:

  • numexpr
  • numba
  • llvmlite
  • GDAL

They can be obtained from the website by Christoph Gohlke.


Linux normally comes with python installed, but the additional libraries will still need to be installed. One convenient option is to install the above libraries through Anaconda Python.


Anaconda users are advised not to use pip since it can break PyQt5. However, two packages are installed only by pip, so a Conda environment should be created. Note that I installed all packages from the ‘defaults’ conda channel, except where the command specifies otherwise.

The process to install is as follows:

conda create -n pygmi

conda activate pygmi

conda config –add channels conda-forge

conda config –set channel_priority flexible

conda install pyqt

conda install numpy

conda install scipy

conda install matplotlib

conda install psutil

conda install numexpr

conda install pandas

conda install rasterio

conda install geopandas

conda install numba

conda install scikit-learn

conda install scikit-image

conda install pyopengl

conda install segyio

conda install simpeg

conda install pyshp

pip install mtpy

Once this is done, download pygmi, extract (unzip) it to a directory, and run it from its root directory with the following command:


Alternatively, if you satisfy the requirements, you can run the following command from within the extracted directory:

python install

Running pygmi can be now done at the command prompt as follows:


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

pygmi- (2.9 MB view hashes)

Uploaded source

Built Distribution

pygmi- (661.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page