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-291508 (FAULT-ADAPTIVE).

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!

EPANET Open Source Initiative

community.wateranalytics.com

github.com/OpenWaterAnalytics/EPANET

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).

Use of EPANET — GUI-based

Use of EPANET — Shell-based

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

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

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

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

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).

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

Create EPANET object for Net2 Load Toolkit Create EPANET object for Net2

Check structural parameters. Retrieve property values

Get/Set functions Plot Network

Solve Hydraulics Plot Pressure

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

Solve MSX Plot Quality

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

Simulation Results