Skip to main content

Wetterdienst - Open weather data for humans

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 https://img.shields.io/discord/704622099750191174.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2

Introduction

Welcome to Wetterdienst, your friendly weather service library for Python.

We are a group of like-minded people trying 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.

While our long-term goal is to provide access to multiple weather services, we are still stuck with the German Weather Service (DWD). Contributions are always welcome!

This program and its repository tries to use modern Python technologies all over the place. The library is based on Pandas across the board, uses Poetry for package administration and GitHub Actions for all things CI.

Features

Coverage

The library currently covers

  • Weather observation data. Both historical and recent.

  • Radar data. All of composite, radolan, radvor, sites and radolan_cdc.

  • MOSMIX statistical optimized scalar forecasts extracted from weather models. Both MOSMIX-L and MOSMIX-S is supported.

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

Details

  • Get metadata for a set of Parameter, PeriodType and TimeResolution.

  • Get station(s) nearby a selected location.

  • Command line interface.

  • Run SQL queries on the results.

  • Export results to databases and other data sinks.

  • Public Docker image.

Setup

Run this to make wetterdienst available in your current environment:

pip install wetterdienst

Synopsis

Get historical data for specific stations, using Python:

>>> from wetterdienst.dwd.observations import (
...     DWDObservationData,
...     DWDObservationParameterSet,
...     DWDObservationPeriod,
...     DWDObservationResolution
... )
>>> observations = DWDObservationData(
...    station_ids=[1048,4411],
...    parameters=[DWDObservationParameterSet.CLIMATE_SUMMARY,
...                DWDObservationParameterSet.SOLAR],
...    resolution=DWDObservationResolution.DAILY,
...    start_date="1990-01-01",
...    end_date="2020-01-01",
...    tidy_data=True,
...    humanize_parameters=True,
... )
>>> df = observations.all()

Get data for specific stations from the command line:

# Get list of all stations for daily climate summary data in JSON format
wetterdienst stations --parameter=kl --resolution=daily --period=recent

# Get daily climate summary data for specific stations
wetterdienst readings --station=1048,4411 --parameter=kl --resolution=daily --period=recent

Documentation

We strongly recommend reading the full documentation, which will be updated continuously as we make progress with this library:

For the whole functionality, check out the Wetterdienst API section of our documentation, which will be constantly updated. To stay up to date with the development, take a look at the changelog. Also, don’t miss out our examples.

Data license

Although the data is specified as being open, the DWD asks you to reference them as copyright owner. Please take a look at the Open Data Strategy at the DWD and the Official Copyright statements before using the data.

Release files for wetterdienst 0.12.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for wetterdienst 0.12.1
File Size Uploaded
wetterdienst-0.12.1.tar.gz 75.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for wetterdienst 0.12.1
File Interpreter ABI Platform
wetterdienst-0.12.1-py3-none-any.whl Python 3 none any Details

Total release size: 171.3 kB

Release files / wetterdienst-0.12.1.tar.gz

Download URL wetterdienst-0.12.1.tar.gz
Size 75.5 kB
Tags Source
SHA-256 checksum
How to use checksums
0b0a453763afa3a7ec33c048b2a4ccf95d88fffcd3472b6bbdb2f16f8276f023
BLAKE2b-256 checksum
How to use checksums
245c9f6c40a39684527e1d3f50d3985c6c87935eb6d1e2592a65dee38efaabf6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.1.4 CPython/3.9.1 Linux/5.4.0-1032-azure

Release files / wetterdienst-0.12.1-py3-none-any.whl

Download URL wetterdienst-0.12.1-py3-none-any.whl
Size 95.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4f2eb1d1e7d14dcc6f512c30311fe8dcce327c0aa136dfc21a2fd797ac201903
BLAKE2b-256 checksum
How to use checksums
1e420a7334f097f23e2610bd240bbc4380d6e3595e47ae7a600411227f09a4c8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.1.4 CPython/3.9.1 Linux/5.4.0-1032-azure

Release history Release notifications | RSS feed

0.99.0

2 release files

0.95.0

2 release files

0.94.0

2 release files

0.92.0

2 release files

0.91.0

2 release files

0.90.0

2 release files

0.88.0

2 release files

0.85.0

2 release files

0.84.0

2 release files

0.83.0

2 release files

0.82.0

2 release files

0.79.0

2 release files

0.75.0

2 release files

0.74.0

2 release files

0.72.0

2 release files

0.70.0

2 release files

0.69.0

2 release files

0.67.0

2 release files

0.65.0

2 release files

0.64.0

2 release files

0.60.0

2 release files

0.59.3

2 release files

0.59.1

2 release files

0.59.0

2 release files

0.58.1

2 release files

0.58.0

2 release files

0.57.1

2 release files

0.57.0

2 release files

0.56.2

2 release files

0.56.1

2 release files

0.55.1

2 release files

0.55.0

2 release files

0.54.1

2 release files

0.52.0

2 release files

0.49.0

2 release files

0.48.0

2 release files

0.47.1

2 release files

0.47.0

2 release files

0.46.0

2 release files

0.45.2

2 release files

0.45.1

2 release files

0.45.0

2 release files

0.44.0

2 release files

0.42.1

2 release files

0.42.0

2 release files

0.41.0

2 release files

0.40.0

2 release files

0.39.0

2 release files

0.36.0

2 release files

0.35.0

2 release files

0.34.0

2 release files

0.33.0

2 release files

0.32.4

2 release files

0.32.3

2 release files

0.32.0

2 release files

0.31.0

2 release files

0.30.0

2 release files

0.29.0

2 release files

0.28.0

2 release files

0.27.0

2 release files

0.25.1

2 release files

0.25.0

2 release files

0.24.0

2 release files

0.23.0

2 release files

0.21.0

2 release files

0.20.4

2 release files

0.20.3

2 release files

0.20.2

2 release files

0.20.1

2 release files

0.20.0

2 release files

0.19.0

2 release files

0.16.1

2 release files

0.16.0

2 release files

0.14.1

2 release files

0.13.0

2 release files

This release

0.12.1 This release

2 release files

0.12.0

2 release files

0.11.1

2 release files

0.10.1

2 release files

0.10.0

2 release files

0.9.0

2 release files

0.8.0

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page