User's Guide

CUTCHG

Modifies an IBIS cutline file as specified.

Function:

Reads an image based information system (IBIS) cutline file, prints the data to the terminal, modifies the data as specified, and then writes the modified data to the output file.

Parameters:

INFILE
Input file. The input file is an image based information system (IBIS) file in graphics format and contains line/sample locations.

OUTFILE
Output file. The output file contains the modified line/sample locations in the graphics format.

Example:

  1. LAS> cutchg infile=in.dat outfile=out.dat

    IN.DAT is opened and the line/sample locations are read in and printed to the terminal. A command is entered and the prompts for that command are displayed. When the "W" (write) command is entered, the points are written to OUT.DAT and the completion message is displayed.

Description/Algorithm:

After reading the input parameters, INFILE and OUTFILE are opened and the data is printed to the terminal. The user is then prompted to enter one of the commands shown below; and depending on the command entered, may be prompted further as indicated.

A: Add a point.

   Enter the number of the point which precedes the point to be
   added.
   Enter the line location of the point to be added.
   Enter the sample location of the point to be added.
   Do you wish to add another point? (yes,no)

D: Delete a point.

   Enter the number of the point to be deleted.
   Do you wish to delete another point? (yes,no)

H: Display help.

M: Modify a point.

   Enter the number of the point to be modified.
   Enter the new line location of the point to be modified.
   Enter the new sample location of the point to be modified.
   Do you wish to modify another point? (yes,no)

P: Print out points to the terminal.  

W: Write points to OUTFILE and end session.  

Q: End session without writing points to OUTFILE.  

After all the points are written to OUTFILE, all the files are closed, and the completion message is displayed.

Nonfatal Error Messages:

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

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

  2. [cutchg-command] Command entered is not a valid command

    The command entered is not valid. Enter a valid command.

  3. [cutchg-point] Point could not be found.

    The point number entered is not valid. Re-enter the point number that is needed.

Fatal Error Messages:

  1. [cutchg-batch] This program cannot be run in batch mode

    This program cannot be run in batch mode. It expects a user to interactively type in the commands.

  2. [cutchg-fatal] Fatal error encountered

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

  3. [cutchg-lines] This terminal does not have enough lines

    This terminal does not have enough lines to display the cutline points. Execute this program on a terminal that has at least 23 lines of output.

  4. [cutchg-open] Cannot open <XXXXXX> file

    The <XXXXXX> file could not be opened and processing is terminated. Verify that the <XXXXXX> file exists.

  5. [cutchg-read] Error reading <XXXXXX> file

    The <XXXXXX> file could not be read; and therefore, an output file cannot be created. Verify that the format of the file is correct.

  6. [cutchg-term] Terminal is not a support CRT

    This terminal is not supported the TAE terminal output. Refer to your TAE manual for terminals that are supported.

  7. [cutchg-write] Error writing to <XXXXXXX> file

    The <XXXXXXX> file could not be written to. Verify that disk space is available.

User Notes:

  1. This routine cannot be run in batch mode.

  2. When entering line/sample locations, the decimal point must always be entered.

  3. When adding or deleting a point, the point numbers displayed on the screen will be accurate until the user exits the add or delete mode. A limit of 450 points can be added or deleted at one time.