# pywaterinfo
Python package to download time series data from waterinfo.be
## Description
pywaterinfo facilitates access to [waterinfo.be](https://www.waterinfo.be/), a website managed by the [Flanders Environment Agency (VMM)](https://en.vmm.be/) and [Flanders Hydraulics Research](https://www.waterbouwkundiglaboratorium.be/). The website provides access to real-time water and weather related environmental variables for Flanders (Belgium), such as rainfall, air pressure, discharge, and water level. The package provides functions to search for stations and variables, and download time series.
Check out the [documentation website](https://fluves.github.io/pywaterinfo/) for more information.
## Installation
```
pip install pywaterinfo
```
## Example
To initialize data requests from VMM, setup the `Waterinfo` class with `vmm` as input:
```
from pywaterinfo import Waterinfo
vmm = Waterinfo("vmm")
```
The time series provided by waterinfo are all defined by a unique identifier called `ts_id`. Each combination of a given __variable__ (e.g. air pressure)
measured at a given __location__ (e.g. Overpelt) with a certain __frequency__ (e.g. 15min) is defined by an `ts_id` identifier. Using such an identifier,
one can download the data of a given period with the command `get_timeseries_values()`. For example, the 15min air pressure time series
at Overpelt has identifier `ts_id = 78124042`. To get last day of data for the time series with ID `78124042`:
```
df = vmm.get_timeseries_values(78124042, period="P1D")
```
pywaterinfo returns the data as a [Pandas DataFrame](https://pandas.pydata.org/pandas-docs/stable/index.html), which provides functionlities to plot and manipulate the time series.
Requesting data from from HIC is very similar:
```
hic = Waterinfo("hic")
```
Get last day of data for the time series with ID `39496010`, corresponding to high-resolution (5min) conductivity measurements in Dendermonde:
```
df = hic.get_timeseries_values(ts_id="39496010", period="P1D")
```
Next to the request of time series data for a given time series identifier, other
requests are supported as well. These functions provide multiple ways to search for the
`ts_id` you need to download certain data. See the [documentation website](https://fluves.github.io/pywaterinfo/) for more info.
## Note on restrictions of the downloads
The amount of data downloaded from waterinfo.be is limited via a credit system. You do not need to get a token right away to download data. For limited and irregular downloads, a token will not be required.
When you require more extended data requests, please request a download token from the waterinfo.be site administrators via the e-mail address <hydrometrie@waterinfo.be> with a statement of which data and how frequently you would like to download data. You will then receive a client-credit code that can be used to obtain a token that is valid for 24 hours, after which the token can be refreshed with the same client-credit code. The handling of this token is done by
the package itself, but it is important to use the code when initializing the `Waterinfo` instance. For example, using a VMM token:
```
from pywaterinfo import Waterinfo
vmm_token = "YOUR TOKEN CODE"
vmm = Waterinfo("vmm", token=vmm_token)
```
## Contribute
Want to contribute code or functionalities to the `pywaterinfo` package? Great news! Check out the [contributing guidelines](https://fluves.github.io/pywaterinfo/contributing.html) and the [development guidelines](https://fluves.github.io/pywaterinfo/contributing.html#development-guidelines) in the documentation website.
## Acknowledgements
The package development and maintenance is supported by [Fluves](https://fluves.com/).
Part of the initial development of this package has been supported by [VITO](https://vito.be).
<p align="center">
<img src="./docs/_static/img/logo_fluves.png">
<img src="./docs/_static/img/logo_vito.png">
</p>
This package is just a small wrapper around waterinfo.be to facilitate researchers and other stakeholders in downloading the data from [waterinfo.be](http://www.waterinfo.be). The availability of this data is made possible by *de Vlaamse Milieumaatschappij, Waterbouwkundig Laboratorium, Maritieme Dienstverlening & Kust, Waterwegen en Zeekanaal NV en De Scheepvaart NV*.
## Meta
* We welcome [contributions](.github/CONTRIBUTING.rst) including bug reports.
* License: MIT
* Please note that this project is released with a [Contributor Code of Conduct](.github/CODE_OF_CONDUCT.rst). By participating in this project you agree to abide by its terms.
This project has been set up using PyScaffold 3.2.3. For details and usage
information on PyScaffold see https://pyscaffold.org/.
Raw data
{
"_id": null,
"home_page": "https://github.com/fluves/pywaterinfo",
"name": "pywaterinfo",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": null,
"author": "Stijn Van Hoey",
"author_email": "stijn@fluves.com",
"download_url": "https://files.pythonhosted.org/packages/b4/ad/4ff83e41de3cae5832a84b549a391c2556e29427f36563338539ea867d04/pywaterinfo-0.8.1.tar.gz",
"platform": "any",
"description": "# pywaterinfo\n\nPython package to download time series data from waterinfo.be\n\n\n\n## Description\n\npywaterinfo facilitates access to [waterinfo.be](https://www.waterinfo.be/), a website managed by the [Flanders Environment Agency (VMM)](https://en.vmm.be/) and [Flanders Hydraulics Research](https://www.waterbouwkundiglaboratorium.be/). The website provides access to real-time water and weather related environmental variables for Flanders (Belgium), such as rainfall, air pressure, discharge, and water level. The package provides functions to search for stations and variables, and download time series.\n\nCheck out the [documentation website](https://fluves.github.io/pywaterinfo/) for more information.\n\n## Installation\n\n```\npip install pywaterinfo\n```\n\n## Example\n\nTo initialize data requests from VMM, setup the `Waterinfo` class with `vmm` as input:\n\n```\nfrom pywaterinfo import Waterinfo\nvmm = Waterinfo(\"vmm\")\n```\n\nThe time series provided by waterinfo are all defined by a unique identifier called `ts_id`. Each combination of a given __variable__ (e.g. air pressure)\nmeasured at a given __location__ (e.g. Overpelt) with a certain __frequency__ (e.g. 15min) is defined by an `ts_id` identifier. Using such an identifier,\none can download the data of a given period with the command `get_timeseries_values()`. For example, the 15min air pressure time series\nat Overpelt has identifier `ts_id = 78124042`. To get last day of data for the time series with ID `78124042`:\n\n```\ndf = vmm.get_timeseries_values(78124042, period=\"P1D\")\n```\n\npywaterinfo returns the data as a [Pandas DataFrame](https://pandas.pydata.org/pandas-docs/stable/index.html), which provides functionlities to plot and manipulate the time series.\n\nRequesting data from from HIC is very similar:\n\n```\n\nhic = Waterinfo(\"hic\")\n```\n\nGet last day of data for the time series with ID `39496010`, corresponding to high-resolution (5min) conductivity measurements in Dendermonde:\n\n```\ndf = hic.get_timeseries_values(ts_id=\"39496010\", period=\"P1D\")\n```\n\nNext to the request of time series data for a given time series identifier, other\nrequests are supported as well. These functions provide multiple ways to search for the\n`ts_id` you need to download certain data. See the [documentation website](https://fluves.github.io/pywaterinfo/) for more info.\n\n## Note on restrictions of the downloads\n\nThe amount of data downloaded from waterinfo.be is limited via a credit system. You do not need to get a token right away to download data. For limited and irregular downloads, a token will not be required.\n\nWhen you require more extended data requests, please request a download token from the waterinfo.be site administrators via the e-mail address <hydrometrie@waterinfo.be> with a statement of which data and how frequently you would like to download data. You will then receive a client-credit code that can be used to obtain a token that is valid for 24 hours, after which the token can be refreshed with the same client-credit code. The handling of this token is done by\nthe package itself, but it is important to use the code when initializing the `Waterinfo` instance. For example, using a VMM token:\n\n```\nfrom pywaterinfo import Waterinfo\nvmm_token = \"YOUR TOKEN CODE\"\nvmm = Waterinfo(\"vmm\", token=vmm_token)\n```\n\n## Contribute\n\nWant to contribute code or functionalities to the `pywaterinfo` package? Great news! Check out the [contributing guidelines](https://fluves.github.io/pywaterinfo/contributing.html) and the [development guidelines](https://fluves.github.io/pywaterinfo/contributing.html#development-guidelines) in the documentation website.\n\n## Acknowledgements\n\nThe package development and maintenance is supported by [Fluves](https://fluves.com/).\nPart of the initial development of this package has been supported by [VITO](https://vito.be).\n\n<p align=\"center\">\n <img src=\"./docs/_static/img/logo_fluves.png\">\n <img src=\"./docs/_static/img/logo_vito.png\">\n</p>\n\nThis package is just a small wrapper around waterinfo.be to facilitate researchers and other stakeholders in downloading the data from [waterinfo.be](http://www.waterinfo.be). The availability of this data is made possible by *de Vlaamse Milieumaatschappij, Waterbouwkundig Laboratorium, Maritieme Dienstverlening & Kust, Waterwegen en Zeekanaal NV en De Scheepvaart NV*.\n\n## Meta\n\n* We welcome [contributions](.github/CONTRIBUTING.rst) including bug reports.\n* License: MIT\n* Please note that this project is released with a [Contributor Code of Conduct](.github/CODE_OF_CONDUCT.rst). By participating in this project you agree to abide by its terms.\n\nThis project has been set up using PyScaffold 3.2.3. For details and usage\ninformation on PyScaffold see https://pyscaffold.org/.\n",
"bugtrack_url": null,
"license": "mit",
"summary": "Python package to download time series data from waterinfo.be",
"version": "0.8.1",
"project_urls": {
"Documentation": "https://github.com/fluves/pywaterinfo",
"Homepage": "https://github.com/fluves/pywaterinfo"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6c2793ab2b6651476d0ee911dea0313694bdc8f04824ef646ec5e73b4942a856",
"md5": "fdb52bb3b0f57a9f1b1600219d3e1474",
"sha256": "394d8492292c04675665f561012f70b19571986d17d9890249c6a780b31fcd6e"
},
"downloads": -1,
"filename": "pywaterinfo-0.8.1-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "fdb52bb3b0f57a9f1b1600219d3e1474",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.7",
"size": 14862,
"upload_time": "2024-08-28T15:07:08",
"upload_time_iso_8601": "2024-08-28T15:07:08.635001Z",
"url": "https://files.pythonhosted.org/packages/6c/27/93ab2b6651476d0ee911dea0313694bdc8f04824ef646ec5e73b4942a856/pywaterinfo-0.8.1-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b4ad4ff83e41de3cae5832a84b549a391c2556e29427f36563338539ea867d04",
"md5": "d8aa2f60a057889d2b779db6c215f8a9",
"sha256": "e5af7c3733d407270f3fc6c981d7a94ca456fe03cca0a02398534dc14425477e"
},
"downloads": -1,
"filename": "pywaterinfo-0.8.1.tar.gz",
"has_sig": false,
"md5_digest": "d8aa2f60a057889d2b779db6c215f8a9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 50821,
"upload_time": "2024-08-28T15:07:09",
"upload_time_iso_8601": "2024-08-28T15:07:09.597525Z",
"url": "https://files.pythonhosted.org/packages/b4/ad/4ff83e41de3cae5832a84b549a391c2556e29427f36563338539ea867d04/pywaterinfo-0.8.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-28 15:07:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "fluves",
"github_project": "pywaterinfo",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"tox": true,
"lcname": "pywaterinfo"
}
JSON
