Skip to main content

Python library to ease access to open weather data

Project description

https://github.com/earthobservations/wetterdienst/workflows/Tests/badge.svg https://codecov.io/gh/earthobservations/wetterdienst/branch/master/graph/badge.svg Documentation Status https://img.shields.io/badge/code%20style-black-000000.svg https://img.shields.io/pypi/pyversions/wetterdienst.svg https://img.shields.io/pypi/v/wetterdienst.svg https://img.shields.io/pypi/status/wetterdienst.svg https://pepy.tech/badge/wetterdienst/month https://img.shields.io/github/license/earthobservations/wetterdienst https://zenodo.org/badge/160953150.svg

Welcome to wetterdienst, your friendly weather service library for Python from the neighbourhood! We are a group of people, who try to make access to weather data in Python feel like a warm summer breeze, similar to other projects like rdwd for the R language ,which originally drew our interest in this project. As we long-term goal is to provide you with data from multiple weather services, we are still stuck with the German Weather Service (DWD).

We currently cover

  • historical weather data from ground stations

  • RADOLAN fitted radar data for areal precipitation

and soon

  • MOSMIX statistical optimized scalar forecasts extracted from weather models

To get better insight on which data we have currently made available, with this library take a look at Data Coverage .

CAUTION Although the data is specified as being open, the DWD asks you to reference them as Copyright owner. To check out further, take a look at the Open Data Strategy at the DWD and the Official Copyright

To keep you updated about added features etc. we provide a Changelog .

We strongly recommend reading the full documentation, which will be updated continuously as we make progress with this library: https://wetterdienst.readthedocs.io/en/latest/

Getting started

Run the following to make wetterdienst available in your current environment:

pip install wetterdienst

To get some historical observed station data call

from wetterdienst import collect_dwd_data
from wetterdienst import Parameter, PeriodType, TimeResolution

station_data = collect_dwd_data(
    station_ids=[1048],
    parameter=Parameter.CLIMATE_SUMMARY,
    time_resolution=TimeResolution.DAILY,
    period_type=PeriodType.HISTORICAL
)

Furthermore we currently offer:

  • RADOLAN radar based precipitation for Germany

  • getting metadata for a set of Parameter, PeriodType and TimeResolution

  • getting station(s) nearby a selected location for a given set…

and also

  • storing/recovering collected data

  • a prepared Docker image to run the library dockerized

  • a client to run the library from command line

For the whole functionality, check out the API section of our documentation, which will be constantly updated. Also don’t miss out our examples .

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wetterdienst-0.5.0.tar.gz (41.4 kB view hashes)

Uploaded Source

Built Distribution

wetterdienst-0.5.0-py3-none-any.whl (52.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page