DESCRIPTION
This utility converts a set of geolocated time series into a set of TINs or grids,
using a control file that closely resembles the one used by the HEC-GageInterp
program (HEC, 2016). A resultant TIN or grid is created for every time step
defined in the control file, or the command line options.
USAGE
OPTIONS
-controlFile file
Specifies how to convert gage data into a gridded dataset.
-dssIn file
Overrides the DSS input file specified in the control file if present.
-dssOut file
Overrides the DSS output file specified in the control file if present.
Cannot be used with the outFile option.
-
Overrides the output file specified in the control file if present.
Cannot be used with the dssOut option.
-gridType type
Specifies the type of TIN to generate. "type" can be either 'TIN',
'HRAP', or 'SHG'. The correct grid origin etc. must be specified in the
control file for the related option override to succeed.
-sTime time
See Command Line Time Specifications
-eTime time
See Command Line Time Specifications
-dTime timespan
See Command Line Time Specifications
By default, the program extends data onto the entire grid that is
specified in the control file. If the -noExtrapolate option is used,
cells in the output grid that are located outside of the spatial extents
of the gage network TIN will be set to 'out of bounds'.
-aggregate
Add all the images together into an aggregate image and store
that as an additional TIN.
-logFile file
The file to log the output to. Output also goes to the console, which can
be redirected to a file if desired.
-dialog
Show the configuration dialog to make setting adjustments.
SAMPLE COMMAND LINE ARGUMENTS:
Perform gage interpolation for October 6th, 1985
-controlFile C:\\control.ginterp -dssIn C:\\data.dss -dssOut C:\\results.dss
-sTime 06OCT1985,000000 -eTime 06OCT1985,240000
Perform gage interpolation for 3 days and aggregate into single image
-controlFile C:\\control.ginterp -dssIn C:\\data.dss -dssOut C:\\results.dss
-sTime 06OCT1985,000000 -eTime 08OCT1985,240000 -aggregate
Perform gage interpolation for October 6th, 1985 and write to SHG without
extrapolating
-controlFile C:\\control.ginterp -dssIn C:\\data.dss -dssOut C:\\results.dss
-sTime 06OCT1985,000000 -eTime 06OCT1985,240000 -gridType SHG -noExtrapolate
This program may utilize a significant amount of memory depending on datasets specified.
For extra intensive data operations, it may be necessary to increase the memory allocated
to the jvm. This can be performed by setting the -Xmx argument, which can be altered
easily in the "memory_setting" variable in the GageToTin.cmd example file provided.
