AIPS NRAO AIPS HELP file for OFMPL in 31DEC26



As of Tue Feb 10 2:28:43 2026


OFMPL: Task to review and compare OFM color tables

INPUTS

INFILE                             Logical disk area with OFM
                                   files.  ' ' -> use standard
                                   areas
           Optional image to be displayed with OFMs
INNAME                             Image name(name).
INCLASS                            Image name(class).
INSEQ           0.0      9999.0    Image name(seq. #). 0=>high
INDISK          0.0         9.0    Disk drive #. 0=>any
TBLC            0.0      4096.0    Bottom Left Corner of image
                                     0=>entire image
TTRC            0.0      4096.0    Top Right Corner of image
                                     0=>entire image
TXINC        -100.0       256.0    Load every TXINC'th column
TYINC        -100.0       256.0    Load every TYINC'th row
PIXRANGE                           Min,Max  of image intensity
                                     0=>entire range
FUNCTYPE                           Image intensity transfer func
                                     'LN' Linear.  unknown=>'LN'
                                     'LG' Logarithmic
                                     'L2' More logarithmic
                                     'SQ' Square root
                                     'NE' Negative linear
                                     'NG' Negative logarithmic
                                     'N2' Negative more log.
                                     'NQ' Negative square root

HELP SECTION

OFMPL
Type: Task
Use:  OFMPL offers a menu of color tables to display.  There are two
      modes of display.  The first displays 4 step wedges.  If you hit
      button A while selecting one of the color tables, the lowest
      step wedge will display that table and its name will appear above
      the step wedge in white.  Hitting button B causes the second step
      wedge to display the selected color table while button C causes
      the third step wedge to be used and button D uses the upper step
      wedge..  The menu option SWITCH selects the alternative display
      in which the selected color table is plotted in 3 colors.
      Choosing SWITCH again returns to the first display.  TV channels
      2 through 4 are used for the first display and channels 5 through
      7 are used for the second display.  This allows each display to
      be remembered after a SWITCH.  The menu option EXIT causes the
      task to exit, but the TV channels and graphics planes are not
      cleared so you may use other AIPS verbs on them.

      A third form of OFM display uses an optional image file loaded
      into image plane 1.  This display is available only when an image
      is specified.  When it is an IMAGE option is added to the menu.
      Selecting this option turns on the display of the image or turns
      it off.
Adverbs:
  INFILE......Logical name of disk area with OFM files to include.
              ' ' => use only standard areas

Optional image display adverbs:
  INNAME......Image name(name).       Standard defaults.
  INCLASS.....Image name(class).      Standard defaults.
  INSEQ.......Image name(seq. #).     0 => highest.
  INDISK......Disk drive # of image.  0 => any.
  TBLC........The Bottom Left-hand pixel of the subarray of
              the map to be displayed. The value (0,0,...)
              means take the entire first plane of the image.
  TTRC........The Top Right-hand pixel of the subarray of
              the map to be displayed.  The value (0,0) means
              take the entire plane of the image.
  TXINC.......Load every TXINC'th column beginning at TBLC.
              TXINC = -1 => interpolate columns to fill as much
              of the screen as possible.  TXINC = -2 =>
              interpolate one column between image columns (if
              possible), -3 => 2 interpolated columns, etc.
  TYINC.......Load every TYINC'th row beginning at TBLC.
              TYINC = -1 => interpolate rows to fill as much of
              the screen as possible.  TYINC = -2 =>
              interpolate one row between image rows (if
              possible), -3 => 2 interpolated rows, etc.
  PIXRANGE....Min,Max intensity to display. 0 => entire range.
  FUNCTYPE....Image intensity transfer function
              'LN' => linear;        'NE' => negative lin.
              'LG' => log;           'NG' => negative log;
              'L2' => extreme log;   'N2' => negative extra log;
              'SQ' => square root,;  'NQ' => negative square root;
              others => linear.

EXPLAIN SECTION


The publicly available color maps are displayed at
    https://cmap-docs.readthedocs.io/en/latest/catalog/
although many of them are not suitable for use in AIPS.

The actual data for these may be found starting at
   https://github.com/pyapp-kit/cmap/blob/main/src/cmap/data/
We have selected a small number of them to ship with AIPS.  The names
were those used by the authors of the data.

AIPS