Tutorial 1 – New Model xpsoftware Version 2010

Building a new model in wspg2010

The Water Surface Profile Gradient 2010 (wspg2010 by XP Software) model is a hydraulic analysis system that computes and plots uniform and non-uniform steady flow water surface profiles and pressure gradients in open channels or closed conduits with irregular or regular sections. The model was developed by the Los Angeles County Flood Control District in the late 1970’s and early 1980’s. The model completes calculations required under the guidelines of the Hydraulic Design Manual of Los Angeles County Dept of Public Works and is recommended for public and private use in design and analysis of hydraulic systems. The WSPG model has been available as a DOS-based program or in the WSPG-W menu-driven interface program.

The Los Angeles Dept of Public Works (LACDPW), in cooperation with XP Software, has undertaken a major update to the WSPG program code and addition of a graphical user-interface. The program calculations remained unchanged, only programming code and structure was updated. xpwspg within xpswmm or xpstorm provides additional features and functionality.

In this tutorial, users will learn how to utilize wspg2010 tools to layout the nodes and links in a simple network. xpwspg tools can be used to extract data from data sources such as GIS or terrain files.

Level: Beginner

Objectives: Introduce the steps required to: • Layout a model: link elements in wspg2010 • Modify an existing model • Calculate pipe lengths from the model coordinate system • Enter required data for links and nodes in dialogs • Enter the basic configurations settings for solving in wspg2010 • Obtain results from the output file and the Review Results tool

Time: 1 hour

Data files: …\Tutorial\LA\WSPG\Testl1.xp …\Tutorial\LA\WSPG\Tutorial1.xp

Part 1 – Exploring wspg2010

1. Start program, select New, and Continue

Tutorial 1 – New Model

Page 1-2

2. Name new project “Test1.xp” (note: file name extension “.xp” will be added automatically). Click Save.

3. In the wspg2010 Job Control window, enter the Title of the project. Results options can be selected from this window. Select OK.

4. Explore the various input dialogs for wspg2010. Using the Link Tool located on the right hand column, add links (nodes will be created automatically) to create a network. Starting at the upstream end and proceeding downstream.

5. Double-clicking will terminate the addition of links/nodes to the network; automatically indicate flow direction and automatic naming of links and nodes.

Tutorial 1 – New Models

Page 1-3

6. Using the select tool located on the right hand column, double clicking on a Node or Link highlights the element and opens the Element Data dialog. The appropriate element from the Element Type drop down box can be chosen. From the Element Type pull down menu, select element type.

Tutorial 1 – New Model

Page 1-4

7. Nodes can be selected from the Element Data Element Type pull down menu as well.

8. Links can be selected from the Element Data Element Type pull down menu.

9. Explore each of the Element types and associated data entry options.

a. System Outlet – Station Number, Invert Elevation, System Outlet Water Surface Elevation. Ground Elevation is optional and not used in the computations.

Tutorial 1 – New Models

Page 1-5

A new Channel Group must be created. This is done by clicking on the gray bar next to Channel Group. The Select box will pop up.

Name the channels and click Add. The channel group will appear in the main box. Click on it and select Edit. Select Channel Type and type in the size or dimensions.

Tutorial 1 – New Model

Page 1-6

Click OK. Make sure the new channel type created is highlighted and hit Select. The selected Channel Type should now appear in the Element Data Box dialog.

Use the blue arrows in the lower left of the Element Data dialog to walk the network and edit connected elements (nodes or links) upstream or downstream of current element displayed.

Tutorial 1 – New Models

Page 1-7

b. Reach –

• Invert Elevation (can be automatically calculated with a DTM layer using Tools->Modify Elevations->Read Inverts From TIN Files. User must still input a starting invert elevation at the System Outlet),

• Length (or can be automatically calculated if using a background with real world coordinates by going to Tools->Calculate Conduits->Lengths),

• Manning’s n if different from default,

• Channel Group (existing or create a new one). The station will be automatically updated based on length of element.

Optionally, enter Curvature, Angle Point, and Number of Manholes if applicable.

c. Transition – Same information as a Reach, but no Curvature, Angle Point, or Manhole. Must create a new Channel Group since the network transitions into a new size or shape.

d. Junction – Invert Elevation, Channel Group for the mainline, Length will be the diameter or width of your lateral (Ex: If there is a 2 foot pipe coming into the mainline, the length along the mainline will be 2 feet), Manning’s n.

Tutorial 1 – New Model

Page 1-8

To enter the Lateral Branch data click on the gray Edit box next the Lateral Branches row.

The Lateral Branches dialog will open up. Enter a channel type (either existing or create a new one), confluence angle, and flow coming in from lateral. The invert elevation will automatically be picked up from the mainline data entered.

e. Head Work – Data entered is the same as the System Outlet, but a starting Head Work Flow is required. A Head Work Water Surface Elevation is not required.

Tutorial 1 – New Models

Page 1-9

f. Join – This is a new option for wspg2010 and is used when there is another system feeding into the mainline. This additional system will have its own elements including a System Head Work. The System Outlet will be on the same line as the Join element on the mainline. The information entered is the same as the Junction, only a flow is not entered in the Lateral branches box. Enter all the same information for the additional system as was entered for the mainline.

g. Wall Entrance and Bridge Entrance – invert elevation, channel group, and loss or reduction factor.

h. Wall Exit and Bridge Exit – invert elevation and channel group.

Tutorial 1 – New Model

Page 1-10

Part 2 – Building a new model

1. Starting a new model, as described in Step 1 of Part 1, name the new file “Tutorial1.xp”. The file name will appear in the working directory as “Tutorial1.xp”.

2. Build a new model consisting of seven (7) nodes and six (6) links. Select the link button and click nodes and links on the blank model space.

3. Double-clicking on any link or node will open the Element Data window. The model will be created on the blank screen. Placing several links together in a row will automatically create nodes in between those links.

4. As previously described, nodes can be System Head Work, System Outlet, Wall Entrance, Wall Exit, Bridge Entrance, Bridge Exit, Junction, Join, or Dummy. Links can be Dummy, Reach, or Transitions.

5. Enter the following data in the Element Data dialog for the Headwork:

a. Station = Leave blank

b. Node Invert Elevation = 307.57

c. Node Ground Elevation = 0.0

d. Channel Group = Channel 3 (as already described, name Channel 3)

e. Head Work Flow = 10.0

f. Head Work Water Surface Elevation = 0.0

6. Continue defining the elements as follows:

Type Element No.

Station Invert Length Manning’s n Channel

Reach (R) 7 307.57 369.29 0.013 3 (3.5’ dia.)

Reach (R) 6 306.10 187.20 0.013 3

Transition (TX)

5 303.97 15 0.013 3

Reach (R) 4 303.70 100.20 0.013 2 (2.5’ dia.)

Reach (R) 3 302.40 302.60 0.013 2

Tutorial 1 – New Models

Page 1-11

Type Element No.

Station Invert Length Manning’s n Channel

Junction (JX)

2 301.2 0.013 2

Dummy Link

System Outlet (SO)

Outlet 5738 300.30 1 (1.75’ dia.)

7. Review the network and define the Junction attributes.

8. Define the Lateral 1 at the Junction in Element 2. Click the gray box at Lateral Branches in the Element Data dialog for the Junction.

a. Click Edit in the gray box. Enter Lateral name, click the Channel Group to assign a channel geometry; enter confluence angle, flow entering through lateral and invert elevation.

Tutorial 1 – New Model

Page 1-12

b. For Part 2, enter the following information:

i. Name = Lateral 1

ii. Channel Group = Channel 4 (1.5’ diameter pipe)

iii. Confluence angle = 0

iv. Flow = 10 cfs

v. Invert elevation = 301.2

9. Click Analyze (located on the top bar) and then Solve. Click on any element (link or node) to find the flow rate and depth at that station.

Viewing Model Output:

10. Go to Results (located on the menu), then select Browse File or click the icon and select and Open the output file.