Equal Discharge Increment (EDI) Software

**UPDATE** Equal Discharge Increment calculations are now available in QRev v4.x. The USGS does not currently plan to continue development on the EDI Matlab program.

Description

Equal-discharge-increment method (EDI) samples are obtained from the centroids of equal-discharge increments across the cross section. This method requires some knowledge of the distribution of streamflow in the cross section, based on a long period of discharge record or on a discharge measurement made immediately prior to selecting sampling verticals. If this information can be obtained (such as with an ADCP), the EDI method can save time and labor; compared to the equal-width increment method. This is especially true on the larger streams, because fewer verticals are required (Hubbell and others, 1956)(Edwards and Glysson,1999).

Purpose and Scope

A discharge measurement made with an ADCP immediately prior to the collection of EDI samples can be used to identify the location, depth, and mean velocity for each EDI sample. To improve the accuracy and efficiency of using ADCP discharge measurements for EDI sampling a program was written in Matlab to read data from TRDI WinRiver II and SonTek/YSI RiverSurveyor Live ADCP software and perform the necessary computations. EDI is compiled with the Matlab compiler to allow users who do not have Matlab available to them to run the program.

Versions

Do not use as of 1/27/2011

Software/Firmware Status Definitions

Required Minimum: Minimum version required. This version has proven stable and may contain enhancements that are significant over previous required versions.

Recommended: Shown to have been reliable and contains features that result in a recommended upgrade over the required version. There could be a few specific use cases where this version may have issues that would result in some users not using this version. If so, those cases will be noted.

Allowed*: Deemed reliable during initial testing. Any issues will be noted along with improvements available over prior versions. Use of allowed versions may be desired in cases when the changes benefit a significant number of the user's conditions or equipment. For example: a new version of software is released that adds support for new hardware. If the user has this hardware, they would need to upgrade to the newer software before it becomes recommended or required. Use of these versions by experienced users will also help OSW identify any unknown issues.

Testing*: OSW is currently testing; any known issues or advantages over prior release will be noted. The use of a version that is in testing should usually be limited to advanced users that can trouble shoot potential issues and provide feedback on any irregularities or problems observed.

Do Not Use: A version either prior to the required minimum or that contains issues that significantly affect operations.

*Note: A version may remain in Allowed or Testing indefinitely. Example: A new version is released while the prior version is still in Testing. In this case the prior version may remain in Testing, while future testing efforts are placed on the newer version.

Data Input

The EDI program supports all TRDI ADCPs compatible with the moving-boat discharge measurement software WinRiver II and SonTek/YSI RiverSurveyor ADCPs compatible with the moving-boat discharge measurement software RiverSurveyor Live. After collecting the required transects that comprise a valid discharge measurement the user selects a representative transect to process with the EDI program. If data were collected with WinRiver II, an ASCII output file using the Classic format must be created and used as the input file for the EDI program. If RiverSurveyor Live was used to collect the data, a Matlab output file needs to be created and used as the input file for the EDI program.

Sources/Usage: Public Domain. View Media Details

Discussion of Computations

The EDI program does not recomputed the measured discharge separate from the ADCP software, but rather uses the discharge elements computed by the ADCP software and stored in the files discussed in the "Data Input" section. The EDI program interface allows the user to change the default increments of 10, 30, 50, 70, and 90 percent of the discharge to any desired flow percentage between 0 and 100 (see Figure 1). The location of the sample is determined by finding the first ensemble (referred to as the target ensemble) with a cumulative discharge that exceeds the target discharge. The target discharge is computed as the Target Percentage multiplied by the Total Discharge obtained from the selected transect. Both the target discharge and measured cumulative discharge to the target ensemble are displayed in the user interface. The distance displayed in the user interface is from the starting bank of the selected transect and is computed as the Distance Made Good (a straight-line distance from the starting location) to the target ensemble location plus the starting edge distance and a user provided zero distance offset. Therefore, it is important that the transect traverse the channel in a straight line.

The depth displayed is computed as the simple mean of the beam depths for the target ensemble. The velocity displayed is the magnitude of the mean velocity of the measured part of the velocity profile for the target ensemble. No accounting for the unmeasured part of the velocity profile is included. If GPS data are available in the ADCP files, the longitude and latitude in degrees, minutes, and decimal minutes are displayed for each target sample-location. These data may be used with navigation software and devices to assist in navigating to and holding the boat on the desired locations. In addition, there is an option (Figure 1) to create a file compatible with Delorme TopoQuad software. The file is named "tqlatlon.txt" and contains the information to plot a yellow dot for each sampling location in the TopoQuad display.

Limitations

• Only moving-boat measurements are supported. Mid-section type measurements made with ADCPs are not supported.
• The mean velocity is based only on a single ensemble and does not consider the unmeasured top and bottom parts of the profile.

How to Download the Software

The latest version of EDI can be downloaded by clicking on the version number in the table above. In order to provide support for extrap and to provide an efficient means to communicate with users and allow users an efficient and organized means of providing suggestions and comments, you are encouraged to register for the Hydroacoustic Forum. In the forum you will find an "EDI" board under Hydroacoustics Software. Open the EDI board and click "Notify" to automatically receive emails on any bug fixes or issues identified with extrap. This is the only way of being automatically notified if there has been an identified problem or if a new version has been released.

Installation Instructions

1. Install the appropriate Matlab Component Runtime lobarly, if necessary. For instructions on how to determine if you have the needed library and/or to install the library see Matlab Component Runtime Library Download and Installation
2. Download the EDI executable from above.
3. Select a directory and store the EDI_3_30*.exe file. This file can be in any directory where the user has read/write permission.
4. Run the program by double-clicking on EDI_3_30*.exe in Windows Explorer or My Computer. You may wish to create a shortcut to EDI_3_30*.exe in a convenient location in the Start Menu or on the Desktop.

Operational Instructions

NOTE: If the cross section was from left to right, distances are from the left bank but if the cross section was from right to left, distances are from the right bank.

1. Use the appropriate manufacturer's Software to identify and select a transect collected with an ADCP and process the transect to a TRDI compatible Classic ASCII output file or a SonTek/YSI RiverSurveyor Live Matlab output file.
2. If you created a shortcut to EDI_3_30*.exe during the installation, you can run the program using the shortcut. Otherwise you can run the program by double-clicking on EDI.exe in Windows Explorer or My Computer. Note: It may take more time than expected for the EDI GUI to appear, particularly the first time it is run. Please be patient.
3. Click on "Open File" and navigate and open the desired *t.000 or *ASC.txt or *.mat file depending on the type of ADCP and software used.
4. A message at the bottom of the table will notify you that file is being read. After the file has finished loading, the name of the file will appear below the EDI table. Reading the file can be a slow process, be patient.
5. If you collected GPS data along with the ADCP data and you use DeLorme TopoQuads to assist in navigating to the sample locations, clicking the Create TopoQuads check box will create a TopoQuad compatible file that when loaded into TopoQuads will mark each computed sample location. You will be prompted to name this file after you click on Compute Stations. The file will be located in the same directory as the input file you processed.
6. The standard set of discharge percentages are available by default but they can be edited and changed by the user.
7. Enter the appropriate Zero Distance Offset. If the distance reference is from the edge of water then the Zero Distance Offset is set to zero. However, if referencing from a target on the bank then the distance from the target to edge of water should be entered.
8. Confirm the default settings or modify the five discharge percentages and then click "Compute Stations". The table will populate the with the appropriate data.
9. The discharge percentage settings can be changed and the stations can be recomputed without having to reload the file.

References

Edward, T.K. and Glysson, G.D., 1999, Field methods for measurement of fluvial sediment, U.S. Geological Survey Techniques of Water-Resources Investigations, Book 3, Chapter C2, 89 p., https://doi.org/10.3133/twri03C2

Hubbell, D.W., and others, 1956, Progress report no. 1, Investigations of some sedimentation characteristics of a sand-bed stream: U.S. Geological Survey Open-File Report, 78 p., https://doi.org/10.3133/70038838

Any use of trade, product, or firm names is for descriptive purposes only and does not imply endorsement by the U.S. Government.