VPROJ

Description

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

Parameters

Name	Type	Caption	Length	Value range
FILE *	String	Input file name	1 - 192
DBVS *	Integer	Input vector segment	1 - 1
TFILE *	String	Rates of erosion text file	1 - 192
FLDNME *	String	Year of shoreline from which to project	1 - 64
NUM1 *	Integer	Number of years to predict	1 - 1
DBSN	String	Output segment name	0 - 8
DBSD	String	Output segment description	0 - 64
REPORT	String	Report mode	0 - 192	Quick links
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

* Required parameter

Parameter descriptions

FILE

Specifies the name of the PCIDSK file to process. This file contains the vector segment generated by the TRANSEC function.

DBVS

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

TFILE

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.

FLDNME

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

NUM1

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

DBSN

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

DBSD

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:

• TERM: generates a report on the terminal (default)
• DISK: generates a report on file "IMPRPT.LST"
• OFF: turns off report generation
• <filename>: appends a report to the specified file

MONITOR

The program progress can be monitored by printing the percentage of processing completed. A system parameter, MONITOR, controls this activity.

Available options are:

• ON: Turns the monitor ON (default)
• OFF: Turns the monitor OFF (recommended if running in batch or background mode)

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.

Example

This example demonstrates the use of VPROJ in generating a vector layer from TRANSEC and a text file to create a new predicted shoreline.

EASI>file	=	"maaexample.pix"	! input file
EASI>dbvs	=	10	! TRANSEC vector segment 
EASI>tfile	=	"tableforvproj.txt"	! rates of erosion
EASI>fldnme	=	"1988"	! field name
EASI>num1	=	10	! number of years to project
EASI>dbsn	=	"VPROJ"	! output segment name
EASI>dbsd	=		! output segment description

EASI>run VPROJ