US Army Corps of Engineers
Hydrologic Engineering Center

Skip Navigation LinksHome > software > hec-dssvue > plugins

An HEC-DSSVue plug-in is a set of Java software that is compiled and put into a Java ".jar" file. By simply placing this file into the HEC-DSSVue\Plugins directory, it is automatically loaded and accessible from the HEC-DSSVue program. The purpose of a plug-in is similar to the jython scripting capability that is available in HEC-DSSVue. However, since plug-ins are written in the Java language, which is used by HEC-DSSVue, there are extended capabilities and controls available. The plug-in code can access the HEC-DSSVue API (Application Program Interface) directly. Typical uses for plug-ins are complex mathematical operations, specialized formatting of data for entry into another application (such as a program that uses a "card format"), and retrieval of data from a web site.

How to Install HEC-DSSVue Plug-ins:
  1. Unzip the contents of the downloaded plug-in (e.g. into the Plugins directory. By default the Plugins directory is located at:
    • 32-Bit version of Windows XP, Vista, or 7: C:\Program Files\HEC\HEC-DSSVue\Plugins
    • 64-Bit version of Windows XP, Vista, or 7: C:\Program Files (x86)\HEC\HEC-DSSVue\Plugins

  2. Next time you start HEC-DSSVue, the plug-in will be automatically loaded.

  3. In HEC-DSSVue Version 2.0 or later, plug-in access has been move to menus (e.g., for USGS, go to Data Entry -> Import -> USGS)
Plug-Ins Catalog

Below is a list of plug-ins included with HEC-DSSVue 2.0.1.

As updates to plug-ins are released, they will be bolded below.

  • SnoTel Data Retrieval

      Download - SnoTel 2.0 (March 2014)

      Changes in Version 2.0:

      Major overhaul to work with NRCS new website and SnoTel ReportGenerator.

  • USGS Data Retrieval [Documentation]
    • Retrieve and import time-series data from the USGS NWIS database.
    • Download - USGS 5.3 (August 2016)

      Changes in Version 5.3:

      The plug-in was modified to handle a format change made to NWIS on 09 August 2016.
      The NWIS format change involved moving from "Data Descriptors" to "Time-Series Identifiers"

  • RiverGages 
    • Retrieve data from the web site
    • Download - RiverGages (November 2013)

      Changed URL to updated RiverGages web site.

  • NCDC  
    • Import data in a NCDC format
    • Download - NCDC 3.0 (April 2013) - Beta

      Changes In Version 3.0:
           Added methods to import new ".csv" format produced by NCDC. The methods will only work on
           a .csv formatted file, not the .txt or other formats available (old formats are still supported.)
           As this was a substantial update and the plug-in is in a beta state, please double check the
           imported data and report any errors to HEC (along with the file that had the error).

  • Charts
    • Displays data in pie charts

  • Excel
    • Import time series data from Microsoft Excel into HEC-DSS

  • WaterML
    • Import data from the Water Markup Language (.xml) format

    • Retrieve data from the North Carolina CRONOS database

  • NCDWR Duration Hydrograph
    • An alternative duration hydrograph analysis from the North Carolina DWR

  • CDEC
    • Retrieve data from the California Data Exchange Center