User's Guide

RELMAP

Renumbers specific values of an input image by use of a set of relational numbers extracted from an Oracle database table.

Function:

Renumbers specific values of an input image by use of a set of relational numbers extracted from an Oracle database table.

Parameters:

IN
Input image. The input data type must be BYTE or INTEGER*2. The input image pixel values from FROMCOL are reassigned to the respective values specified in TOCOL in the output image.

OUT
Output image. The output data type will be BYTE or INTEGER*2 as determined by the values specified in FROMCOL. Those values not explicitly specified for reassignment have the same values as IN.

ORCUID
Oracle USERID. The user's Oracle USERID.

ORCPWD
Oracle password. The user's Oracle password.

ORCTAB
Oracle table. The Oracle table containing the input and output pixel renumber values.

FROMCOL
From column. The name of the column within ORCTAB that contains the input pixel renumber values.

TOCOL
To column. The name of the column within ORCTAB that contains the output pixel renumber values.

Example:

  1. LAS> relmap in=test1 out=testout orcuid=bob orcpwd=bob123 orctab=test fromcol=from tocol=to

    The values from the Oracle table TEST will be written to a spool output file by the Oracle account BOB. The values in the FROM and TO columns of the table TEST will be reformatted, and passed to the procedure RENUMBER, resulting in the output image TESTOUT.

Description/Algorithm

Given that the data required for remapping a specified input image is in an Oracle database table, a spool file is created to extract the information from the table and place it in an ASCII text file. The ASCII file is then read, and the mapping values are reformatted into input and output strings compatible with the FROM and TO parameters of the procedure RENUMBER. RENUMBER is then called to renumber the input image.

Nonfatal Error Messages:

    None.

Fatal Error Messages:

  1. [relmap-fatal] Fatal error encounterd

    A fatal error was encountered during processing. Processing is terminated. The error message that is displayed immediately preceding this message is the specific error encountered.

  2. [relmap-db] The Oracle database does not exist

    The Oracle database is not resident upon the host system. Run on a machine with the Oracle database. Contact database administrator for a list of machines running with Oracle

  3. [relmap-len] String length overrun

    A string length overrun error occured. See the LAS system administrator.

  4. [relmap-open] Error opening <xxx> file

    An error occured while trying to open the specified file. Check file protections. If the problem persists, contact the system administrator.

  5. [relmap-spool] Spool process failed

    A fatal error was encountered during an attempt to write the specified information from the Oracle table to an ASCII file. Check to ensure that the table exists, containing the desired columns. Also ensure ORCUID and ORCPWD were correctly entered.

  6. [relmap-tae] Error writing to TAE parameter block

    An error occured when writing data to the TAE parameter block. See the LAS system administrator.

User note:

  1. This procedure must be run under UNIX, and on a machine that has the Oracle database in residence.

  2. A related routine is RENUMBER.

  3. Oracle database tables with FROM and TO renumber values are established by users to allow a variety of both image processing and cartographic manipulation options in the product production flow.