DESCRIPTION
This utility is used to calibrate radar TINs using rainfall observer TINs.
It may be used for other purposes, which could use a control TIN that
has accurate measurements, but is spatially sparse, to adjust a target
TIN, which has a dense spatial set of measurements but less accurate values.
Although developed for radar calibration, this utility is a generalized
adjustment utility, which could be used for elevation corrections and
possibly other uses as well.
USAGE
OPTIONS
-controlFile file
This specifies the control file to use for calibration.
This is typically a rainfall file.
-sourceFile file
This specifies the file to adjust the measurement values for.
This is typically a radar file.
-title "title"
Specifies the title for the calibrated image. Use quotes around title.
e.g. -title "My new Title"
-missingOut
Specifies points on the source TIN that are outside of the perimeter of
the control TIN should be set to missing.
By default, the values outside of the perimeter of the control TIN are
left unadjusted.
-weightedThreshold threshold
The maximum ratio to be used between rainfall and radar measurement
values before switching to an additive weighting method. The default is
3.0. For example, if the measurement value for a point from the control
TIN is .15 and the measurement value for the coincident source TIN point
is .03, this would give a ratio of 5.0. If the default max ratio is used,
then this exceeds the 3.0 maximum, so the adjustment becomes additive and
the difference between the two measurement values (.12) becomes the
control for adjustment instead of the ratio
-targetFile file
This specifies the primary output file.
This is typically an adjusted radar file.
-deltaFile file
If specified, a secondary TIN is created. This additional TIN has the
same TIN point locations as the control file, with the measurement values
being the difference at those points between the controlfile and sourcefile.
Note: this file can be used to help visually identify erroneous
measurement values from the control file.
-statFile file
Text output file which holds an ordered list representing the 'fit'
between the control and source TIN datasets. It can be used to help
identify erroneous measurement values from the control file.
SAMPLE COMMAND LINE ARGUMENTS:
CalRad-r 08may09.rf -n 08mar09.rad -c 08may09.cal -d 08may09.dif -s 08may09.stat.txt -f 3.5
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 CalRad.cmd example file provided.
