1. EPANET-MATLAB Toolkit An Open-Source Software for Interfacing EPANET with MATLAB™
Demetrios ELIADES, Marios KYRIAKOU, Stelios VRACHIMIS and Marios POLYCARPOU
KIOS Research Center for Intelligent Systems and Networks
Electrical and Computer Engineering Department
University of Cyprus
CCWI 2016
November 8, 2016
This research is funded by the European Research Council under the ERC Advanced Grant ERC-2011-ADG
(FAULT-ADAPTIVE).

2. EPANET Created in 1993 by Lew Rossman, version 2 in 2000.
Released in the public domain by the US EPA.
Designed as a research tool to better understand the dynamics of water quality.
Solves flows, pressures and water quality for a certain period of time.
Since v2 it can be linked with external software.
Links with a graphical interface.
Extended capabilities with EPANET-MSX.
Growing popularity!

3. EPANET Open Source Initiative

4. community.wateranalytics.com

5. github.com/OpenWaterAnalytics/EPANET

6. Impact of EPANET Industry & utility operators Researchers:
Standard (de facto) / Interoperability
Run what-if scenarios / Integrated GIS/EPANET-based solutions
Create new products based on it
Researchers:
Create models of real-system and test new methodologies (in silico)
Integrate EPANET as part of their solution methodologies
Facilitated the creation of new research avenues (water security and sensor placement, operational optimization, network design optimization, etc.)
Create benchmarks (networks), the “Battle” competitions
Reproducibility, verifiability (open science).

7. Use of EPANET — GUI-based

8. Use of EPANET — Shell-based

9. Use of EPANET — Library-based
epanet2.dll
toolkit.h
Repeat, Close files
Create Hydraulic and Binary Reports
Simulate Hydraulics and Quality
Do some calculations
Extract data from model
Open EPANET Input File

10. What are the challenges?
User must be aware of all the functions (75+ EPANET/MSX functions)
User must know the proper sequence of function calls
No programming templates
There is no common data structure, which makes portability more difficult
Ability to read/write the Input files
Integrate additional capabilities

11. EPANET-MATLAB Toolkit
First released in 2009 as a “function wrapper” – limited set of functions, no data structure.
Second release in 2013 on GitHub as a MATLAB Class
Continuously being updated with new functions!
Open Source (EUPL)
It can also interface with the executable to create binary report — suitable for distributed computing (Big Data)
@mariosmsk

12. What’s in the Toolkit Matlab Class: epanet.m
More than 11K lines of code!
440 methods!
A single class for retrieving all possible data from Input files
A single class to manage all the available EPANET/MSX functions
Interfaces with library and executable (can also run without the library)
Visualization capabilities (plots networks)
70 public benchmark networks
Latest compiled Libraries/Executables for EPANET 2.1 and EPANET MSX
Unit-testing and example files

13. Why should you care? (aka Conclusions)
The EPANET-MATLAB Toolkit is an easy-to-use tool for researchers.
It can facilitate the design of templates and benchmarks.
It can be a common framework to support reproducible research and open science.
It expands the current capabilities of EPANET.
It is Open Source and is continuously updated by the KIOS Team.
It supports the EPANET binary outputs, using the library and the executable.
All network data are stored in a single object, allowing portability.
Our vision: to create a complete toolkit with example modules to showcase all the different capabilities of EPANET (a tutorial book is underway).

14. github.com/eldemet/ccwi2016
Let’s see it in action!
github.com/eldemet/ccwi2016
Download code
Press “start_toolkit”
Run examples in CCWI2016

15. Create EPANET object for Net2
Load Toolkit
Create EPANET object for Net2

17. Check structural parameters.
Retrieve property values

18. Get/Set functions
Plot Network

19. Solve Hydraulics
Plot Pressure

20. Solve and store results in binary format
Solve Quality
Solve and store results in binary format

21. Solve MSX
Plot Quality

22. Randomized Arsenite Contamination Simulator
Load network
Set sensor locations
Setup simulation
Create random attack scenarios
Sim. injection scenario
Randomize hydraulics
Solve hydraulics and MSX dynamics

23. Simulation Results