/EPANET

The Water Distribution System Hydraulic and Water Quality Analysis Toolkit

Primary LanguageCMIT LicenseMIT

OWA-EPANET

Build Status

Build status Build Status

codecov

DESCRIPTION

EPANET is an industry-standard program for modeling the hydraulic and water quality behavior of water distribution system pipe networks. The EPANET Programmer's Toolkit is a library of functions (or API) written in C that allow programmers to customize the use of EPANET's solution engine for their own applications. Both EPANET and its toolkit were originally developed by the U.S. Environmental Protection Agency (USEPA). If you are interested in using/extending the EPANET engine and its API for academic, personal, or commercial use, then you've come to the right place. Read more about EPANET on Wikipedia. (Please note that this project covers only the EPANET hydraulic and water quality solver engine, not the graphical user interface.)

INSTALLATION

Instructions for building the OWA-EPANET Toolkit's function library as well as its command line executable from the source files in this repository can be found here.

USAGE

See the full documentation of the OWA-EPANET API, along with examples of how to use the toolkit for water distribution system analysis. Additional information may be found on this project's Wiki.

CONTRIBUTING

Everyone is welcome to participate in this project. Whether you are helping others to resolve issues, reporting a new issue that hasn't yet been discovered, suggesting a new feature that would benefit your workflow, or writing code (or tests, or scripts, or ...), we value your time and effort. The path for contribution starts with the Issues. Look around at open Issues and the conversation around them, get engaged by commenting on an outstanding Issue or creating a new one. If you want to contribute code, it helps to give the community time to discuss the ideas you present and offer constructive feedback. Once you get a clear path forward, Fork this repo to your own account. Make your commits on your dev branch (or one based on dev). Once you are finished, you can open a Pull Request to test the code and discuss merging your changes back into the community repository. A step-by-step tutorial on how to contribute to OWA-EPANET using GitHub is also available.

CREDITS

The Open Water Analytics (OWA) Community is an international group of EPANET developers and users, whose objective is to provide group interaction and coordinated development of the EPANET codebase, to ensure that important new user interface and algorithmic features are identified and that these features progress efficiently from prototype code to production implementations. OWA is actively maintaining OWA-EPANET, a community-supported branch of USEPA EPANET, since May 2014. The full list of individuals contributing to this project can be found here.

DISCLAIMER

Although OWA is not formally affiliated with nor endorsed by USEPA, this project has been a collaborative effort between the two that builds upon and extends the USEPA’s legacy EPANET 2.0 code base. For the last "official" release of EPANET please go to the USEPA website.

For more general community discussion, FAQ, and roadmapping of the project, please go to the Community Forum.