rws-ddlpy 0.5.0

Service from Rijkswaterstaat for distributing water quantity data.

ddlpy

(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

Install the latest ddlpy PyPI release with (extra dependencies between [] are optional):

pip install rws-ddlpy[netcdf,examples]

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

Run ddlpy from console

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

Something broke?

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.