riverflo-2d v31 users guide

7/21/2019 Riverflo-2d v31 Users Guide

1/167


2/167

RiverFLO-2D v3 Users Guide

ii

RiverFLO-2Dv3model and documentation produced by Hydronia, LLC. Pembroke Pines, FL. USA.

Information in this document is subject to change without notice and does not represent a commitment on part of Hydronia, LLC.The software described in this document is furnished under a license agreement.

RiverFLO-2D andRiverFLO-2D v3arecopyrighted by Hydronia, LLC. 2011-2013.SMS is trademak of Aquaveo, LLC.Argus ONE is trademarks of Argus Holdings Ltd.

All other products or service names mentioned herein are trademarks of their respective owners.

All rights reserved. No part of this publication may be reproduced, stored in a retrieval system or transmittedin any form or by any means electronic, mechanical, photocopying, recording or otherwise, without the prior written permissionof Hydronia, LLC.

Last document modification date: May, 2013.

Technical Support:[email protected]

Web site:www.hydronia.com
mailto:[email protected]:[email protected]:[email protected]://www.hydronia.com/http://www.hydronia.com/http://www.hydronia.com/http://www.hydronia.com/mailto:[email protected]


3/167


iii

ContentsCONTENTS.................................................................................................................................................. III

LIST OF FIGURES ..................................................................................................................................... VII

LIST OF TABLES ........................................................................................................................................ XI1 INTRODUCTION .................................................................................................................................. 1

1.1 WHATS NEW IN RELEASE V3.1 ............................................................................................................................................ 2

2 INSTALLING RIVERFLO-2D V3 - ARGUS ONE EDITION................................................................. 3

2.1 UPGRADING FROM RIVERFLO-2DV2009 ............................................................................................................................. 32.2 COMPATIBILITY WITH RIVERFLO-2DV2009 .......................................................................................................................... 42.3 HARDWARE REQUIREMENTS ................................................................................................................................................ 42.4 INSTALLING RIVERFLO-2DV3/ARGUS ONESINGLE USER VERSION.................................................................................... 42.5 INSTALLING RIVERFLO-2DV3/ARGUS ONENETWORK VERSION......................................................................................... 5

Installing Argus ONE Network Manager ........................................................................................................................ 52.5.1

3 ARGUS ONE MAIN WINDOW ............................................................................................................. 6

4 RIVERFLO-2D V3 / ARGUS ONE LAYER STRUCTURE................................................................... 7

4.1 RIVERFLO-2DLAYERS........................................................................................................................................................ 74.2 EXPORTING RIVERFLO-2DV3FILES .................................................................................................................................. 104.3 PARAMETER NAMES IN RESULT DATA LAYERS ...................................................................................................................... 114.4 PARAMETER NAMES IN MAX_RESULTSDATA LAYER......................................................................................................... 13

5 CREATING YOUR FIRST RIVERFLO-2D V3 PROJECT ................................................................. 15

5.1 STARTING A NEW RIVERFLO-2DV3PROJECT .................................................................................................................... 155.2 IMPORTING BED ELEVATIONS ............................................................................................................................................. 175.3 DEFINING THE DOMAIN BOUNDARY ..................................................................................................................................... 205.4 GENERATING THE FINITE ELEMENT MESH ........................................................................................................................... 225.5 ENTERING MANNINGS N COEFFICIENT DATA ....................................................................................................................... 24

5.6 ENTERING BOUNDARY CONDITIONS .................................................................................................................................... 265.7 EXPORTING RIVERFLO-2DMESH DATA ............................................................................................................................. 285.8 ENTERING ADDITIONAL DATA AND RUNNING THE MODEL ...................................................................................................... 29

6 RIVERFLO-2D MODEL EQUATIONS ............................................................................................... 31

6.1 HYDRODYNAMIC MODEL .................................................................................................................................................... 31Mannings n Roughness Coefficients .......................................................................................................................... 326.1.1Hydrodynamic Boundary Conditions ........................................................................................................................... 326.1.2

6.1.2.1 Closed Boundary Conditions ............................................................................................................................................... 326.1.2.2 Open Boundary Conditions .............................................................................................................. ................................... 336.1.2.3 Single Variable Boundary Condition Types (BCTYPE 1-8) ................................................................................................. 336.1.2.4 Water Discharge Converted in Velocities (BCTYPE 6) ....................................................................................................... 346.1.2.5 Water Discharge as a Source (BCTYPE 61) ....................................................................................................................... 346.1.2.6 Discharge Rating Table (BCTYPE 9) .................................................................................................................................. 35

6.1.2.7 Free Open Boundaries (BCTYPE 10, 11)......................................................................................................................... 356.1.2.8 Uniform Flow Boundary Condition (BCTYPE 12) ................................................................................................................ 356.1.2.9 Open Boundary Geometry Considerations that may affect Mass Conservation ................................................................. 35

Assumptions of the Hydrodynamic Model ................................................................................................................... 366.1.36.2 SEDIMENT TRANSPORT MODEL .......................................................................................................................................... 37

Sediment Transport Boundary Conditions .................................................................................................................. 376.2.1Sediment Transport Formulas ..................................................................................................................................... 386.2.2

6.2.2.1 Meyer-Peter & Muller Bed Load Formula ............................................................................................................................ 386.2.2.2 Ackers-White Total Load Formula ....................................................................................................................................... 386.2.2.3 Karim-Kennedy Total Load Formula .................................................................................................................................... 39


4/167


iv

6.2.2.4 Yang Total Load Formula for Sands .................................................................................................................................... 406.2.2.5 Yang Total Load Formula for Gravels ............................................................................................................................ ..... 416.2.2.6 Parker-Klingeman-Mclean Formula ................................................................................................................................ ..... 426.2.2.7 Van Rijn Total Load Formula ............................................................................................................................................... 426.2.2.8 Engelund-Hansen Total Load Formula ................................................................................................................................ 436.2.2.9 Rating Curve ........................................................................................................................................................................ 44

Assumptions of the Sediment Transport Model .......................................................................................................... 446.2.3

7 FINITE ELEMENT METHOD ............................................................................................................. 46

7.1 SPATIALAPPROXIMATION ................................................................................................................................................... 467.2 TIME-INTEGRATION SCHEME .............................................................................................................................................. 477.3 STABILITYANALYSIS .......................................................................................................................................................... 487.4 TIME-STEP OPTIONS .......................................................................................................................................................... 48

Constant Time-Steps ................................................................................................................................................... 487.4.1Variable Time-Step Algorithm ..................................................................................................................................... 487.4.2

8 CODE PARALLELIZATION .............................................................................................................. 50

9 DRY AND WET REGION MODELING (OVERBANK FLOW)........................................................... 52

9.1 WET,DRY AND PARTIALLY-DRY ELEMENTS ......................................................................................................................... 52Element definitions based on dry and wet conditions ................................................................................................. 529.1.1

Algorithm A .................................................................................................................................................................. 539.1.2Algorithm B .................................................................................................................................................................. 539.1.3Assumptions of Dry-Wet Region Calculations ............................................................................................................. 549.1.4

10 COMPONENTS .................................................................................................................................. 55

10.1 BRIDGE PIERS ............................................................................................................................................................. 55Bridge Pier Calculation .............................................................................................................................................. 5610.1.1

10.2 CULVERTS ................................................................................................................................................................... 57Culvert Calculation using a Rating Table (CulvertType = 0) ..................................................................................... 5810.2.1

Culvert Calculation using a Culvert Characteristics (CulvertType = 1,2) ................................................................... 5810.2.2Assumptions of Culvert Calculations ......................................................................................................................... 6310.2.3

10.3 INTERNAL RATING TABLES ............................................................................................................................................ 64Internal Rating Table Calculations ............................................................................................................................ 6510.3.1

Assumptions of Internal Rating Table Calculations ................................................................................................... 6610.3.210.4 SOURCES/SINKS .......................................................................................................................................................... 6610.5 WEIRS ......................................................................................................................................................................... 67

Weir Calculations ...................................................................................................................................................... 6910.5.1Assumptions of Weir Calculations ............................................................................................................................. 6910.5.2

11 POST-PROCESSING CALCULATIONS ........................................................................................... 70

11.1 CROSS SECTIONS ........................................................................................................................................................ 70Cross Section Calculations ....................................................................................................................................... 7111.1.1

11.2 OBSERVATION POINTS .................................................................................................................................................. 71Observation Point Calculations ................................................................................................................................. 7211.2.1

11.3 PROFILES .................................................................................................................................................................... 72Profile Calculations .................................................................................................................................................... 7411.3.1

11.4 USBRHAZARD MAPPING ............................................................................................................................................. 74Use of USBR Hazard Classification Files .................................................................................................................. 7811.4.1

12 TOOLS ............................................................................................................................................... 80

12.1 TWO-DIMENSIONAL MODEL RESULT INTERPRETER:2DMRI ............................................................................................ 8012.2 HEC-RASDATA EXTRACTION TOOL ............................................................................................................................. 81

13 TUTORIALS ....................................................................................................................................... 82

13.1 VISUALIZING RIVERFLO-2DV3RESULTS WITH THE POST PROCESSOR TOOL.................................................................. 8213.2 VISUALIZING RIVERFLO-2DV3RESULTS WITHARGUS ONE .......................................................................................... 85


5/167


v

Visualizing Velocity Fields ......................................................................................................................................... 8713.2.113.3 USING HEC-RASDATA EXTRACTION TOOL.................................................................................................................. 89

Use HEC-RAS Data Extraction Tool to read the geometry file and create the X Y Z and polygon files ................... 9013.3.1Open Argus ONE and create a new data layer for the elevation points .................................................................... 9213.3.2Import the elevation points into the data layer ........................................................................................................... 9313.3.3Link the bed elevation parameter to the HEC-RAS data layer .................................................................................. 9513.3.4

Enter the modeling area polygon in the Domain Outline layer .................................................................................. 9613.3.5Generate the Finite Element mesh ............................................................................................................................ 9713.3.6Check interpolated elevations ................................................................................................................................... 9813.3.7

13.4 USING LARGE ELEVATION DATA SETS ......................................................................................................................... 100Open an Existing Project with a Mesh ..................................................................................................................... 10013.4.1

Sampling the Data ................................................................................................................................................... 10113.4.2Linking the New Data Layer to the Existing Mesh ................................................................................................... 10313.4.3

13.5 USING MULTIPLE ELEVATION DATA SETS AND SPATIALLY VARIED INTERPOLATION METHODS......................................... 105Open an Existing RiverFLO-2D v3 Project .............................................................................................................. 10513.5.1

Create New Layers for Channel Data. .................................................................................................................... 10613.5.2Import elevation points for the channel. .................................................................................................................. 10713.5.3Create an Expression to Calculate the Bed Elevations. .......................................................................................... 10813.5.4Verify Interpolated Elevations .................................................................................................................................. 10913.5.5

13.6 ADJUSTING BED ELEVATIONS ON SELECTEDAREAS ..................................................................................................... 109Open an Existing RiverFLO-2D v3 Project .............................................................................................................. 11013.6.1

Create a new Information Layer (Polygon1). ........................................................................................................... 11013.6.2Create a Polygon on the Polygon1 Layer ................................................................................................................ 11113.6.3Create an Expression to Process the Bed Elevation Adjustment ............................................................................ 11313.6.4Ver ify Elevation Adjustment .................................................................................................................................... 11413.6.5

13.7 DEFINING SPATIALLY VARIABLE INITIAL WATER ELEVATIONS......................................................................................... 114Open an Existing RiverFLO-2D v3 Project .............................................................................................................. 11513.7.1

Create a Polygon that Covers the Area where we will Define Initial Water Elevations ........................................... 11513.7.2Create a new Information layer to enter the initial condition data. .......................................................................... 11613.7.3Add Initial Water Elevation Data .............................................................................................................................. 11613.7.4Create an Expression to Compute the InitialWSE Parameter ................................................................................. 11813.7.5

13.8 CULVERT COMPONENT ............................................................................................................................................... 120

Open an Existing RiverFLO-2D v3 Project. ............................................................................................................. 12113.8.1Create New Culverts in the Culverts Layer ............................................................................................................. 12213.8.2Export the Data and Setup Control Parameters ...................................................................................................... 12413.8.3Running the Model .................................................................................................................................................. 12713.8.4Review Culvert Output Files .................................................................................................................................... 12813.8.5

13.9 IMPORTINGAERIAL IMAGES ......................................................................................................................................... 129World File Format .................................................................................................................................................... 12913.9.1

Image Size Calculator Program .............................................................................................................................. 13013.9.2Start a new RiverFLO-2D v3 project to import a geo-referenced Image ................................................................. 13213.9.3Import the Image Vertex Coordinates ..................................................................................................................... 13313.9.4Activate the Aerial map layer and copy rectangle ................................................................................................... 13313.9.5Place the image in the Aerial map layer .................................................................................................................. 13313.9.6Adjust image to Match Rectangle ............................................................................................................................ 13413.9.7

13.10 CREATING VELOCITY FIELD SHAPE FILES.................................................................................................................... 135

Activate or Create a New Information Layer ......................................................................................................... 13613.10.1Adjust the Layer Properties to Allow Line Intersections ........................................................................................ 13713.10.2Import Model Results for a Selected Time into the New Layer ............................................................................. 13713.10.3Customize Visualization ........................................................................................................................................ 13813.10.4Export Shape File .................................................................................................................................................. 14013.10.5

13.11 CREATING WATER ELEVATION AND DEPTH SHAPE FILES.............................................................................................. 140Activate or Create a New Information Layer ......................................................................................................... 14113.11.1Adjust the Layer Properties to Allow Line Intersections ........................................................................................ 14213.11.2Import Model Results for a Selected Time Into the New Layer ............................................................................. 14213.11.3


6/167


vi

Customize Visualization ........................................................................................................................................ 14313.11.4Export Shape File .................................................................................................................................................. 14513.11.5

13.12 CREATINGANIMATIONS AND GOOGLE EARTH PLOTS WITH RIVERANIMATOR................................................................. 146Common Inputs ..................................................................................................................................................... 14713.12.1

KML Animations .................................................................................................................................................... 15113.12.2WMV Animations ................................................................................................................................................... 15313.12.3

14 REFERENCES ................................................................................................................................. 155


7/167


vii

List of Figures

Figure 1 RiverFLO-2D v3 finite element mesh. ................................................................................................................................. 1Figure 2 Argus ONE main window showing a velocity field computed with RiverFLO-2D ................................................................ 3Figure 3 Argus ONE main window .................................................................................................................................................... 6

Figure 4 Argus ONE Floating Layer Window. ................................................................................................................................... 6Figure 5 Argus ONE layers dialog. ................................................................................................................................................... 6Figure 6 Creating a new RiverFLO-2D project .................................................................................................................................. 7Figure 7 Export command in PIE drop list ...................................................................................................................................... 10Figure 8 Export fi le selection dialog ................................................................................................................................................ 10Figure 9 Results data layer contents .............................................................................................................................................. 11Figure 10 Results layer drop list ..................................................................................................................................................... 13Figure 11 Hardware key error message ......................................................................................................................................... 15Figure 12 Argus ONE PIEs Menu ................................................................................................................................................... 16Figure 13 Argus ONE layers window .............................................................................................................................................. 16Figure 14 Activating bed elevations layer from drop list ................................................................................................................. 17Figure 15 Activating bed elevations layer in layer window .............................................................................................................. 17Figure 16 Import bed elevations with text file .................................................................................................................................. 18

Figure 17 Argus ONE import data dialog. ....................................................................................................................................... 18Figure 18 Import message .............................................................................................................................................................. 19Figure 19 Display of bed elevations points ..................................................................................................................................... 19Figure 20 Select BedElevations layer for color display ................................................................................................................... 20Figure 21 Select dot size display .................................................................................................................................................... 20Figure 22 Active layer indication ..................................................................................................................................................... 20Figure 23 Activating the draw polygon tool ..................................................................................................................................... 21Figure 24 Set mesh density ............................................................................................................................................................ 21Figure 25 Polygon for mesh ............................................................................................................................................................ 22Figure 26 Select Magic Wand tool .................................................................................................................................................. 22Figure 27 Created mesh ................................................................................................................................................................. 23Figure 28 Select BedElevation layer for color display ..................................................................................................................... 23Figure 29 Mesh color coded by bed elevation ................................................................................................................................ 24Figure 30 Entering Manning's n Data. ............................................................................................................................................ 25Figure 31 Setting Manning's n ........................................................................................................................................................ 25Figure 32 Define inflow boundary condition polygon ...................................................................................................................... 26Figure 33 Enter inflow boundary condition data .............................................................................................................................. 26Figure 34 Define outlfow boundary polygon ................................................................................................................................... 27Figure 35 Enter outflow boundary condition data ........................................................................................................................... 27Figure 36 Data export command .................................................................................................................................................... 28Figure 37 RiverFLO-2D v3 export dialog. ....................................................................................................................................... 28Figure 38 RiverFLO-2D Data Input Program main window. ........................................................................................................... 29Figure 39 RiverFLO-2D Data Input Program Graphic Output Options tab. .................................................................................... 30Figure 40 Velocity field and depth plot ............................................................................................................................................ 30Figure 41 Open and closed boundary conditions ........................................................................................................................... 32Figure 42 Inflow water discharge imposed as velocities (BCTYPE 6). ........................................................................................... 34Figure 43 Inflow water discharge as sources boundary condition (BCTYPE 61). .......................................................................... 34

Figure 44 Triangular linear element used in RiverFLO-2D ............................................................................................................. 46Figure 45 Speed up using RiverFLO-2D parallelized code as a function of number of processor cores. ...................................... 50Figure 46 Activate point tool ........................................................................................................................................................... 55Figure 47 Define pier layer .............................................................................................................................................................. 55Figure 48 Pier layer data dailog ...................................................................................................................................................... 55Figure 49 Bridge Piers on a mesh. ................................................................................................................................................. 56Figure 50 Schematic view of a rectangular pier. ............................................................................................................................. 56Figure 51 Constructing a culvert ..................................................................................................................................................... 57Figure 52 Culvert data dialog .......................................................................................................................................................... 58


8/167


viii

Figure 53 Activate polyline tool ....................................................................................................................................................... 64Figure 54 Constructing a polyline for an internal rating table .......................................................................................................... 64Figure 55 Internal Rating Table dialog ............................................................................................................................................ 64Figure 56 Internal Rating Table polyline on mesh .......................................................................................................................... 65Figure 57 Activate point tool ........................................................................................................................................................... 66Figure 58 Adding a source or sink to model ................................................................................................................................... 66Figure 59 Source or sink data dialog .............................................................................................................................................. 67Figure 60 Activate polyline tool ....................................................................................................................................................... 67Figure 61 Constructing a polyline for a weir .................................................................................................................................... 67Figure 62 Weir data dialog .............................................................................................................................................................. 68Figure 63 Weir in mesh ................................................................................................................................................................... 69Figure 64 Activate polyline tool ....................................................................................................................................................... 70Figure 65 Cross sections on mesh ................................................................................................................................................. 70Figure 66 Cross sections data dialog .............................................................................................................................................. 71Figure 67 Activate point tool ........................................................................................................................................................... 71Figure 68 Observations data dialog ................................................................................................................................................ 72Figure 69 Observation points in model ........................................................................................................................................... 72Figure 70 Activate polyline tool ....................................................................................................................................................... 73Figure 71 Constructing a profile ...................................................................................................................................................... 73Figure 72 Profile data dialog ........................................................................................................................................................... 73

Figure 73 Profile on mesh ............................................................................................................................................................... 74Figure 74 USBR Hazard Classification for permanent residencies, homes, and buildings. ........................................................... 76 Figure 75 USBR Hazard Classification for mobile homes. ............................................................................................................. 76Figure 76 USBR Hazard Classification for roadways/vehicles. ...................................................................................................... 77Figure 77 USBR Hazard Classification for pedestrian routes (adults). ........................................................................................... 77Figure 78 USBR Hazard Classification for pedestrian routes (children). ........................................................................................ 78Figure 79 Data Input Program Graphic Output Options for USBR hazard files .............................................................................. 78Figure 80 Export shape file dialog for USBR hazard files ............................................................................................................... 79Figure 81 Run 2dMRI on tools tab .................................................................................................................................................. 80Figure 82 HEC-RAS command on tools tab ................................................................................................................................... 81Figure 83 Click on the RiverFLO-2D Post Processor Command .................................................................................................... 82Figure 84 RiverFLO-2D Post Processor Plot Selection Dialog. ...................................................................................................... 83Figure 85 Check the available plot options on the Post Processor Dialog .................................................................................... 83

Figure 86 The program imports results in a data layer and creates the selected plots in map layers ............................................ 84Figure 87 Plot created in the TIME_ENG_0000_02_00_00_VelocityField layer ............................................................................ 84Figure 88 Import data dialog ........................................................................................................................................................... 85Figure 89 Activate vector tool ......................................................................................................................................................... 87Figure 90 Vector diagram dialog Chart tab ..................................................................................................................................... 88Figure 91 Vector diagram Position tab ............................................................................................................................................ 88Figure 92 Velocity field plot ............................................................................................................................................................. 89Figure 93 Extract data from HEC-RAS command on Tool tab ....................................................................................................... 90Figure 94 Results of HEC-RAS data extraction .............................................................................................................................. 90Figure 95 Folder for HEC-RAS extracted files ................................................................................................................................ 91Figure 96 Confirmation of HEC-RAS extracted files ....................................................................................................................... 91Figure 97 New RiverFLO-2D model command ............................................................................................................................... 92Figure 98 Make bed elevations layer active.................................................................................................................................... 92Figure 99 Layers dialog .................................................................................................................................................................. 93Figure 100 Make HEC-RAS bed elevations layer active ................................................................................................................ 93Figure 101 Specify a text file........................................................................................................................................................... 94Figure 102 Specify type of data ...................................................................................................................................................... 94Figure 103 HEC-RAS elevations displayed in color ........................................................................................................................ 95Figure 104 Activate fini te element mesh layer ................................................................................................................................ 96Figure 105 Edit finite element mesh layer ....................................................................................................................................... 96Figure 106 Link HEC-RAS elevations to bed elevations ................................................................................................................. 96Figure 107 Activate domain outline................................................................................................................................................. 97Figure 108 Activate polygon tool ..................................................................................................................................................... 97


9/167


ix

Figure 109 HEC-RAS elevations displayed in color ........................................................................................................................ 97Figure 110 Activate mesh layer Figure 111 Select magic wand tool ......................................................................................... 98Figure 112 HEC-RAS elevation layer with color dispaly ................................................................................................................. 98Figure 113 Specify color for bed elevation display ......................................................................................................................... 99Figure 114 Review bed elevations layer ......................................................................................................................................... 99Figure 115 Elevation data model .................................................................................................................................................. 100

Figure 116 Import command ......................................................................................................................................................... 101Figure 117 Import options dialog .................................................................................................................................................. 101Figure 118 Define data type for import ......................................................................................................................................... 101Figure 119 Select Read File ......................................................................................................................................................... 102Figure 120 Data position dialog .................................................................................................................................................... 102Figure 121 Select elevation data file ............................................................................................................................................. 102Figure 122 Read file dialog ........................................................................................................................................................... 103Figure 123 Layers in elevation tutorial .......................................................................................................................................... 103Figure 124 Finite element mesh data dialog ................................................................................................................................. 104Figure 125 Dialog used to link sampled data ................................................................................................................................ 104Figure 126 Mesh with interpolated elevations............................................................................................................................... 105Figure 127 Multiple elevations model ........................................................................................................................................... 106Figure 128 Channel polygons layer data dialog ............................................................................................................................ 106

Figure 129 Channel survey layer data dialog ............................................................................................................................... 107Figure 130 Import channel survey points ...................................................................................................................................... 107Figure 131 Finite element mesh layer data dialog ........................................................................................................................ 108Figure 132 Expression builder to calculate bed elevations ........................................................................................................... 108Figure 133 Verified interpolated bed elevations............................................................................................................................ 109Figure 134 Hoh_ADJUST model .................................................................................................................................................. 110Figure 135 Polygon_1 layer data dialog ....................................................................................................................................... 111Figure 136 Select polygon tool ..................................................................................................................................................... 111Figure 137 Created polygon ......................................................................................................................................................... 112Figure 138 Data dialog for layer.................................................................................................................................................... 112Figure 139 Finite element mesh layer dialog ................................................................................................................................ 113Figure 140 Expression builder for polygon_1 ............................................................................................................................... 113Figure 141 Adjusted bed elevations.............................................................................................................................................. 114

Figure 142 Initial conditions model ............................................................................................................................................... 115Figure 143 Initial conditions model with channel .......................................................................................................................... 116Figure 144 Initial water surface elevation layer data dialog .......................................................................................................... 116Figure 145 Activate add point tool ................................................................................................................................................ 117Figure 146 Initial water surface elevation layer data dialog .......................................................................................................... 117Figure 147 Set elevations for downstream points ......................................................................................................................... 117Figure 148 Set elevations for upstream points ............................................................................................................................. 118Figure 149 Water surface elevation layer data dialog................................................................................................................... 118Figure 150 Expression builder for water surface elevation layer .................................................................................................. 119Figure 151 Node data dialog......................................................................................................................................................... 119Figure 152 Initial water surface elevations.................................................................................................................................... 120Figure 153 Culvert configuration schematic.................................................................................................................................. 120Figure 154 Culvert tutorial. Initial window. .................................................................................................................................... 122Figure 155 Activate polyline tool ................................................................................................................................................... 122

Figure 156 Culvert data dialog ...................................................................................................................................................... 123Figure 157 Culvert 1 in finite element mesh ................................................................................................................................. 123Figure 158 Finite element mesh showing two culverts. ............................................................................................................... 124Figure 159 Export model to RiverFLO-2D .................................................................................................................................... 125Figure 160 RiverFLO-2D v3 export dialog. ................................................................................................................................... 125Figure 161 Data Input Program Control data settings. ................................................................................................................. 126Figure 162 Data Input Program Graphic Output Options settings. ............................................................................................... 126Figure 163 Graphic output file generated for each report interval ................................................................................................ 127Figure 164 Output file for Culvert 1. .............................................................................................................................................. 128


10/167


x

Figure 165 Output file for Culvert 2. .............................................................................................................................................. 128Figure 166 Labels of corners of image ......................................................................................................................................... 130Figure 167 Image size calculator .................................................................................................................................................. 131Figure 168 Image size calculator with data................................................................................................................................... 131Figure 169 Open RiverFLO-2D project ......................................................................................................................................... 132Figure 170 Ariel map layer in Argus One ...................................................................................................................................... 133Figure 171 Place image command ............................................................................................................................................... 134Figure 172 Image displayed in aerial layer ................................................................................................................................... 135Figure 173 Data Output Program Graphics Output Options settings ............................................................................................ 136Figure 174 Velocity layer data dialog ............................................................................................................................................ 137Figure 175 Allow intersections setting on Special menu ............................................................................................................... 137Figure 176 Import text file command ............................................................................................................................................ 138Figure 177 Initial display of velocity vectors with tags .................................................................................................................. 138Figure 178 View settings for velocity vector layer ......................................................................................................................... 138Figure 179 Velocity vectors ........................................................................................................................................................... 139Figure 180 Set velocity vector display to color.............................................................................................................................. 139Figure 181 Velocity vectors displayed in color .............................................................................................................................. 139Figure 182 Export shapefile command ......................................................................................................................................... 140Figure 183 Expression builder for velocity shape files .................................................................................................................. 140Figure 184 Data Output Program Graphic Output Options settings ............................................................................................. 141

Figure 185 Layer information dialog ............................................................................................................................................. 142Figure 186 Allow intersections setting .......................................................................................................................................... 142Figure 187 Inset text file command ............................................................................................................................................... 143Figure 188 Initial display of velocity vectors with tags .................................................................................................................. 143Figure 189 View settings for velocity vectors layer ....................................................................................................................... 144Figure 190 Display of mesh polygons ........................................................................................................................................... 144Figure 191 Display water surface elevations in color .................................................................................................................... 144Figure 192 Mesh polygons colored by water surface elevationss ................................................................................................ 145Figure 193 Export shape file command ........................................................................................................................................ 145Figure 194 Export shape file dialog .............................................................................................................................................. 146Figure 195 Data Input Program River Animator tab settings ........................................................................................................ 147Figure 196 River animator settings for WMV output ..................................................................................................................... 148Figure 197 Screen capture at 0.8 hours ....................................................................................................................................... 149

Figure 198 Data Input Program Show velocity settings for smaller and more widely spaced arrows ........................................... 150Figure 199 Screen capture at 0.8 hours with adjusted velocity settings ....................................................................................... 151Figure 200 Plot options for KML output ........................................................................................................................................ 152Figure 201 Spatial references codes ............................................................................................................................................ 152Figure 202 Settings for WVM animation ....................................................................................................................................... 153
http://c/RiverFLO-2D/Manuals/v31/RiverFLO-2D_v3_USERS_Guide%2020%20APR%202013-TEB3+PostProc.docx%23_Toc354244759http://c/RiverFLO-2D/Manuals/v31/RiverFLO-2D_v3_USERS_Guide%2020%20APR%202013-TEB3+PostProc.docx%23_Toc354244759http://c/RiverFLO-2D/Manuals/v31/RiverFLO-2D_v3_USERS_Guide%2020%20APR%202013-TEB3+PostProc.docx%23_Toc354244759


11/167


xi

List of Tables

Table 1 Argus ONE layers for RiverFLO-2D v3. ............................................................................................................................... 8Table 2 Argus ONE layers for RiverFLO-2D v3 (cont.). .................................................................................................................... 9Table 3 Actions on RiverFLO-2D v3 Export Dialog........................................................................................................................ 11

Table 4 Parameters in new Result Data Layer in Argus ONE/RiverFLO-2D v3 ............................................................................. 12 Table 5 Parameters in new Result Data Layer in Argus ONE/RiverFLO-2D v3 ............................................................................. 13 Table 6 Required boundary conditions ........................................................................................................................................... 33Table 7 Open Boundary Condition Types for Hydrodynamics. ....................................................................................................... 33Table 8 Velocities at inflow boundaries. .......................................................................................................................................... 36Table 9 Inflow boundary geometry options .................................................................................................................................... 36Table 10 Boundary condition types for the sediment transport model. ........................................................................................... 37Table 11 B-coefficient in formula qs= A qB for various rivers (from Garde & Ranga Raju, 1985). ................................................ 44Table 12 Wet, dry and partially dry element classes ...................................................................................................................... 52Table 13 Mannings n roughness coefficients for various culvert materials. Adapted from Froehlich (2003). ................................ 59Table 14 Entrance loss coefficients Ke. Adapted from Froehlich (2003). ....................................................................................... 60Table 15 Culvert inlet control formula coefficients. Adapted from Froehlich (2003). ...................................................................... 61Table 16 Culvert inlet configurations. (Adapted from www.xmswiki .com/xms/). ............................................................................. 62

Table 17 HEC-RAS files with elevation data ................................................................................................................................... 81Table 18 Var iables in Results Data layer ........................................................................................................................................ 87Table 19 Culvert data .................................................................................................................................................................... 121Table 20 Graphic file types and world file extensions. .................................................................................................................. 129Table 21 Image formats supported by Argus ONE in Map layers. ................................................................................................ 134


12/167


13/167


1

1 INTRODUCTION

RiverFLO-2Dv3is a hydrodynamic and mobile bed finite element model for rivers. It can route floods and simulatechannel bed changes at high resolution and with remarkable stability. The use of adaptive triangular meshes enables

the flow field to be resolved around key features in complex river environments.

RiverFLO-2Dv3Argus ONE Edition user interface is based upon Argus Open Numerical Environment (Argus ONE).This GIS-integrated software system provides interactive functions to generate and refine the finite element mesh. It

also facilitates assigning boundary conditions and roughness values. By importing and exporting multiple GIS

layers, the user can graphically display the model results in a number of formats.

RiverFLO-2Dv3computation engine uses an efficient and stable finite element solution method that eliminates theboundary and hot start difficulties of outdated 2-D finite element models. This version has more than 100 new

features and improvements, including hydraulic structures such as culverts, weirs, bridge piers, and internal rating

tables.

This users guide provides instructions to install the RiverFLO-2Dv3model, creating your first project, refining yourmodels and explains the fundamentals of the model and its components, as well as the numerical methods used to

solve the governing equations.

Figure 1 RiverFLO-2D v3 finite element mesh.


14/167


2

1.1Whats New in Release v3.1

RiverFLO-2D v3 release 3.1 provides new capabilities including:

Comprehensive Culver t D ialogV3.1 includes a redesigned and expanded dialog box that allows entering data for rectangular and circular culverts

and provides tables with typical parameters in drop down lists.

Dynamic Animations with Aerial BackgroundV3.1 can now plot model results over an aerial image in the background with transparency option.

RiverF LO-2D Post Processor ToolV3.1 greatly simplifies result visualization with this powerful capability that allows generating any number of

selected plots (water elevations, velocity, etc.) for multiple times with just a few clicks.

River AnimatorRiver Animator is a new tool to plot results including animations in Google Earth and standalone animations in

Windows Media Viewer format. River Animator was developed by Herrera Environmental Consultant in

collaboration with Hydronia and is distributed as a free visualization add-on for RiverFLO-2D.

2dMRI : Two-dimensional Model Resul t I nterpreterTwo-dimensional Model Result Interpreter was developed in collaboration with Northwest Hydraulic Consultants,

and is distributed as a free add-on to RiverFLO-2D v3, allowing generating plots and animations of profiles, cross

sections and observation points. 2dMRI capabilities include:

Step through time and zoom in on profiles or cross sections showing riverbed and water surface

View a hydrograph at any point along a profile with a single click

Plot a hydrograph at any observation point and dynamic animation of profiles and cross sections

HEC-RAS Data Extr action ToolThis tool will extract bed elevations from HEC-RAS geometry files and generate X Y Z ASCII files that can be

readily imported in Argus ONE and SMS.

USBR Hazard Mapping ToolWith this new capability the model will export support files to generate Hazard Map Shape Files based on the

United States Bureau of Reclamation (USBR) guidelines for hazard classification downstream of dams.

Enhancements for DXF exportExport the finite element mesh and velocity field in DXF format.

New Boundary conditi onA new boundary condition was added: BCTYPE = 25 to impose water and sediment discharge and WSE that is

appropriate when supercritical flow regime occurs at the upstream boundary.

New parameters in resul t f il esWhen performing sediment transport simulations, the program now calculates the maximum and minimum bed

elevation, and the maximum erosion and deposition depths at all nodes and writes them to the output maximum

files: .MAXE,MAXI, _ENG_MAX.EXP _METRIC_MAX.EXP

New Output f il e to report f looded areaThe model now creates a file output the flooding area for every report interval.

V3.1 also includes various bug fixes and several performance improvements.


15/167


3

2 INSTALLING RiverFLO-2D v3 - Argus ONE EDITION

This RiverFLO-2Dv3uses the well-established Argus ONE graphical interface software (www.argusone.com)as apre-processor to facilitate data input and display results. Argus ONE provides a user friendly GIS environment,

automatically linking the physical data in GIS layers to mesh nodes and elements. Regenerating the computational

mesh does not require re-entering the baseline data such as bed elevations, roughness coefficients, or boundaryconditions. The software provides a variety of mesh generation options to optimize the mesh creation around

complex river features. This enables the model to resolve difficult flow issues in a rapidly varied flow field.

Creating a RiverFLO-2Dv3project is relatively straight forward, but more importantly, its robust and stable numericalsolution method minimizes tedious debugging saving time and computational resources.

Figure 2 Argus ONE main window showing a velocity field computed with RiverFLO-2D

2.1Upgrading from RiverFLO-2D v2009

If you own a RiverFLO-2D v2009license and are upgrading to RiverFLO-2D v3, you can follow the setup guide belowto install the new version. You can have both versions installed in the same computer and they will not interfere with

each other. There is no need to have a new hardware key. RiverFLO-2D v3uses the same key that works with v2009.
http://www.argusone.com/http://www.argusone.com/http://www.argusone.com/http://www.argusone.com/


16/167


17/167


5

2.5 Installing RiverFLO-2D v3 / Argus ONE Network Version

NOTE: You will need Administrator permissions to install the RiverFLO-2D v3.Also, in Windows 7 you may need tomodify the program installation permissions.

Using RiverFLO-2D v3and Argus ONE on a network configuration with floating licenses allows the programs to beinstalled on as many networked PCs as required and used simultaneously from any of those PCs. The number of

users which can run RiverFLO-2D v3and Argus ONE concurrently equals to the number of licenses your organizationhas purchased. As long as this number is not exceeded, more users can start RiverFLO-2D v3and Argus ONE and useit from their own PC.

This section explains:

1.

How to install the license manager on the "license server".

2.

How to install RiverFLO-2D v3 and Argus ONE on the work stations so that it will look for the license overthe network.

The floating license configuration uses the Aladdin NetHASP technology which is comprised of two main

components:

1. NetHASP key (network USB hardware key).

2. License Manager Server software (LM).

The License Manager Server allows the RiverFLO-2D v3and Argus ONE programs to connect and communicate withthe network key provided. The network key must be connected to a USB port of the same PC the License Manager

(LM) server will be run on. This PC should be on the same network to which the users of RiverFLO-2D v3 and ArgusONE are connected. Many network protocols are supported including TCP/IP, UDP, and NetBios.

Installing Argus ONE Network Manager2.5.1

NOTE: Skip steps 1-4 if you are upgrading f rom v2009 network version.

1.

Make sure you have Administrator privileges before commencing.

2.

Be sure to pick a computer that is not often rebooted, since every restart of the LM will terminate any open

licenses. On the RiverFLO-2D v3 installation CD, open the folder NetHASPUtils, where you will find thefollowing files and directories:

a.

LMsetup.exe: Installer of the License Manager Program.

b.

Monitor Install: A directory containing the installer for the Monitor program used to monitor the

number and location of users.

c. NetHASP.ini: Optional Configuration file for the workstations.

d. Readme.txt: a copy of this file (the one you are now reading).

3. Run the LMsetup.exe double clicking on the file to install the required drivers and the LM as a service.

4. Connect the Network Hardware Key (Red USB NetHASP Key) to the USB port of the PC you selected for

installing the LM Server on. (Again, be sure to pick a computer that is not often rebooted, since every

restart of the LM will terminate any open licenses).

5.

Double click the file "RiverFLO-2D_v3_Network_Setup.exe" on the RiverFLO-2D v3 CD.6.

Follow the installation instructions on your screen to install both Argus ONE and RiverFLO-2D v3.7.

Open the Argus ONE program.

8.

If Argus ONE does not find the network manager close the program and reopen it.

It is recommended to start exploring RiverFLO-2D v3 reading this Users Guide.All RiverFLO-2D v3 documentation isinstalled in the folder:

\Documents \RiverFLO-2Dv3\Documentation


18/167


6

3 Argus ONE MAIN WINDOW

This figure shows the main parts of the Argus ONE window.

Figure 3 Argus ONE main window

Clicking on the Layersbutton of the Layer window will open the Layers Dialog:

Figure 4 Argus ONE Floating LayerWindow.

Figure 5 Argus ONE layers dialog.


19/167


7

4 RiverFLO-2D v3 / Argus ONE LAYER STRUCTURE

4.1RiverFLO-2D Layers

To create a new RiverFLO-2D v31 environment in Argus ONE, use the New RiverFLO-2D v31 Project in Argus ONEPIE (Plug In Extension) menu:

Figure 6 Creating a new RiverFLO-2D project

This operation will create the new layer structure available in RiverFLO-2D v3.

RiverFLO-2D v3 includes a set of standard layers organized in groups that simplify data input as well as visualizationof model output, facilitating the user interaction with the model. The new layer groups include: Mesh Spatial Data,

Components, Output Control, Output Results and Plots shown in the following Argus ONE layer window and in

Table 1 1 below:


20/167


8

Table 1 Argus ONE layers for RiverFLO-2D v3.

LAYERS WINDOW LAYER/GROUP NAME TYPE PURPOSE/CONTENT

Domain Outline Information Polygons that delimits the

modeling area, break lines,

polylines that define weirs and

internal boundaries.

Mesh Density Information Used to refine mesh on

polygons, along polylines or

around points.

FiniteElementMesh TriMesh Finite element mesh.

BedElevations Data Point elevation data.

Boundary Conditions Data Boundary conditions data.

MESH_SPATIAL_DATA GROUPDELIMITATION FOR MESHDATA LAYERS

InitialWSE Information Polygons with initial water

surface elevation.ManningsN Information Polygons with Mannings n

values.

MaximumErosionDepth Information Polygons with maximum erosion

depths.

COMPONENTS GROUPDELIMITATION FORCOMPONENT LAYERS

Culverts Information Lines representing culverts.

Flow between the elements on

both line ends will be

determined based on a rating

table that needs to be provided.

InternalRatingTables Information Polylines where internal ratingtables will be used to compute

water surface elevation as a

function of discharge. Every

polyline needs to be duplicated

on the Domain Outline layer to

ensure that nodes are generated

over the line.

BridgePiers Information Points that represent bridge

piers.

SourcesSinks Information Includes points to impose inflow

or outflow.

Weirs Information Polylines defining weirs. Everypolyline needs to be duplicated

on the Domain Outline layer to

ensure that nodes are generated

over the line.


21/167


9

Table 2 Argus ONE layers for RiverFLO-2D v3 (cont.).

LAYERS WINDOW LAYER/GROUP NAME TYPE PURPOSE/CONTENT

OUTPUT_CONTROL GROUP

DELIMITATION FOR

OUTPUT CONTROL

LAYERS

Aerial Map Aerial image.PlotWindow Information Rectangle that represents the

area where plots will be

generated during run.

ObservationPoints Information Points that the model will use to

generate time series output of

results at the point locations.

CrossSections Information Lines representing cross sections

where the model will report

results.

Profiles Information Polylines representing profiles

along which the model will

report results.

OUTPUT_RESULTS GROUP DELIMITATION FOR RESULTLAYERS

RESULTS1 Data Import results from the model.

MAX_RESULTS Data Import extreme (MAX/MIN)

results from the model.

ShapeFileVelocities Information Import support files to createvelocity field shapefiles.

ShapeFileWSELs Information Import support files to createwater elevation shapefiles.

ShapeFileDepths Information Import support files to createdepth shapefiles.

USBRHazard Information Import support files to createUSBR Hazard Map shapefiles.

PLOTS GROUP DELIMITATION FOR PLOTLAYERS

VelocityField1 Map Velocity field plot.

VelocityModules1 Map Velocity module plot.

Depths1 Map Depth plot.

WSEL1 Map Water surface elevation plot.

BEDEL_ORI1 Map Initial bed elevation plot.

BEDEL1 Map Bed elevation plot.

DELTA_BEDEL1 Map Differences in bed elevation

since time = 0.

FROUDE Map Froude number.

QSX1 Map Volumetric sediment dischargeper unit width in x direction.

QSY1 Map Volumetric sediment discharge

per unit width in y direction.

QS1 Map Volumetric sediment discharge

vector per unit width.


22/167


10

4.2Exporting RiverFLO-2D v3 Files

To export RiverFLO-2D v3 files and run the model, use the Export RiverFLO-2D v3 in Argus ONE PIE menu:

Figure 7 Export command in PIE drop list

This operation will create the layer structure available in RiverFLO-2D v3.

The program will now display the following dialog:

Figure 8 Export file selection dialog

The following table describes the actions that will take place for each selection.


23/167


11

Table 3 Actions on RiverFLO-2D v3 Export Dialog.

EXPORT FILE SELECTION ACTION

Export All Data Files Generates all RiverFLO-2Dv3model files and returns control to ArgusONE without running the model.

Export Only Component and

Control Data Files

Generates component and control data files and returns control to

Argus ONE without running the model.

Export All Data Files and Run

RiverFLO-2D

Generates all RiverFLO-2Dv3model files and starts running the model.

Export Only Component and

Control Data Files and Run

RiverFLO-2D

Generates component and control data files and stats running the

model. Spatial data is read from existing files.

Run RiverFLO-2D with

Existing Files (Do not export

files)

The model will start running reading data from existing files.

4.3Parameter names in Result data layers

When importing TIME_ENG*.EXPor TIME_METRIC*.EXPfiles in theRESULTSdata layer, results will beorganized in parameters with readily identifiable names as shown:

Figure 9 Results data layer contents


24/167


12

Table 4 Parameters in new Result Data Layer in Argus ONE/RiverFLO-2D v3

PARAMETERNAME

DESCRIPTION

X x coordinate

Y y coordinateUx of U Velocity component in x direction

Uy or V Velocity component in y direction

Velocity Velocity magnitude WSEL Water surface elevation

Depth Depth

BEDEL_ORI Initial bed elevation

BEDEL Bed elevation

DELTA_BED Bed elevation change since time = 0

DRY_WET Dry or wet

FROUDE Froude number

QSX Volumetric sediment discharge per unit width in X direction: Qsx

QSY Volumetric sediment discharge per unit width in X direction: Qsy

QS Volumetric sediment discharge magnitude: TAU Bed shear stress* C For use in future advection-dispersion module.

T For use in future advection-dispersion module.

*English units: =62.4 lb/ft3, k=1.49;metric units: =9810 N/m3; k=1, n = Mannings coefficient.


25/167


13

4.4Parameter names in MAX_RESULTS data layer

When importing _ENG_MAX.EXP or _METRIC_MAX.EXP files in theMAX_RESULTSdata layer, results will be organized in parameters with readily identifiable names as shown:

Figure 10 Results layer drop list

Table 5 Parameters in new Result Data Layer in Argus ONE/RiverFLO-2D v3

PARAMETER NAME DESCRIPTION

X x coordinate

Y y coordinate

MAXVEL Maximum velocity

MAXDEPTH Maximum depth

MAXWSEL Maximum water elevation

MAXBEDEL Maximum bed elevation

MINBEDEL Minimum bed elevation

MAXEROSIONDEPTH Maximum erosion depth

MAXDEPOSITIONDEPTH Maximum deposition depth

*English units: =62.4 lb/ft3, k=1.49;metric units: =9810 N/m3; k=1, n = Mannings coefficient.


26/167


14


27/167


15

5 CREATING YOUR FIRST RiverFLO-2D v3 PROJECT

This section provides a step-by-step guide to help you get started on a RiverFLO-2D v3project. This procedure willinclude instructions for entering bed and terrain elevation data, running the RiverFLO-2Dmodel and creating plots ofthe hydraulic results. As an example, a river simulation with available bed elevation data is used. The boundary

conditions include discharge inflow and water surface elevation outflow. It is recommended that the Argus ONEUsers Guide be consulted for further information on model setup and result visualization.

The following steps are discussed:

1.

Starting a new RiverFLO-2Dv3project

2.

Importing Bed Elevations

3.

Defining the Domain Boundary

4.

Generating the Finite Element Mesh

5.

Entering Mannings n Coefficient Data

6. Entering Boundary Conditions

7. Exporting RiverFLO-2D Mesh Data

8.

Entering additional Data and Running the Model

All the data files required to run this project are in the following directory:

5.1Starting a New RiverFLO-2D v3 Project

To start using RiverFLO-2D v3,double-click the Argus ONE icon on your desktop

NOTE: If you do not have hardware key connected to your computer or the network, Argus ONE will display a

message similar to this:

Figure 11 Hardware key error message

This will limit Argus ONE to run in Evaluation Mode. This mode is fully functional except that it is not possible to

save projects and even though you are able to generate large meshes for evaluation purposes, exporting is limited to

625 elements.

\Documents\RiverFLO-2Dv3\ExampleProjects\Hoh


28/167


16

To start, click onNew RiverFLO-2D v31 Project. on the PIEs menu:

Figure 12 Argus ONE PIEs Menu

A new RiverFLO-2D v3project environment is created in Argus ONE that includes a set of predefined layers as shownin the layers window:

You may add other layers as required. For example, to visualize model

results you will typically import them from one of the model output files

into a new data layer. Then it is easy to create a new Map layers to

generate plots from the imported results. For further details on the features

of the Argus ONE program, refer to the Argus ONE Users Guide in the

directory:

\Documents\RiverFLO-2Dv3\Documentation.

Figure 13 Argus ONE layers window


29/167


17

5.2 Importing Bed Elevations

To import a set of elevation points, first activate the BedElevations layer (if is not active already) selecting it from

the Layers drop down list

Figure 14 Activating bed elevations layer from drop list

Activating the BedElevations Layer can also be done by clicking at the left of the BedElevations layer on the Layers

window:

Figure 15 Activating bed elevations layer in layer window

NOTE: It is required to activate