The Quick-Start tutorial is designed for first-time users of InfoWater Pro and provides a guided tour to core commands and functions used to create, run, and analyze a model in InfoWater Pro. The Quick Start tutorial will help first-time users become familiar with the core set of InfoWater Pro features and should be used as a launching point to a more comprehensive understanding of InfoWater Pro.
The general layout of the InfoWater Pro interface is shown below. All ArcGIS menus and toolbars are accessible while using InfoWater Pro. To avoid confusion between ArcGIS and InfoWater Pro menus, all InfoWater Pro menus are accessed using the InfoWater Pro drop-down menu. The ArcGIS table of contents is shown on the left.
The Model Explorer - Attribute Tab is on the right-side of the figure below. The Model Explorer - Attribute Tab details the currently selected feature in the InfoWater Pro model. InfoWater Pro adds three additional tabs to this dialog box, Contour, Operation, and Annotation. Feature data may be updated in the tabular section, while the buttons at the top provide access to more advanced parameters and functions.
The InfoWater Pro user interface consists of the following:
InfoWater Pro Menu – Contains all InfoWater menus. Individual menus are organized by functionally within this main menu.
Contents – Controls the display of all layers in the map document. Refer to ESRI documentation for more details.
Model Explorer - Attribute Tab – The InfoWater Pro xplorer - Attribute Tab allows you to view and edit the database information of a selected link or node. The InfoWater Browser also provides access to operational features as well as annotation and contours and Command Center with Edit, Exchange, Scenario, Tools, Utilities, and Help menus.
The basic InfoWater Pro menu structure is detailed below:
Project – Use to import H2OMAP or H2ONET projects and set the project's spatial reference.
Edit – Use to edit InfoWater model input data including attributes for multiple components.
View – Use to change the map display and add/remove InfoWater toolbars.
Exchange – Import and export data including shapefiles, EPANET files, and feature classes.
Scenario – Use to define and edit scenarios and their components.
Tools – Use to run a simulation, view reports/graphs, create animations, and much more.
Utilities – Contains specialized editing tools including:
- Locate network components
- Change Element ID
- Review network connectivity and fix problem areas
- Perform database and graphical transfers
Help - Use the online help system for information on how to use InfoWater Pro. Additionally, link to the Innovyze Internet home page for additional information and software updates.
The estimated time to complete the Quick Start tutorial is approximately four hours.
The Quick Start tutorial will help first-time users become familiar with the following:
- Starting InfoWater Pro and opening a model, called a “project” in InfoWater Pro.
- Adding essential modeling information to the project including building the network map and entering network facility and related data.
- Setting important modeling options.
- Performing a standard (hydraulic and water quality) simulation.
- Running a fire flow simulation.
- Conducting an energy management simulation.
- Developing modeling scenarios.
- Reviewing and analyzing model results.
- Saving the model for later use.
During the Quick Start tutorial, the user will modify an existing project called “Yourtown”. This project is provided with the typical InfoWater software installation and can be found in one of the following directories (location depends on operating system and install method):
For Windows XP (one of the following):
C:\Documents and Settings\All Users\Documents\InfoWater\Examples
C:\Program Files\ InfoWater Pro\Examples
For Vista (one of the following):
C:\ Users\Public\Documents\ InfoWater Pro\Examples
C:\Program Files\ InfoWater Pro\Examples
The “Yourtown” project modified in this tutorial illustrates how InfoWater models network hydraulics and chlorine decay, performs fire flow analyses, calculates pump operating costs, and evaluates distribution system performance before and after adding a planned development (subdivision) to the model.
The “Yourtown” model is partially complete and will be completed as part of this tutorial. The completed model contains two pressure zones and consists of the following components:
- One reservoir (storage node 101)
- One tank (storage node 103)
- Two pumps located at the water treatment plant and numbered 200 and 210
- One pressure reducing valve located at node 300
- One check valve located in pipe 78
- Fifty-eight pipes
- Forty-five junction nodes
- One reference file containing the parcel and street layout (not shown in the illustration below)
Pump 200 turns off when the level in tank 103 rises above 40 feet and turns on when the level in tank 103 falls below 25 feet. Pump 210 turns off when the level in tank 103 rises above 45 feet and turns on when the level in tank 103 falls below 35 feet.
Use the following as a reference when completing the tutorial.
During the tutorial, you will be guided through:
- Creating several network components (at least one of each component type).
- Entering modeling data required for hydraulic, water quality, fire flow, and pump energy costing simulations.
- Running and evaluating each simulation type.
- Developing scenarios to evaluate the hydraulic performance of the “Yourtown” system with a proposed new development, including anticipated future demands.
Although not necessary to complete the Quick Start tutorial, it is suggested that you briefly review the Data Elements as described in InfoWater Pro’s On-line Help before continuing.
STEP 1: OPEN THE YOURTOWN PROJECT
The first step is to open the InfoWater project.
- Choose the “Start” menu, select PROGRAMS, choose the ArcGIS Pro, and then choose InfoWater Project.
- Navigate to the directory containing the “Yourtown.mxd” project and choose that file.
- At this point the network map will be drawn on the screen. You will note that the drawing is missing several elements when compared to the illustration on the previous page. You will be adding those components during this tutorial.
- Click on the RED DOWN ARROW icon to initialize InfoWater Pro. When initialized, the icons on the InfoWater Pro toolbars will be enable for use.
- Before continuing, save the “Yourtown” project to a new project. If you wish to restart the tutorial, the original project will be available. Choose the FILE> SAVE AS command. On the dialog box enter the new project name “Tutorial”. This becomes the active project.
STEP 2: DEFINE BASIC OPTIONS FOR THE NEW PROJECT
Before adding new components (pipes, pumps, valves, storage nodes, and junction nodes) to the model, you should identify basic project units and hydraulic properties. In this step, you will identify “gallons per minute” as the flow units and the Hazen-Williams headloss formula for hydraulic analysis. Step 2 should only be performed once when the project is created. These options are saved as a permanent part of the project. You can skip Step 2 whenever the “Tutorial” project is opened for later use.
1. Select the OPERATION tabfrom the INFOWATER BROWSER window, select the SIMULATION OPTIONS ® BASE SIMULATION OPTIONS and double-click. When the SIMULATION OPTIONS dialog box appears choose the GENERAL tab.
2. Choose “Gallon/Minute” from the FLOW UNIT drop-down list on the SIMULATION OPTIONS dialog box. Flow units are applied to pipe flows and to junction demands and define the units of your input data. “Gallon/Minute” also indicates that your input data (elevations, diameters, etc.) will be in US Customary units.
3. Choose “psi” from the PRESSURE UNIT drop-down list. Choose “Hazen-Williams” from the HEADLOSS EQUATION drop-down list.
4. Choose the “OK” button to close the SIMULATION OPTIONS dialog box.
STEP 3: CREATE NETWORK COMPONENTS
The next step is to complete the network by adding new components and entering modeling data for those new network components (facilities). In this step, you will add components to the network and enter the critical attributes required for modeling into the project database. You will add seven pipes, one junction, one tank, one pressure reducing valve and one pump.
Use the illustration on page 3-2 and the tables below as a guide when creating the network.
NOTE: Lengths will be automatically calculated by InfoWater when adding pipes.
In tutorial Step 5, you will modify the lengths to match those indicated in this table
NOTE: Database fields for which no values are required are not illustrated here.
Leave these fields empty when entering data.
When creating the network, don’t worry if it does not match the exact shape and dimensions of that illustrated above; in tutorial Step 4 you will modify network geometry to better match the illustrated network representation.
SET SYMBOL SIZES FOR NEW COMPONENTS
Before adding new components you should set the desired symbol sizes for those new components. InfoWater stores and displays symbols in font size. To change your default symbol sizes, perform the following:
1. Click on the InfoWater buttonand then select the PREFERENCES command. When the PREFERENCES dialog box appears on the screen, select the DEFAULT SYMBOL tab as shown below.
2. Click on each symbol and specify the sizes for each element type as shown below. Press the “OK” button to close the PREFERENCES dialog box.
You will start by digitizing the tank located at node 103 in the upper right-hand corner of the model (use page 3-2 for graphical reference).
1. Click on the INSERT TANK iconfrom the INFOWATER PRO EDIT toolbar. Move the cursor to the desired location and press the left mouse button. Select a general tank location per the network map provided on page
2. You are then prompted to enter the identifier and an optional description for the new tank. Enter the TANK ID as shown below, using a comma to separate the ID from the description.
3. The tank should now appear on the screen as a blue tank symbol. In the MODEL EXPLORER - ATTRIBUTE TAB window, perform the following:
Choose “0: Cylindrical Tank” in the TYPE field.
Enter “320.00” in the Elevation field.
Enter “10.00” in the Minimum Level field.
Enter “50.00” in the Maximum Level field.
Enter “44.00” in the Initial Level field.
Enter “50.00” in the Diameter field.
Leave all other fields blank.
The MODEL EXPLORER - ATTRIBUTE TAB window should appear as above. Please note that you may have different values for the geometry coordinates.
4. Click once on the “Save” button .
You will now add pump 200 between junction 1 and junction 3 (use page 3-2 for graphical reference).
1. Click on the INSERT PUMP iconfrom the INFOWATER Pro EDIT toolbar. Move the cursor to the center of the network (just above pump 210) and press the left mouse button. For the general location of junction pump 200, refer to the network map provided on page 3-2.
2. You are then prompted to enter the pump identifier and an optional description for the new pump. Enter the PUMP ID as shown below, using a comma to separate the ID from the description.
3. Pump 200 should now appear as a magenta pump node symbol. In the MODEL EXPLORER - ATTRIBUTE TAB window on the right, perform the following:
- Choose the “2: Exponential 3-Point Curve” in the TYPE field.
- Enter “95.00” in the ELEVATION field.
- Enter “10.00” in the DIAMETER field.
- Enter “280.00” in the SHUTOFF HEAD field.
- Enter “260.00” in the DESIGN HEAD field.
- Enter “400.00” in the DESIGN FLOW field.
- Enter “220.00” in the HIGH HEAD field.
- Enter “800.00” in the HIGH FLOW field.
- Leave all other fields blank.
The MODEL EXPLORER - ATTRIBUTE TAB window should appear as:
4. Click once on the “Save” button .
You will now add valve 300 between junction nodes 87 and 49. This valve maintains unidirectional flow and constant water pressure from pressure zone 1 to pressure zone 2 (use page 3-2 for graphical reference).
1. Click on the INSERT VALVE iconfrom the INFOWATER PRO EDIT toolbar. Move the cursor to the lower left corner of the network and press the left mouse button. For the general location of valve 300, refer to the network map provided on page 3-2.
2. You are then prompted to enter the valve identifier and an optional description for the new valve. Enter the VALVE ID as shown below, using a comma to separate the ID from the description.
3. Valve 300 should now appear as a yellow valve symbol. In the MODEL EXPLORER - ATTRIBUTE TAB window on the right, perform the following:
- Choose the “0: Pressure Reducing Valve” in the TYPE field.
- Enter “50.00” in the ELEVATION field.
- Enter “8.00” in the DIAMETER field.
- Enter “50.00” in the SETTING field.
- Enter “0.00” in the MINOR LOSS field.
- Leave all other fields blank.
The MODEL EXPLORER - ATTRIBUTE TAB window should appear as:
4. Click once on the “Save” button .
Digitize the pipes as listed in page 3-5 starting with pipe 52 at the bottom left-hand corner of the network, connected to PRV 300 (use figure on page 3-2 for graphical reference).
1. Click on the INSERT PIPE iconfrom the INFOWATER EDIT NETWORK toolbar. Using your mouse, left click on junction node 33, and then double-click on junction node 87 to complete the straight line representing pipe 52.
2. You are then prompted to enter the pipe identifier and an optional description for the new pipe. Enter “52, New Pipe” in the PIPE ID field as shown below.
3. Pipe 52 should now appear as a blue line connecting junction nodes 33 and 87. In the MODEL EXPLORER - ATTRIBUTE TAB window, choose the MODELING section and enter the information associated with pipe 52 as listed in the Pipe Attributes table on page 3-5 except for the LENGTH field. Leave the length as is. The MODEL EXPLORER - ATTRIBUTE TAB window should appear as:
4. Click once on the “Save” button .
Enter the location and attributes for pipes 76, 104, 200A, 200B, 300A and 300B in a similar fashion as pipe 52. You should add intermediate shape-defining vertices along pipe 76 to reflect the slight bend in the road.
Please Note: The pipes connecting the point facilities at Pump 200 and Pressure Reducing Valve 300 determine the anticipated direction of flow for these items. Pipe 200A should be defined from node 1 to pump node 200 and pipe 200B should be defined from pump node 200 to node 3. The pipes at the valve node 300 should be defined in a similar fashion. Pipe 300A will go from node 87 to valve node 300 and pipe 300B will go from valve node 300 to node 49.
NETWORK CREATION PRODUCTIVITY TOOLS
You have probably noticed that nodes must be added to the project prior to adding the pipes connecting them. Choosing the INSERT JUNCTION, INSERT TANK, INSERT RESERVOIR, INSERT PUMP and INSERT VALVE commands before adding pipes can therefore slow the network creation process when you have a large number of components to add.
InfoWater provides a shortcut allowing you to create network component of all types at one time. You can use the DIGITIZE NETWORK iconfrom the INFOWATER EDIT NETWORK toolbar to digitize junctions and pipes in series, eliminating the need to keep making separate choices. The DIGITIZE NETWORK command provides a method for data entry where you are not required to first enter the junction nodes prior to entering pipes. Use of the DIGITIZE NETWORK command is entirely optional, but is recommended for bulk data entry.
Additional commands such as MERGE NODE from the UTILITIES menu (to remove a junction node and “dissolve” the boundary between two adjacent pipes of the same type) can be used to further modify your distribution system network.
To modify the attributes of any network component, use the MODEL EXPLORER - ATTRIBUTE TAB window.
STEP 4: MODIFY THE NETWORK CONFIGURATION
InfoWater Pro provides tools allowing you to maintain and modify the network geometry. In this step, you will modify a pipe’s shape and a junction node’s location to better match the illustration on page 3-2
TURNING OFF “AUTO LENGTH CALCULATION”
Before modifying the network, you should turn off the AUTO LENGTH CALCULATION preference. When this setting is active, InfoWater automatically calculates pipe lengths based on the drawing scale when pipes are added or edited. When this preference is inactive, user-specified pipe lengths will be preserved regardless of the length of the pipe on the map display. To disable the AUTO LENGTH CALCULATION preference, perform the following:
1. Click on the InfoWater Pro buttonand then select the PREFERENCES command under PROJECT Menu.
2. Choose the OPERATION SETTINGS tab and disable the AUTO LENGTH CALCULATION preference by clicking on the check-box so that no check appears next to the prompt. Leave all other preferences in their current state.
3. Click on the “OK” button to close the window. The preference is now set.
MODIFYING PIPE SHAPE
If you added any pipes in Step 3 above with a curvilinear representation, you can now adjust any intermediate shape-defining points for those pipes. You will now re-digitize pipe 76 to better match the shape of the street. First note the length of the pipe before the edit:
Click on the SELECT ELEMENT iconfrom the INFOWATER EDIT MENU toolbar, click on pipe 76 and then select the REDRAW PIPE icon from the INFOWATER PRO EDIT MENU toolbar to redraw the pipe.
From the MODEL EXPLORER - ATTRIBUTE TAB window note that the length of the pipe remains unchanged as the Auto Length Calculation preference is OFF (disabled). Alternatively, you can edit the vertices by using the EDIT PIPE VERTEX iconfrom the INFOWATER PRO EDIT MENU.
Now you can adjust the location of one or more nodes so that your network more accurately matches the diagram illustrated on page 3-2. Note that when you move a node, InfoWater will also stretch the pipes connected to that node. If the Auto Length Calculation preference is “ON” (it is not at this point in the tutorial), InfoWater will re-calculate the lengths of all connecting pipes. To move a node:
Click on the SELECT ELEMENT iconfrom the INFOWATER PRO EDIT MENU , place the cursor on the node to be moved and press the left mouse button, then select the MOVE NODE icon from the INFOWATER PRO EDIT MENU to move the node to the desired location.
STEP 5: MODIFY COMPONENT ATTRIBUTES
InfoWater Pro provides two tools for modifying network component attributes. One method entails selecting a component and modifying its attributes one component at a time. Another method entails viewing and modifying attributes in a spreadsheet format with the DB EDITOR. The former method is illustrated here as you enter the correct pipe lengths for individual pipes and the latter method is used to adjust pipe roughness coefficients.
MODIFY ELEMENTS ONE AT A TIME
When entering pipes earlier in the tutorial, InfoWater automatically calculated pipe lengths. Now, using information from the table on page 3-5 enter the correct pipe lengths for pipes 52, 76, 104, 200A, 200B, 300A and 300B. Perform the following for each pipe:
1. Click on the SELECT ELEMENT iconfrom the INFOWATER EDIT MENU, and then select the pipe with ID 52.
2. In the MODELING section of the MODEL EXPLORER - ATTRIBUTE TAB window, change the length (as computed by InfoWater) to the correct length indicated on page 3-5.
3. Click once on the “Save” icon of the MODEL EXPLORER - ATTRIBUTE TAB window and repeat the process for the six other pipes.
GROUP EDITING WITH THE DATABASE EDITOR
The DB EDITOR is used to maintain InfoWater database tables. The DB EDITOR provides the ability to customize tables by adding user-defined fields and adding, modifying, and deleting table information in a spreadsheet fashion. Using the DB EDITOR you will globally adjust pipe roughness for all pipes in the “Tutorial” project.
1. Click on the DB EDITOR iconfrom the INFOWATERPRO EDIT MENU.
2. When the OPEN TABLE dialog box appears on the screen, choose the PIPE HYDRAULIC (MODELING) DATA table from the ELEMENT HYDRAULIC DATA section, then select ENTIRE TABLE in the DATA SCOPE area (indicating you want the entire contents of the table to be displayed and available for editing), and click once on the “OK” button. The PIPE HYDRAULIC (MODELING) DATA table appears on the screen.
3. To adjust the contents of an entire field, in this case ROUGHNESS, click once on the column header with the mouse. The entire column should be highlighted.
4. You will adjust all roughness coefficients by increasing the current coefficients by 10.
5. Choose the “Block Editing” button while the ROUGHNESS field remains highlighted. When the BLOCK EDITING dialog appears on the screen, choose the “Add” operation, enter “10” for the value to be added, and then choose “OK”. All roughness coefficients should now be increased by 10. Select the “Save” button .
The following picture illustrates how the DB EDITOR should appear after increasing the pipe roughness coefficients by 10:
6. Choose the “Close” iconat the top of the DB EDITOR window. Close the DB EDITOR by selecting the “Exit” icon at the top of the window.
7. This would be a good time to save your work. Choose the FILE> SAVE command. This will save the current state of the InfoWater project data. It is recommended that you save the project after all subsequent tutorial steps.
STEP 6: BUILD THE HYDRAULIC MODEL
Now that you have completed the process of creating the network and entering the attributes associated with network components, the next step is to enter hydraulic modeling options. You will specify a 24-hour extended period simulation (EPS) with a 1-hour hydraulic simulation timestep, build a demand pattern to model temporal variation in water usage at junction nodes, and specify pump 200 to turn on and off based on the water level in tank 103.
SET DURATION OF THE SIMULATION
1. Select the OPERATION tabfrom the INFOWATER MODEL EXPLORER, choose the SIMULATION TIME®BASE, BASE SIMULATION TIME SETTING and double-click. The SIMULATION TIME dialog box should appear on the screen.
2. Double-click on the DECIMAL TIME field to the right of Duration, enter “24” (indicating a length of the entire simulation of 24 time units), and press the TAB key to apply the change. Choose the “Hours” option under UNITS, indicating a 24-hour simulation.
3. Double-click on the DECIMAL TIME field to the right of Hydraulic Timestep, enter “1” and press the TAB key to apply the change. Choose the “Hours” option under UNITS, indicating network hydraulics will be calculated every hour for 24 hours.
4. Change the Pattern Timestep to “1” in a similar fashion as the hydraulic timestep above and choose the “Hours” option. InfoWater will apply a unique demand multiplier for each hydraulic timestep period. Therefore, 24 demand multipliers are required to model varying demands over a 24-hour period. The SIMULATION TIME dialog box should appear as:
5. Leave all the other fields to their default values. Choose the “OK” iconto close the SIMULATION TIME dialog box.
BUILD A PATTERN TO DEFINE VARIABLE DEMANDS
Build a time-series pattern defining a set of multipliers to be applied to the base demand of each junction node at each simulation timestep. Each pattern is identified by a unique alphanumeric identifier (up to thirty-two characters with no embedded spaces or special characters, i.e. #, $, &) and an optional description. At any timestep, the demand at a junction node is the base demand multiplied by the current pattern multiplier. You will enter 24 multipliers for an average day demand pattern, and InfoWater will apply each multiplier for a 1-hour period during the simulation:
1. Select the OPERATION tabfrom the INFOWATER PRO MODEL EXPLORER, click once on PATTERN and then right-click and select the “New” command.
2. You are prompted to enter a new ID and description for the pattern. Enter “1, Average Day Demand” and choose the “OK” button.
3. The PATTERN dialog box appears on the screen. Enter the twenty-four multipliers for pattern 1:
*Choose the “Set Rows” button, then enter “24” as the value, and choose “OK”.
*Enter the pattern factors from step 2. As you add the multipliers the graph will be shown on the dialog box.
*Click on the “Save” buttonat the top of the dialog box to apply the factors to pattern 1.
You will enter the following 24 pattern multipliers set in the values column:
4. Choose the “OK” buttonto close the PATTERN dialog box. Pattern 1 now contains 24 multipliers and is ready for use.
ASSIGN A PATTERN TO JUNCTION NODES
Now that a time-series pattern of demand multipliers has been defined, the pattern can be assigned to the junction nodes.
1. To assign the 24 demand multipliers (pattern) to the junction nodes, click on the DB EDITOR iconfrom the INFOWATER PRO EDIT MENU
2. When the OPEN TABLE dialog box appears on the screen, go to the ELEMENT HYDRAULIC DATA section and choose the JUNCTION DEMAND (MODELING) DATA table , select ENTIRE TABLE in the DATA SCOPE area (indicating you want the entire contents of the table to be displayed and available for editing), and click once on the “OK” button. The JUNCTION DEMAND (MODELING) DATA table appears on the screen.
3. To adjust the contents of an entire field, in this case PATTERN1, click once on the column header with the mouse. The entire column should be highlighted.
4. Now specify Pattern ID 1 (Average Day Demand) for each junction node. Choose the “Block Editing” buttonwhile the PATTERN1 field remains highlighted. When the BLOCK EDITING dialog appears on the screen, replace with a “1”, indicating pattern ID “1” and then click on the “OK” button. All junction nodes now have a pattern equal to “1”.
5. Select the “Save” buttonand then choose the “Close” icon at the top of the DB EDITOR window. Close the DB EDITOR by selecting the “Exit” icon at the top of the window.
SET OPERATIONAL CONTROLS
Set controls for pump 200 so that the pump turns on when the water level in tank 103 falls below 25 feet (above the tank’s bottom elevation) and off when the water level in tank 103 rises above 40 feet at any time during the simulation:
1. Click on the SELECT ELEMENT iconfrom the INFOWATER PRO EDIT MENU, place the cursor on pump 200 and press the left mouse button.
2. To define the control rules to turn pump 200 on and off, click on the TOOLS iconon the MODEL EXPLORER - ATTRIBUTE TAB window, then choose the CONTROL command. The PUMP CONTROL dialog box appears on the screen.
To define the control stating pump 200 will be turned on if the level in tank 103 falls below 25 feet:
* Choose the “Open” option.
* Choose the “Pressure/Head” method and enter the number “103” in the Node ID entry field (alternately you can graphically pick tank 103 by clicking the select button).
* Select “Below” in the LEVEL VALUE area on the dialog box and enter a value of “25”. Because you selected a tank, InfoWater assumes the value is the tank water level (above tank bottom).
* Click on the “Insert” button to add the control rule for pump 200.
3. To define the control stating pump 200 will be turned off if the level in tank 103 rises above 40 feet:
* Choose the “Closed” option.
* Choose the “Pressure/Head” method and enter the number “103” in the Node ID entry field.
* Select “Above” in the LEVEL VALUE area on the dialog box and enter a value of “40”.
* Click on the “Insert” button to add the second control rule for pump 200. You should now have two control rules defined for pump 200.
The PUMP CONTROL dialog box should appear as:
4. Click on the “Create” button to close the PUMP CONTROL dialog box. Click once on the “Save” buttonof the MODEL EXPLORER - ATTRIBUTE TAB window.
STEP 7: BUILD THE WATER QUALITY MODEL
You will now specify water quality model options and parameters. In conjunction with the 24-hour hydraulic simulation, you will also perform a chlorine decay analysis. In this step you will specify the type of quality analysis (there are several in InfoWater), specify the initial water quality (i.e., chlorine concentration) throughout the system at the start of the simulation, and specify reaction rate coefficients for the model.
SPECIFY TYPE OF WQ ANALYSIS & REACTION RATE COEFFICIENTS
Indicate to InfoWater that you wish to run a water quality simulation when calculating network hydraulics. Also indicate the reaction rates for the chlorine decay analysis.
1. Select the OPERATION tabfrom the INFOWATER PRO MODEL EXPLORER, select the SIMULATION OPTIONS ® BASE SIMULATION OPTIONS and double-click. When the SIMULATION OPTIONS dialog box appears choose the GENERAL tab.
2. Choose the QUALITY tab on the SIMULATION OPTIONS dialog box. Choose the “Chemical” option to indicate a chemical growth/decay analysis.
3. Enter “Chlorine” in the entry field to the right of Chemical Name and choose “mg/L” in the MASS Unit entry field. This is only for descriptive purposes; what you type and select in these two boxes is the name and unit of the chemical displayed on output graphs, charts, and reports. The reaction rates that you specify are critical to proper simulation of water quality constituent movement and consequence throughout the distribution system.
Now enter the reaction rates for chlorine in the “Tutorial” system:
4. Enter “-1.0” in the entry field to the right of the Global Bulk. This is the reaction rate of chlorine within the pipe bulk flow for all pipes in the system. The negative sign indicates decay rather than growth.
5. Enter “-0.5” in the entry field to the right of the Global Wall. This is the reaction rate of chlorine as it comes in contact with the pipe wall for all pipes in the system.
6. Choose the “OK” buttonto close the SIMULATION OPTIONS dialog box.
SPECIFY THE INITIAL WATER QUALITY
Now specify the initial water quality (chlorine concentration for this tutorial) at junction and storage nodes at the beginning of the simulation. For this tutorial you will specify an initial water quality of 0.5 mg/L for all junction nodes and tank 103.
To do this you will create a domain and use the Group Editing function to edit water quality for a selected group of network components.
DOMAIN AND GROUP EDITING
A domain is a temporary selection of network components. Components in the domain are highlighted for visual reference. The domain is useful in that many of InfoWater’s data editing and mapping functions can be performed globally on components in the domain. In this tutorial, you will create a domain containing all junction nodes and tank 103. You will then specify the initial water quality for those nodes in a single operation.
1. Click on the InfoWater Pro buttonselect the DOMAIN MANAGER command from Domain Menu. The DOMAIN MANAGER Dialog box appears on the screen.
There are several methods for including network components in the domain, including graphical selection and database query. An additional method, which you will employ, is to add all components of a selected type (junctions, pipes, etc.) to the domain:
2. To add all junction nodes to the domain, choose the Network element source option, select “All Junctions”, and then press the “Add” button. All junction nodes should now appear highlighted in the color red.
3. To add tank 103 to the domain, choose the MAP Selection element source option and press the “Add” button. InfoWater will then prompt you to select objects. With the left mouse button click on tank 103 and then right click and press ENTER to confirm the selection. Tank 103 should now appear highlighted in the color red. You can now close the DOMAIN MANAGER Dialog box by clicking on the “Close” button.
4. Click on the GROUP EDITING ON DOMAIN icon from the INFOWATER EDIT MENU toolbar. The GROUP EDITINGdialog box appears on the screen.
5. In the DESIRED ELEMENT SELECTION section, select DOMAIN. Choose the INITIAL QUALITY tabon the GROUP EDITING dialog box. All components in the domain (all junction nodes and tank 103) will be assigned an initial water quality of 0.5 mg/L:
* Enter “0.5” in the Initial VALUE entry field .
* Choose the “Apply” button .
* Press “OK” when prompted to confirm applying changes and then “Close” the GROUP EDITING dialog box.
Any values set on the GROUP EDITING dialog box are applied to components in the domain.
6. Finally, clear the domain by opening the DOMAIN MANAGER dialog box (see step 1 above) and choosing the “Clear” button. You can now close the DOMAIN MANAGER Dialog box by clicking on the “Close” button.
SPECIFY THE SOURCE OF CHLORINE INJECTION
You should now assign a baseline source concentration of 1.2 mg/L at the water treatment plant (storage node 101). We will assume no variation (constant 1.2 mg/L input dosage) in source concentration over time.
1. Click on the SELECT ELEMENT iconfrom the INFOWATER PRO EDIT MENU, place the cursor on reservoir 101 and press the left mouse button.
2. In the MODEL EXPLORER - ATTRIBUTE TAB window click on the TOOLS iconand then choose the QUALITY SOURCE command. Select “Concentration” in the TYPE area and enter “1.2” in the Baseline Concentration field. Leave the CONCENTRATION Pattern entry field blank indicating there is no variation in source concentration over time. In fact, the optional CONCENTRATION Pattern identifies the pattern ID which will be used to vary the source concentration about its baseline level over time. The dialog box should appear as shown below.
Press the “Create” button and click once on the “Save” buttonof the MODEL EXPLORER - ATTRIBUTE TAB window.
STEP 8: RUN THE SIMULATION
You have now entered all required information for the model. To run the simulation, perform the following:
1. Select the RUN MANAGERfrom the Model Explorer on the top right (Also, Check the button for Refresh Output in the Model Explorer). The RUN MANAGER dialog box appears on the screen.
2. Choose the STANDARD tab. Before running the simulation you can pick the simulation options (hydraulic and/or water quality), time and duration options (steady state or extended period simulation), and reporting options to be associated with the next simulation run.
3. Choose the “Run”at the top of the RUN MANAGER dialog box. Upon successful completion of the simulation, the status stoplight on the RUN MANAGER should show green, indicating successful completion of the simulation run. Choose the “OK” button to close the RUN MANAGER dialog box.
NOTE: The model results are stored in an output source entitled *ACTIVE*:STANDARD. When you want to access results from this run, you will choose the output source with that name.
STEP 9: REVIEW MODEL RESULTS
InfoWater offers numerous tools for reviewing and analyzing model results. In this tutorial you will be introduced to displaying results on the network map, and reviewing results in graph and report form.
REVIEW RESULTS WITH THE MODEL EXPLORER - ATTRIBUTE TAB
First you will use the MODEL EXPLORER - ATTRIBUTE TAB to review model results one network component at a time. To do this, perform the following:
1. Click on the SELECT ELEMENT iconfrom the INFOWATER PRO EDIT MENU, place the cursor on the desired node or pipe.
2. Results for that node or pipe are shown in the OUTPUT section of the MODEL EXPLORER - ATTRIBUTE TAB window.
3. To review how the model results change throughout the simulation, move the slider bar to the desired simulation timestep in the Model Explorer.
If you desire, you can launch a graph or a spreadsheet report showing model results for the selected node or pipe. Simply click on the REPORTor GRAPH icons on the MODEL EXPLORER - ATTRIBUTE TAB window. You will also display reports and graphs using a different tool later in the tutorial.
CUSTOMIZE THE MAP DISPLAY
You will now customize the network map display, labeling pipes with calculated flows and with flow direction arrows, and labeling all junction nodes with calculated chlorine concentrations. Pipes will be color-coded based on flow values and junction nodes will be color-coded based on chlorine concentrations. The results will be displayed for the 24th (and final) timestep of the extended period simulation. Arrows indicating flow direction at the 24th timestep will also be displayed.
You will use the MAP DISPLAY iconfrom the INFOWATER PRO VIEW MENU to customize the map display.
SPECIFY MAP CUSTOMIZATION OPTIONS
1. Choose simulation timestep 24:00 HRS in the INFOWATER OUPUT toolbar, indicating that InfoWater will display results at the last simulation timestep. Click on the MAP DISPLAY iconfrom the INFOWATER PRO from VIEW. The MAP DISPLAY dialog box appears on the screen.
2. Choose the JUNCTION option in the ELEMENT TYPE area and select the ACTIVE OUTPUT option in the DATA SOURCE area. This output data source stores the results of your most recent simulation run.
3. Select QUALITY as the DATA FIELD that will be displayed. Enter “5” in the CLASSES field.
4. Now choose the colors and range breaks used to display chlorine. Perform the following to define five classification range breaks as shown below.
5. For this example, enter “0.2” in the BREAK section as the first break value and assign the corresponding color to highlight all junctions with a chlorine concentration less than 0.2 mg/L. Single-click on the corresponding color box in the COLOR section, choose the corresponding color and then click on the “OK” button. Repeat the above step using the range breaks shown in the table above.
6. Choose the LABEL PROPERTIES tab and check the SHOW UNIT check-box. Click on the “Apply” button and then click on the “OK” button to close the window. The nodes will be redrawn to reflect your choices.
Repeat steps 1 to 6 to customize the pipe display. Label each pipe with the FLOW at simulation timestep 24:00. Check the SHOW FLOW DIRECTION option and the flow direction arrows will be automatically displayed.
NOTE: To remove the map customization and revert to the default display, click on the RESET DISPLAY iconfrom the INFOWATER PRO VIEW MENU.
STEP 10: BROWSE MODEL RESULTS
Another method for reviewing model results is to view results in tabular or spreadsheet format. InfoWater provides several tools for browsing results in this fashion. The REPORT MANAGER is used to display simulation results in either tabular or graph form. You can fully customize the format, content, and layout of display tables and graphs with the REPORT MANAGER.
In this example you will open a table displaying model results for junction nodes.
OPEN THE REPORT MANAGER
1. Click on the InfoWater Pro buttonand from the VIEW menu, choose the REPORT MANAGER.
2. On the REPORT MANAGER choose the “New” button . When the OUTPUT REPORT & GRAPH dialog box appears on the screen, select the *ACTIVE*:STANDARD Output Source (containing results from your most recent model run), click on the REPORT button, choose “Junction Report”, and then choose “Open”.
3. When the Junction Report appears on the screen the OUTPUT REPORT & GRAPH dialog box will close automatically.
4. The results are displayed for the first simulation timestep; “00:00”. Pick the desired time from the drop-down list. The REPORT MANAGER will display junction results for the selected time period. You can open additional output reports and/or graphs by choosing the “New” button .
SORTING AND FILTERING RECORDS
You may now restrict the display to only those components meeting a user-specified criterion. For instance, you could request to see only those junction records where chlorine residuals are greater than 0.75 mg/L at simulation timestep “8:00”:
1. Select timestep 8:00 from the drop-down list then choose the “Filtering” button. The DATA FILTERING dialog box appears on the screen:
Click once on “Chlorine” in the AVAILABLE COLUMNS area.
- Click once on “>” (greater than) in the OPERATOR area.
- Type “0.75” in the VALUE entry field.
- Click on the “Add” button. The query “Chlorine > 0.75” should appear in the DATA FILTERS list on the DATA FILTERING dialog box.
- Choose the “Apply” button at the bottom of the DATA FILTERING dialog box.
When the DATA FILTER dialog box closes, the junction node records meeting your criterion will be identified check box.
The selected records may be scattered throughout the table. Therefore you can sort the table on the chlorine residual column such that the selected records are grouped together:
2. Click once on the “Chlorine” field header in the REPORT MANAGER. The entire column should be selected.
3. Choose the “Sort Ascending” button. The Junction Report table will now be sorted from the lowest chlorine concentration to the highest. Scroll to the bottom of the report to view the selected records. The “Sort Descending” button would sort the junction nodes in reverse (descending) order.
STEP 11: CREATE GRAPHS
Another method for reviewing model results is to display simulation result variables on time-series graphs. With InfoWater you can graph any simulation result variable for pipes or nodes and can also display and animate pump curves and hydraulic grade lines. Here, you will graph calculated chlorine concentrations for a selected junction node. Graphs are also created using the REPORT MANAGER.
OPENING A GRAPH
1. While the REPORT MANAGER is open (and is displaying the Junction Report from Step 10 above), choose the “New” button. When the OUTPUT REPORT & GRAPH dialog box appears on the screen, choose the *ACTIVE*:STANDARD Output Source, click on the GRAPH button, choose “Junction Graph”, and then choose “Open”.
2. Place the cursor on the desired junction node and press the left mouse button. A graph is then displayed on the screen showing demand for the selected node.
3. When the Junction Graph appears on the screen the OUTPUT REPORT & GRAPH dialog box will automatically close.
4. To change to a different type of graph, choose the desired variable from the drop-down list above the graph.
You may use any of the available buttons above the graph to customize the graph display.
STEP 12: PRINTING GRAPHS / REPORTS AND EXPORTING RESULTS
You can print or export the content of an output report graph or table. Alternately you can copy selected results and paste them into other applications using standard Windows copy-and-paste functionality.
PRINTING A GRAPH / REPORT
1. Open a new graph or report, or alternately make active the desired graph or report by clicking on the corresponding tab at the top of the REPORT MANAGER.
2. Choose the “Print” button. For graphs the current graph display is sent to the printer. For reports you can specify report header and footer information. Additionally, for tabular data you can select any number of rows or columns to print. If nothing is selected (highlighted) on the table, the entire table will be printed.
EXPORTING GRAPH / REPORT DATA
To copy model result data and paste them into other Windows applications such as a word processor or spreadsheet, perform the following:
1. Open a new graph or report, or alternately make active the desired graph or report by clicking on the corresponding tab at the top of the REPORT MANAGER.
For tabular reports:
2. Select the desired cells, rows, or columns to copy by dragging the mouse over the desired data. Release the left mouse button when you are done selecting data.
3. Press the Ctrl-C keys to copy the data to the Windows Clipboard.
4. Open the desired word processor or spreadsheet and press Ctrl-V (or PASTE from the EDIT menu) to paste the data into the application.
1. Customize the graph display as desired then choose the “Properties" buttonThe GRAPH CONTROL dialog box appears on the screen.
2. On the GRAPH CONTROL dialog box, choose the “Clipboard” option in the IMAGE TARGET area and then choose the “Copy” button in the middle of the dialog box.
3. Close the GRAPH CONTROL dialog box by choosing “OK” and open the desired word processor or presentation software. Press the Ctrl-V keys (or PASTE from the EDIT menu) to paste the data into the application.
WHERE DO I GO FROM HERE
Congratulations! You have completed the Quick-Start tutorial. You have been introduced to the most commonly used InfoWater commands and functions. You have opened a model, entered network data for that model, developed and performed a 24-hour hydraulic and water quality simulation, and used several tools to review simulation results. Your “Tutorial” project should now closely match the “Sample” project in the InfoWater Examples directory (shown on p. 3-3)
At the end of each tutorial step, you were referred to one or more locations in the InfoWater On-line Help system to gain more information on that particular function in InfoWater. You may now want to review those chapters and experiment with some of the new InfoWater features you learn about while reading those chapters. It is suggested that you experiment with new features using the “Tutorial” project. Alternately, you can begin to create a model of your water distribution system.
For those who want to learn more about InfoWater, it is suggested that you review the following topics in the On-line Help system before experimenting with new commands and features in InfoWater:
- Data Elements
- Scenario Explorer
- Database Management
You may want to print these sections for easier review. However the On-line Help system has numerous links to quickly and easily move between related topics.