(D)ata (D)istributie (L)aag is a service from Rijkswaterstaat for distributing water quantity data. This package provides an API for Python. See also https://github.com/wstolte/rwsapi for the R API.
Install the latest ddlpy PyPI release with (extra dependencies between [] are optional):
pip install rws-ddlpy[netcdf,examples]
Documentation: https://deltares.github.io/ddlpy
In the examples/notebooks folders you will find the following examples to get you started:
-
minimal_example.py -> minimal code to retrieve data.
-
retrieve_parallel_to_netcdf.py -> Code to retrieve a bulk of observations and write to netcdf files for each station.
-
measurements.ipynb -> interactive notebook to subset/inspect locations and download/plot measurements
-
waterinfo.ipynb -> interactive notebook to read csv's obained from waterinfo.rws.nl
With ddlpy locations you can generate a (subsetted) locations.json file, for instance:
ddlpy locations --quantity WATHTE --station HOEKVHLD
With ddlpy measurements you can obtain measurements for locations/parameters in an existing locations.json, for instance:
ddlpy measurements 2023-01-01 2023-01-03
Check the status of the DDL (at the Updates heading). If you have a suggestion or found a bug in ddlpy, please create an issue.