EPANETMATLAB Toolkit An OpenSource Software for Interfacing EPANET

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 v 2 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/Open. Water. Analytics/EPANET

Impact of EPANET § Industry & utility operators § 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 Open EPANET Input File Extract data from model Do some calculations Simulate Hydraulics and Quality Create Hydraulic and Binary Reports Repeat, Close files epanet 2. dll toolkit. h

What are the challenges? 1. User must be aware of all the functions (75+ EPANET/MSX functions) 2. User must know the proper sequence of function calls 3. No programming templates 4. There is no common data structure, which makes portability more difficult 5. Ability to read/write the Input files 6. 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 Git. Hub 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 11 K 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).

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

Load Toolkit Create EPANET object for Net 2

Check structural parameters. Retrieve property values

Get/Set functions Plot Network

Solve Hydraulics Plot Pressure

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