Untitled Document

AreaComp


Description

AreaComp is a graphical user interface used to analyze ADCP data and compute a relationship between channel area and stage for an ADCP measurement. The stage area relationship (stage area rating) can be used in the computation of discharge using index-velocity methods.

AreaComp3 is a python application for development and validation of stage-area ratings. AreaComp3 supports stage-area validation that is required by OSW Technical Memorandum 2015.05 and USGS Techniques and Methods report 3-A23 by adding the functionality to compare the bathymetry and stage-area ratings of multiple cross-section surveys. The application has the following new features:

  • Updated user interface.
  • Improved ability to stitch together multiple sub-survey files.
  • Added ability to import cross-section surveys from SVMAQ XML files.
  • Added Functionality to compare multiple Stage-Area ratings and bathymetry surveys.
*With the release of AreaComp3, development and support for AreaComp2 will be ended.

AreaComp2 is version of AreaComp that is written in Matlab and provides support for output from WinRiver II and RiverSurveyor Live, in addition to comma separated value files.. AreaComp2 can also read existing AreaComp 1.3 files. Users can export processed data into comma-separated value files. Users can save and open AreaComp2 files.

A draft user's guide for AreaComp2  is available here: User's Guide

Compatibility: AreaComp3 saves processed data in MATLAB format files. Files saved in AreaComp2 can be opened and reprocessed in AreaComp3. Files saved in AreaComp3 cannot be opened in AreaComp2.


Versions

USGS Software Users Rights Notice

Version
Status
Changes and Known Issues
AreaComp3
1.3.4
Recommended - Added option to flip the start edge of sub surveys.
- Fix reading of ASCII files where start edge was not determined correctly.
- Added start edge meta-data to .mat output for sub-surveys.
- Added warning when start edge meta-data is not present in the file.
AreaComp3
1.3.3
Allowed - Fixed crash when loading AC3 mat file missing the stage value for the channel characteristics.
- Fixed display issues for systems with default resolution of 150%.
AreaComp3
1.3.2
Allowed - Update XYZ CSV projections.
AreaComp3
1.3.1
Allowed> - Added ability to select and delete multiple points from station table.
- Add screening for erroneous data in sub survey data.
- Fix improper loading of AreaComp3 files containing ADCP data that was saved, opened, saved, then opened again. This action caused the depth, x, and y values to be labeled incorrectly.
- Fix ability to change plotted ADCP Track data.
- Added computation of conveyance.
- Added Channel Characteristic ratings.
- Added ability to delete sub surveys.
- Updated plot controls to preserve zoom settings when toggling bathymetry checkboxes and adding/removing sub-survey points via the station stage table.
AreaComp3
1.2.1
Allowed - Fixed UI crash when units changed before loading data.
- Added auto determination of units for RDI ASCII files.
- Added auto determination of headers and XZ vs XYZ in CSV files.
AreaComp3
1.2.0
Allowed - Added units recognition and ability to change units.
- Fixed negative values in Channel Characteristics.
- Added transect import from QRev
AreaComp3
1.1.0
Allowed -Upgraded the python from 3.6 to 3.8.
-Added a Tab for computing Channel Characteristics and adding sub sections. (Wetted Perimeter, Width, Hydraulic Radius).
-Added PDF reports for Summary, Channel Characteristics, and Cross section comparisons.
-Add option to import CSV files with XYZ data.
-Added warnings when imported files if duplicate stations are present.
-Added cell shading for cells in the station stage table when stations are duplicated.
-Added Area Look up table on Cross-Section Comparison tab.
AreaComp3
1.0.1
Allowed -Added screening of bad depth data from TRDI ASCII files.
-Added option to choose "Rating" survey for comparison data.
-Fixes crash when opening a AC3 file containing an SVMAQ sub-surveys
-Fixes crash when clearing data when validation surveys are present.
-Fixed crash caused by loading csv files created in excel where data was formatted as text.
AreaComp3
1.0.0
Testing - Initial Python Release
-Updated user interface.
-Improved ability to stitch together multiple sub-survey files.
-Added ability to import cross-section surveys from SVMAQ XML files.
-Added Functionality to compare multiple Stage-Area ratings and bathymetry surveys.
AreaComp2
1.07_32
1.07_64
Allowed - Requires Matlab Runtime Libraries Version 9.0, either 32-bit version or 64-bit version depending on which version of AreaComp you download.
- Minor bug fixes.
- Compiled with Matlab 2015b.
AreaComp2
1.06
Allowed - Requires Matlab Runtime Libraries Version 7.17, 32-bit version (even on 64-bit operating systems)
-
Operational bug fixes.
AreaComp2

1.04

Allowed
- Requires Matlab Runtime Libraries Version 7.17, 32-bit version (even on 64-bit operating systems)
- Written in Matlab
- New user interface.
- Support for RiverSurveyor Live
- Compiled with Matlab 2012a and requires Matlab Compiler Runtime 7.17
AreaComp 1
1.13
Allowed
- Previous version.

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.


How to Download the Software

The latest version of AreaComp can be downloaded by clicking on the version number in the table above.


Installation Instructions for AreaComp3

  1. AreaComp3 will be automatically distributed through WFAST to registered computers on April 9. Internal USGS users with computers not registered in WFAST can download the software from the AreaComp3 repository at the link in the table above.
  2. To access the repository, users will need to sign in with the USGS login option.
  3. No installation is required to use the software.
  4. To run the application, extract the contents from the downloaded .zip file into a folder of the user's choice.
  5. The .zip file includes a user guide that contains detailed instructions on AreaComp3's features and an executable to run the application.

Installation Instructions for AreaComp2

  1. Install the appropriate Matlab Component Runtime libary, if necessary. For instuctions 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 AreaComp2 executable from above.
  3. Select a directory and store the AreaComp2_1_04.exe file.
  4. Run the program by double-clicking on AreaComp2_1_04.exe in Windows Explorer or My Computer. You may wish to create a shortcut to AreaComp2_1_04.exe in a convenient location in the Start Menu or on the Desktop.