EPIC Program Modeling System (version 1.01) Daene McKinney and Andrey Savitsky 16 August 2001 On this CD you will find executable files for the EPIC Modeling system which is capable of modeling river flow and energy exchange between users. For the current version, the system is limited to 400 river nodes, 5 energy system owners and 36 time steps. If you have the General Algebraic Modeling System (GAMS), please make sure that it is installed in the directory "C:\GAMS\" Please copy the personal editor program "PE.exe" and its help file "PE2.hlp" from the CD-ROM into the C:\GAMS\ directory of your computer. Please copy the directory "EPIC" from the CD-ROM to your computer. The user's guide for the EPIC modeling system is contined in the PDF file "EPICguide.pdf". If you want to see the example of the Aral Sea basin for 1999, please copy the directory "1999" from the CD-ROM to your computer. After you copy this directory, you MUST open the directory, select all the files in the directory and change their property from "read only". Do this by pressing the right mouse button and selecting "properties" and then unchecking the "read only" box. To start the EPIC Program, please execute the file "Main.exe" which is located in the directory "EPIC". First, you must establish the path to the directory you will work in. This is done by seleting the first item in menu "Water" when you run the "Main" program. To see the Aral Sea basin example, please select the directory "1999" that you copied from the CD-ROM. Second, you must rebuild the Aral Sea basin model in your computer in order to establish the correct path to the working directory on your computer. Do this by: 1. Selecting "Build Model" from the "Water" menu and selecting "All Model" and exit to the "Main" program. 2. Selecting "Build Model" from the "Water-Salt" menu and selecting "All Model" and exit to the "Main" program. 3. Selecting "Build Model" from the "Water-Energy" menu and checking "Connect water and energy" and select "All Model". Then exit to the "Main" program. Now, if you have GAMS, you can solve the "water" model, the "water and salt" model and the "water and energy" model. 1. To solve the "Water" model, select "Solve model" from the "water" menu and the program will execute GAMS to solve this model. When GAMS has finished, you can view the results by selecting "Display Results" from the "Water" menu. 2. To solve the "Water and salt" model, select "Solve model" from the "Water-salt" menu and the program will execute GAMS to solve this model. When GAMS has finished, you can view the results by selecting "Display Results" from the "Water-salt" menu. 3. To solve the "Water and energy" model, first, select "Prices" form the "Water-Energy" menu and open and then save the file "money.in". Second, select "Solve model" from the "Water-Energy" menu and the program will execute GAMS to solve this model. When GAMS has finished, you can view the results by selecting "Display Results" from the "Water-Energy" menu. You can also view the new "water" model results by selecting "Display Results" from the "Water" menu If you do not have GAMS, you can still display the input data, the model formulation, and the model results (for the Aral Sea basin example). If you do not want to use the EPIC Program software, you can solve the GAMS model which is also in the directory "1999". GAMS model for Water task: GAMS model: Riv_new.gms, cnstr, equation, digits.in Output files: River.new, Demo.new GAMS model for Water + Salt task: GAMS model: Riv_news.gms, cnstr, cnstr_s, equatios, digits.in Output files: RiverS.new, Demo.new, Demo_S.new GAMS model for Water + Energy task: GAMS model: Riv_newE.gms, cnstr, cnstr_E, equatioE, digits.in, demand.in, money.in, Output files: RiverE.new, Demo.new, Demo_E.new In ths case, you may need to edit the "paths" for the "included" files in the model. Search for "$Include"in the GAMS files. All data in the Aral Sea basin example was collected by the participants of the USAID EPIC Program Coordination and Technical Groups on Modeling. You can see these data in the file "Data_1999.xls" on the CD-ROM. There may be mistakes in the data and this can be corrected as necessary. There may be mistakes in the software, and we take full responsibility for these mistakes. If errors are identified, please send them to us and we will correct them.