User's Guide

CUTADD

Adds points along a cutline

Function:

Adds in points along a cutline. The input coordinates for the cutline are either stored in an image based information system (IBIS) graphics file or entered by the user. The output coordinates are stored in an IBIS graphics file.

Parameters:

Subcommand -FILE:
The input coordinates are in an IBIS graphics file.

INFILE
Input file. The IBIS graphics file containing the coordinates for the input cutline or polygon. The coordinates must be stored in the graphics file in line,sample (or Y,X) order. The polygon must be closed.

OUTFILE
Output file. The output IBIS graphics file containing the new coordinates for the cutline.

PNTINC(100)
Point increment. Indicates how far apart the points to be added should be placed.
Subcommand -MANUAL:
The input coordinates are entered by the user.

LSCOORS
Line/sample coordinates. The coordinates that the user enters to define the input cutline or polygon. The coordinates must be listed in line,sample (or Y,X) order. The polygon must be closed. Currently, the user may enter up to 50 points.

OUTFILE
Output file. The output IBIS graphics file containing the new coordinates for the cutline.

PNTINC(100)
Point increment. Indicates how far apart the points to be added should be placed.

Examples:

  1. LAS> cutadd-file infile=cut outfile=newcut

    Coordinates for the cutline stored in the input IBIS graphics file CUT are read in and points to be added in are generated using a point increment of 100. The new coordinates for the cutline are stored in the output IBIS graphics file NEWCUT.

  2. LAS> cutadd-manual lscoors=(1,1,1,50,50,50,50,1,1,1) outfile=newcut pntinc=10

    The input coordinates are retrieved as specified by the user and points to be added in are generated using a point increment of 10. The new coordinates are output to the IBIS graphics file NEWCUT.

Description/Algorithm:

The program begins with the standard initialization and retrieval of user-specified parameters. The points of the input polygon are read in from either the IBIS graphics file or the LSCOORS parameter. Points are generated according to the specified step size (PNTINC) to be added in to the cutline. The resulting points are written to the output IBIS graphics file.

Nonfatal Error Message:

  1. [cutadd-close] Error closing <XXXXX> file

    An error was encountered closing the <XXXXX> file. The data may be valid.

Fatal Error Messages:

  1. [cutadd-fatal] Fatal error encountered

    A fatal error was encountered during processing. The output IBIS graphics file may or may not be valid. The message that is displayed immediately preceding this message is the specific error that was encountered.

  2. [cutadd-open] Error opening <XXX> file

    An error was encountered while trying to open the specified file.

  3. [cutadd-limit] Excess number of points generated

    As a result of the input polygon data and the given point increment, over 5400 pairs would be generated for the output polygon. Increase the point increment so that less points are generated.

  4. [cutadd-read] Error reading input file

    An error was encountered while trying to read from the input IBIS graphics file.

  5. [cutadd-write] Error writing output file

    An error was encountered while trying to write to the output IBIS graphics file.

User Notes:

    None.