AIPS HELP file for QBEAM in 31DEC25

As of Wed Mar 26 16:01:06 2025

INPUTS

OUTNAME                            Save beam image if not blank
OUTSEQ             0.0     9999.0  Output file name (seq. #)
OUTDISK                            Output file disk unit #
INFILE                             Input data file
RADIUS                             Accept data only < RADIUS
                                      in arc min    0 -> large
CUTOFF            -1.0             Accept data only > CUTOFF
DOPLOT                             Bit pattern:
                                   1 -> make contour plots
                                   2 -> make IRING plots
DOTV             -1.0       1.0    > 0 Do plot on the TV, else
                                   make a plot file if OUTNAME
                                   is not blank
GRCHAN            0.0       8.0    Graphics channel 0 => 1.
BADDISK           0.0     9999.0   Disks to avoid for scratch

HELP SECTION

QBEAM
Type: Task
Use:  Make a contour display of raster scan beam data and output an
      interpolated image thereof.  It is similar to PBEAM but without
      the least squares fitting.  This is likely to be used for Q, U,
      and V data while PBEAM will be used to fit RR, LL, VV, HH, or
      I polarization data.  The data will be normalized to a peak of
      1.0.
Adverbs:
  OUTNAME....Output image file name (name).  If not blank, output
             images will be made of the data.  If DOTV <= 0,
             OUTNAME must be set and the plot of the image will be
             attached to the image file.  If OUTNAME is blank, DOTV
             will be forced to true.
  OUTSEQ.....Output UV file name (seq. #).    0 => highest.
  OUTDISK....Disk drive # of output UV file.  0 => any.
  INFILE.....Input file with the raster scanned beam data for one
             polarization.  The accepted format is that used by UVHOL.
             Lines starting with '#!' are headers, and contain a
             variety of information.  The lines beginning '#! RefAnt'
             are particularly inportant and should not be altered from
             those provided by UVHOL.  They give reference antenna,
             antenna number, Stokes and frequency for the following
             beam data. The data lines have a free format giving X, Y,
             Amplitude, and Phase.
  DOPLOT.....Controls whether plots are done:
             DOPLOT = 1,3,5,7, 9, 11, 13, 15 -> make contour plots
                          of each image (data, model, residual)
             DOPLOT = 2,3,6,7, 10,11, 14, 15 -> make a plot of the
                          model and data versus radius
             DOPLOT = 4,5,6,7, 12, 13, 14, 15 -> make IRING-like
                           plots comparing data and model with average
                           beam in ring and sum of beam values inside
                           ring  from the images
             DOPLOT = 8,9,10,11,12,13,14,15 -> make plots of the
                           IRING-like average in each ring and sum
                           interior from the difference image and of
                           the difference IRING divided by the model
                           IRING.
  DOTV.......> 0 Do plot on the TV.
  GRCHAN.....Graphics channel 0 => use channels 1,2,3,4 which allows
             color to separate things being plotted.  Labels go in 1
             (usually yellow), contours and the IRING connecting line
             go in 2 (usually green), data IRING X's go in 4 (usually
             cyan), and model IRING plus signs go in 3 (usually pink).
  BADDISK....A list of disks on which scratch files are not to
             be placed.  This will not affect the output file.

EXPLAIN SECTION