Skip to main content
U.S. flag

An official website of the United States government

The Surrogate Analysis and Index Developer (SAID) Tool

October 30, 2018

Overview

Media
Sediment acoustics composite screens

The Surrogate Analysis and Index Developer (SAID) tool is a stand-alone tool to assist in the creation of ordinary least squares (OLS) regression models by providing visual and quantitative diagnostics to the user. The tool also processes acoustic parameters to be used as predictor variables using a constant spatial suspended sediment concentration method. The method utilizes acoustic backscatter data from fixed-mount acoustic Doppler velocity meters (ADVM).

Within the program, you can:

  • Match observations from multiple time series datasets
  • Create linear regression models
  • Compute ADVM backscatter parameters
  • View backscatter profiles
  • View linear model diagnostic statistics and plots
  • Export model information
  • Generate a predicted time series
     

Features

Match observations from multiple time series data sets

  • Similar method to a left join database operation
  • Matching is done between observations that are closest in time
  • Adjustable maximum allowable time difference between matching observations

Create linear regression models

  • Ordinary least squares regression models
  • Quickly change the variables used in the regression
  • No limit on the number of variables used in the linear model
  • No restrictions to which variables must be used
  • Ability to exclude observations used in the model

Compute ADVM backscatter parameters

  • Modify ADVM configuration parameters
  • Adjust backscatter values and cell range used in the computation
  • Near field correction

View backscatter profiles

  • Plots of measured, water corrected, and sediment corrected backscatter against distance along acoustic beam axis.
  • Simultaneously view multiple observations

View linear model diagnostic statistics and plots

  • Diagnostic statistics
    • Standard linear regression diagnostic statistics
    • Probability plot correlation coefficient
    • Non-parametric smearing bias correction factor
  • Plots
    • SLR scatter plots in transformed and linear space
    • Partial residual plots for MLR
    • Model residual
      • Raw vs. fitted
      • Probability
      • Standardized serial correlation

Export model information

  • Save model information as a MATLAB MAT-file
  • Write model information as a .csv file

Generate a predicted time series

 

Known Issues

IssueStatusCauses and solutions
Error on loading data files with trailing tabsSAID v 1.1 is unable to load data from tab delimited text files with trailing tabs.One cause of the error may be that the entire final column is blank. If the trailing tabs from each line are removed, the program will be able to load data from the file. Another cause may be a blank observation in the final column of the file. Putting a variable that contains an entry for each observation (for instance, a date or time variable) will remedy the issue.

 

Downloads

The first two files below are options to install SAID and, if necessary, the required MATLAB Compiler Runtime (MCR) library. The current version of SAID requires 32-bit MCR version R2014a. The other download options include the SAID manual and example data, plus a couple additional utilities.

SAID 1.1 installer, MCR full installer (522 MB) - The MCR is packaged within this installer. Use this installer if you plan on installing without internet connectivity, as the web installer will not run without a connection. It is also recommended to download this file if you don't have the appropriate MCR installed.

SAID 1.1 installer, MCR web installer (2.4 MB) - If the necessary MCR is not already installed, this installer will download and install it. Use this installer if you already have the appropriate MCR version installed. This installer requires internet connectivity to run.

SAID 1.1 Release Notes - See what is updated in the latest version.

SAID manual - Download the SAID manual from the USGS Publications Warehouse.

SAID Example Data (2.0 MB) - Example data that can be used in SAID. Also, included in the Spoon River data directory is a tutorial on using the example data.

ARGcat and Readme (411 KB) - ARGCat, the Argonaut dataset concatenator program, combines several Argonaut datasets read from ViewArgonaut exported ASCII files and exports them as a single SAID readable text file. The SAID program can also combine several Argonaut datasets.

 

Documentation

Surrogate Analysis and Index Developer (SAID) Tool

Acoustic Index Methods for Computing SSC

Estimating Suspended Sediment in Rivers Using Acoustic Doppler Meters Fact Sheet

 

Bug Reports or Suggestions

If you're experiencing a problem with SAID, submit the following information and possibly a graphical representation of the bug.

Please include the following information in an email and send it to the Sediment Acoustics Leadership Team gs-w_salt@usgs.gov.

  1. Contact Information: Name, Phone Number, and E-mail Address
  2. What version of the software are you using?
  3. What operating system are you using?
  4. An explanation of the problem (e.g., "Input data not being read correctly")
  5. If the problem is reproducible, please list the steps required to re-create the problem (e.g., "1. Load Dataset. 2. Insert some text ...)
  6. If the problem is not reproducible (only happened once, or occasionally for no apparent reason) please describe the circumstances in which it occurred and the symptoms observed (Note: it is much harder to fix non-reproducible bugs)
  7. If the problem causes any error messages to appear, please write down the exact text displayed
  8. If you have a SAID dataset that demonstrates the problem, the "Save" option is under the "File" menu on the main SAID window and include this in your email. 

If you want to make a suggestion you can send email to the addresses listed above.

 

Suggested Citation

Domanski, M.M., Straub, T.D., and Landers, M.N., 2015, Surrogate Analysis and Index Developer (SAID) tool (version 1.0, September 2015): U.S. Geological Survey Open-File Report 2015–1177, 38 p., https://doi.org/10.3133/ofr20151177.

 

Disclaimer

The MATLAB Compiler Runtime library required for SAID 1.1 contains an unmaintained, end-of-life copy of log4j version 1.x. MathWorks has stated that they are not aware of exploitable vulnerabilities associated with the inclusion of log4j.  
                
We are in the process of developing a Python version of SAID. The Python version will remove the MATLAB dependency. 

 

Collaborators

Publication Year 2018
Title The Surrogate Analysis and Index Developer (SAID) Tool
Product Type Software Release
Record Source USGS Asset Identifier Service (AIS)
Was this page helpful?