TRANSEC

Description

Creates perpendicular transects from a segment of shore baseline at regular intervals. The perpendicular transects will be created with a table denoting the distance of each shoreline from the shore baseline. A new output vector segment is created.

Parameters

Name	Type	Caption	Length	Value range
FILE *	String	Input file name	1 - 192
DBVS *	Integer	Input shorelines vector segment	1 -
DBSL *	Integer	Input baseline vector segment	1 - 1
FLDNME *	String	Field containing the year	1 - 64
NUM1 *	Integer	Interval between perpendicular transects	1 - 1
STR1	String	Query string for selecting shorelines	0 - 64
STR2	String	Method for computing new shoreline	0 - 64	NONE \| FIXED \| ENDPOINT \| AVERAGE Default: NONE
NUM2	Integer	Years of erosion/erosion rate	0 - 1
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. The specified file must contain at least one vector segment.

DBVS

Specifies the input vector segment that describes the shorelines for which transects are to be made.

Ranges of channels or segments can be specified with negative values. For example, {1,-4,10} is internally expanded to {1,2,3,4,10}. When you are not specifying a range in this way, only 48 numbers can be specified explicitly.

DBSL

Specifies the baseline input vector segment that defines the normal direction in which transects are to be made.

FLDNME

Specifies a field, associated with each input vector segment, to use as the year marker.

NUM1

Specifies, in ground units, the interval to use for the automated transects.

STR1

Optionally specifies a vector query expression used to selectively use vectors that satisfy the search criteria.

For example, using the following expression:

"year < 1970"

TRANSEC uses only vectors that have "year" values of less than 1970.

The following is the grammar:

 EXPRESSION: PRIMARY
             not (EXPRESSION)
             (EXPRESSION) BINARY_OP (EXPRESSION)

 PRIMARY: FIELDNAME OPERATOR VALUE

 OPERATOR: =
           <=
           >=
           <
           >

 BINARY_OP: and
            or
 VALUE: number
        "string"

 FIELDNAME: valid fieldname of the vector segment or "ShapeId"

        attribute = 1
        not (attribute = 1)
        (attribute < 12 and attribute > 4) or (group < 2)

STR2

Specifies the method to use to compute a new shoreline.

Supported methods are:

NONE: no shoreline is to be computed (default)
FIXED: the new shoreline is NUM2 units away from the most recent shoreline
ENDPOINT: the erosion rate is calculated using the oldest and newest shorelines. The new shoreline will be NUM2* CalculatedErosionRate units away from the most recent shoreline.
AVERAGE: the erosion rate is calculated in the following manner:
1. The yearly erosion rate is calculated for adjacent shorelines.
2. These yearly erosion rates are then averaged together to yield a final erosion rate.
3. The new shoreline will be NUM2 * CalculatedErosionRate units away from the most recent shoreline.

NUM2

If STR2 (Method for Computing New Shoreline) is AVERAGE or ENDPOINT, specifies the number of years of erosion to simulate.

If STR2 is FIXED, specifies the total erosion.

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

Transects are created along the base line vectors every NUM1 units. Should a transect interval span an interior vertex of the base line, a bisector is created for the transect at the interior vertex. In all other cases, a transect perpendicular to the baseline is created. A minimum of two line segments are created for each line segment.

A vertex is created where each transect crosses a shore boundary. A shore may cross a transect more than once and all vertices are recorded. If several shoreline layers are specified, vertices are added sequentially to each transect for each shoreline segment.

A record is created with each transect, with each field denoting the distance between the baseline and shoreline. Each field will be marked with the values obtained from the field specified by FLDNME (Field Containing the Year).

In the case of a shore boundary that crosses the transect multiple times, the closest one to the baseline is recorded.

Where a shoreline does not cross the transect, the distance recorded will be -1.

If the specified Method for Computing New Shorelines (STR2) is not NONE, a predicted shoreline will also be created based on either calculated or provided erosion rates.

Example

Generate a vector segment from a segment of shore baseline at regular intervals.

EASI>file	=	"maaexample.pix"	! input file
EASI>dbvs	=	2,3,4,5,6,7	! shoreline vector segments
EASI>dbsl	=	11	! baseline vector segment 
EASI>fldnme	=	"Year"	! field name
EASI>num1	=	10	! interval of transects
EASI>str1	=	"year > 1980"	! after 1980
EASI>str2	=		! none
EASI>num2	=	  

EASI>run TRANSEC

Environments	PYTHON :: EASI :: MODELER
Quick links	Description :: Parameters :: Parameter descriptions :: Details :: Example