National Weather Service United States Department of Commerce

AV-THRESHR TUTORIAL

(Workshop used for COMET Training Course, March 2000)
Last Modified 02/28/2000


1.0 Introduction:

This tutorial provides instructions on how to use AV-ThreshR.  Readers who want to know more details about AV-ThreshR methods and the accompanying database may want to take a look at the AV-ThreshR documentation.  Hyperlinks within this document link to this user documentation to explain certain concepts.

The AV-ThreshR system is being developed for implementation at each of the 13 National Weather Service River Forecast Centers (RFCs).  As discussed in the user documentation, AV-ThreshR consists of both software and a database.  The software consists primarily of Avenue programs that are packaged as an ArcView Extension called threshr.avx.  For UNIX users, the AV-ThreshR package is also delivered with a compiled C++ program to provide a more efficient stream tracing algorithm.

2.0 Requirements:


Software:  AV-ThreshR requires ArcView v. 3.1 or later and Spatial Analyst v. 1.1 or later.

Hardware:
Most of the ThreshR calculations are done using Avenue scripts which are platform independent; however, the Avenue script used to determine watershed connectivity makes a call to pre-compiled C++ program (source: IdUpstreamC, executable: idupstream) because this program is much faster than the equivalent Avenue code.  This code was compiled on the HP-UX 10.20 operating system using the aCC compiler.  Although, there are currently no plans to provide support for a PC version of AV-ThreshR, PC users may opt to use the less efficient Avenue codes to determine watershed connectivity, making the entire AV-ThreshR package platform independent.

User Knowledge:

  • It is assumed that the user has a basic understanding of hydrology and understands the threshold runoff concept.  It is recommended, but not required, that the user read Sections 1, 2.1, 2.2, and 5 of the AV-ThreshR Documentation.
  • It is assumed that the user has a basic knowledge of ArcView terminology and knows how to navigate the ArcView user interface. For those people used to running Windows software, learning ArcView is fairly intuitive. For users that have little or no ArcView experience, it is STRONGLY RECOMMENDED that you go through the ArcView "Quick Start Tutorial" Chapter 2, Exercise 1 in the book "Using ArcView" that is distributed with the software, and the Spatial Analyst "Quick Start Tutorial," Chapter 2 in "Using the ArcView Spatial Analyst," also distributed with the software. Learning the basics of ArcView will only take a few hours and can be fun. Files for these tutorials can be found on the installation CDs. [At HRL, files for the ArcView tutorial are located on the NHDRs in the directory /nonawips/gis/avtutor/arcview. Files for the Spatial Analyst tutorial are located in the directory /nonawips/opt/arcview3/avtutor/spatial.]

3.0 Demo Instructions:

3.1 Getting Started

- On UNIX systems,  copy the extension file threshr.avx to either your Home directory or to the directory /ext under the ArcView3 installation directory.  If the file is copied to your Home directory, only you will be able to load threshr.avx.  If threshr.avx is copied to the /ext directory, all ArcView users will be able to access the AV-ThreshR extension.  [On a PC, copy threshr.avx to the ArcViewext32 directory.]

- Start ArcView and load the AV-ThreshR Extension.  This can be done by accessing the menu item File --> Extensions when either a Project window or a View window is active.  In the Extensions dialog, scroll down the list of available Extensions and place a check mark next to "ThreshR."  To see information about the version number of ThreshR in the "About" frame, click the mouse on the "ThreshR" text.  Threshr.avx is dependent on the Spatial Analyst so the Spatial Analyst Extension is automatically loaded if the ThreshR extension box is selected.  An error will occur if the Spatial Analyst Extension is not available.  Click OK.

- Open a new View and you will see that two customized Menus, "ThreshR" and "ThreshR-Utility," are added to the default View GUI.  In other words, whenever a View is active, these menus will be seen.  Customized tools have also been added to the Tool bar.  For the simplest and most straightforward implementation of AV-ThreshR, the end-user is only concerned with items under the "ThreshR" menu.  The "ThreshR-Utility" menu contains programs used for data preparation and pre-processing; however, these programs are not needed to calculate threshold runoff and are provided for the advanced user only.  Only the programs underneath the "ThreshR" menu are described in this document.

-  Create a directory in which you want output files to be written.  Make the Project window active and then select Project --> Properties.  In the "Project Properties" window enter the name of your output directory in the "Work Directory" text box.

- With your View active, click View --> Properties and set map units to meters and distance units to meters and click OK.

3.2 Program Execution

The 9 items in the main "ThreshR" pull-down menu are shown in the figure below.  The ThreshR menu items are divided into logical groups that are separated by a horizontal bar.  Steps 2, 3, and 4 are pure GIS processing steps and are also the most time consuming (hours).  More discussion of  computational time is discussed in the User Documentation.    It is expected that a user would run steps 2, 3, and 4 only once or perhaps a few times.  Steps 5, 6, and 7 are relatively fast (minutes) and users may wish to repeat these steps to study different scenarios.  A user will likely wish to examine subbasin threshold runoff results from Step 7 before interpolating results to the HRAP grid in Step 8 (~ 15 minutes).  Subbasin and parameter output from steps 2, 3, and 4 have been pre-computed for ABRFC for one possible subbasin size.  These subbasin are used later in the ABRFC Analysis section.  The instructions here guide a user through the entire AV-ThreshR procedure for a relatively small analysis area.  This is done to illustrate all of the processing steps while eliminating long wait times.

        ThreshR

tr graphic

Step 1.  ThreshR --> Setup

Click on this menu item and you will be prompted to enter the directory name for the location of the input data.  (Note: The programs can read data directly from a CD-ROM drive although the program performance may be slower and an MSEEK error may occur.  Therefore, it is recommended that the input data be available on a local or networked hard disk.)

Dialog used to specify the input directory:

tr graphic

After clicking OK, the user is asked whether or not to load input data.  Typically the answer is yes unless all of the input data is already loaded and you are just running setup to change the identity of the input directory.  In either case, the program will not load a second copy of a Theme to the project if there is already a data Theme with that name loaded.

tr graphic

Click yes and the setup program will automatically load the following data Themes into your currently active View window.

Shapefiles:
rfcbound.shp -- RFC boundary defined by the DEM
rf1.shp -- a modified version of EPA's River Reach File 1 (RF1); although not used directly by the ThreshR programs, this file is useful for spatial reference because it contains river names
statekey.shp -- State Boundaries used for USGS regression equations.
regions.shp -- Regions used in USGS Regression Equations
hrappts.shp -- center points of HRAP cells (this shapefile will look skewed because of the map projection being used; however, the projection being used is well suited for the type of analysis being done); interpolated values of ThreshR are joined to this shapefile and exported to FFG.

Grids:
slopeff -- slope in ft/ft
fd -- flow direction grid
fa -- flow accumulation grid
mask -- buffered mask of RFC boundary; cells within the basin are assigned the value 1 and cells outside the basin are assigned "NODATA"
fld -- downstream flowlength (m)

Two Table documents are also loaded into your project:
parcode.dbf -- stores information the programs need to determine which parameters to compute and how to compute them
regequat.dbf -- stores constants needed for the USGS Peakflow regression equations in different states and different regions

tr graphic

In this tutorial, information about these input data sets will be provided on an as needed basis.  Much more information about the input data is provided in User Documentation: Data, and a more detailed description of the parcode.dbf and regequat.dbf tables is provided in User Documentation: Function.

The GIS data sources displayed in your view are not all of the data sources used by the ThreshR programs.  Other input data sets required for USGS Flood Frequency Regression parameter calculations are accessed directly by Avenue codes using their file system names (without loading the data as Themes into a View).  This is done to avoid cluttering up the Theme Table of Contents in the View window.  Curious users may wish to look at these data Themes if there is time at the end of this workshop.  The parcode.dbf field lists file and directory names for these additional data layers.
 

Step 1.1  Setting the Analysis Properties

- With a View active, click Analysis --> Properties and set the Analysis Extent to Same as the flow direction grid (fd).  Also set the Analysis Cell Size to Same as fd.  Set the Analysis Mask to Mask and click OK.

Step 2.  ThreshR --> Define Subbasins

By default, AV-ThreshR is set up to work on a large analysis area (the entire RFC).  However, to facilitate a quick tutorial we will focus on a small area.  To analyze only a selected area, a polygon Shapefile of the area to be analyzed is required.  This can be created using ArcView delineation tools, but a pre-defined Shapefile is used in this tutorial.  Load the Shapefile called "tkshd.shp" from the input data directory ("/yourlocalpath/abrfc") using tr graphic.  This is a basin boundary for the Illinois River draining to the Tenkiller Reservoir in eastern Oklahoma.  Now you are ready to define subbasins within this area.  Turn this Theme "on" in the View by placing a check next to its name in the Table of Contents and Zoom to the extent of this Theme using tr graphic.

The default method used to define subbasins will be referred to as the "Streamlink" method.  This method is explained in detail in User Documentation: Function: Define Subbasins.  The basic approach is to (1) define a stream network from the DEM using an area threshold, (2) define local subbasins draining to each stream reach, and (3) calculate threshold runoff at the outlet of each subbasin.  Since the final Threshold Runoff values are currently used in a gridded form by the Flash Flood Guidance (FFG) program, the objective of subbasin definition is to create a sampling of outlet points covering a large geographic area where computations can be made and interpolated to a grid.  Two alternative subbasin definition methods have recently been added as options to the AV-ThreshR software.  For purposes of this workshop, stick with the fully tested "Streamlink" method.  Alternative subbasin delineation options will be discussed in the lecture.

Click ThreshR --> Define Subbasins and the following dialog will appear.

tr graphic
 
 

  • For demonstration purposes, enter 30 km2  as the drainage area threshold.  Note:  This is the minimum drainage area used to define a headwater subbasin, not the average area of the headwater subbasins that get created.  As discussed in User Documentation: Function: Define Subbasins, using the "Streamlink" delineation method, the mean headwater basin size is typically about 2.3 times the size of the stream threshold selected.  The "area threshold" is the minimum drainage area used to define a stream.  Subbasins are delineated for each stream link in the stream network defined using this area threshold.
  • The program will provide the default names for the flow direction (fd) and flow accumulation Grids (fa).  Leave these names as is, unless you have renamed the flow direction and flow accumulation Themes in your project.
  • Select the box next to "Analyze Only Selected Area."   When this box is selected, the "Selected Area Theme" text line becomes visible. Enter "tkshd.shp" into this line.  Note: To analyze the entire RFC, you would enter "rfcbound.shp" as the "Selected Area Theme" text line.
  • Select the box next to "Use Area Limit" is selected and use the default value of 2000 km2 as the maximum cumulative area that will be used in defining subbasins basins for the analysis.  This option is included because computation of threshold runoff relies on unit hydrograph theory and it is often stated that unit hydrograph theory breaks down for large basins for which it is unlikely to get uniform rainfall.  An often cited value for the upper limit on unit graph application is 2000 km2.
Click the Calculate button to define the subbasins.  Calculations should only take several seconds to a minute or two.  When the program finishes, a completion report is presented to the user.  Click OK.

Five Themes are added to the View by this program: a subbasin theme (shdx.shp), a subbasin outlet theme (outcx.shp), a stream coverage (strcx.shp), a watershed grid (shdgrix), and stream grid (strgx).  The "x" in these file names represents an integer that should be equal to 1 on the first run, but will be incremented if you re-run the programs using the same Project Working Directory.  You will need to adjust the Theme Legends to see a result similar to that shown here.

tr graphic
 

Note that the white areas are interbasins for which the cumulative area at the outlet is greater than 2000 km2.  The subbasin delineation program can be re-run with no area limit if it is desirable to delineate these "missing" interbasins.  The option to specify a maximum subbasin size has been included at this step to reduce the number of subbasins for which calculations are required in the next two steps:  stream connectivity and subbasin parameter calculations.  This option, to set a maximum subbasin size where calculations actually occur is also offered in subsequent steps.

Threshold runoff results will be sensitive to the stream definition threshold.  As database development continues and guidelines for software use are refomed (Status, Future Plans), it will be important to consider how subbasin size relates to:  (1) threshold runoff, (2) the underlying rainfall-runoff model used for flash-flood guidance, (3) the spatial resolution of the rainfall, and (4) the required spatial resolution in flash-flood forecasts.

Step 3.  ThreshR --> Determine Connectivity

NOTE:  When running "Determine Connectivity" for a large area (>10,000) subbasins, I've had problems with the user dialog locking up (and not closing correctly) after the calculations are complete.  I don't know what causes this yet but it is a good idea to periodically save your project file in case this occurs.

Basin connectivity is determined to facilitate computation of cumulative subbasin parameters for non-headwater subbasins.

Click ThreshR --> Determine Connectivity to get the following dialog:

tr graphic

Check to make sure the program has provided the correct subwatershed and stream line theme names (shown above) and click Calculate to run.  Click OK when the program is complete.

This program identifies headwater and outlet subbasins and also stores upstream connectivity information in three ASCII files.  See Function: Determine Connectivity for more information about these files.  The program adds the fields "shdishead" and "shdisout" to the subbasin Shapefile (shd1.shp).  One way to see this is to make shd1.shp the active theme (by clicking on its Theme name in the Table of Contents), click on tr graphic , enter the query ( [shdishead] = 1 ), and click on the "New Set" button to select all headwater subbasins.  Queries can be entered without typing by double-clicking on a field name, clicking on an operator (e.g. "="), and double clicking on a value in the query window presented.

tr graphic

To close this query window, hold down the left mouse on the tab in the upper left corner and select "Close" from the options presented (or use Alt-F4).

The "No C Program" option is provided for users who do not have the executable file "idupstream" (e.g. PC users).  For this small example area, running with the No C Program box checked is fairly quick; however, this option becomes inefficient when working with many subbasins; hence, the reason for using an external program.  This option will add an "isoutlet" field to the stream Shapefile (strc1.shp) rather than adding the "shdisout" field to the subbasin Shapefile (shd1.shp).

Step 4.  ThreshR --> Compute Subbasin Parameters

Click on ThreshR --> Compute Subbasin Parameters to see the following dialog:

tr graphic

For standard runs, the program will provide the correct names for the input Themes so no typing is required.  The option to change the names of inpute themes is only provided for users who want to skip around in the processing sequence.

Radio buttons on the right side of the dialog allow the user to choose whether "All Parameters,""Basic Parameters Only," or "USGS Regression Parameters Only" will be computed.  For this tutorial, select the "All Parameters" button.  More information about the other options is provided in Function: Compute Subbasin Parameters Do not check the box next to Heads Only (2/28/2000) -- this option has no been fully tested.

Click Calculate to start calculations.  For this area, these calculations may take several minutes depending on the speed of your computer.  Click OK  when the calculations are complete.

This program computes topographic and climatic parameters required for Snyder unit graph peak flow calculations and USGS Flood Frequency Regression Equations.  The parameters required for the Snyder unit graph peak flow calculations are cumulative drainage area (ARM), length of the longest flow path (CHLN), and length to the point on the longest flow path opposite the centroid (CHCN).

Since the drainage area of interest intersects both Oklahoma and Arkansas-Flood Region B, the following equations will be used to calculate the 2-year peak flow in the next step:

Oklahoma:

Q2 = 0.368*ARM^0.59*PRE_OK^1.84

Arkansas Region B:

Q2 = 0.120*ARM^0.78*CHSL^0.42*PRE_AR^0.55*ELV^0.75

These equations are taken from USGS WRIR 94-4002.  The input parameters for these equations are:
 

  • ARM = cumulative drainage area in [mi2]
  • CHSL = "channel slope" measured as the slope between two points along the longest flow path measured at 85% and 10% of the distance from the outlet to the basin divide [ft/mile].  Note: This is the definition of channel slope used in both USGS WRIR 87-4008 and USGS WRIR 86-4335.  To my knowledge, it is not stated anywhere in USGS WRIR 94-4002 that a consistent method of measuring "channel slope" is used by all states requiring this parameter.
  • PRE_OK = mean annual precipitation in Oklahoma  [inches]
  • PRE_AR = mean annual precipitation in Arkansas minus 30 [inches]  (Note: mean annual precip is computed from source maps cited in USGS WRIR 94-4002.)
  • ELV = mean basin elevation [ft]
A description of the input parameters to these equations is given in the table "parcode.dbf" in your project.  Take a look at this table by activating the Project Window, clicking on the tables icon tr graphic and double-clicking on "parcode.dbf."  This table contains a list of all parameters of interest in ABRFC; however, only parameter values relevant to the analysis area of interest are computed.  More details about how parcode.dbf is used are given in Function: Compute Subbasin Parameters.

Take a look at the parameter values that have been computed for each subbasin by reactivating the View window, making the shd1.shp Theme the active Theme, and clicking on tr graphic to view the attribute table associated with shd1.shp.  You may want to enlarge the table window and scroll to the right.  In this table, you will see that the attributes (fields) ARM, CHSL0, CHLN, CHSL, CHCN, stateabbr, regions, and reg_fract are computed for all subbasins while PRE_AR and ELV are only computed for subbasins with their centroid in Arkansas and PRE_OK is only computed for subbasins which have their centroid in Oklahoma.  The subbasins that are considered to be in Arkansas can be highlighted on the map by querying the attribute table tr graphic with the string ( [stateabbr] = "AR" ) and selecting New Set.
 

Note that none of the subbasins in this example intersect multiple flood frequency regions within a given State so the "reg_fract" attribute in the shd1.shp attribute table is always 1.0.  If a subbasin did overlap more than one region, the area weights for each region would be seen in the reg_fract field.

Step 5.  ThreshR --> Compute Q2, Q5, etc.

With all required parameter values pre-computed, computation of peakflow values for a specified return period is relatively quick. Click ThreshR --> Compute Q2, Q5, etc. to see the following dialog:

tr graphic

For this example, select 2 [years] as the return period.  The program should have identified "shd1.shp" as the input Theme and "tkshd.shp" as the "Analysis Area Theme."  Leave these inputs as is.  Leave the Max. Cum. Area (km2) at its default value of 2000 km2.   Enter  a 1 to identify this run and click Calculate. Click OK when the completion report appears.

The program calculates Q2 for each subbasin.  A field called "Q2_1" is added to the shd1.shp attribute table.  The output field name will always be "Q" concatenated with the selected return period followed by "_" and the run identifier.  The units for Q2 are cfs.

Take a look at the output by editing the Theme legend for shd1.shp to map the 2-year peak flows.  To do this, double-click on the shd1.shp Theme, select "Graduated Color" as the legend type, choose Q2_1 as the classification field, and then click "Apply."  Your result should look similar to the image below.  The interbasins with the largest cumulative drainage areas have the highest Q2 values.

tr graphic
 
 

Step 6.  ThreshR --> UG Peak Flow

The last step that occurs before threshold runoff can be calculated is to determine the unit hydrograph peak flow for each subbasin.  For the initial release of AV-ThreshR, the only GUI supported unit graph method is the the Snyder method; however, other unit graph approaches could be implemented using standard ArcView table calculations.  The programming to include additional synthetic unit graph options (e.g. the geomorphologic unit graph) would be relatively simple; however, the difficulty is that synthetic unit graph parameters (e.g. Snyder coefficients Cp and Ct or cross section parameters for the geomorphological unit graph) cannot be estimated from the GIS database and must be supplied by the user.  Note: The possibility of developing a national database to support automatic unit graph estimation for ThreshR has been discussed (See Status and Future Plans).

For this example application, we will assume that Cp and Ct are uniform throughout the study area (Cp = 2.7 and Ct = 0.93).  Thus variations in Qp (peakflow estimates) will be due to variations in geometric parameters only.  These Cp and Ct values were estimated by simulating a 1 hour unit graph for the Illinois River near Watts, OK using modClark parameter values from an HEC-HMS study, and then back calculating Cp and Ct based on geometric characteristics derived using AV-ThreshR.  Note: This unit graph and the resulting Cp and Ct values were derived by calibrating data for only a single event and are used for illustration purposes only.  Local knowledge of this area should yield better values.

tr graphic
 

Click ThreshR --> UG Peak Flow and you will see the following dialog:

tr graphic

The program should have identified "shd1.shp" as the Subbain Theme and the run identifier should be the same as that for the peak flow calculations ("1").  Leave these inputs as is.

For this tutorial, do not click the check box next to "UG Parameters from A File" because the Snyder coefficients will be entered manually for this case.  When this box is selected, the user can specify the name of a polygon Theme that contains spatially distributed Snyder parameter values.

Click Calculate Peak Flow and you will be prompted to enter Cp and Ct values.  As discussed above, enter Ct = 2.7 and Cp = 0.93.  A message will appear when calculations are complete.  Click OK.

Three new fields have been added to the attribute table of shd1.shp.  These fields are named "Qsd1_1," "Qsd3_1," and "Qsd6_1" respectively, which represent the 1 hour, 3 hour, and 6 hour unit hydrograph peak flows respectively in [cfs].

Step 7.  ThreshR -->  Subbasin Threshold Runoff

The function of this step is to simply create a new field (or fields) in the subbasin theme ("shd1.shp") that contains the computed threshold runoff for a selected duration (or durations).  The programs run in this step provide an interface for making the necessary tabular calculations (dividing the bankfull flow field (cfs) by the unit graph peak flow field (cfs/in)).  If the bankfull flow or unit graph peak values for any of the subbasins are 0, then the value in the output field is flagged as -1.

With your View active, Click ThreshR --> Subbasins Threshold Runoff and you will see a dialog similar to the following except that the "Bankfull Flow Field" Combo Box and the "UG Peaks" List Box will initially be blank.  Once you select "shd1.shp" as the subbasin Theme, this Combo Box and List Box get populated.

tr graphic
 

Select Q2_1 as the bankfull flow field and select Qsd1_1 as the unit graph peak flow field.  Alternatively, you could select multiple unit graph peak flow fields to calculate threshold runoff for multiple unit graph durations (e.g. 1 hr, 3 hr, and 6 hr) in a single pass.  Selecting multiple entries in the "UG Peaks" list box can be achieved by holding down the shift key.  Click Calculate and you will be prompted to name the output field that will contain computed threshold runoff values.  Type "tr1hr_1" or whatever name you like and click OK.  (This prompt will appear multiple times if you have selected multiple fields in the "UG Peaks" list box).   Q2_1 in cfs is divided by Qsd1_1 in cfs/inch to derive threshold runoff values.

Map the subbasin threshold runoff results in the field Qsd1_1 by modifying the legend of shd1.shp to display the values in the field tr1hr_1.  You should get a result that looks similar to the map shown below.  The general trend shown that threshold runoff values decrease with cumulative drainage area is expected because Q2 is proportional to A raised to a power less than 1 (0.59 in OK and 0.78 in AR), while the unit graph peak values are proportional to A raised to the power of 1.

tr graphic

Compute statistics for the tr1hr_1 field by making shd1.shp the active Theme, clicking on tr graphic, selecting the field tr1hr_1 with the mouse, and then choosing the menu item Field --> Statistics.   You will see that the statistics for 1 hour threshold runoff values in the 68 subbasins are:
 

mean = 2.3
max = 3.9
min = 1.0


A comparison of the values for headwater basins of comparable size in Oklahoma and Arkansas shows that Arkansas values tend to be higher than Oklahoma values.  This is simply because the Q2 regression equation for Arkansas Region B predicts higher values for this hydroclimatic region than the Q2 equation for Oklahoma.  This is not immediately obvious by looking at the Q2 equations themselves; however, if the Oklahoma Q2 equation is used to make calculations in Arkansas, the following results are obtained:

tr graphic

In this case, when the Oklahoma regression equation is applied to the entire area, the 1 hr threshold runoff statistics for the 68 subbasins are significantly different:
 

mean = 1.4
min = 0.9
max = 1.8
Notes:  This example was included only to illustrate that flood frequency equations for neighboring states may produce significantly different results near state boundaries.  The method used to apply Oklahoma regression equations in Arkansas was to change the database, not the software.  The ThreshR software is still under evaluation.  Predicted Q2 values should be compared with some of the original data sources for verification.

Step 8.  ThreshR --> Interpolate to HRAP

This step adds threshold runoff values to the Hrappts.shp (center points of the HRAP cells) Theme.  There is an option to interpolate values only from the headwater outlets and an option to interpolate values from all subbasin outlets (including cumulative subbasins).

In the Avenue program, interpolation to the hrappts.shp locations is actually accomplished in 3 steps: (1) hrappts.shp points that lie within subbasins with known threshold runoff values are assigned the corresponding subbasin values, (2) a grid of interpolated threshold runoff is created using the hrappts.shp points with known values as input (this grid covers all areas including the blank interbasin areas that drain more than 2000 km2), and (3) values from the interpolated grid are mapped back to hrappts.shp to provide a complete set of values for all HRAP cells within the analysis area.  Click ThreshR --> Interpolate to HRAP

tr graphic

The program should have identified "shd1.shp" as the Subbasin Polygons, "hrappts.shp" as the HRAP Points, "shdgri1" as the Subbasin Grid, and "tkshd.shp" as the analysis polygon Theme.

You may choose to interpolate values from headwaters only or from all subbasins in this example.  Click Calculate on the "Interpolate to HRAP" dialog and you will be prompted to identify the name of the field in shd1.shp that contains Threshold Runoff values.  In this example, the field name is tr1hr_1.  Click OK.

Two outputs are created.  One is a grid called Trgrid1 which is created for display purposes only.  The second is an attribute field called tr1hr_1 that is added to hrappts.shp.  If a field named "tr1hr_1" already exists, then the user is prompted to enter an alternate name.  Note:  hrappts.shp is stored as a point file rather than a grid because the HRAP cells are not regular square cells in the Albers Equal-Area projection used for threshold runoff analysis.

Step 9.  ThreshR -->  Write FFG ASCII File

This program reads values from hrappts.shp and writes an ASCII file that can be read by the FFG program.  Upon selecting ThreshR --> Write FFG ASCII File the user is prompted with several questions.  Select hrapptst.shp as the HRAP Theme.  Select tr1hr_1 as the field with threshold runoff values, select tkshd.shp as the analysis polygon Theme, enter "1" as the unit graph duration, and enter any text string as the output file name.  An ASCII file with this name is written to the ArcView Project Working directory.

----------------------------------------------------------------------
It is probably a good idea to save your project at this point by clicking File --> Save Project As.
-----------------------------------------------------------------------
 

4.0 Analysis for all of ABRFC

Given pre-computed subbasin parameter values, this section is included to demonstrate that it is relatively quick and easy to calculate threshold runoff values for an entire RFC, that is, if reasonable estimates of Snyder unit graph coefficients are available.  Because there is currently no spatial database of synthetic unit hydrograph coefficients (e.g. Snyder's Cp and Ct) or regression equations to estimate these coefficients in the AV-ThreshR database, ABRFC wide computations are illustrated by assuming constant Cp and Ct values -- most likely a poor assumption.

-- Open a new View.
-- Click ThreshR --> Setup and type the directory location of the input data.  Say Yes to load the input data.
-- Click Analysis  --> Properties and set the Analysis Extent to "Same as Fd," set the Analysis Cell Size to "Same as Fd," and the Analysis Mask to "Mask."  Click OK.
-- Click View --> Properties  and set both the map units and distance units to meters.
-- Load  the pre-computed subbasins and streams from the data directory by clicking tr graphic , navigating to the input data directory, and selecting shd1.shp and strc1.shp as the Themes to load.  "Turn on" the shd1.shp Theme to see 7403 subbasins in ABRFC.
-- Click ThreshR --> Compute Q2, Q5, etc and be sure that the Return Period is 2, enter the name of the Subbasin Theme (shd1.shp), and make sure the Analysis Area Theme is rfcbound.shp.  Enter "1" as the identifier for this run and click Calculate.  Wait a few minutes and calculations will be complete.  If the program says the output field already exists, then use a different identifier.  The field "Q2_1" is added to shd1.shp.  Note that 0 values are computed for many subbasins in  Colorado.  This is because USGS WRIR 94-4002 does not provide 2-year flood frequency equations for the plains region of Colorado.  As the database is cleaned up and delivered to the RFCs, any missing data or equations for certain states or regions are noted in Database: Release Notes.

-- Click ThreshR --> UG Peak Flow Calculations.  In the corresponding dialog, make sure there is no check mark next to "UG Parameters From A File," and the run identifier is the same as what was entered in the last step.  Click Calculate Peak Flow.  When prompted to enter the Snyder parameter values, enter the same values that were used in the example above (Ct=2.7 and Cp=0.93) and click OK.  These calculations should only take a minute or so.  Click OK when the completion report appears and the input dialog should close automatically.  The fields "Qsd1_1," "Qsd3_1," and "Qsd6_1" are added to shd1.shp.

-- Click ThreshR --> Subbasin Threshold Runoff.  Select "shd1.shp" as the Subbasin Theme, select "Q2_1" as the bankfull flow field, and select "Qsd1_1," as the unit graph peak flow field.  Click Calculate and enter a name for the output field.  Suggested name: "tr1hr_1."  The 1 hour threshold runoff field is added to shd1.shp.

-- Display subbasin results by editing the legend of shd1.shp to display tr1hr_1 using the Graduated Color legend type.  The value -1 has been assigned to subbasins in Colorado where Q2 is not known.  Unknown areas will be filled in by the interpolation procedures.

Although not critical for this tutorial, once satisfied with the subbasin threshold runoff results, a user can interpolate the results to the HRAP grid (~10-15 minutes) and Write the FFG ASCII File (several minutes?).  If you want to run the interpolation program for this example, you need to add the subbasin Grid shdgri1 from the input directory to your View.  In an end-to-end run, this grid would already be loaded in your project.

Main Link Categories:
Home | OHD | NWS