python module for GDP
Python Gherkin Makefile
Switch branches/tags
Nothing to show
Pull request Compare This branch is 20 commits behind USGS-CIDA:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Build Status

pyGDP provides a fast and efficient way of making calls to the USGS GeoData Portal.

pyGDP has the following algorithms: - FeatureCategoricalGridCoverage - FeatureWeightedGridStatistics - FeatureCoverageOPenDap - FeatureCoverageWCSIntersection

Before using the Geo Data Portal via Python, please read the scalability guidelines.

Additional documentation can be found at the Geo Data Portal wiki.


pyGDP request owslib and lxml.etree (which, in turn, uses libxml2 and libxslt)


You can find example usages and scripts in the examples folder.


1.) Use of virtualenv and pip is highly recommended. Sample commands to install pyGDP as a virtual env on a mac/unix operating system are given below. Similar commands can be used on windows.

git clone
virtualenv -p /usr/bin/python2.7 pyGDP/venv
source pyGDP/venv/bin/activate
pip install -r pyGDP/requirements.txt
pip install -r pyGDP/testing-requirements.txt
cd pyGDP
python install
lettuce Lettuce_Tests/features/ --tag=-not_working

OR 2.) Install using pip (first install or --upgrade dependencies):

pip install owslib --upgrade

pip install lxml --upgrade

You can find libxml2 and libxlst with:

pip install libxml2-python

You can install the pyGDP git master branch (with python v.3.0 or greater):

pip install git+ (for the lastest stable version)

pip install git+ (for the, possibly unstable, current commit)


OR 3.) Install using Enthought Canopy:

Find and install the lxml and owslib though Package Manager

(Recommended you set Canopy as your default python environment) Install pyGDP as in 1.)

OR 4.) Install using Anaconda/miniconda Add the IOOS channel and install pyGDP: conda config --add channels ioos -f conda install pygdp

Install pyGDP without subscribing to the channel conda install -c pygdp

For more info on Anaconda and the IOOS channel see:

Having trouble compiling?

Windows users can find the unofficial windows binaries of lxml, owslib, and lots of other packages at:

For OSX users, you can find installation instructions here:

OR use macports

OR install with homebrew ( and pip:

brew install libxml2

pip install lxml


Contact for questions, issues.


  1. Dave Blodgett
  2. Jordan I Walker
  3. Jordan Read
  4. Steve Kochaver


This software is in the public domain because it contains materials that originally came from the U.S. Geological Survey, an agency of the United States Department of Interior. For more information, see the official USGS copyright policy at

Although this software program has been used by the U.S. Geological Survey (USGS), no warranty, expressed or implied, is made by the USGS or the U.S. Government as to the accuracy and functioning of the program and related program material nor shall the fact of distribution constitute any such warranty, and no responsibility is assumed by the USGS in connection therewith.

This software is provided "AS IS."