AIPS NRAO AIPS HELP file for OFMFILE in 31DEC25



As of Fri Jun 20 20:13:42 2025



HELP SECTION

OFMFILE
Type:     Adverb   (String*48)
Use:      The color look-up tables applied to the images shown on the
          TV may be saved in text files usually stored in an area
          known by the logical name OFMFIL.  These files are in ASCII
          and have one record per input value in the form:
                      IIII : BBBBB GGGGG RRRRR
          where IIII is the input intensity, BBBBB is the blue output
          intensity, GGGGG is the green output intensity, and RRRRR is
          the red output intensity.  The range 0 to 10000 is scaled to
          0.0 to 1.0 for loading to the TV.  You must retain this
          format exactly and have one record for each input value in
          order of increasing input intensity.  These files may be
          edited by your favorite text editor.  Their name is
          .uuu, where  is a 1-8 character name of your
          choice (in upper case) and .uuu is your user number in
          extended hexadecimal (base 36, with leading 0's as needed to
          make 3 characters).

          The standard AIPS OFMs are kept in an area with the
          pre-defined logical name AIPSOFM.  Use OFMDIR for a
          list of these files.

          You may also keep OFM files in any area of your choosing.
          In that case, specify
                     OFMFILE = ':',
          where  is the logical name of your area (usually in
          upper case) and the colon is required and implies this
          usage.  The full file name including any extension must be
          given in this case.  Note that the Unix-standard $ ahead of
          the logical is omitted.  Other forms are now acceptable as
          well (except in OFMGET which requires a logical)
             OFMFILE = 'MyOFM
          will find the file in the logical directories AIPSOFM or
          OFMFIL.  A full path name may also be given
             OFMFILE = '/home/primate2/egreisen/AIPS/Text.ofm
          if it fits in 48 characters.  Note that the trailing quote
          mark is left off and this is the last command on the input
          line so that the case is preserved.

          All verbs which use this adverb are also capable of taking
          an immediate argument which will override the adverb value.
          For examples,
                   OFMZAP  'MYAREA:LOUSY.OFM'
                   OFMGET  'COLWED8'
          Note that the apostrophies are required.

          New task OFMPL will let you look at all of the available
          OFM files as step wedges, plots, and as they affect one of
          your images.
Verbs:
  OFMGET......Load the specified OFM file to the TV OFM.
  OFMSAVE.....Create a new OFM file of the specified name and
              fill it with the current OFM.
  OFMZAP......Delete the specified OFM file.
Tasks:
  GREYS.......Make a grey-scale plot scaled with the OFM.  Contours
              may also be drawn.
  KNTR........Make a grey-scale plot scaled with the OFM.  Contours
              and polarization vectors can also be drawn.
  LWPLA.......Convert a plot file to PostScript for saving and/or
              printing.  The OFM is used to convert grey scales.
  PCNTR.......Make a grey-scale plot scaled with the OFM.  Contours
              and polarization vectors are also drawn.
  PLAYR.......Task to load one or two images and play with them on the
              TV.  OFMFILE is the name of a file to be fetched, saved,
              and/or deleted.  Can be changed interactively.

EXPLAIN SECTION

The AIPSOFM files provided are

Black & white ones:

BLACK      Just as it says - all 0 or black
EYEBW      The eye perceives this as linear
FOTOBW     Actually linear
GREY01W    1 step wedge
GREY02W    2 step wedges
GREY04A    4 discreet levels.
GREY04B    8 discreet levels, alternating brighter and darker.
GREY04C    16 discreet levels in sets of 4, increasing between sets,
           decreasing within each set
GREY04D    32 discreet levels in sets of 8, increasing between sets,
           decreasing within each set
GREY04W    4 step wedges.
GREY08A    8 discreet levels.
GREY08B    16 discreet levels, alternating brighter and darker.
GREY08C    32 discreet levels in sets of 4, increasing between sets,
           decreasing within each set
GREY08W    8 step wedges.
GREY16A    16 discreet levels.
GREY16B    32 discreet levels, alternating brighter and darker.
GREY16W    16 step wedges.
GREY32A    32 discreet levels
GREY32W    32 step wedges.
GREY64W    64 step wedges.
GREY128W   Many discreet levels alternating brighter and darker, both
           getting brighter as the level increases
GREY256    Continuous single wedge.
GREYLOGA   4 discreet steps increasing logarithmicly
GREYLOGB   4 discreet steps increasing logarithmicly
GREYLOGC   4 discreet steps increasing logarithmicly
GREYLOGD   4 discreet steps increasing logarithmicly
WHITE      All white
ZERO       See BLACK

Color ones

CIRCLE     Circle of colors Blue, red, orange, green, blue
CIRCLE2    As CIRCLE but 2 circles
COLOUR16   16 blended steps of color also getting brighter
COLOUR8    8 blended steps of color all fairly bright
COLWED16   16 step wedges in different colors
COLWED8    8 step wedges in different colors
COMB2152   Blue, greens, purple, reds, yellow, white in blended steps
DEMO3      Similar to the previous in fewer steps
ROB1       Like COMB2152 with varying levels at which steps come in.
ROB2       Like COMB2152 with varying levels at which steps come in.
ROB3       Like COMB2152 with varying levels at which steps come in.
ROB4       Like COMB2152 with varying levels at which steps come in.
RAINBOW    Smooth rainbow of colors from blue to red
STEP8      8 steps of color - basic AIPS TVFIDDLE set
STEPS8     8 steps of color - TVPSEUDO button C 3 times
STEP10     10 steps of color - TVPSEUDO button C 2 times
STEP64     64 steps of color in a rainbow - TVPSEUDO button C 4 times
RYPHLAME   Red -> yellow -> white flame       1st color of TVPHLAME
GCPHLAME   Green -> cyan -> white flame       2nd color of TVPHLAME
BPPHLAME   Blue -> purple -> white flame      3rd color of TVPHLAME
BPHLAME    Dark -> light blue -> white flame  4th color of TVPHLAME
GYPHLAME   Green -> yellow -> white flame     5th color of TVPHLAME
RPPHLAME   Red -> purple -> white flame       6th color of TVPHLAME

New (2025) color ones: descriptions are similar but each one is
different

ALGAE      Dark green to white
AMBER      Dark red to yellow-white
ARAUCARI   Dark purple to white
CERADO     Dark red to white
CETCBL4    Dark yellow-green to white
CIVIDIS    Blue from fairly dark to light yellow
CREST      Blue from fairly dark to light
ECLIPSE    Dark blue to yellow-white
ECTD1      Blue to white in middle to red
FLAMINGO   Dark red through pink to white
FLARE      Dark purple to light red
FREEZE     Dark purple through blue to white
ICEFIRE    Light blue to center dark through red to almost white
INFERNO    Dark purple through red, yellow, white
LAJOLLA    Dark red through yellow to white
MAGMA      Dark purple through red, yellow, white
MAKO       Blue from fairly dark to light
OXY        Dark red through yellow to white
PANTANAL   Dark red to blue to green to white
PARULA     Dark purple to green to light yellow
PLASMA     Dark purple through red, yellow, white
RAIN       Dark blue through blue-green to white
ROCKET     Dark red to white
TROPICAL   Bright purple, red, yellow, green, blue
TURBID     Dark brown to yellow-white
TURBO      Smooth rainbow of colors from blue to red
TWILIGHT   Light blue to center dark through red to almost white
VIRIDIS    Dark purple hrough blue, green, to light yellow
VLAG       Light blue through white to red


AIPS