School of GeoSciences

School of GeoSciences



PyGMT communicates with GMT commands using pipes and makes use of the latest Python features. Python 2.3 is, therefore, required. I use the Numeric Python extension for grid I/O, so you will need that for PyGMT to work. If your distribution has seperate development packages (for the header files, etc), you will also need to install that.


As so often, there is hardly anydocumentation. The available documentation of the Python classes and methods can by access by using the pydoc program. The source tar ball contains a directory with some example scripts, which I used to test various bits of the wrapper.


  1. Unpack the source tar ball, using tar
    tar xvzf PyGMT-0.0.tar.gz
  2. Set the environment variable GMTINC to where the GMT header file gmt_grd.h is installed.
  3. Run the setup script:
    ./ install --home=DIR_WHERE_YOU_WANT_THE_STUFF_TO_GO
    Use --home to specify a non-standard installation directory. If you do that, you will need to set the environment variable PYTHONPATH to point to this directory in order for python to find the module. Furthermore, the netCDFlibrary is required. looks for the header files in the standard locations, i.e. /usr/include and /usr/local/include.
  4. Run the example/test scripts in the test directory. By issuing commands like
    These scripts should also give a first impression how PyGMT might work. Hopefully, I will get around to add some more documentation.