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, see the WNTR documentation at https://usepa.github.io/WNTR

DeepWiki AI-generated documentation, which includes code architecture diagrams and a chatbot, are available at https://deepwiki.com/USEPA/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

  pip install wntr

• Anaconda

  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., D. Hart, M. Bynum, J. Hogge, Terranna Haxton, R. Murray, AND J. Burkhardt. (2023). Water Network Tool for Resilience (WNTR) User Manual Version 1.0. U.S. Environmental Protection Agency, Washington, DC, EPA/600/B-23/098

• 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

• Katherine Klise, Sandia National Laboratories, kaklise@sandia.gov
• Terra Haxton, US Environmental Protection Agency, haxton.terra@epa.gov

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.