# WaterBenchmarkHub
[](https://pypi.org/project/water-benchmark-hub/)
[](https://opensource.org/licenses/MIT)
[](https://waterbenchmarkhub.readthedocs.io/en/stable/?badge=stable)
[](https://pepy.tech/project/water-benchmark-hub)
[](https://pepy.tech/project/water-benchmark-hub)
The [*WaterBenchmarkHub*](https://waterfutures.github.io/WaterBenchmarkHub) is a platform for
accessing and sharing Water Distribution Network (WDN) benchmarks and data sets.
The webpage is available at
[https://waterfutures.github.io/WaterBenchmarkHub](https://waterfutures.github.io/WaterBenchmarkHub)
-- see [docs/](docs/) for details such as source code, etc.
The availability and accessibility of benchmarks are essential for reproducible research as well as
for accelerating scientific progress.
A benchmark is a *verified* data set or resource (e.g. a water distribution network) together with an
evaluation functions that can evaluate different algorithms/methods under the same criteria.
The WaterBenchmarkHub is also available as a Python package *water-benchmark-hub*.
## Call for Contributions
If you have a benchmark (resource) that is not yet available in the *WaterBenchmarkHub*,
please either create a new issue or read on
[How to Contribute](https://waterbenchmarkhub.readthedocs.io/en/latest/how_to_contribute.html).
## Installation of the Python Package
The Python package supports Python 3.9 - 3.13
### PyPI
```
pip install water-benchmark-hub
```
### Git
Download or clone the repository:
```
git clone https://github.com/WaterFutures/WaterBenchmarkHub.git
cd WaterBenchmarkHub
```
Install all requirements as listed in [REQUIREMENTS.txt](REQUIREMENTS.txt):
```
pip install -r REQUIREMENTS.txt
```
Install the benchmark hub:
```
pip install .
```
## Quick Example
```python
from water_benchmark_hub import load
if __name__ == "__main__":
# Load the GECCO Water Quality 2019 benchmark
benchmark = load("GECCO-WaterQuality2019")
# Load data set
data = benchmark.load_data(return_X_y=True)
# Show number of samples
X_train, y_train = data["train"]
X_val, y_val = data["validation"]
X_test, y_test = data["test"]
print(X_train.shape, X_val.shape, X_test.shape)
```
## Documentation
Documentation is available on readthedocs:
[https://waterbenchmarkhub.readthedocs.io/en/stable/](https://waterbenchmarkhub.readthedocs.io/en/stable/)
## License
MIT license -- see [LICENSE](LICENSE)
## How to Cite?
If you use the WaterBenchmarkHub in your research, please cite it as follows:
```
@article{Artelt_Giese_Vrachimis_Eliades_Polycarpou_Hammer_2025,
title={{The WaterBenchmarkHub: A Platform for Benchmarks in Water Distribution Networks}},
DOI={10.15131/SHEF.DATA.29921051.V1},
journal={21st Computing and Control in the Water Industry Conference (CCWI 2025) at the University of Sheffield (1st - 3rd September 2025)},
publisher={The University of Sheffield},
author={Artelt, André and Giese, Katharina and Vrachimis, Stelios G. and Eliades, Demetris G. and Polycarpou, Marios M. and Hammer, Barbara},
year={2025},
url = {https://github.com/WaterFutures/WaterBenchmarkHub}
}
```
## How to get Support?
If you come across any bug or need assistance please feel free to open a new issue if none of the existing issues answers your questions.
## How to Contribute?
Contributions (e.g. creating issues, pull-requests, etc.) are welcome -- please make sure to read
[How to Contribute](https://waterbenchmarkhub.readthedocs.io/en/latest/how_to_contribute.html),
the [code of conduct](CODE_OF_CONDUCT.md) and follow the [developers' guidelines](DEVELOPERS.md).
Raw data
{
"_id": null,
"home_page": null,
"name": "water-benchmark-hub",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "water, networks, benchmarks, data",
"author": null,
"author_email": "Andr\u00e9 Artelt <aartelt@techfak.uni-bielefeld.de>",
"download_url": "https://files.pythonhosted.org/packages/b2/4b/e735acd7aa1ab5d0efe39df8b15c795036a7c0af6c06f2cae78b8c033928/water_benchmark_hub-0.3.0.tar.gz",
"platform": null,
"description": "# WaterBenchmarkHub\n[](https://pypi.org/project/water-benchmark-hub/)\n[](https://opensource.org/licenses/MIT)\n\n[](https://waterbenchmarkhub.readthedocs.io/en/stable/?badge=stable)\n[](https://pepy.tech/project/water-benchmark-hub)\n[](https://pepy.tech/project/water-benchmark-hub)\n\nThe [*WaterBenchmarkHub*](https://waterfutures.github.io/WaterBenchmarkHub) is a platform for\naccessing and sharing Water Distribution Network (WDN) benchmarks and data sets.\nThe webpage is available at\n[https://waterfutures.github.io/WaterBenchmarkHub](https://waterfutures.github.io/WaterBenchmarkHub)\n-- see [docs/](docs/) for details such as source code, etc.\n\nThe availability and accessibility of benchmarks are essential for reproducible research as well as\nfor accelerating scientific progress.\nA benchmark is a *verified* data set or resource (e.g. a water distribution network) together with an\nevaluation functions that can evaluate different algorithms/methods under the same criteria.\n\nThe WaterBenchmarkHub is also available as a Python package *water-benchmark-hub*.\n\n## Call for Contributions\n\nIf you have a benchmark (resource) that is not yet available in the *WaterBenchmarkHub*,\nplease either create a new issue or read on\n[How to Contribute](https://waterbenchmarkhub.readthedocs.io/en/latest/how_to_contribute.html).\n\n## Installation of the Python Package\n\nThe Python package supports Python 3.9 - 3.13\n\n### PyPI\n\n```\npip install water-benchmark-hub\n```\n\n### Git\nDownload or clone the repository:\n```\ngit clone https://github.com/WaterFutures/WaterBenchmarkHub.git\ncd WaterBenchmarkHub\n```\n\nInstall all requirements as listed in [REQUIREMENTS.txt](REQUIREMENTS.txt):\n```\npip install -r REQUIREMENTS.txt\n```\n\nInstall the benchmark hub:\n```\npip install .\n```\n\n## Quick Example\n\n```python\nfrom water_benchmark_hub import load\n\n\nif __name__ == \"__main__\":\n # Load the GECCO Water Quality 2019 benchmark\n benchmark = load(\"GECCO-WaterQuality2019\")\n\n # Load data set\n data = benchmark.load_data(return_X_y=True)\n\n # Show number of samples\n X_train, y_train = data[\"train\"]\n X_val, y_val = data[\"validation\"]\n X_test, y_test = data[\"test\"]\n print(X_train.shape, X_val.shape, X_test.shape)\n```\n\n## Documentation\n\nDocumentation is available on readthedocs:\n[https://waterbenchmarkhub.readthedocs.io/en/stable/](https://waterbenchmarkhub.readthedocs.io/en/stable/)\n\n## License\n\nMIT license -- see [LICENSE](LICENSE)\n\n## How to Cite?\n\nIf you use the WaterBenchmarkHub in your research, please cite it as follows:\n\n```\n@article{Artelt_Giese_Vrachimis_Eliades_Polycarpou_Hammer_2025,\n title={{The WaterBenchmarkHub: A Platform for Benchmarks in Water Distribution Networks}},\n DOI={10.15131/SHEF.DATA.29921051.V1},\n journal={21st Computing and Control in the Water Industry Conference (CCWI 2025) at the University of Sheffield (1st - 3rd September 2025)},\n publisher={The University of Sheffield},\n author={Artelt, Andr\u00e9 and Giese, Katharina and Vrachimis, Stelios G. and Eliades, Demetris G. and Polycarpou, Marios M. and Hammer, Barbara},\n year={2025},\n url = {https://github.com/WaterFutures/WaterBenchmarkHub}\n}\n```\n\n## How to get Support?\n\nIf you come across any bug or need assistance please feel free to open a new issue if none of the existing issues answers your questions.\n\n## How to Contribute?\n\nContributions (e.g. creating issues, pull-requests, etc.) are welcome -- please make sure to read\n[How to Contribute](https://waterbenchmarkhub.readthedocs.io/en/latest/how_to_contribute.html),\nthe [code of conduct](CODE_OF_CONDUCT.md) and follow the [developers' guidelines](DEVELOPERS.md).\n",
"bugtrack_url": null,
"license": null,
"summary": "WaterBenchmarkHub",
"version": "0.3.0",
"project_urls": {
"Documentation": "https://water-benchmark-hub.readthedocs.io/en/latest/",
"Homepage": "https://github.com/WaterFutures/WaterBenchmarkHub",
"Issues": "https://github.com/WaterFutures/WaterBenchmarkHub/issues",
"Repository": "https://github.com/WaterFutures/WaterBenchmarkHub.git"
},
"split_keywords": [
"water",
" networks",
" benchmarks",
" data"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b7948d0ec86af361b83f22ca71bf0010472e533ec7b13b8bd0cd78a1f4d7612e",
"md5": "cedce6eb547b6c03c9bf83bed6664c91",
"sha256": "da0dcc9c67cd649bc17dd927d9c1594625aa83829ccd31849e0b4d28015bc222"
},
"downloads": -1,
"filename": "water_benchmark_hub-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cedce6eb547b6c03c9bf83bed6664c91",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 194702,
"upload_time": "2025-09-01T19:46:46",
"upload_time_iso_8601": "2025-09-01T19:46:46.524812Z",
"url": "https://files.pythonhosted.org/packages/b7/94/8d0ec86af361b83f22ca71bf0010472e533ec7b13b8bd0cd78a1f4d7612e/water_benchmark_hub-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b24be735acd7aa1ab5d0efe39df8b15c795036a7c0af6c06f2cae78b8c033928",
"md5": "2578d4556b921dce4a6bd27464f9f714",
"sha256": "3b91be6cfd0fc30e73eefc4acd4c382ebe2baa83f3c219fba6b57bd0844e6377"
},
"downloads": -1,
"filename": "water_benchmark_hub-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "2578d4556b921dce4a6bd27464f9f714",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 375424,
"upload_time": "2025-09-01T19:46:47",
"upload_time_iso_8601": "2025-09-01T19:46:47.987414Z",
"url": "https://files.pythonhosted.org/packages/b2/4b/e735acd7aa1ab5d0efe39df8b15c795036a7c0af6c06f2cae78b8c033928/water_benchmark_hub-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-01 19:46:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "WaterFutures",
"github_project": "WaterBenchmarkHub",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "water-benchmark-hub"
}
JSON
