Skip to content

Latest commit

 

History

History
53 lines (31 loc) · 2.27 KB

README.md

File metadata and controls

53 lines (31 loc) · 2.27 KB

dwdbulk: Easy Access to the World of Open German Weather Data

What is it?

dwdbulk is a library that enables users to access open German weather data provided by the Deutsche Wetterdienst (DWD). It aspires to acheive the following objectives:

  • Comprehensive: Covers all relevant data made available by DWD.
  • Accessible: With minimal code and similar interfaces, users can access full longitudinal span for weather stations, both for forecasts and historical observations; similarly users can easily access cross-sectional data for a Germany-wide view.
  • Consistent: Data fields across different time frames and datasets are aligned (e.g. latitude and longitude always in decimal format).
  • Python 3.7+ & Pandas: Uses 'modern' Python. Does not aspire to have a CLI or other interfaces. Is not backed by a database. Yields data in DataFrame format.
  • Lightweight: Minimal dependencies.
  • Linux: Given prevalence of containers and the potential maintenance overhead of Mac & Windows, only Linux is targeted for support.

Library

Build Status

Python client to access weather data from Deutscher Wetterdienst (DWD), the federal meteorological service in Germany.

Installation

pip install git+https://github.com/jlewis91/dwdbulk.git

Spin Up Container to Develop Library

docker-compose -f compose/docker-develop.yml --project-directory . up --build

Usage as library

See notebooks here: examples/

Licenses

Code license

Licensed under the MIT license. See file LICENSE for details.

Data license

The DWD has information about their re-use policy in German and English.

Credits

Thanks to Andreas Motl, Marian Steinbach, Philipp Klaus and all people from DWD. This project is based on dwdbulk2.

Changelog

See file CHANGES.md.