AIPS NRAO AIPS HELP file for PCPLT in 31DEC18



As of Wed Oct 17 5:58:45 2018


PCPLT: Plots pulse-cal tables as profiles wrt time or antenna

INPUTS

USERID                             User number _ ignored
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 #
INEXT                              'PC'
INVERS            0.0              Table version to plot
FREQID            0.0              Frequency ID code to plot.
SUBARRAY          0.0              Subarray to plot; 0 => 1
TIMERANG                           Range of times to include
                                   T2 < T1 => plot T2 -> T1 but
                                   average all times
BCHAN            -1.0     8192.0   Lowest channel plotted
ECHAN             0.0     8192.0   Highest channel plotted
BIF               0.0       90.0   Lowest IF plotted
EIF               0.0       90.0   Highest IF plotted
STOKES                             'R...', 'L...', else both
ANTENNAS                           Include these antennas only
                                   0 => all; < 0 exclude list
CODETYPE                           'AMP ','PHAS','REAL','IMAG',
                                   'DIFA','DIFP','DIFR','DIFI',
                                   'ADIF','PDIF'
DOCALIB                            > 0 -> calibrate the delays
                                     and remove them from phases
SORT                               'TA', other => 'AT'
PIXRANGE                           Clip at these intensities.
                                   0,0=> map min, max.
                                   PIXR(2) < PIXR(1) -> each
                                   panel self scales
FACTOR          0.0                Scale each profile from the
                                   default by FACTOR
DO3COL         -1.0         2.0    3-color lines: 0 no, 1 yes
                                   to separate time/antenna,
                                   2 to distinguish intensity
LTYPE        -410.0       410.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.
XYRATIO         0.0                X/Y ratio 0 -> fit TV or 1 PL
BADDISK                            Disks to avoid for scratch

HELP SECTION

PCPLT
Type:  Task
Use:   To create one or more plots (on the TV or plot files) of the
       selected pulse-cal 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 PC table
       and selected by the adverbs.

       Pulse-cal amplitude, phase, or residual phase may be displayed.
       Residual phase is that phase remaining after on-the-fly fitting
       of a delay and phase to each IF in each time and antenna
       sample.  Computation of the residual is requested with adverb
       DOCALIB and display of residuals is requested by the various
       CODETYPEs.

Adverbs:
  USERID.....Input file user number.  Ignored
  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.
  INEXT......table type ignored, 'PC' always used
  INVERS.....Specifies the version of the PC 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.  T1 = T2 => plot and average all times.
             T1 < T2 => average over T1 through T2 and plot T1 through
             T2; T1 > T2 => average all times but plot only T2 through
             T1.
  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.  If two Stokes are present, 'I' will plot
             (R+L)/2 and 'V' will plot (R-L)/2 for PC tables only.
  ANTENNAS...A list of antennas to be included.  all 0 => include all
             If any in the list is negative, then include all antennas
             except and that appear (in absolute value) in the list.
             Thus ANTEN = 3,-5,7 inlcudes all antennas except 3, 5,
             and 7.
  CODETYPE...'AMP ' to plot the amplitude of the pulse-cal spectrum.
             'PHAS' to plot the phase of the pulse-cal spectrum.
             'REAL' to plot the real part of the pulse-cal spectrum.
             'IMAG' to plot the imaginary part of the pulse-cal
                    spectrum.
             'DIFA' to plot the amplitude of the vector difference
                    between the current pulse-cal spectrum and the
                    average pulse-cal spectrum for the selected time
                    or antenna
             'DIFP' to plot the phase of the vector difference between
                    the current pulse-cal spectrum and the average
                    pulse-cal spectrum for the selected time or
                    antenna
             'DIFR' to plot the real part of the vector difference
                    between the current pulse-cal spectrum and the
                    average pulse-cal spectrum for the selected time
                    or antenna
             'DIFI' to plot the imaginary part of the vector
                    difference between the current pulse-cal spectrum
                    and the average pulse-cal spectrum for the
                    selected time or antenna
             'ADIF' to plot the difference in the amplitude of the
                    current pulse-cal spectrum and the average
                    pulse-cal spectrum for the selected time or
                    antenna.
             'PDIF' to plot the difference in the phase of the current
                    pulse-cal spectrum and the average pulse-cal
                    spectrum for the selected time or antenna.
             The average pulse-cal spectrum is done with a scalar
             average for amplitudes and a vector average for phases.
  DOCALIB....> 0 -> attempt to fit the data for a delay and phasee in
                    each IF and polarization and subtract the
                    calibration from the observed phases before
                    plotting.
  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.
             If PIXRANGE(2) < PIXRANGE(1), each small plot will be
             self-scaled within its own plot area.  Else all small
             plots share the same scaling (which is frequently what
             you will actually want).
             Note that phase is initially computed in the range -180
             to 180 degrees, but will be plotted in the range 0 to 360
             if specified as such.  In self-scaled phase plots, the
             plot with the smaller total range of those two
             possibilities is used.  Values > 360 or < -180 are not
             available.
  FACTOR.....Controls the plot scale for each profile.
  DO3COLOR...<= 0 => use a single line drawing color (TYPE 2).
             =1 => the various pulse-cal spectra drawn are in a
                range of colors from blue for the first spectrum
                plotted (at the bottom) to red for the last spectrum
                plotted (at the top).. Color distinguishes antenna
                when SORT='TA' and distinguishes times otherwise.
             =2 => use color as an additional separator of intensity.
                The intensity range is assigned colors from blue at
                the lowest value to red at the highest.  Each point on
                the plot gets the color appropriate to its intensity.
             These color options allow the drawings to be more crowded
             and still somewhat distinguishable.
  LTYPE......Labelling type, see HELP LTYPE for details:
             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.
             Add n * 100 to alter the metric scaling.
  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.
  XYRATIO....Scale the X axis longer than the Y by XYRATIO.
             If DOTV >  0, 0 -> fit to the TV window
             If DOTV <= 0, 0 -> 1.
  BADDISK....The disk numbers to avoid for scratch files (sorting
             tables mostly).

EXPLAIN SECTION


AIPS