Water Network Tool for Resilience

A Python package designed to simulate and analyze resilience of water distribution networks.
https://github.com/usepa/wntr

Category: Natural Resources
Sub Category: Water Supply and Quality

Keywords

modeling ord python simulation water

Keywords from Contributors

mathematical-programming hydraulic-modeling mapping-tools multiprocessing snl-applications modeling-language nonlinear-programming

Last synced: about 19 hours ago
JSON representation

Repository metadata

An EPANET compatible python package to simulate and analyze water distribution networks under disaster scenarios.

README.md

GitHub CI
Coverage Status
Documentation Status

The Water Network Tool for Resilience (WNTR) is a Python package designed to simulate and
analyze resilience of water distribution networks. The software includes capability to:

  • Generate water network models
  • Modify network structure and operations
  • Add disruptive events including pipe leaks
  • Add response/repair strategies
  • Simulate pressure dependent demand and demand-driven hydraulics
  • Simulate water quality
  • Evaluate resilience
  • Visualize results

For more information, go to https://usepa.github.io/WNTR/

Installation

The latest release of WNTR can be installed from PyPI or Anaconda using one of the following commands in a command line or PowerShell prompt.

  • PyPI version Downloads

    pip install wntr

  • Anaconda version downloads

    conda install -c conda-forge wntr

See installation instructions for more details.

Citing WNTR

To cite WNTR, use one of the following references:

  • Klise, K.A., Hart, D.B., Bynum, M., Hogge, J., Haxton, T., Murray, R., Burkhardt, J. (2020). Water Network Tool for Resilience (WNTR) User Manual: Version 0.2.3. U.S. EPA Office of Research and Development, Washington, DC, EPA/600/R-20/185, 82p.

  • Klise, K.A., Murray, R., Haxton, T. (2018). An overview of the Water Network Tool for Resilience (WNTR), In Proceedings of the 1st International WDSA/CCWI Joint Conference, Kingston, Ontario, Canada, July 23-25, 075, 8p.

  • Klise, K.A., Bynum, M., Moriarty, D., Murray, R. (2017). A software framework for assessing the resilience of drinking water systems to disasters with an example earthquake case study, Environmental Modelling and Software, 95, 420-431, doi: 10.1016/j.envsoft.2017.06.022

License

WNTR is released under the Revised BSD license. See
LICENSE.md for more details.

Organization

Directories

  • wntr - Python package
  • documentation - User manual
  • examples - Examples and network files

Contact

EPA Disclaimer

The United States Environmental Protection Agency (EPA) GitHub project code is provided on an "as is"
basis and the user assumes responsibility for its use. EPA has relinquished control of the information and
no longer has responsibility to protect the integrity , confidentiality, or availability of the information. Any
reference to specific commercial products, processes, or services by service mark, trademark, manufacturer,
or otherwise, does not constitute or imply their endorsement, recommendation or favoring by EPA. The EPA
seal and logo shall not be used in any manner to imply endorsement of any commercial product or activity
by EPA or the United States Government.

Sandia Funding Statement

Sandia National Laboratories is a multimission laboratory managed and operated by National Technology and
Engineering Solutions of Sandia, LLC., a wholly owned subsidiary of Honeywell International, Inc., for the
U.S. Department of Energy's National Nuclear Security Administration under contract DE-NA-0003525.


Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 7 days ago

Total Commits: 2,983
Total Committers: 60
Avg Commits per committer: 49.717
Development Distribution Score (DDS): 0.605

Commits in past year: 219
Committers in past year: 8
Avg Commits per committer in past year: 27.375
Development Distribution Score (DDS) in past year: 0.388

Name Email Commits
kaklise k****e@s****v 1179
Michael Bynum m****m 783
dbhart d****t@s****v 473
Wendy Dushanin 7****n 134
kbonney k****8@g****m 99
jhogge 5****e 47
Arpan Seth s****a@p****u 45
Thi t****n@g****m 32
Terra Haxton t****n 21
Santiago s****o@g****m 20
Daniel Villa 3****a 17
Joerg Rings m****l@r****e 9
Josh j****h@j****k 9
dmmoria d****a@s****v 9
Joi Chu-Ketterer 4****t 8
Regan Murray m****n@e****v 8
Carl Laird c****d@C****l 8
Michael Bynum m****m@p****u 7
santiagoropb s****b@g****m 6
GalPerelman p****r@g****m 5
Stephen Frechette s****e@c****u 5
angusmcb 5****b 4
Michael Bynum b****m@B****l 4
Michael Bynum m****m@p****u 4
Michael Bynum b****m@c****u 3
Michael Bynum m****m@p****u 3
Carl Laird c****d@s****v 2
Buhari Shehu 4****S 2
Frank f****k@h****i 2
Pablo Marques p****o 2
and 30 more...

Committer domains:


Issue and Pull Request metadata

Last synced: 2 days ago

Total issues: 271
Total pull requests: 254
Average time to close issues: 4 months
Average time to close pull requests: 19 days
Total issue authors: 148
Total pull request authors: 34
Average comments per issue: 3.41
Average comments per pull request: 1.11
Merged pull request: 194
Bot issues: 0
Bot pull requests: 1

Past year issues: 36
Past year pull requests: 60
Past year average time to close issues: about 2 months
Past year average time to close pull requests: 23 days
Past year issue authors: 21
Past year pull request authors: 9
Past year average comments per issue: 2.42
Past year average comments per pull request: 1.68
Past year merged pull request: 39
Past year bot issues: 0
Past year bot pull requests: 1

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/usepa/wntr

Top Issue Authors

  • angusmcb (10)
  • tyjchen (8)
  • DanielaBS1 (7)
  • pshassett (6)
  • uthmankareem (6)
  • henryco123 (6)
  • michaelbynum (6)
  • dionikolop (5)
  • kbonney (5)
  • YanisaMadmay (5)
  • kalebsm (5)
  • chocolate-771 (4)
  • emmaliulu (4)
  • Thaulino (4)
  • jeongsoo0908 (4)

Top Pull Request Authors

  • kaklise (105)
  • kbonney (43)
  • dbhart (29)
  • michaelbynum (20)
  • angusmcb (8)
  • wDushanin (5)
  • jckett (3)
  • BuhariS (3)
  • Thaulino (3)
  • jhogge (3)
  • jrings (3)
  • mariocastrogama (2)
  • emmanuel-ferdman (2)
  • GalPerelman (2)
  • this-josh (2)

Top Issue Labels

  • support (48)
  • enhancement (26)
  • bug (21)
  • installation (13)
  • epanet (6)
  • question (3)
  • documentation (3)
  • dependencies (3)
  • stale (1)

Top Pull Request Labels

  • installation (1)
  • dependencies (1)

Package metadata

pypi.org: wntr

Water Network Tool for Resilience

  • Homepage: https://github.com/USEPA/WNTR
  • Documentation: https://wntr.readthedocs.io/
  • Licenses: Revised BSD
  • Latest release: 1.3.2 (published 2 months ago)
  • Last Synced: 2025-05-16T00:12:16.997Z (2 days ago)
  • Versions: 26
  • Dependent Packages: 6
  • Dependent Repositories: 19
  • Downloads: 11,481 Last month
  • Docker Downloads: 9
  • Rankings:
    • Dependent packages count: 1.596%
    • Dependent repos count: 3.356%
    • Docker downloads count: 3.536%
    • Forks count: 3.851%
    • Stargazers count: 3.906%
    • Average: 3.906%
    • Downloads: 7.192%
  • Maintainers (1)
conda-forge.org: wntr

  • Homepage: https://github.com/USEPA/WNTR
  • Licenses: BSD-3-Clause
  • Latest release: v0.4.2 (published almost 3 years ago)
  • Last Synced: 2025-05-16T00:12:53.363Z (2 days ago)
  • Versions: 9
  • Dependent Packages: 0
  • Dependent Repositories: 3
  • Rankings:
    • Forks count: 14.425%
    • Dependent repos count: 17.914%
    • Stargazers count: 24.672%
    • Average: 27.138%
    • Dependent packages count: 51.54%

Dependencies

.github/workflows/build_tests.yml actions
  • actions/checkout v2 composite
  • actions/download-artifact v3 composite
  • actions/download-artifact v2 composite
  • actions/setup-python v4 composite
  • actions/upload-artifact v3 composite
  • actions/upload-artifact v2 composite
.github/workflows/quick_check.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v4 composite
.github/workflows/release.yml actions
  • actions/checkout v3 composite
  • actions/download-artifact v3 composite
  • actions/setup-python v4 composite
  • actions/upload-artifact v3 composite
  • pypa/cibuildwheel v2.11.1 composite
  • pypa/gh-action-pypi-publish release/v1 composite
requirements.txt pypi
  • coverage *
  • folium *
  • geopandas *
  • ipykernel *
  • matplotlib *
  • nbconvert *
  • nbformat *
  • networkx *
  • numpy *
  • openpyxl *
  • pandas *
  • plotly <=5.11.0
  • pytest *
  • rtree *
  • scipy *
  • sphinx_rtd_theme *
  • utm *
.github/workflows/build_deploy_pages.yml actions
  • actions/checkout v3 composite
  • actions/configure-pages v3 composite
  • actions/deploy-pages v1 composite
  • actions/setup-python v2 composite
  • actions/upload-pages-artifact v1 composite
documentation/environment.yml pypi
pyproject.toml pypi
setup.py pypi

Score: 19.417446336262444