AIPS NRAO AIPS HELP file for PDPLT in 31DEC25



As of Tue Dec 10 3:46:56 2024


PDPLT: Plots selected contents of a PD table

INPUTS

INNAME                             UV data (name).
INCLASS                            UV data (class).
INSEQ             0.0    9999.0    UV data (seq. #).  0 => high
INDISK            0.0       9.0    Disk unit #.  0 => any
INEXT                              Input 'PD'
INVERS                             Input table file version no.
IN2NAME                            UV data (name). comparison
IN2CLASS                           UV data (class).
IN2SEQ            0.0    9999.0    UV data (seq. #).  0 => high
IN2DISK           0.0       9.0    Disk unit #.  0 => any
IN2VERS                            Input table file version no.
IN3NAME                            UV data (name). comparison
IN3CLASS                           UV data (class).
IN3SEQ            0.0    9999.0    UV data (seq. #).  0 => high
IN3DISK           0.0       9.0    Disk unit #.  0 => any
IN3VERS                            Input table file version no.
IN4NAME                            UV data (name). comparison
IN4CLASS                           UV data (class).
IN4SEQ            0.0    9999.0    UV data (seq. #).  0 => high
IN4DISK           0.0       9.0    Disk unit #.  0 => any
IN4VERS                            Input table file version no.
ANTENNAS                           Antennas from INNAME
BPARM                              Antennas from IN2NAME
CPARM                              Antennas from IN3NAME
DPARM                              Antennas from IN4NAME
FREQID                             Freq. ID to plot, -1=>all
SUBARRAY         -1.0              Limit to subarray; 0 -> 1
                                      -1 -> all
STOKES                             Stokes type to plot:
                                      R, L, RR, LL, RRLL,
                                      V, H, VV, HH, VVHH
BIF               0.0      100.0   First IF to plot, 0=>1.
EIF               0.0      100.0   Last IF to plot 0 -> highest
BCHAN             0.0              Min channel to plot
ECHAN             0.0              Max channel to plot
OPTYPE                             Data to be plotted:
                                   'PHAS','AMP ','A&P'
PIXRANGE                           Range to plot: 0 => self
                                   scale each antenna separately
APARM                              (1,2) Phase plot range A&P
                                   (3) > 0 label with frequency
                                   (4) > 0 omit IF dividers
OVERLAP                            > 0 => plot all antennas on
                                       one plot
DO3COLOR         -1.0        2.0   > 0 use 3-color symbols to
                                   separate antennas
SYMBOL          0.0        24.0    Plot symbol number: 1 - 24
FACTOR        -10.0        10.0    Scale plot symbols by FACTOR
                                   <0 => connect points too
LTYPE        -410.0       410.0    Type of labeling: 1 border,
                                   2 no ticks, 3 - 6 standard,
                                   7 - 10 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
XYRATIO         0.0                X/Y ratio 0 -> fit TV or 1 PL

HELP SECTION

PDPLT
Type:  Task
Use:   Plots selected data versus frequency from a PD (spectral
       polarization D term) table.
Adverbs:
  INNAME.....UV file name (name).       Standard defaults.
  INCLASS....UV file name (class).      Standard defaults.
  INSEQ......UV file name (seq. #).     0 => highest.
  INDISK.....Disk unit #.               0 => any.
  INEXT......'PD' is assumed for now
  INVERS.....Version number of table to plot, 0=>highest no.
  IN2NAME....UV file name (name).       Standard defaults.
                Fill the 2 adverbs only if you want to compare
                two different PD tables.
  IN2CLASS...UV file name (class).      Standard defaults.
  IN2SEQ.....UV file name (seq. #).     0 => highest.
  IN2DISK....Disk unit #.               0 => any.
  IN2VERS....Version number of table to plot, 0=>highest no.
  IN3NAME....UV file name (name).       Standard defaults.
                Fill the 3 adverbs only if you want to compare
                three different PD tables.
  IN3CLASS...UV file name (class).      Standard defaults.
  IN3SEQ.....UV file name (seq. #).     0 => highest.
  IN3DISK....Disk unit #.               0 => any.
  IN3VERS....Version number of table to plot, 0=>highest no.
  IN4NAME....UV file name (name).       Standard defaults.
                Fill the 4 adverbs only if you want to compare
                four different PD tables.
  IN4CLASS...UV file name (class).      Standard defaults.
  IN4SEQ.....UV file name (seq. #).     0 => highest.
  IN4DISK....Disk unit #.               0 => any.
  IN4VERS....Version number of table to plot, 0=>highest no.
  ANTENNAS...A list of the antennas to be plotted. All 0 => all.
             (The use of negative to omit is not done in this task.)
             These antenna numbers apply to the first data set.
  BPARM......A list of antenna numbers in the second data set where
             BPARM(i) corresponds to ANTENNAS(i).  If BPARM(1) is
             zero, ANTENNAS is used for the second data set.
  CPARM......A list of antenna numbers in the third data set where
             CPARM(i) corresponds to ANTENNAS(i).  If CPARM(1) is
             zero, ANTENNAS is used for the third data set.
  DPARM......A list of antenna numbers in the fourth data set where
             DPARM(i) corresponds to ANTENNAS(i).  If DPARM(1) is
             zero, ANTENNAS is used for the fourth data set.
  FREQID.....Frequency identifier to select (you may determine which is
             applicable from a PRTAB on the PD table)
  SUBARRAY...Limit display to specific subarray.  0 -> 1.
  STOKES.....The desired Stokes type of the displayed data:
             'R' = RCP, 'L' = LCP, 'RL' or 'RRLL' both RCP and LCP
             'V' = VLP, 'H' = HLP, 'VH' or 'VVHH' both VLP and HLP
  BIF........First IF IF to plot
  EIF........Last IF to plot.
  OPTYPE.....Data to be plotted:
             1.  'PHAS' = phase,
             2.  'AMP ' = amplitude,
             3.  'A&P ' = both together
  PIXRANGE...If PIXR(1) < PIXR(2), all plots will be from  PIXR(1) to
             PIXR(2) (amplitude, phase, or in A&P, amplitude).
             Otherwise each plot will be self-scaling.
  APARM......(1) For A&P, if APARM(1) < APARM(2), use these to control
                 the phase plot range.
             (3) If > 0, plot frequency labels on the x axis
                 If the 2 files have different frequencies then this
                 option is forced as is APARM(4) and no divider is
                 plotted.
             (4) If > 0, omit IF dividers.  A divider without ticks
                 will still be plotted if there is a discontinuity in
                 the frequency axis.
  DO3COLOR...<= 0 => use line type 4 for all points plotted.
             > 0 => use 3-color to separate antennas
             > 1.5 => use 3-color to separate each antenna in ANTENNAS
                      but use the same color for BPARM(i), CPARM(i),
                      and DPARM(i) as is used for ANTENNAS(i).
  SYMBOL.....Choices are:
              1: Plus sign           13: Star of David
              2: Cross (X)           14: Seven-pointed star
              3: Circle              15: Eight-pointed star
              4: Box                 16: Nine-pointed star
              5: Triangle            17: Ten-pointed star
              6: Diamond             18: 11-pointed star
              7: Pentagon            19: 12-pointed star
              8: Hexagon             20: 13-pointed star
              9: Septagon            21: 14-pointed star
              10: Octagon            22: Plus (+) with gap
              11: Nine-gon           23: Cross (X) with gap
              12: Five pointed star  24: Vertical line
  FACTOR.....Scale plot symbols by FACTOR     0 -> 1.
             If FACTOR < 0, draw lines between the points and use
             abs(FACTOR) to scale the points plotted.  To have
             no points plotted, set -0.2 <=FACTOR < 0.
  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.
             A value of 0 causes more than one graphics channel to be
             used.
  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.

EXPLAIN SECTION


AIPS