TSTool / Release Notes / Version 14

• Known Limitations
• Changes in Version 14.1.0
• Changes in Version 14.0.6
• Changes in Version 14.0.5
• Changes in Version 14.0.4
• Changes in Version 14.0.3
• Changes in Version 14.0.2
• Changes in Version 14.0.1
• Changes in Version 14.0.0
• Release notes for all versions

---

Known Limitations

• [14.0.0+] Features that were previously available for reading and writing HEC-DSS files are disabled. Additional resources are needed to update the software to use 64-bit libraries for HEC-DSS.

Changes in Version 14.1.0

Enhancement release to format table as Markdown and improve file handling.

• [14.1.0] Add the SetTableColumnProperties command to set table column properties, used when formatting output.
• [14.1.0] Add the WriteTableToMarkdown command to write a table to a Markdown format file.
• [14.1.0] Update the AppendFile command:
  • The output file can be the same as an input file (input file will be overwritten).
  • Input files can now be specified as a comma-separated-value list of filenames or patterns.
  • Filename pattern handling has been enhanced.
  • The AppendText parameter has been added to append text to a file.
  • Increase flexibility of wildcard (glob) pattern matching.
• [14.1.0] Update the StartRegressionTestResultsReport command to output a report with nonum in the name. The file is the same as the normal output but with test numbers removed, which is useful for comparing one test suite output to another.
• [14.1.0] Update the Cumulate command Reset parameter to allow ${Property} notation.
• [14.1.0] Update the FormatFile command to allow overwriting the input file.

Changes in Version 14.0.6

Maintenance release for to improve @require functionality.

• [14.0.6] Updated the @require Comment command:
  • Improve the @require software design to allow datastores more flexibility in implementing requirements.
  • Add the datastore type to @require command status messages to improve troubleshooting.

Changes in Version 14.0.5

Maintenance release for testing and to update the log4j library.

• [14.0.5] Update the Log4J library to version 2.17.1 for security patches.
• [14.0.5] Updated the FormatStringProperty command:
  • Add the IntegerFormat, Endianness, Delimiter, and NumBytes parameters to format integer properties as hex code string, which is useful for automated testing.

Changes in Version 14.0.4

Maintenance release to update training materials and respond to "Log4Shell" vulnerability.

• [14.0.4] Update the log4j library to version 2.17.0 in response to the "Log4Shell" security vulnerability. See the Apache Log4J Vulnerability Guidance documentation.
• [14.0.4] Fix a bug introduced in the previous release that broke transfer of time series identifiers from the time series list to TSID commands. This bug was due to new features that handle datastore aliases used in software testing. The bug mainly impacts the case where the HydroBase input type is used with TSID commands. If version 14.0.3 is used, the work-around is to configure a HydroBase datastore named HydroBase.
• [14.0.4] Training materials that are distributed in the doc/training folder have been updated to be compatible with the latest software features. Additional training presentations will be added in the future as training materials are updated. The Training documentation now links to online training materials.
• [14.0.4] Updated the WebGet command to handle redirects.

Changes in Version 14.0.3

Maintenance release for Reclamation Linux version.

• [14.0.3] Updated the CompareTimeSeries command to have AllowedDiff parameter
• [14.0.3] Minor changes to ReclamationHDB commands based on testing.

Changes in Version 14.0.2

Maintenance release with changes to address issues and features needed for automated testing.

• [14.0.2] Fix bug related to substitute datastore features:
  • was causing an exception editing commands that operate on datastores, fixed in the following commands:
    • CreateDataStoreDataDictionary
    • DeleteDataStoreTableRows
    • ReadTableFromDataStore
    • ReadTimeSeriesFromDataStore
    • RunSql
    • WriteTableToDataStore
  • substitute datastore name was not being used to form time series identifiers in the man user interface - the selected datastore (which may be a substitute) is now used to create TSID commands
• [14.0.2] Fix the TableToTimeSeries command so that irregular interval data outside the requested period are not set in the time series.
• [14.0.2] Change the ReadTableFromDelimitedFile command IncludeText and ExcludeText parameters to automatically convert * wildcard to Java .* to simplify wildcard use and be consistent with other commands.
• [14.0.2] Update the ReadTableFromDelimitedFile command:
  • allow * in the filename
  • fix the HeaderLines parameter to work
• [14.0.2] Update commands to improve handling database functions and procedures:
  • ReadTableFromDataStore
  • RunSql
• [14.0.2] Add --ui-titlemod=TitleMod TSTool program parameter to specify a string to use in the TSTool main UI title bar, to specifically identify the TSTool session .

Changes in Version 14.0.1

Maintenance release with minor changes to address issues and features needed for automated testing.

• [14.0.1] Fix command processing so that if a command has an error, the command's output files will be listed in the Results / Output Files. Previously, a command with an error would not list its output files.
• [14.0.1] Fix problem with command documentation not finding latest documentation if versioned documentation does not exist and update documentation URLs to https.
• [14.0.1] Fix the CompareTimeSeries command to properly handle comparing two files or ensembles.
• [14.0.1] Fix bug where command with #@expectedStatus comment that, when run returned a different status, was not resulting in a failure indication in the user interface.
• [14.0.1] Add a Cancel button to the Tools / Diagnostics dialog and clarify the tooltips on buttons related to setting diagnostics properties.
• [14.0.1] Add TSTool.cfg configuration properties DiffProgram.Windows and DiffProgram.Linux to allow configuring visual difference program for each environment without having to change the single DiffProgram configuration property, and default to KDiff3 as an example of typical use.
• [14.0.1] Update the following commands to list datastores opened with OpenDataStore command, used in automated testing (previously only listed datastores that are opened at startup, which limited the ability to edit command parameters):
  • CloseDataStore
  • CreateDataStoreDataDictionary
  • DeleteDataStoreTableRows
  • ReadTableFromDataStore
  • ReadTimeSeriesFromDataStore
  • RunSql
  • WriteTableToDataStore
  • WriteTimeSeriesToDataStore
• [14.0.1] Message dialogs now show text that can be highlighted and copied.
• [14.0.1] Update the CreateRegressionTestCommandFile command:
  • Improve how test suites are handled with IncludeTestSuite and ExcludeTestSuite. The behavior is now intuitive.
  • Add support for @os linux, which is equivalent to @os UNIX.
  • Allow the SearchFolder parameter to list more than one folder
• [14.0.1] Update the FormatTableDateTime command to support seconds for IncrementBaseUnit parameter.
• [14.0.1] Update the Message command to have PromptActions parameter, which enables interactive prompts to confirm message in command workflows, for example to prompt for confirmation for destructive actions such as removing files and folders.
• [14.0.1] Update the ReadStateModB command to have OutputVersion parameter, which allows converting old data files to current format.
• [14.0.1] Update the ReadTableFromDataStore command:
  • allow newline character in Sql parameter to format multi-line SQL
  • default floating point column precision to 6 digits for SQLite databases
  • add OutputProperties parameter to set output properties when a single row is returned
• [14.0.1] Update the ReadTableFromDelimitedFile command to accept space for Delimiter parameter, using \s notation.
• [14.0.1] Update the RunCommands command to have StdoutProperty parameter.
• [14.0.1] Fix the Wait command to properly handle small wait time specified as decimal fraction of second.
• [14.0.1] Update the WriteTableToDelimitedFile command to have IncludeColumns and ExcludeColumns parameters.
• [14.0.1] Add --datastore-substitute=datastore,substitute TSTool program parameter to specify substitute datastore name, useful for automated testing.

Changes in Version 14.0.0

This is the first 64-bit Java release. See also many new features that were added in the last 13.x releases.

• [14.0.0] This is the first 64-bit release with new major version number 14:
  • Installing version 14 will automatically copy a user's .tstool configuration files for previous version to this version.
  • The HEC-DSS features are disabled. Additional resources are needed to update the software to use 64-bit libraries for HEC-DSS.
  • This 64-bit version is constrained only by available memory on the computer and can be configured to use more memory for large datasets, if necessary. This is an improvement over the 32-bit version, which was constrained to approximately 1.2 GB of memory use.
• [14.0.0] Enhance the raster graph:
  • The ProcessRasterGraph command TSProductFile and OutputFile parameters can now be specified using ${Property} syntax.
  • Time series product file now accepts a Data property SymbolTablePath, which specifies the path to a symbol table, which describes the colors for the raster graph. If not specified, the raster graph uses deciles, after rounding the minimum and maximum values.
  • The Data property RasterGraphLegendPosition has been added, and currently always defaults to Right. A color legend is always shown.
  • An optional mouse tracker can be enabled in the graph window.
  • Improved the mouse position information to include the symbol table range, consistent with the symbol table for colors.
  • Improve the handling of colors.
  • Attempting to zoom cased errors. Zoom is now disabled.
• [14.0.0] Update the CompareTimeSeries command:
  • The WarnIfDifferent and WarnIfSame parameters have been changed to IfDifferent and IfSame to provide more flexibility, similar to other commands.
  • The CreateDiffTS parameter has been updated to provide IfDifferent option, which will only create the difference time series for cases where a difference is detected. This significantly reduces the number of output time series and increases processing speed.
  • Add DifferenceFile parameter to indicate a file listing the difference counts for all time series. The output was previously always saved in the log file, which led to large log files.
  • Add SummaryFile parameter to indicate a file listing the summary of time series with differences. Time series without differences are not included in the summary. The output was previously always saved in the log file.
  • Add MatchAlias parameter to match time series alias.
  • Improve error checks and warnings when a time series cannot be matched.
  • Improve performance.
• [14.0.0] Update the ReadStateCUB command:
  • Added the OutputVersion parameter to allow old binary files to be translated to latest format, necessary to minimize differences when testing.
• [14.0.0] Update the ReadStateModB command:
  • Ignores parameter with name NA, which are placeholders that don't have data.
  • Handle the case where b44 (reservoir) file contains no reservoir stations.
  • Add IfFileNotFound parameter to provide more control over error handling.
• [14.0.0] Add the --java-xmx parameter to the Linux tstool shell script to set the maximum computer memory to use for TSTool Java Runtime Environment.
• [14.0.0] Added the --space-replacement TSTool command line parameter to help with commands lines that include spaces in parameters.