DepthAreaCurveToTin

DESCRIPTION

This utility uses depth-area data to create a TIN with an elliptical storm
pattern that conforms to the depth-area data. The resultant TIN can then use
the MetVue disaggregation capability to create a design storm.

USAGE

DepthAreaCurveToTin -maxPrecip pointPrecip
-inputAreaArray "inputAreaArray"
-inputPrecipArray "inputPrecipArray"
[-bTime time] [-dTime timespan] [-eTime time]
[-ellipseRatio ratio]
[-location "lon,lat,angle"]
[-pointsPerEllipse points]
[-minDist distance]
[-smooth]
[-logInterp]
[-title "title"]
[-outputAreaArray "outputAreaArray"]
-outFile outputFile
[-logFile logFile]

The options -maxPrecip, -inputAreaArray, and -inputPrecipArray must be specified.

-maxPrecip pointPrecip

This is the value for the maximum precip used in all computations.

-inputAreaArray "inputAreaArray"

A comma separated array of input areas. MUST be enclosed in double quotes.
e.g. -inputAreaArray "1, 10, 1000, 5000"

-inputPrecipArray "inputPrecipArray"

A comma separated array of input indexed precip values.
MUST be enclosed in double quotes.
e.g. -inputPrecipArray "1, .969, .858, .444". The number of items in the
list MUST match the items in the list specified by -inputAreaArray

-ellipseRatio ratio

Specify the ellipse ratio to use (major/minor axis ratio). If not
specified, a value of 2.5 is used. Value should be 1.0 or greater.

-location "lon,lat,angle"

The location and rotational angle of the resultant TIN. MUST be enclosed
in double quotes. e.g. -location "-95.25,33.50".

The angle defaults to 0 CCW from the X axis if not specified.

-pointsPerEllipse points

Specifies the number of points per ellipse. If not specified the default
of 72 is used (5 degrees).

This must be a whole number. There may be fewer points if the -v
argument is specified also.

-minDist distance

Specifies the minimum distance between points on an ellipse in miles.
The default is 0 so that the -pointsPerEllipse option controls point
placement. If -minDist is specified, the points along the ellipse are
guaranteed to be no closer than what is specified.

-smooth

Smooth the input arrays specified using the -inputAreaArray and
-inputPrecipArray option using a spline fit.
The default is to use the raw curve.

-logInterp

Use log interpolation of the input curve for the areas. The default is
to use linear interpolation.

-title "title"

Used to specify a title for the output file. If none is specified the
program will generate one.
The title MUST be enclosed in double quotes. e.g. -t "this is my title"

-outputAreaArray "outputAreaArray"

A comma separated array of output areas to generate ellipses for. MUST
be enclosed in double quotes and be encompassed within the bounds of the
inputAreaArray specified above.

e.g. -outputAreaArray "1,2,5,10,100,500,1000,2000,5000".

If no array is specified then the array specified using the
-inputAreaArray argument is used.

-outFile outputFile

Specifies the file to which the triangulated TIN data will be saved.
Defaults to DepthAreaCurve2Tin.rf if not specified

-logFile logfile

Specify the output file for results/error review. If not specified, it
defaults to DepthAreaCurve2Tin.log

SAMPLE COMMAND LINE ARGUMENTS

-maxPrecip 7.79 -inputAreaArray "10,25,50,100,175,300,450,700,1000,1500,2150,3000,4500,6500"
-inputPrecipArray "7.79,7.61,7.48,7.32,7.09,6.82,6.61,6.36,6.13,5.85,5.58,5.29,4.89,4.48"
-smooth -ratio 2.5 -pointsPerEllipse 90 -location "-103.0,36.0,90"
-bTime "17DEC1991,010000" -eTime "24Dec1991,240000" -title "Dec 1991 Trinity Storm"
-outfile "d:/trinity/trinityDec91.tin"

NOTE ON PERFORMANCE

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 DepthAreaCurveToTin.cmd example file provided.