{"id":13557396,"url":"https://github.com/earthobservations/wetterdienst","last_synced_at":"2026-06-07T01:04:31.080Z","repository":{"id":38108811,"uuid":"160953150","full_name":"earthobservations/wetterdienst","owner":"earthobservations","description":"Open weather data for humans.","archived":false,"fork":false,"pushed_at":"2025-05-05T19:16:00.000Z","size":24614,"stargazers_count":382,"open_issues_count":21,"forks_count":55,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-05-12T22:41:08.168Z","etag":null,"topics":["canada","data","deutscher-wetterdienst","dwd","eccc","germany","historical-data","hydrology","meteorology","open-data","open-source","radar","time-series","uk","united-states","weather","weather-api","weather-forecast","weather-station","weatherservice"],"latest_commit_sha":null,"homepage":"https://wetterdienst.eobs.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/earthobservations.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["gutzbenj"],"patreon":"earthobservations","custom":["paypal.me/BenjaminGutzmann"]}},"created_at":"2018-12-08T15:39:42.000Z","updated_at":"2025-05-07T14:40:43.000Z","dependencies_parsed_at":"2023-10-16T12:50:40.816Z","dependency_job_id":"85352046-cca8-4a6f-a79c-13b489739b65","html_url":"https://github.com/earthobservations/wetterdienst","commit_stats":{"total_commits":1624,"total_committers":27,"mean_commits":"60.148148148148145","dds":0.3589901477832512,"last_synced_commit":"2330a0156e7d9d266162fd7622848a7ce2b840f3"},"previous_names":[],"tags_count":144,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/earthobservations%2Fwetterdienst","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/earthobservations%2Fwetterdienst/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/earthobservations%2Fwetterdienst/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/earthobservations%2Fwetterdienst/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/earthobservations","download_url":"https://codeload.github.com/earthobservations/wetterdienst/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254041312,"owners_count":22004700,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["canada","data","deutscher-wetterdienst","dwd","eccc","germany","historical-data","hydrology","meteorology","open-data","open-source","radar","time-series","uk","united-states","weather","weather-api","weather-forecast","weather-station","weatherservice"],"created_at":"2024-08-01T12:04:19.659Z","updated_at":"2026-06-07T01:04:31.028Z","avatar_url":"https://github.com/earthobservations.png","language":"Python","funding_links":["https://github.com/sponsors/gutzbenj","https://patreon.com/earthobservations","paypal.me/BenjaminGutzmann"],"categories":["Python","data","Atmosphere"],"sub_categories":["Meteorological Observation and Forecast"],"readme":"# Wetterdienst - Open weather data for humans\n\n\u003cp\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/earthobservations/wetterdienst/main/docs/assets/german_weather_stations.png\" alt=\"German weather stations managed by Deutscher Wetterdienst\" width=\"32%\"/\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/earthobservations/wetterdienst/main/docs/assets/temperature_ts.png\" alt=\"temperature timeseries of Hohenpeissenberg/Germany\" width=\"32%\"/\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/earthobservations/wetterdienst/main/docs/assets/hohenpeissenberg_warming_stripes.png\" alt=\"warming stripes of Hohenpeissenberg/Germany\" width=\"32%\"/\u003e\n\u003c/p\u003e\n\n\n\u003e \"What do we want? Climate Justice! When do we want it? Now!\" - FFF\n\n\u003e [!WARNING]\n\u003e This library is a work in progress!\n\u003e Breaking changes should be expected until a 1.0 release, so version pinning is recommended.\n\n### Badges\n\n#### CI\n\n[![CI status](https://github.com/earthobservations/wetterdienst/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/earthobservations/wetterdienst/actions?workflow=Tests)\n[![Documentation status](https://readthedocs.org/projects/wetterdienst/badge/?version=latest)](https://wetterdienst.readthedocs.io/en/latest/?badge=latest)\n[![Code coverage](https://codecov.io/gh/earthobservations/wetterdienst/branch/main/graph/badge.svg)](https://codecov.io/gh/earthobservations/wetterdienst)\n\n#### Meta\n\n[![PyPI version](https://img.shields.io/pypi/v/wetterdienst.svg)](https://pypi.org/project/wetterdienst/)\n[![Conda version](https://img.shields.io/conda/vn/conda-forge/wetterdienst.svg)](https://anaconda.org/conda-forge/wetterdienst)\n[![Project license](https://img.shields.io/github/license/earthobservations/wetterdienst)](https://github.com/earthobservations/wetterdienst/blob/main/LICENSE)\n[![Project status (alpha, beta, stable)](https://img.shields.io/pypi/status/wetterdienst.svg)](https://pypi.python.org/pypi/wetterdienst/)\n[![Python version compatibility](https://img.shields.io/pypi/pyversions/wetterdienst.svg)](https://pypi.python.org/pypi/wetterdienst/)\n\n#### Downloads\n\n[![PyPI downloads](https://static.pepy.tech/personalized-badge/wetterdienst?period=month\u0026units=international_system\u0026left_color=grey\u0026right_color=blue\u0026left_text=PyPI%20downloads/month)](https://pepy.tech/project/wetterdienst)\n[![Conda downloads](https://img.shields.io/conda/dn/conda-forge/wetterdienst.svg?label=Conda%20downloads)](https://anaconda.org/conda-forge/wetterdienst)\n\n#### Citation\n\n[![Citation reference](https://zenodo.org/badge/160953150.svg)](https://zenodo.org/badge/latestdoi/160953150)\n\n## Overview\n\nWelcome to Wetterdienst, your friendly weather service library for Python.\n\nWe are a group of like-minded people trying to make access to weather data in Python feel like a warm summer breeze,\nsimilar to other projects like [rdwd](https://github.com/brry/rdwd) for the R language, which originally drew our\ninterest in this project. Our long-term goal is to provide access to multiple weather services as well as other related\nagencies such as river measurements. With ``wetterdienst`` we try to use modern Python technologies all over the place.\nThe library is based on [polars](https://www.pola.rs/) (we \u003c3 [pandas](https://pandas.pydata.org/), it is still part of\nsome IO processes) across the board, uses [uv](https://github.com/astral-sh/uv) for package administration and GitHub\nActions for all things CI. Our users are an important part of the development as we are not currently using the data we\nare providing and only implement what we think would be the best. Therefore, contributions and feedback whether it be\ndata related or library related are very welcome! Just hand in a PR or Issue if you think we should include a new\nfeature or data source.\n\n## Data\n\nFor an overview of the data we have currently made available and under which license it is published take a look at the\n[data](https://wetterdienst.readthedocs.io/en/latest/data/index.html) section. Detailed information on datasets and\nparameters is given at the [coverage](https://wetterdienst.readthedocs.io/en/improve-documentation/data/coverage.html)\nsubsection. Licenses and usage requirements may differ for each provider so check this out before including the data in\nyour project to be sure that you fulfill copyright requirements!\n\nFor a closer look on the DWD data, you can use the [interactive map](https://bookdown.org/brry/rdwd/interactive-map.html)\nor the [table](https://bookdown.org/brry/rdwd/available-datasets.html) provided by the `rdwd` package.\n\n## Features\n\n- APIs for stations and values\n- Get stations nearby a selected location\n- Define your request by arguments such as `parameters`, `periods`, `start date`, `end date`\n- Define general settings in Settings context\n- Command line interfaced\n- Web-API via FastAPI, hosted on [wetterdienst.eobs.org](https://wetterdienst.eobs.org/)\n- Rich UI features like [explorer](https://wetterdienst.streamlit.app/), [stripes](https://stripes.streamlit.app/)\n- Run SQL queries on the results\n- Export results to databases and other data sinks\n- Public Docker image\n- Interpolation and Summary of station values\n\n## Setup\n\n### Native\n\nVia PyPi (standard):\n\n```bash\npip install wetterdienst\n```\n\nVia Github (most recent):\n\n```bash\npip install git+https://github.com/earthobservations/wetterdienst\n```\n\nThere are some extras available for ``wetterdienst``. Use them like:\n\n```bash\npip install wetterdienst[sql]\n```\n\n- cratedb: Install support for CrateDB.\n- docs: Install the Sphinx documentation generator.\n- duckdb: Install support for DuckDB.\n- export: Install openpyxl for Excel export and pyarrow for writing files in Feather- and Parquet-format.\n- influxdb: Install support for InfluxDB.\n- interpolation: Install support for station interpolation.\n- mysql: Install support for MySQL.\n- matplotlib: Install support for plotting (matplotlib), only used in radar examples.\n- plotting: Install support for plotting (plotly).\n- postgresql: Install support for PostgreSQL.\n- sql: Install DuckDB for querying data using SQL.\n\nTo check the installation, invoke:\n\n```bash\nwetterdienst --help\n```\n\n### Docker\n\nDocker images for each stable release will get pushed to GitHub Container Registry.\n\n``wetterdienst`` serves a full environment, including *all* the optional dependencies of Wetterdienst.\n\nPull the Docker image:\n\n```bash\ndocker pull ghcr.io/earthobservations/wetterdienst\n```\n\n#### Library\n\nUse the latest stable version of ``wetterdienst``:\n\n```bash\n$ docker run -ti ghcr.io/earthobservations/wetterdienst\nPython 3.8.5 (default, Sep 10 2020, 16:58:22)\n[GCC 8.3.0] on linux\n```\n\n```python\nimport wetterdienst\nwetterdienst.__version__\n```\n\n#### Command line script\n\nThe ``wetterdienst`` command is also available:\n\n```bash\n# Make an alias to use it conveniently from your shell.\nalias wetterdienst='docker run -ti ghcr.io/earthobservations/wetterdienst wetterdienst'\n\nwetterdienst --help\nwetterdienst --version\nwetterdienst info\n```\n\n### Raspberry Pi / LINUX ARM\n\nRunning wetterdienst on Raspberry Pi, you need to install **numpy**\nand **lxml** prior to installing wetterdienst by running the following\nlines:\n\n```bash\n# not all installations may be required to get lxml running\nsudo apt-get install gfortran\nsudo apt-get install libopenblas-base\nsudo apt-get install libopenblas-dev\nsudo apt-get install libatlas-base-dev\nsudo apt-get install python3-lxml\n```\n\nAdditionally expanding the Swap to 2048 mb may be required and can be done via swap-file:\n\n```bash\nsudo nano /etc/dphys-swapfile\n```\n\nThanks [chr-sto](https://github.com/chr-sto) for reporting back to us!\n\n## Example\n\n### Task\n\nGet historical climate summary for two German stations between 1990 and 2020\n\n### Library\n\n```python\nfrom wetterdienst import Settings\nfrom wetterdienst.provider.dwd.observation import DwdObservationRequest\n\nsettings = Settings(  # default\n  ts_shape=\"long\",  # tidy data\n  ts_humanize=True,  # humanized parameters\n  ts_convert_units=True  # convert values to SI units\n)\n\nrequest = DwdObservationRequest(\n  parameters=[\n    (\"daily\", \"climate_summary\", \"precipitation_height\"),\n  ],\n  start_date=\"2002-08-11\",  # if not given timezone defaulted to UTC\n  end_date=\"2002-08-13\",  # if not given timezone defaulted to UTC\n  settings=settings\n).filter_by_station_id(station_id=(5779,))\n\nstations = request.df\nstations.head()\n# ┌────────────┬─────────────────┬────────────┬─────────────────────────┬───┬───────────┬────────┬──────────────────────┬─────────┐\n# │ resolution ┆ dataset         ┆ station_id ┆ start_date              ┆ … ┆ longitude ┆ height ┆ name                 ┆ state   │\n# │ ---        ┆ ---             ┆ ---        ┆ ---                     ┆   ┆ ---       ┆ ---    ┆ ---                  ┆ ---     │\n# │ str        ┆ str             ┆ str        ┆ datetime[μs, UTC]       ┆   ┆ f64       ┆ f64    ┆ str                  ┆ str     │\n# ╞════════════╪═════════════════╪════════════╪═════════════════════════╪═══╪═══════════╪════════╪══════════════════════╪═════════╡\n# │ daily      ┆ climate_summary ┆ 05779      ┆ 1971-01-01 00:00:00 UTC ┆ … ┆ 13.7516   ┆ 877.0  ┆ Zinnwald-Georgenfeld ┆ Sachsen │\n# └────────────┴─────────────────┴────────────┴─────────────────────────┴───┴───────────┴────────┴──────────────────────┴─────────┘\n\nvalues = request.values.all().df\nvalues.head()\n# ┌────────────┬────────────┬─────────────────┬──────────────────────┬─────────────────────────┬───────┬─────────┐\n# │ station_id ┆ resolution ┆ dataset         ┆ parameter            ┆ date                    ┆ value ┆ quality │\n# │ ---        ┆ ---        ┆ ---             ┆ ---                  ┆ ---                     ┆ ---   ┆ ---     │\n# │ str        ┆ str        ┆ str             ┆ str                  ┆ datetime[μs, UTC]       ┆ f64   ┆ f64     │\n# ╞════════════╪════════════╪═════════════════╪══════════════════════╪═════════════════════════╪═══════╪═════════╡\n# │ 05779      ┆ daily      ┆ climate_summary ┆ precipitation_height ┆ 2002-08-11 00:00:00 UTC ┆ 67.9  ┆ 10.0    │\n# │ 05779      ┆ daily      ┆ climate_summary ┆ precipitation_height ┆ 2002-08-12 00:00:00 UTC ┆ 312.0 ┆ 10.0    │\n# │ 05779      ┆ daily      ┆ climate_summary ┆ precipitation_height ┆ 2002-08-13 00:00:00 UTC ┆ 26.3  ┆ 10.0    │\n# └────────────┴────────────┴─────────────────┴──────────────────────┴─────────────────────────┴───────┴─────────┘\n\n# to get a pandas DataFrame and e.g. create some matplotlib plots    \nvalues.to_pandas()\n```\n\n### Client\n\n```bash\n# Get list of all stations for daily climate summary data in JSON format\nwetterdienst stations --provider=dwd --network=observation --parameters=daily/kl --all\n\n# Get daily climate summary data for specific stations\nwetterdienst values --provider=dwd --network=observation --parameters=daily/kl --station=1048,4411\n```\n\n### Other\n\nCheckout [examples](https://github.com/earthobservations/wetterdienst/tree/main/examples) for more examples.\n\n## Acknowledgements\n\nWe want to acknowledge all environmental agencies which provide their data open and free of charge first and foremost\nfor the sake of endless research possibilities.\n\nWe want to acknowledge all contributors for being part of the improvements to this library that make it better and\nbetter every day.\n\n## Important Links\n\n- Restapi: https://wetterdienst.eobs.org/\n- Explorer: https://wetterdienst.streamlit.app/\n- Stripes: https://stripes.streamlit.app/\n- Documentation: https://wetterdienst.readthedocs.io/\n\n    - Usage: https://wetterdienst.readthedocs.io/en/latest/usage/\n    - Contribution: https://wetterdienst.readthedocs.io/en/latest/contribution/\n    - Changelog: https://wetterdienst.readthedocs.io/en/latest/changelog.html\n\n- Examples (runnable scripts): https://github.com/earthobservations/wetterdienst/tree/main/examples\n- Benchmarks: https://github.com/earthobservations/wetterdienst/tree/main/benchmarks\n\n## Supported by\n\n[![JetBrains logo.](https://resources.jetbrains.com/storage/products/company/brand/logos/jetbrains.svg)](https://jb.gg/OpenSourceSupport)\n\nSpecial thanks to the kind people at [JetBrains] s.r.o. for supporting us with\nexcellent development tooling.\n\n[JetBrains]: https://www.jetbrains.com/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fearthobservations%2Fwetterdienst","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fearthobservations%2Fwetterdienst","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fearthobservations%2Fwetterdienst/lists"}