WDN-Synth: Water Distribution Network Synthetic Dataset Generator
An EPyT-first framework for generating highly realistic, physics-based synthetic datasets for Water Distribution Networks (WDNs). Designed specifically to benchmark anomaly detection algorithms (like HOT SAX or CUSUM) with realistic diurnal patterns, seasonal drifts, and physically consistent leak signatures.
Installation
You can install wdn-synth directly from PyPI:
pip install wdn-synth
Graphical User Interface (GUI)
The easiest way to generate datasets is using the built-in Streamlit GUI. It provides a visual editor to configure your network, set stochastic demands, and visualize the leakage parameters.
To launch the GUI, simply run:
wdn-synth-gui
Command Line Interface (CLI)
For headless environments or automated workflows, you can use the CLI.
To run the entire pipeline (Plan -> Generate -> Validate) in one shot:
wdn-synth all profiles/your_config.yaml
If you prefer to run the steps individually:
wdn-synth validate profiles/your_config.yaml
wdn-synth plan profiles/your_config.yaml
wdn-synth generate profiles/your_config.yaml --shard 0
wdn-synth finalize profiles/your_config.yaml
License
This project is licensed under the EUPL-1.2.
1 maintainer
Metadata
1 maintainer
Release files for wdn-synth 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| wdn_synth-0.1.0.tar.gz | 74.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| wdn_synth-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 169.8 kB
Release files / wdn_synth-0.1.0.tar.gz
| Download URL | wdn_synth-0.1.0.tar.gz |
|---|---|
| Size | 74.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
613173c1b5bda6ff47d1f6ef5243bd05c3f002bf55417a6d080b6e26eb1470cb
|
|
BLAKE2b-256 checksum How to use checksums |
82c3f4e0501e1f5524aa213280199821d9aa49659aa2eee0dd77fa6d7a91a946
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / wdn_synth-0.1.0-py3-none-any.whl
| Download URL | wdn_synth-0.1.0-py3-none-any.whl |
|---|---|
| Size | 95.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9012fa1a33eb41d7f8b267efdeb17bf6eba43712a6221a920911852fa76ceba3
|
|
BLAKE2b-256 checksum How to use checksums |
aea24ec7ea6d89a859e9fd067c1bcef0f490433795e8319c52ebf8cf183bd907
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
