EPANET2 for LINUX and PERL Files

This archive epanet2-unix.tar.gz provides a wrapper which makes EPANET2 toolkit available for PERL developers. Using the developed wrapper, PERL programmers can access the full functionality of EPANET2 hydraulic and water quality simulation engines inside PERL programs. The wrapper may facilitate faster development of programs using PERL and would also enable the usage of EPANET2 simulation engine in web applications. Authors have tested the developed wrapper in PERL cgi scripts running under Apache Web Server 2.0. Some examples are also included in the archive to demonstrate the 
usage of EPANET2 toolkit using PERL. 

Requirements:

The developed wrapper requires the following programs for successfully compiling and using the EPANET2 PERL wrapper under Unix/Linux environments. 
Windows users can also use the same wrapper under Cygwin.  The compilation requierments are:

1. gcc

2. SWIG (Simplified Wrapper and Interface Generator) utility available from http://www.swig.org/.  
   Please download and install the latest version from the website.

3. PERL5 


Installation:

1. Install the SWIG utility (http://www.swig.org/) and note down the installation path of SWIG executable file available in installation's bin directory. 

2. Unzip the archived file epanet2-unix.tar.gz (e.g. unzip epanet2-unix.tar.gz).

3. Untar epanet2-unix.tar (e.g. tar -xvf epanet2-unix.tar).

4. Open the Makefile existing in epanet2/wrappers/perl/ and modify the SWIG variable to point to the SWIG installation path recorded in Step-1.

5. Go to top-level directory epanet2 and type make. It will build the EPANET2 library and the command line program existing in the lib directory. 
   Then the wrappers will be built (in the wrappers/perl directory).

6. Set the environment variable PERL5LIB to point to the wrappers/perl directory. 


Testing:

7. Go into wrappers/perl/examples and try to run the files in there. There is example data in the data directory.