About this book#

EPANET by Example is a JupyterBook implementation of worked EPANET examples from a variety of sources, some real, most are pedagogical. The examples will have a set of files needed to replicate the example, you simply have to download the files, and run the EPANET model using the various files to replicate the examples.

EPANET by Example also shares the running prototype of the FreeSWMM web interface. FreeSWMM is a website as well as an interface to a desktop environment that is already provisioned with working implementations of SWMM and EPANET running the the EPA-supplied graphical user interface.

Note

This book is a collection of course notes adapted from Cleveland, T.G. 2023. Hydraulic Network Simulation with EPANET and Python. Notes to accompany Metropolia ICT Summer School 2023 Course TX00FJ07. This short course was also taught at Metropolia ICT Summer School in 2018 under the same title. These courses were supported in part by an EU ERASMUS grant.

Suggested Citation#

Cleveland, T.G. 2023. Hydraulic Network Simulation with EPANET and Python. Notes to accompany Metropolia ICT Summer School 2023 Course TX00FJ07

Git-Hub Repository#

This book and supporting files are located in a public repository on GitHub at https://github.com/dustykat/ects-epanet/blob/main/README.md. To recreate the book, clone the repository into your /var/www/html directory (or whatever your webroot is). Then create an entry point to http://YOUR-WEBROOT/ects-epanet/ects-epanet-notes/_build/html/index.html and you should have the book. If you clone the book, you should also get the shared object (.so) library built for my Raspberry Pi. I am not sure it entirely works this way - I left notes to build your own in the book. Windows folks have much better support as the .dll distribute from the EPA website, and I dont think you have to build your own modules.

Note

Some of the links herein are to a specific TCP/IP address and you will need to change it to your webroot for the links to work. If you went to the trouble to clone and rebuild, the prefix (IP address) is obvious; if the address also contains “ects-epanet” then you have the file in the repository and changing the prefix to your webroot will restore the link.

Links with the prefix http://54.243.252.9 are on a different server, that does not have a DNS entry. If you wish to to have a complete copy of the notebook webroot, you will have to take these links to the resource, copy it to your host and adjust the link URL - this was not intentional, just a consequence of learning as I go in how to build web resources.

The freeswmm.ddns.net is a little more complicated. It is a Linux instance running on AWS servers, there are ways to transfer and copy instances, but you are probably better served to just buy a suitable computer if you need to use it for serious computation.