Level 2 Help for LOOKUP

INP

If an input table file is specified, it must be the last input file listed,
and the TABNO, TBLSAVE, or SAVE parameter must be specified.


OUT

If an output table file is specified, it must be the last output file listed,
and the NEWTBLF, TBLSAVE, or SAVE parameter must be specified.


LIST

The default LIST value is no listing of the lookup table.


TABNO

The basis for the lookup table will be the table number (record number)
specified by this parameter. If this parameter is used, a lookup table
dataset must be supplied as the last input dataset.


PS

The basis for the lookup table will be the IDX pseudocolor table of the same
number. IT may then be modified via the LTABLE parameter. Valid tables are:
      PS=0      for an identity transformation (all outputs like input)
         1      for the original 8 color table
         2      for the original 16 color table
         3      for the original 32 color table
         4      for the 16 color table, with colors selected for screen display
         5      for the 8 color table, with colors selected for screen display
         6      for the 6 color table
         7      for the 4 color table
         8      for the 32 color table, with colors selected for MDA playback
         9      for the 16 color table, with colors selected for MDA playback
        10      for the 10 color table, with colors selected for MDA playback
        11      for the 8 color table, with colors selected for MDA playback
PS3 and PS8 use black and white as two of the 32 colors; PS10 and PS11 use
black and white in addition to the stated number of colors to denote saturation.
They map only 0 and 255 input. All other tables do not use black or white.


NEWTBLF

If you wish to save (write out) the lookup table and the 
table file is new, enter 'NEWTBLF. The lookup table will be saved as table 1.
 If NEWTBLF is specified, then neither SAVE nor TBLSAVE is specified.


SAVE

If you wish to save (write out) the lookup table in an existing table
file, enter either 'SAVE to have the lookup table saved in the next 
available location in the table file,      or
enter a specific location (table number) for TBLSAVE.
The modified table file will be written to the output table file specified
in the OUT parameter.  The input table file is not modified.


TBLSAVE

If you wish to save (write out) the lookup table in an existing table
file, enter either 'SAVE to have the lookup table saved in the next 
available location in the table file,      or
enter a specific location (table number) for TBLSAVE.
The modified table file will be written to the output table file specified
in the OUT parameter.  The input table file is not modified.


USE

The default is USE=(1,2,3,4).


CHANGE

Pairs of values are entered following the CHANGE keyword.  Each pair
of values represents a change to the lookup mapping.  Although the
program accomplishes the change by changing the table, the effect on
the lookup mapping can best be explained as changing input data numbers
of the first value (in the pair) to the second value (of the pair)
before the lookup table is applied.  Each change is based
on the table specified and is independent of other changes
specified with it.
The CHANGE parameters may be used with or without LTABLE parameters.
If both LTABLE and CHANGE parameters are used, the CHANGE parameters
are applied to the result produced by the LTABLE parameters.


LTABLE

By specifying LTABLE parameters the user can apply modifications to
an existing table or can completely define a new table.  These
parameters specify the data numbers for each channel to which
given data numbers are to be mapped.

LTABLE parameters are entered in groups of NCHAN+1 values
for a single data number or NCHAN+2 values for a range of
data numbers. For a single data number, the group consists
of the data number followed by the values assigned to that
data number for each of the NCHAN channels.  For a range of
data numbers, the group consists of the data number for the
start of the range followed by  -1 times the data number 
for the end of the range followed by the values assigned to
any data number in that range for each of the NCHAN channels.

When modifying an existing table, the user enters groups of 
parameters only for the data numbers for which changes are
desired.  When defining a new table, the user enters the full
table so that a mapping is defined for all of the data numbers
from 0 to 255.

The following example illustrates the format and usage of the LTABLE
parameters.  In this example the mapping is completely defined for
two channels.  The first channel maps  0 to 1, 1 to 3, and 2 through
255 to 5.  The second channel maps  0 to 2, 1 to 4, and 2 through
255 to 6.
          LTABLE = ( 0         1  2                                 1         3  4                                 2  -255   5  6             )

The LTABLE parameters may be used with or without CHANGE parameters.
If both LTABLE and CHANGE parameters are used, the CHANGE parameters
are applied to the result produced by the LTABLE parameters.