AIPS HELP file for DOCOLOR in 31DEC26

As of Fri Jan 16 17:28:34 2026

HELP SECTION

DOCOLOR
Type:     Adverb   (Scalar - generally logical)
Use:      Plot programs draw lines and symbols of different
          categories.  They are also able to draw "dark" as well as
          "bright" versions of these line/symbol categories.  The dark
          ones are normally drawn to provide contrast when the
          background grey-scale image is strong.  DOCOLOR is used to
          control whether these different categories are converted to
          colors, usually using the the PLCOLORS adverb.

          DOCOLOR is also used to instruct programs whether to convert
          an image with an RGB axis to a true-color image.  Such image
          may be build with MCUBE using PUTHEAD to create the RGB
          axis.  Tasks RGBMP, TVHUI, and LAYER also create such RGB
          cubes.
Tasks:
   GREYS.........Plots grey-scale with contours and special box and
                 slice marks.  Can make 3 images into true color as well
                 as using the RGB axis of a cube.
   KNTR..........Plots grey-scale, contours, polarization vectors in one
                 or more panels with a smooth contouring algorithm.
   LAYER.........Task to create an RGB image from multiple images.
                 DOCOLOR > 0 => PLCOLORS is used to color absorption.
   LWPLA.........Convert a plot file to PostScript for saving and/or
                 printing.  When DOCOLOR is > 0, the PLCOLORS adverb
                 controls the coloring of the 4 bright and 4 dark line
                 types plus the external characters and the overall
                 background.
   PCNTR.........Plots grey-scale, contours, polarization vectors.
   PLOTR.........Basic task to generate a plot file from text input.
                 DOCOLOR > 0 => a color input column is used to color
                 the data samples.
Procedures:
   BASFIT........Fits antenna locations from SN-table data.  DOCOLOR
                 controls how the plots are made.  > 0 -> do some
                 overplotting with color separating IFs, polarizations,
                 and antennas.
   DEFCOLOR......Sets adverb PLCOLORS to match a default XAS TV.
                 DOCOLOR set to 1.
   OKCOLORS......Sets adverb PLCOLORS to use less ink (white
                 background).  DOCOLOR set to 1.
   TVCOLORS......Sets adverb PLCOLORS to match current TV usage.
                 DOCOLOR set to 1.

EXPLAIN SECTION