[](https://github.com/woudc/pywoudc/actions)
[](http://pypi.python.org/pypi/pywoudc)
[](http://pypi.python.org/pypi/pywoudc)
# pywoudc
High level package providing Pythonic access to [WOUDC](https://woudc.org/en/data/data-access)
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](http://www.wmo.int/gaw) programme of the World
Meteorological Organization.
The WOUDC archive is made available via
[OGC APIs](https://api.woudc.org). These APIs are publically
available and can be used with any environment and / or software supporting
the OGC API 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](https://www.python.org) 3 and above
- [virtualenv](https://virtualenv.pypa.io)
### Dependencies
Dependencies are listed in [requirements.txt](requirements.txt). Dependencies
are automatically installed during pywoudc installation.
### Installing pywoudc
```bash
# 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
pip3 install .
```
## Running
From the command line:
```bash
pywoudc --version
# get all stations
pywoudc stations
# get station report
pywoudc station <woudc_id>
# get instruments
pywoudc instruments
# get instrument report
pywoudc instrument <instrument_id>
```
## Using the API
```python
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')
# get a GeoJSON dict of all instruments
client.get_metadata('instruments')
```
## Development
```bash
virtualenv pywoudc
cd pywoudc
source bin/activate
git clone https://github.com/woudc/pywoudc.git
cd pywoudc
pip3 install -r requirements.txt
pip3 install -r requirements-dev.txt
```
### Running tests
```bash
# via setuptools
python3 setup.py test
# manually
python3 tests/run_tests.py
```
### Releasing
```bash
# create release (x.y.z is the release version)
vi pywoudc/__init__.py # update __version__
vi debian/changelog # add changelog entry
git commit -am 'update release version x.y.z'
git push origin master
git tag -a x.y.z -m 'tagging release version x.y.z'
git push --tags
# upload to PyPI
rm -fr build dist *.egg-info
python3 setup.py sdist bdist_wheel --universal
twine upload dist/*
# publish release on GitHub (https://github.com/woudc/pywoudc/releases/new)
# bump version back to dev
vi pywoudc/__init__.py # update __version__
git commit -am 'back to dev'
git push origin master
```
### Code Conventions
pywoudc code conventions are as per
[PEP8](https://www.python.org/dev/peps/pep-0008)
## Issues
Issues are managed at https://github.com/woudc/pywoudc/issues
Raw data
{
"_id": null,
"home_page": "https://github.com/woudc/pywoudc",
"name": "pywoudc",
"maintainer": "Tom Kralidis",
"docs_url": null,
"requires_python": null,
"maintainer_email": "tomkraldis@gmail.com",
"keywords": "woudc ozone uv ultra-violet atmosphere atmospheric composition WMO",
"author": "Tom Kralidis",
"author_email": "tomkralidis@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/70/08/f274a076d316bf5902dacc94410ffb5192093e58c558d4744e111647a85f/pywoudc-0.3.1.tar.gz",
"platform": "all",
"description": "[](https://github.com/woudc/pywoudc/actions)\n[](http://pypi.python.org/pypi/pywoudc)\n[](http://pypi.python.org/pypi/pywoudc)\n\n# pywoudc\n\nHigh level package providing Pythonic access to [WOUDC](https://woudc.org/en/data/data-access)\ndata services.\n\n## Overview\n\nThe World Ozone and Ultraviolet Radiation Data Centre (WOUDC) is one of six\nWorld Data Centres which are part of the\n[Global Atmosphere Watch](http://www.wmo.int/gaw) programme of the World\nMeteorological Organization.\n\nThe WOUDC archive is made available via\n[OGC APIs](https://api.woudc.org). These APIs are publically\navailable and can be used with any environment and / or software supporting\nthe OGC API standards. pywoudc provides a high level library using Python idioms\n(API, data structures) which provides Python implementations a simple,\nstraightforward bridge without requiring intimate knowledge of the OGC\nstandards.\n\n## Installation\n\n### Requirements\n- [Python](https://www.python.org) 3 and above\n- [virtualenv](https://virtualenv.pypa.io)\n\n### Dependencies\nDependencies are listed in [requirements.txt](requirements.txt). Dependencies\nare automatically installed during pywoudc installation.\n\n### Installing pywoudc\n\n```bash\n# setup virtualenv\npython3 -m venv --system-site-packages pywoudc\ncd pywoudc\nsource bin/activate\n\n# clone codebase and install\ngit clone https://github.com/woudc/pywoudc.git\ncd pywoudc\npip3 install .\n```\n\n## Running\n\nFrom the command line:\n\n```bash\npywoudc --version\n\n# get all stations\npywoudc stations\n\n# get station report\npywoudc station <woudc_id>\n\n# get instruments\npywoudc instruments\n\n# get instrument report\npywoudc instrument <instrument_id>\n```\n\n## Using the API\n\n```python\nfrom pywoudc import WoudcClient\nclient = WoudcClient()\n\n# get a GeoJSON dict of all contributors\nclient.get_metadata('contributors')\n\n# get a GeoJSON dict of all stations\nclient.get_metadata('stations')\n\n# get a GeoJSON dict of all instruments\nclient.get_metadata('instruments')\n```\n\n## Development\n\n```bash\nvirtualenv pywoudc\ncd pywoudc\nsource bin/activate\ngit clone https://github.com/woudc/pywoudc.git\ncd pywoudc\npip3 install -r requirements.txt\npip3 install -r requirements-dev.txt\n```\n\n### Running tests\n\n```bash\n# via setuptools\npython3 setup.py test\n# manually\npython3 tests/run_tests.py\n```\n\n### Releasing\n\n```bash\n# create release (x.y.z is the release version)\nvi pywoudc/__init__.py # update __version__\nvi debian/changelog # add changelog entry\ngit commit -am 'update release version x.y.z'\ngit push origin master\ngit tag -a x.y.z -m 'tagging release version x.y.z'\ngit push --tags\n\n# upload to PyPI\nrm -fr build dist *.egg-info\npython3 setup.py sdist bdist_wheel --universal\ntwine upload dist/*\n\n# publish release on GitHub (https://github.com/woudc/pywoudc/releases/new)\n\n# bump version back to dev\nvi pywoudc/__init__.py # update __version__\ngit commit -am 'back to dev'\ngit push origin master\n```\n\n### Code Conventions\n\npywoudc code conventions are as per\n[PEP8](https://www.python.org/dev/peps/pep-0008)\n\n## Issues\n\nIssues are managed at https://github.com/woudc/pywoudc/issues\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "High level package providing Pythonic access to WMO WOUDC data services",
"version": "0.3.1",
"project_urls": {
"Homepage": "https://github.com/woudc/pywoudc"
},
"split_keywords": [
"woudc",
"ozone",
"uv",
"ultra-violet",
"atmosphere",
"atmospheric",
"composition",
"wmo"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "380531ee328233d4f21d68323b37ee873b3e0f1551f6939af5179f3d3c2a4546",
"md5": "48cbdeab188f1a4eba6136f726abdb71",
"sha256": "6c96914858a8650eded1f8b45c8646aa57f5eb97ff4379a3eddfaac89fe3fc99"
},
"downloads": -1,
"filename": "pywoudc-0.3.1-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "48cbdeab188f1a4eba6136f726abdb71",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 13792,
"upload_time": "2025-08-18T16:41:28",
"upload_time_iso_8601": "2025-08-18T16:41:28.289835Z",
"url": "https://files.pythonhosted.org/packages/38/05/31ee328233d4f21d68323b37ee873b3e0f1551f6939af5179f3d3c2a4546/pywoudc-0.3.1-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "7008f274a076d316bf5902dacc94410ffb5192093e58c558d4744e111647a85f",
"md5": "c3ba1e33f8187bf01674db5d70c3f4a1",
"sha256": "5e2dbdac1f55d0413a4b21c3a7833c589c3b98049d3fcbfc10b2f642d575a594"
},
"downloads": -1,
"filename": "pywoudc-0.3.1.tar.gz",
"has_sig": false,
"md5_digest": "c3ba1e33f8187bf01674db5d70c3f4a1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 15368,
"upload_time": "2025-08-18T16:41:30",
"upload_time_iso_8601": "2025-08-18T16:41:30.166959Z",
"url": "https://files.pythonhosted.org/packages/70/08/f274a076d316bf5902dacc94410ffb5192093e58c558d4744e111647a85f/pywoudc-0.3.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-18 16:41:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "woudc",
"github_project": "pywoudc",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "click",
"specs": []
},
{
"name": "OWSLib",
"specs": []
},
{
"name": "prettytable",
"specs": []
}
],
"lcname": "pywoudc"
}
JSON
