Skip to main content
U.S. flag

An official website of the United States government

QRev 4

June 23, 2020
View Software Release

NOTE:  This version, QRev 4, has superceded QRev 3.43 and earlier. Older versions remain available here.
With the release of QRev 4, development of QRev 3 in the MATLAB environment has stopped at the current version 3.43. It is anticipated that all support for version 3.43 will cease on September 30, 2020. Currently, streamflow measurements can be processed using either QRev 4 or 3.43 but users are encouraged to transition to QRev 4 as soon as is convenient. During this transition period, it is suggested that both QRev 4 and 3.43 are available on field computers. If errors are encountered with QRev 4, version 3.43 can be used to complete field processing. Please submit any files that result in processing errors to tknight@usgs.gov.

 

Description

Media
Screenshot of QRev
Sources/Usage: Public Domain. View Media Details

QRev 4 is a major enhancement of the original QRev developed in MATLAB. QRev computes the discharge from a moving-boat ADCP measurement using data collected with any of the Teledyne RD Instrument (TRDI) or SonTek bottom tracking ADCPs. QRev improves the consistency and efficiency of processing streamflow measurements by providing:

  • Automated data quality checks with feedback to the user
  • Automated data filtering
  • Automated application of extrap, LC, and SMBA algorithms
  • Consistent processing algorithms independent of the ADCP used to collect the data
  • Improved handing of invalid data
  • An estimated uncertainty to help guide the user in rating the measurement

IMPORTANT NOTES ON DISCHARGE COMPUTATION:

  • Default QRev settings may result in discharge computations different from WinRiverII and RiverSurveyor Live. Potential differences in discharge are due to QRev data filters, interpolation algorithms, and computations that may differ from manufacturer software.
  • Discharges computed in QRev 4 and 3.43 may exhibit some differences in computed discharge, with identical processing settings. Changes in final values are due to a combination of improvements to filters, improvements to interpolation methods, and differences found in Python and MATLAB processing methods. Please see Important Changes for details.

Office of Surface Water Technical Memorandum 2016.03 recommends and authorizes the use of QRev for processing discharge measurements made with an ADCP from a moving-boat.

Office of Surface Water Technical Memorandum 2017.02 mandates the use of QRev for processing moving-boat streamflow measurements mad with acoustic Doppler Current profilers that are stored in the National Water Information System.

QRev can be used on desktops, laptops, and tablets running 64-bit versions of the Windows operating system. QRev should be used in the field to process measurement immediately after data collection and in the office to review measurements. The graphical user interface for QRev was designed to work on tablets, so most controls are buttons, radio buttons, and check boxes that can be easily operated by tapping on the screen. QRev is written in Python and packaged using PyInstaller. Unlike the MATLAB version, there is no need for installing any additional libraries.

 

Downloads

 

Version History 

Versions prior to 4.41.1 have a security vulnerability related to sqlite3.dll. Version 4.41.1 resolves the vulnerability.

VersionRelease DateStatusChanges and Known Issues
4.41.3February 2025Recommended

Added:

  • N/A

Changed:

  • Modified formatting of empty values in the exported XML file from nan to NaN to prevent SVMAQ failing to load XML files.

Fixed:

  • Fixed launching of Google Earth on systems that previously could not find the generated KML file.
4.41.2December 2025Allowed

Added:

  • N/A

Changed:

  • Changed backend current_tab attribute to use tab names not the tab text in order to support language translations on the front end.

Fixed:

  • Fixed crash when opening toggling the MAP tab.
  • Fixed crash loading some TRDI ADCP data due to Compass QA and backend
    time zones.
  • Fixed crash viewing edges on contour plots due to mixed length arrays.
  • Fixed tab text not updating when language changed in settings.
4.41.1December 2025Allowed

Added:

  • Added partial French translation option.

Changed:

  • Upgraded Python to version 3.13 and impacted dependencies.
  • Refactored MAP's use of scikitlearn to use Scipy to avoid Python conflicts.

Fixed:

  • Fixed crash if RSQ GPSRecords exceed 20.
  • Fixed code in messages tab preventing tooltips from working.
  • Implemented utf-8 encoding for SonTek json and most ASCII files.
  • Fixed bug associated with blanking distance when creating xml file.
  • Modified heading time series graph so right ticks don't show of left axis.
  • Fixed English units conversion on contour csv output in MAP.
  • Fixed bug in edge contour plot if there were 0 edge ensembles.
  • Fixed reading of RSQ edge samples when auto edge not used.
  • Fixed time zone bug when comparing timing of compass calibration to measurement start.
  • Fixed bug when changing plotted transect in Compass/P/R table.
  • Fixed Area Projection setting in Options dialog not being saved.
  • Fixed crash when running on a system where QRev has never created a
    sticky settings file.
     
4.40.2August 2025Allowed

Added:

  • N/A

Changed:

  • Upgraded python to version 3.11 and impacted dependencies.
  • Changed packaging structure to one directory to speed up load time.
  • Changed docs folder name to qrev_docs and converted to python package.
  • Added "complete_setup" class to be run so QRev can be installed
    programmatically.

Fixed:

  • Fixed crash when loading QRev files with a single transect.
  • Fix duplication of axis labels on Discharge Time Series plot after
    loading additional measurement files without closing the UI.
  • Fixed sticky setting crash due to "date_format" call for PDFSummary.
4.40.0June 2025Allowed

Added:

  • Added Alpha and Phi computations to backend.
  • Added tab (currently hidden) for Alpha and Phi computations.
  • Added additional MAP CSV export options and updated UI to show additional buttons to trigger exports.
  • Added phase 1 language translation files.

Changed:

  • Optimized some of the MAP computations to increase processing speeds.

Fixed:

  • Fixed crash due GPS data containing Lat/Longs outside valid range.
  • Fixed MAP contour plot crash.
  • Fixed erroneous MAP contour plots.
  • Fixed crash caused by new time zone feature.
  • Fixed UTC offset crashes.
  • Fixed ADCP Frequency for M9s in PDF export to show Multi instead of 3000.

Merges in QRevInt since last version: 

  • Fixed bug identifying invalid edge ensembles
  • Add processing of vertical velocity
  • Fixed reporting of end time in pdf file
  • Fixed crash when using automatic scaling from Set Axis Limits context menu
  • Fixed bug in SNR filter for non-SonTek data
  • Fixed graphing of data with unspecified ping type
  • Fixed bug not reading SNR range for QRev.mat files
  • Fixed issues with side lobe cutoff data in QRev.mat files
  • Fixed bug computing 3-beam solutions for SNR filtered SonTek data
  • Modified some legend names and colors for ping types
  • Fixed issue with SNR filter when 3-beam computations for SNR are used
  • Fixed bug in bottom track velocity guidance
  • Fixed bug display extrapolation on Main tab when velocity is selected
  • Added support for rsqmb data files without the need to export to Matlab
  • Ping type for rsqmb data files read from files rather than empirically determined for some Matlab files
  • Sidelobe cutoff for rsqmb data computed using data not available in Matlab output
  • Added correct hpr matrix for Sontek ADCPs
  • Added code to identify and filter 3-beam solutions in SonTek Matlab files
  • Fixed error velocity scaling for bottom track for SonTek Matlab files
  • The number of ensembles in an edge is changed by clicking the Left or Right # Ens. column rather than the # Valid column
  • Changed "Max MovBed" to "Avg MovBed" in pdf summary report.
4.38May 2024Allowed

Added:

  • EDI PDF Export.
  • Added Ctrl+M shortcut to maximize Select Transect dialog.
  • Added Wetted perimeter and hydraulic radius computations.

Changed:

  • Package structure updated to better fit use by other applications.
  • Increased default size of Select Transects dialog.

Fixed:

  • Corrected end time in PDF Summary.
  • Fixed change in discharge when opening a saved QRev .mat and reprocessing due to missing SNR range.
  • Display of edge units in exported PDF now honor unit system setting.
  • Added rounding to the magnetic variation in the PDF summary.
4.37February 2024Allowed

Added:

  • MAP: Added radio buttons to plot SNR/RSSI and Number of transects used.

Changed:

  • Now using QRev interpolated data for MAP computation.
  • Moved MAP datatype combobox plot options for contour plots to radio buttons to follow look and workflow of other tabs.

Fixed:

  • Crash when opening a measurement with a single transect.
  • Duplicating signals as new measurements files are loaded without closing UI.
  • Crash when click the Moving Bed Tab when there is no valid bottom track data in a test.
  • Crash when clicking the edge tab when there is no valid bottom track data for an edge.
  • Auto application of Moving Bed corrections when a moving bed is detected.
  • Updating of MAP plot and table when MAP not able to run, ie no data to display.
  • UI crash when MAP crashes due to no data to process.
4.36December 2023Allowed
  • Fix crash resulting from SonTek data with good GGA but no VTG data.
  • Fixed crash when using Nortek Sig500 ADCP.
  • Fix unit conversion on X-axis of BT Other plot with English is selected.
  • Added ability to save figures in several common graphic formats
  • Modified discharge time series graph to show selected transect, cumulative mean discharge, and +/- 5% band on cumulative mean discharge.
  • Added Multitransect Averaged Profile (MAP) tab and connected to backend code.
  • Added PDF Summary Report.
  • Added option to import additional compass calibrations and moving bed tests.
  • Converted documentation from external pdfs to built-in html.
4.34January 2023Allowed
  • Fixed RS5 frequency display.
  • Fixed reading of SonTek files with long directories.
  • Fix MB correction application.
  • Fix crash resulting from very slow boat movement due to repeated shiptrack coordinates.
4.33November 2022Allowed
  • Fixed auto application of MBT correction when no bed is detected.
  • Fix crash resulting from RS5 .mat files containing ping types labeled as 'Other' or '1'
  • For a complete list of changes and bug fixes click here.
4.32August 2022Allowed
  • Added reading of BT ping types for RS5 data.
  • Added use of ping type when computing auto thresholds for bottom track data.
  • Fixed crash associated with corrupt sticky settings file.
  • For a complete list of changes and bug fixes click here.
4.31June 2022Allowed
  • Fixed display issue of data plotted in error and vertical velocity time series plots when English units are used.
  • For a complete list of changes and bug fixes click here.
4.30June 2022Allowed
  • Fix crash when changing WT plot options on file loaded from RS5 Qrev matfile.
  • Fix crash when plotting shiptrack on MvBedTst tab when viewing some older Qrev files.
  • Added config file.
  • Modified XML output. The Uncertainty node now contains only the total uncertainty and the model used. Separate nodes are provided for QRev_UA and Oursin details.
  • Fixed bug in GPS tab when all transects do not have GPS data.
  • Fixed bug for SonTek ADCPs showing no in the xml file CompassCalibrationResult when there is a calibration.
  • For a complete list of changes and bug fixes click here.
4.29December 2021Allowed
  • Fixed crash when loading some TRDI mmt files.
  • For a complete list of changes and bug fixes click here.
4.28December 2021Allowed
  • Fixed crash when using zoom or pan.
  • Fixed crash when opening an older QRev.mat file for a Sontek M9 that had some of the Loop test data marked as edge data.
  • Fixed crash when changing thresholds on older QRev.mat file where bad MBT data was present.
  • Fixed crash when saving caused by bad GPS data.
  • For a complete list of changes and bug fixes click here.
4.27November 2021Allowed
  • Changed composite depths to interpolate for invalid depths using the composite data rather than the primary reference.
  • WT error and vertical velocity filters are now applied based on ping type for all new processing of data. Loading older QRev files without reprocessing will display previous results.
  • BT error and vertical velocity filters are now applied based on bottom track ping frequency for all new processing of data. Loading older QRev files without reprocessing will display previous results.
  • Added points to plots in Depth tab.
  • Added advanced graph tab.
  • Added option to export mean cross-section bathymetry within the XML.
  • For a complete list of changes and bug fixes click here.
4.265/21/2021Recommended
  • Fixed bug in EDI associated with GPS data.
  • Fixed bug in applying weighted medians when switching from automatic to manual data type
  • Modified extrap subsection so that subsectioning always works from left to right
  • Fixed crash associated with Windows OS versions newer than 1909.
  • Fix time formatting on Discharge TS plot so times do not overlap.
  • Fix bug with loading data collected with a PDA and streampro.
  • Fix crash resulting from NaN values in BT data for GPS class.
  • Fix crash resulting from loading old QRev files missing setting dict in mat file.
  • Fix crash resulting from missing elements from sticky settings.
  • For a complete list of changes and bug fixes click here.
4.2311/23/2020Allowed
  • New TRDI raw data reader that is 3+ times faster
  • Fixed issue with depth reference drop down menu when depth sounder data were collected
  • Fixed issue so that GPS references that aren't available cannot be selected
  • Fixed several issues with new GPS-BT tab and GPS usage for moving-bed test
  • Fixed bugs in heading interpolation
  • Fixed bug reading *_QRev.mat having only 1 transect
  • Fixed bug when loading measurement with no transects selected
  • Fixed issue that could occur when processing moving-bed tests loaded from *_QRev.mat
  • For a complete list of changes and bug fixes click here.
4.2110/16/2020Allowed
  • Added code to identify and notify of user changes to original values
  • Added ability to use GPS as a reference for moving-bed tests
  • Added automatic checking of GPS lag
  • Added GPS - BT comparison tab to GPS Tab
  • Added support for user edge discharge for WinRiver II 2.22
  • Fixed issue with applying the correct moving-bed test when multiple tests are available
  • Modified code to use 1st checked transect rather than 1st transect for general settings
  • Fixed issue with selecting transects in EDI if some transects were not checked
  • Fixed issue in EDI if no GPS data are available
  • For a complete list of changes and bug fixes click here.
4.166/22/2020Allowed
  • Fixed issues saving data
  • Fixed several issues related to GPS
  • Fixed several issues related to edges tab
  • Improved use of up/down arrow keys to change transects
  • Fixed other issues with user interface
  • Fixed issues with interaction with RIVRS
  • No changes to computational code
  • For a complete list of changes and bug fixes click here.
4.156/3/2020Allowed
  • Fixed issue with shiptrack when all GPS data are invalid
  • Fixed issue applying stationary moving-bed correction
4.146/2/2020Allowed
  • Fixed issue when measurement contained transects with and without GPS data
  • Fixed issue when stationary test was present the loop test would not be applied even though selected to use
4.135/20/2020Allowed
  • Initial release of Python version
  • For a complete list of changes and bug fixes click here.

 

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.

 

Installation Instructions

  1. Download the latest version of QRev.
  2. Select or create a folder for QRev and unzip the file into that folder.
  3. Run the program by double-clicking on QRev_*.exe in Windows Explorer or My Computer. You may wish to create a shortcut in a convenient location in the Start Menu or on the Desktop.

 

Updates and Bugs

In order to provide support for QRev 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 Hydroacoustics Forum. In the forum you will find a "QRev" board under Hydroacoustics Moving-Boat Deployments. Open the QRev board and click "Notify" to automatically receive emails on any bug fixes or issues identified with QRev. This is the only way of being automatically notified if there has been an identified problem or if a new version has been released. You are also encouraged to report any problems you encounter with QRev and attach the associated files so that any identified problem can be resolved. To access the Hydroacoustics Forums, you must be a registered user of the forums.

Although the Hydroacoustics Forum is the preferred means of communication, you can also email the Hydroacoustics work group (HaWG) at GS-W HaWG All@usgs.gov with questions and bugs.

 

Integration with SVMAQ and AQ

The results of data processed with QRev can be efficiently loaded into AQ through the use of SVMAQ. Saving a processed measurement in QRev automatically creates an XML file (*_QRev.xml). This xml file can be loaded into SVMAQ. After completing the site visit information in SVMAQ, the saved SVMAQ file can be loaded into AQ using the normal procedures.

 

Recommended Workflow

QRev is intended to be used for both field processing and office review. Thus, QRev should be installed on both field and office computers. The recommended workflow is:

  1. Collect data using the manufacturer's software (WinRiver II or RiverSurveyor Live)
  2. Immediately after data collection process the data with QRev. MATLAB output files for RiverSurveyor Live data are required.
  3. Investigate all messages and warnings provided by QRev and make any necessary changes.
  4. Use the comments feature in QRev to explain or justify warnings and changes made.
  5. If necessary, use WinRiver II or RiverSurveyor Live to review data that are not reviewable in QRev.
  6. Finalize the processing and save the QRev files. Using the default date and time in the filenames by QRev: 1) provides unique file names, 2) helps track changes to processing settings, 3) identifies the most recently processed data, and 4) helps prevents accidental overwritting of previously processed data.
  7. Import the QRev XML file into SVMAQ.
  8. Backup all files to separate media from your field computer.
  9. Follow office policy for storage and uploading of data into AQ.

NOTE: The *_QRev.mat file contains all the original data and final processing settings. The *_QRev.mat file is independent of the original manufacturer files. Thus data processed with QRev should only be reviewed by loading the *_QRev.mat file. WinRiver II and RiverSurveyor Live files should be considered the original field data and not used for review or reprocessing of data previously processed in QRev. In the rare situation where a display of data in WinRiver II or RiverSurveyor Live is not available in QRev, WinRiver II or RiverSurveyor Live could be used to review that portion of the data.

 

Viewing QRev Summary without SVMAQ

Saving a processed measurement in QRev automatically creates an XML file (*_QRev.xml). A user friendly summary of the data in the xml file can be achieved using an XSLT style sheet. An example style sheet is available and can be downloaded and modified to meet the user's specific needs. For USGS users this example QRev stylesheet is automatically available when using the Field Sheet Viewer to view a QRev xml file.

Citation Information

Publication Year 2020
Title QRev 4
Product Type Software Release
Record Source USGS Asset Identifier Service (AIS)
Was this page helpful?