README.md

pywoudc

High level package providing Pythonic access to WOUDC data services.

Overview

The World Ozone and Ultraviolet Radiation Data Centre (WOUDC) is one of six World Data Centres which are part of the Global Atmosphere Watch programme of the World Meteorological Organization.

The WOUDC archive is made available via OGC Web Services. These web services are publically available and can be used within a GIS environment and / or software supporting the OGC standards. pywoudc provides a high level library using Python idioms (API, data structures) which provides Python implementations a simple, straightforward bridge without requiring intimate knowledge of the OGC standards.

Installation

Requirements

• Python 3 and above
• virtualenv

Dependencies

Dependencies are listed in requirements.txt. Dependencies are automatically installed during woudc-data-registry installation.

Installing pywoudc

# setup virtualenv
python3 -m venv --system-site-packages pywoudc
cd pywoudc
source bin/activate

# clone codebase and install
git clone https://github.com/woudc/pywoudc.git
cd pywoudc
python setup.py build
python setup.py install

Using the API

from pywoudc import WoudcClient
client = WoudcClient()

# get a GeoJSON dict of all contributors
client.get_metadata('contributors')

# get a GeoJSON dict of all stations
client.get_metadata('stations')

Development

virtualenv pywoudc
cd pywoudc
source bin/activate
git clone https://github.com/woudc/pywoudc.git
cd pywoudc
pip install -r requirements.txt
pip install -r requirements-dev.txt

Running tests

# via distutils
python setup.py test
# manually
python tests/run_tests.py

Code Conventions

pywoudc code conventions are as per PEP8

Issues

Issues are managed at https://github.com/woudc/pywoudc/issues