VPROJ

Description

Combines the vector output from TRANSEC and a text file to create a new predicted shoreline.

Parameters

Name	Type	Length	Value range
Input: Input vector segment *	Vector port	1 - 1
Output: Output vector segment *	Vector port	1 - 1
Rates of Erosion Text File *	String	1 -
Shoreline Year to Project From *	String	1 - 1
Number of Years to Predict *	Integer	1 - 1
Output segment name	String	0 - 1
Output segment description	String	0 - 1
Report	String	0 - 192	See parameter description

* Required parameter

Parameter descriptions

Input: Input vector segment

Specifies the vector segment that contains the perpendicular transects generated by the TRANSEC function.

Output: Output vector segment

Specifies the output vector segment to receive the projected shoreline.

Rates of Erosion Text File

Specifies the text file that contains the rates of erosion for each of the transects.

The format of the text file is:

 <ShapeId> <Erosion Rate meters/yearE (+ve or -ve)>
 ...
 ...

The first number is the ShapeId of the transect and the second number is the erosion rate in meters/year at that transect.

Shoreline Year to Project From

Specifies the field name of the year from which to project the new shoreline.

Number of Years to Predict

Specifies the number of years by which to multiply the rate, to obtain the final shoreline.

Output segment name

Optionally specifies a name (up to 8 characters) for the output segment.

Output segment description

Optionally describes (in up to 64 characters) the contents or origins of the output data.

Report

Specifies where to direct the generated report.

Available options are:

• LOG: generates a report on the terminal (default)
• <modulename.RPT>: appends a report to the module's RPT file
• DISK: generates a report on file "IMPRPT.LST"

Details

This program projects shorelines with a greater degree of local control than the TRANSEC function. Given the vector transects produced by TRANSEC, VPROJ combines these transects with a text file.

The text file is a two-column file that contains the shapeid in the first column and the erosion rate in the second. The two numbers are separated by tabs or spaces. To skip a transect, simply omit the entry in the text file.

For each transect specified in the text file (TFILE), VPROJ multiplies the specified number of years to predict (NUM1) by the erosion rate and adds the calculated distance to the shoreline determined by the FLDNME (Shoreline Year) parameter.

For example, if NUM1 (Number of Years) is set to 10 and FLDNME (Shoreline Year) to "1950", the module will project 10 years from the 1950 shoreline.

The resulting shoreline is placed in its own vector segment.