; BPLOT
;---------------------------------------------------------------
;! Plots bandpass tables in 2 dimensions as function of time
;# Task SPECTRAL UV CALIBRATION PLOT
;-----------------------------------------------------------------------
;;  Copyright (C) 1996, 2003
;;  Associated Universities, Inc. Washington DC, USA.
;;
;;  This program is free software; you can redistribute it and/or
;;  modify it under the terms of the GNU General Public License as
;;  published by the Free Software Foundation; either version 2 of
;;  the License, or (at your option) any later version.
;;
;;  This program is distributed in the hope that it will be useful,
;;  but WITHOUT ANY WARRANTY; without even the implied warranty of
;;  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;;  GNU General Public License for more details.
;;
;;  You should have received a copy of the GNU General Public
;;  License along with this program; if not, write to the Free
;;  Software Foundation, Inc., 675 Massachusetts Ave, Cambridge,
;;  MA 02139, USA.
;;
;;  Correspondence concerning AIPS should be addressed as follows:
;;         Internet email: aipsmail@nrao.edu.
;;         Postal address: AIPS Project Office
;;                         National Radio Astronomy Observatory
;;                         520 Edgemont Road
;;                         Charlottesville, VA 22903-2475 USA
;-----------------------------------------------------------------------
BPLOT     LLLLLLLLLLLLUUUUUUUUUUUU CCCCCCCCCCCCCCCCCCCCCCCCCCCCC
BPLOT     Plots bandpass tables as profiles wrt time or antenna
USERID                             User number
INNAME                             Input UV file name (name)
INCLASS                            Input UV file name (class)
INSEQ             0.0     9999.0   Input UV file name (seq. #)
INDISK            0.0        9.0   Input UV file disk unit #
BPVER                              Bandpass table version
FREQID            0.0              Frequency ID code to plot.
SUBARRAY          0.0              Subarray to plot; 0 => 1
TIMERANG                           Range of times to include
BCHAN            -1.0     8192.0   Lowest channel plotted
ECHAN             0.0     8192.0   Highest channel plotted
BIF               0.0       28.0   Lowest IF plotted
EIF               0.0       28.0   Highest IF plotted
STOKES                             'R...', 'L...', else both
ANTENNAS          0.0              Include these antennas only
                                   0 => all
CODETYPE                           'AMP ', 'PHAS',
                                   'DIFA', 'DIFP', 'ADIF'
SORT                               'TA', other => 'AT'
PIXRANGE                           Clip at these intensities.
                                   0,0=> map min, max.
FACTOR          0.0                Scale each profile from the
                                   default by FACTOR
DO3COL         -1.0         1.0    Use 3-color lines?
LTYPE         -10.0        10.0    Type of labeling: 1 border,
                                   2 no ticks, 3 standard, 4 rel
                                   to center, 5 rel to subim cen
                                   6 pixels, 7-10 as 3-6 with
                                   only tick labels
                                   <0 -> no date/time
DOTV           -1.0         1.0    > 0 Do plot on the TV, else
                                   make a plot file
GRCHAN          0.0         8.0    Graphics channel 0 => 1.
----------------------------------------------------------------
BPLOT
Type:  Task
Use:   To create one or more plots (on the TV or plot files) of the
       selected bandpass table.  The plots will be a set of profiles
       separated on the vertical axis by an increment in time or antenna
       number (depending on the sort selected).  More than one plot for
       more than one antenna or more than one time may be generated.
       Multiple IFs and polarizations will be plotted along the
       horizontal axis if they are present in the BP table and selected
       by the adverbs.
Adverbs:
  USERID.....Input file user number.  0 => logon user,
             32000 => any user.
  INNAME.....Input UV file name (name).      Standard defaults.
  INCLASS....Input UV file name (class).     Standard defaults.
  INSEQ......Input UV file name (seq. #).    0 => highest.
  INDISK.....Disk drive # of input UV file.  0 => any.
  BPVER......Specifies the version of the BP table to be read as input.
             0 -> highest.
  FREQID.....Specifies which freqiency ID to plot.  0 => 1.
  SUBARRAY...The subarray number to be plotted.  0 => 1.
  TIMERANG...Time to be plotted: start day, hour, min, sec, end day,
             hour, min, sec.  0 => all.
  BCHAN......Lowest channel of a range of channels to be plotted.
             0 => 1.
  ECHAN......Highest channel number to be plotted.  0 => highest.
  BIF........Lowest IF to be plotted.  0 => 1
  EIF........Highest IF to be plotted.  0 => highest.
  STOKES.....If the first character is R or L then only that
             polarization is plotted.  Otherwise both are plotted if
             present.
  ANTENNAS...A list of antennas to be included.  0 => all.
  CODETYPE...'AMP ' to plot the amplitude of the bandpass.
             'PHAS' to plot the phase of the bandpass.
             'DIFA' to plot the amplitude of the vector difference
                    between the current bandpass and the average
                    bandpass for the selected time or antenna
             'DIFP' to plot the phase of the vector difference
                    between the current bandpass and the average
                    bandpass for the selected time or antenna
             'ADIF' to plot the difference in the amplitude of the
                    current bandpass and the average bandpass for the
                    selected time or antenna.
             The average bandpass is done with a scalar average for
             amplitudes and a vector average for phases.
  SORT.......Sort order for table.  If SORT = 'TA', then each plot will
             show all antennas at a particular time.  Otherwise, each
             plot will show all times for a particular antenna.
  PIXRANGE...Clip plotted values with PIXRANGE.  0 => self-scale with
             the max min for all solutions in the plot.
  FACTOR.....Controls the plot scale for each profile.
  DO3COL.....> 0 => the various bandpasses drawn are in a range of
             colors from red to blue.  This allows the drawings to be
             more crowded and still somewhat distinguishable.
             <= 0 => use a single line drawing color (TYPE 2).
  LTYPE......Labelling type: 1 = border, 2 = no ticks, 3 or 7 =
             standard, 4 or 8 = relative to ref. pixel, 5 or 9 =
             relative to subimage (BLC, TRC) center, 6 or 10 = pixels.
             7-10 all labels other than tick numbers and axis type are
             omitted.  Less than 0 is the same except that the plot file
             version number and create time are omitted.
  DOTV.......> 0 => plot directly on the TV device, otherwise make a
             plot file for later display on one or more devices
             (including the TV if desired).
  GRCHAN.....Graphics channel (1 - 7) to use for line drawing.  0 => 1.
----------------------------------------------------------------
