skip to navigation
skip to content

pyoos 0.8.2

A Python library for collecting Met/Ocean observations

Note: Pyoos is very much a work in progress and should considered experimental until a 1.0 release is made!

Pyoos attempts to fill the need for a high level data collection library for met/ocean data publically available through many different websites and webservices.

Pyoos will collect and parse the following data services into the Paegan Discrete Geometry CDM:

Common Interface

Filtering data


Filter by bbox

# (minx, miny, maxx, maxy)
collector.filter(bbox=(-74, 30, -70, 38))


Filter from a datetime (the ‘start’ parameter)

from dateime import dateime, timedelta
collector.filter(start=datetime.utcnow() - timedelta(hours=1))

Filter until a datetime (the ‘end’ parameter)

from dateime import dateime

Filter a datetime range (both ‘start’ and ‘end’ parameters)

from dateime import dateime, timedelta
collector.filter(start=datetime.utcnow - timedelta(hours=24), end=datetime.utcnow())


It is highly dependent on the data provider how they identify unique features/stations/objects. Pyoos does its best job to figure out what you are passing in. For example, you may pass WMO ID’s to the NDBC collector and Pyoos will request the correct complete URN to the NDBC SOS.

Retrieve a list of unique features available to filter


Filter by unique feature

# Any iterable of strings


Pyoos does its best job to format any string into the correct format for the actual request. For example, you may pass typical standard_name string from CF-1.6 to the NDBC collector and Pyoos will turn it into a complete MMI URI.

Retreive a list of unique variables available to filter


Filter by variable name

# Any iterable of strings

Clear active filters


Filter Chaining

You may chain many filter calls together (it returns a collector object)

collection.filter(bbox=(-74, 30, -70, 38)).filter(end=datetime.utcnow())

You may also combine many filter types into one call to filter

collection.filter(bbox=(-74, 30, -70, 38), end=datetime.utcnow())

Get Data

As Paegan CDM objects


As raw response from provider


Specific functionality

Each collector may implement a set of functions specific to that collection. Please see the Wiki for an explanation of this type of functionality.


You are using virtualenv, right?

  1. Install virtualenv-burrito
  2. Create virtualenv named “pyoos-dev”: mkvirtualenv -p your_python_binary pyoos-dev
  3. Start using your new virtualenv: workon pyoos-dev


Pyoos requires python 2.7.x and is available on PyPI.

The best way to install Pyoos is through pip:

pip install pyoos

Pyoos requires the following python libraries which will be downloaded and installed through pip:

  • Paegan>=0.9.9
  • numpy>=1.7.0
  • scipy
  • netCDF4>=1.0.2
  • Shapely>=1.2.15
  • pytz
  • python-dateutil>=1.5
  • OWSLib (install from git with pip install git+
  • requests
  • Fiona==0.16.1
  • beautifulsoup4==4.2.1
  • lxml>=3.2.0

If your NetCDF4 and HDF5 libraries are in non-typical locations, you will need to pass the locations to the pip command:

NETCDF4_DIR=path HDF5_DIR=path pip install pyoos

There seems to be a problem installing numpy through pip dependency chains so you may need to install numpy before doing any of the above:

pip install numpy==1.7.0


  • Development of a standardized Metadata concept, possibly through SensorML and/or ISO 19115-2

Use Cases

Submit a PR with your use case!


There is a Google Groups mailing list for pyoos:!forum/pyoos

If you are having trouble getting any of the pyoos functionality to work, try running the tests:

git clone
cd pyoos
python test


File Type Py Version Uploaded on Size
pyoos-0.8.2.tar.gz (md5) Source 2016-08-26 40KB