jeremiahpslewis / dwdbulk

dwdbulk: Easy Access to Open German Weather Data

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

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.

About

dwdbulk: Easy Access to Open German Weather Data

License:MIT License


Languages

Language:Python 99.0%Language:Dockerfile 1.0%