Skip to content

HydrologicEngineeringCenter/FIRO_TSEnsembles

Repository files navigation

FIRO_TSEnsembles

GitHub Action

This is a project intended to develop a set of tools to read in data from the River Forecast Centers and convert it into a sqlite database. This database will be used as a format to share data on disk between plugins in HEC-WAT and possibly CWMS.

Download the latest Build here:

https://github.com/HydrologicEngineeringCenter/FIRO_TSEnsembles/actions/workflows/gradle.yml

Standalone ResSim Setup

Install ResSim currently: 3.5.0.283

Download the zip file here

unzip and copy the jars to HEC-ResSim\jar\ext

Edit Hec-ResSim.config verify HasGlobalVariables to true and temp directory for SQLite as shown below.

#:------------------------------------------------------:
#:Set the following parameter to "true" to turn on      :
#:Global Variables                                      :
#:------------------------------------------------------:
vmparam -DHasGlobalVariables=true

vmparam -Dorg.sqlite.tmpdir=c:\temp

Another way is to put these in the class path. If multiple programs are using the Jars such as both HEC-WAT and HEC-ResSim the jars can be placed in a shared location. This can be done by editing C:\Programs\HEC-ResSim-3.5.0.116\HEC-ResSim.config. (example location)

addjars C:\FIRO_TSEnsembles\libs

Release Versions and Git Tags

To add versioning to artifacts, the user must add a git tag to the commit. There are three artifacts created when pushing changes to remote. To version a specific jar, the following texts are required:

TS-Ensembles - prefix with "ts-". For example, to release version 1.0 the user would create a git tag with the name "ts-v1.0" Ensemble-View - prefix with "ev-". For example, to release version 1.0 the user would create a git tag with the name "ev-v1.0" Dss-Ensembles - prefix with "dss-". For example, to release version 1.0 the user would create a git tag with the name "dss-v1.0"

Currently, only one version can be committed at a time. Tags also must be signed using GPG, SSH, or S/MIME in order for the git tag to be recognized during the remote build process. Unsigned git tags will not used. more information on signing git tags can be found here: https://docs.github.com/en/authentication/managing-commit-signature-verification

Sample Data

sample data ResSim.db https://github.com/HydrologicEngineeringCenter/FIRO_TSEnsembles/tree/master/FIRO_TSEnsembles/src/test/resources/database

Issue

You may see an error such as this, where virius protection program is preventing the sqlitejdbc.dll from running in the default temp directory.

java.lang.UnsatisfiedLinkError: C:\Users\happy\AppData\Local\Temp\1\sqlite-3.30.1-db89cb97-d483-489a-b248-956d0783d9d5-sqlitejdbc.dll: Access is denied

Workaound

add this line below to HEC-ResSim.config

vmparam -Dorg.sqlite.tmpdir=c:\temp