SWToolbox Software Information

Release Date:

Overview and Help

The primary functions of SWToolbox are conduct a n-day frequency analysis (most commonly used for computation of 7Q10) and to computer biologically-based design flows.  Flow duration curves can also be computed. The software is designed to facilitate easy import of USGS NWIS streamflow data as well as user-defined text files.

SWToolbox is built on the EPA BASINS system. The SW Toolbox Documentation found under the Help menu provides information on the functionality of the software. Most of the information on use of the software is general and applies to all applications built on the BASINS platform.

SWToolbox 1.0.4 Known Bugs and Suggested Work-Arounds:

  • For records with zero flow values: The necessary Conditional Probability Adjustment is not being applied during frequency analysis (e.g., 7Q10) for records in the “design flow”  and "DFLOW" (legacy) routines. The frequency statistics are among the options under the non-biologically-based flow metrics.  
    Work around: use only the "NDay, trend, and frequency" tab in the "USGS Integrated Design Flow" Tool for computing hydrologically  based flows. This option also has additional analytical tools to better assess the data and results.  Note that DFLOW is legacy code and should be used only for comparison to previous results.
  • "Custom” date selection: In "Select dates" tab in the "USGS Integrated Design Flow" Tool, "Custom" dates are not being applied to “Frequency grid” button calculations. It will use the entire period of record instead. Custom dates are applied with the “Frequency report” button.  Work around: use the "Subset, Split, or Filter Selected Data" for when selecting data for analysis for specific dates. To confirm, click on "File -> Export results" from Frequency grid output to see details of analysis, including period of record used.

Download Software

The latest software release, USGS-SW-Toolbox1.0.4, resolves issues with downloading data into SWToolbox and contains the correct version number and build date. It is available for download in the link below. 

The installation file below will install the software on Windows machines. Note that R, both 32- and 64-bit, must be installed on a user's system in order to access some functionality under the "Integrated Design Flow" workflow. SWToolbox 1.0.4 is not currently compatible with R versions 3.6.0 or higher.

Software and Manual Release

The user manual describes the functionality of the software and walks the user through an example session. It is available for viewing and download through the USGS publications warehouse:

https://doi.org/10.3133/tm4A11

The installation file below will install the software on Windows machines. Note that R must be installed on a user's system in order to access some functionality under the "Integrated Design Flow" workflow. The integration with R has been seamless on Windows 7 and 8 computers, but we have encountered problems with Windows 10 that we are still trying to resolve.

 

Updates and Feedback

We are always looking for feedback on the SWToolbox software. If you encounter any problems, please let us know by sending an email to SWToolboxTesting@usgs.gov.