pyoos 0.8.1

Common Interface

Filtering data

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

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

from dateime import dateime
collector.filter(end=datetime.utcnow())

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

collector.list_features()

# Any iterable of strings
collector.filter(features=["21KY-BSW004"])

collector.list_variables()

# Any iterable of strings
collector.filter(variables=["sea_water_temperature"])

collector.clear()

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

collector.collect()

collector.raw()

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.

Setup

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

Installation

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+http://github.com/geopython/OWSLib.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

Roadmap

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

Use Cases

Submit a PR with your use case!

Troubleshooting

There is a Google Groups mailing list for pyoos: https://groups.google.com/forum/#!forum/pyoos

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

git clone git@github.com:asascience-open/pyoos.git
cd pyoos
python setup.py test

Contributors

• Kyle Wilcox kyle@axiomdatascience.com

• Sean Cowan scowan@asascience.com

• Alex Crosby acrosby@asascience.com

• Dave Foster dave@axiomdatascience.com

• Filipe Pires Alvarenga Fernandes ocefpaf@gmail.com

Copyright and licence

Copyright (C) 2012-2016 RPS ASA

This file is part of Pyoos.

Pyoos is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Pyoos is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with Pyoos. If not, see http://www.gnu.org/licenses/.