Installation

A Python (3.x) installation is necessary to install the GeophPy package.

Using pip

You can install GeophPy directly from the PyPI repository using pip.

First, make sure you have an up-to-date version of pip using the command:

>>>  pip install --upgrade pip
>>>  or
>>>  python -m pip install --upgrade pip

Then, install, upgrade (or uninstall) GeophPy directly from PyPI repository using pip with these commands:

>>>  pip install geophpy
>>>  pip install --upgrade geophpy
>>>  pip uninstall  geophpy

You can also download the zip file “GeophPy-vx.y” from the PyPI repository, and from the download folder use:

>>>  pip install GeophPy-vx.y.zip

Building from sources

Download the zip file “GeophPy-vx.y” and unzip it. Go to the unzipped folder and run the install script with the following command:

>>>  python setup.py install
>>>  or
>>>  python -m setup.py install

Dependencies

GeophPy depends on the following Python packages:

Name

Version

Comment

numpy

SciPy

matplotlib

netCDF4

Pillow

PySide

pyshp

simplekml

utm

Sphinx

1.4.3 (or greater)

Tip

Failure on Windows

GeophPy uses others Python modules and packages that should be automatically installed. However, the installation of these modules may failed on Windows (in the absence of a C++ compiler for instance).

They can be installed independently using the useful website: http://www.lfd.uci.edu/~gohlke/pythonlibs/. This website provides many popular scientific Python packages precompiled for Windows distributions.

To install a package independently:

  1. Download the precompiled package sources corresponding to your Python version and Windows distribution (SomePackage-vx.y-cp3x-cp3xm_winxx.whl);

    _images/figInstallGeophPyPackages.png

  2. In download folder, use a command prompt and install the package using pip with the name of the downloaded archive:

    >>> python setup.py install SomePackage-vx.y-cp3x-cp3xm_winxx.whl
>>> or
>>> python -m setup.py install SomePackage-vx.y-cp3x-cp3xm_winxx.whl

  3. Repeat the process for all packages which installation failed before re-installing GeophPy.

Uninstallation

The Python package can simply be uninstalled using pip:

>>> pip uninstall geophpy
>>> or
>>>  python -m pip uninstall geophpy