spvfly / pygmi

PyGMI - Python Geophysical Modelling and Interpretation

PyGMI Readme

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

• Magnetic and Gravity 3D forward modelling
• Cluster Analysis
• Routines for cutting, reprojecting and doing simple modifications to data
• Convenient display of data using pseudo-color, ternary and sunshaded representation

It is released under the Gnu General Public License version 3.0

For license information see the file LICENSE.txt

Requirements

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

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

• python 3.5.4
• cycler 0.10.0
• GDAL 2.1.4
• llvmlite 0.19.0
• matplotlib 2.0.2
• numba 0.34.0
• numexpr 2.6.2
• numpy 1.13.1
• pillow 4.2.1
• pip 9.0.1
• pyopengl 3.1.1
• pyparsing 2.2.0
• pyqt5 5.9
• python_dateutil 2.6.1
• pytz 2017.2
• scipy 0.19.1
• scikit_learn 0.18.2
• setuptools 36.2.7
• sip 4.19.3
• six 1.10.0

It is possible that it might work on earlier versions, especially on non-windows operating systems.

Installation

General

The easiest way to install pygmi if you are worning 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. 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 setup.py install

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

pygmi

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

import pygmi
pygmi.main()

Windows

I have now made available convenient installers for PyGMI, thanks to Cyrille Rossant.

Installers are available in 64-bit and 32-bit

Running the software can be achieved through the shortcut on your desktop.

You may need to install the Microsoft Visual C++ 2015 Redistributable. It can be obtained from here

Linux

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.

After installation of python, you can follow the instructions under General.

Anaconda

Anaconda does not find pyqt5 on its system even if it is there already. To install pygmi on anaconda, edit the setup.py file, and replace the install_requires switch with the following:

install_requires=["numpy", "scipy", "matplotlib", "gdal", "numexpr", "numba", "Pillow", "PyOpenGL"],

As you can see, all we have done is removed PyQt5 from the requirements. You will need to make sure it is a part of your conda installation though. From this point the regular command will install pygmi:

python setup.py install

Note that you can simply install Anaconda use its 'conda install' command to satisfy dependencies. For example:

conda install gdal
conda install krb5

Make sure that krb5 is installed, or gdal will not work.

Alternative execution

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:

python quickstart.py