Calling EPANET from Matlab

14Aug08

The easy way to use EPANET with Matlab, is to DOWNLOAD this set of Matlab methods.

This is an “enhanced modified” version of the ones originally posted by Philip Jonkergouw. Please cite the authors of the codes – you are entitled to modify and use the code as you wish.

Use with caution, and verify the algorithms. In case you find bugs, have any remarks or need extra information, please do not hesitate to contact me. For EPANET questions you can always refer to the Water Simulation Forum.

In more detail now, for “lower-lever” programming, the first thing one must do is to put epanet2.dll and epanet2.h in a new folder and setup Matlab to work within that folder. The library files can be imported in Matlab using the loadlibrary command. To see the functions included in the library, use the libfunctions command. For calling a method, use the calllib command with the same arguments as described in the toolkit. When you have reference to pointers, you must use the libpointer command.

Example code for use with net1.inp from EPANET package:

%MATLAB CODE %load epanet2.dll and .h
loadlibrary('epanet2', 'epanet2')

%display library's functions
libfunctions epanet2 -full

%open network file, set output file eg. net1.inp
calllib('epanet2', 'ENopen', 'net1.inp','net1.txt','');

%run hydraulic simulation and save in output file
calllib('epanet2','ENsolveH');

%run quality simulations and save in output file (after ENsolveH)
calllib('epanet2','ENsolveQ');

%for methods with pointers (returning values in arguments) %setup a pointer with this command, see matlab ref for more information. %the pointer reference is initiated with zero in this case
nnodes = libpointer('int32Ptr',0);
%calls the method
calllib('epanet2','ENgetcount', 0 , nnodes);
%returns the values stored in the pointer
get(nnodes,'Value');
%write a formated text report in output file
calllib('epanet2','ENreport');

%close toolkit
calllib('epanet2', 'ENclose');
%unload library
unloadlibrary epanet2

Filed under: Tools   |  14 Comments