AIPS NRAO AIPS HELP file for SNPLT in 31DEC25



As of Wed Dec 11 8:58:00 2024


SNPLT: Plots selected contents of an SN, SY, TY, PC, or CL file

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 'SN','SY','TY','PC',
                                      or 'CL'
INVERS                             Input table file version no.
SOURCES                            Source list
QUAL            -10.0              Source qualifier -1=>all
TIMERANG                           Time range to plot
STOKES                             Stokes type to plot: R, L,
                                      RR, LL, RRLL, DIFF, RATO
                                      V, H, VV, HH, VVHH
SELBAND                            Bandwidth to plot (kHz)
SELFREQ                            Frequency to plot (MHz)
FREQID                             Freq. ID to plot, -1=>all
SUBARRAY         -1.0              Limit to subarray; 0 -> 1
                                      -1 -> all
BIF               0.0      100.0   First IF to plot, 0=>1.
EIF               0.0      100.0   Last IF to plot 0 -> highest
ANTENNAS                           Antennas to plot 0=>all
PIXRANGE                           Range to plot: 0 => self
                                   scale each antenna separately
NPLOTS            0.0      28.0    Number of plots per page
XINC              0.0     5000.0   Plot every XINC'th point
OPTYPE                             Data to be plotted:
                                   'PHAS','AMP ','DELA','RATE',
                                   'TSYS','SUM ','DOPL','SNR ',
                                   'MDEL','TANT','ATM ','GEO ',
                                   'CCAL','DDLY','REAL','IMAG',
                                   'IFR ','PDIF','PSUM','PGN ',
                                   'PON ','POFF','PSYS','PDGN',
                                   'PSGN','POWR','PODB','RPHS'
                                   'RDLY', 'MULT'   ' '=phase
REFANT                             New reference antenna for
                                   'RPHS', 'RDLY'
OPCODE                             Type of plot:
                                   'IFDF' => diff BIF and EIF
                                   'IFRA' => ratio BIF and EIF
                                   'ALIF' => combine all IFs
                                   'ALST' => combine all Stokes
                                   'ALSI' => all IFs & Stokes
APARM                              MULT only: types to plot
BPARM                              MULT only: corresponding
                                      minimum for each plot
CPARM                              MULT only: corresponding
                                      maximum for each plot
DO3COLOR         -1.0        2.0   > 0 use 3-color symbols for
                                   ALIF, ALST, ALSI OPCODEs and
                                   SUM OPTYPE.
                                   DO3COL=2 => color by source
BCOUNT                             If INEXT ='PC' and OPTYPE =
                                   'AMP' or 'PHAS, BCOUNT
                                   specifies the phase cal tone
                                   number to be plotted. 0->1.
XAXIS                              Variable data is to be
                                   plotted against, 0=>time.
SYMBOL          0.0        24.0    Plot symbol number: 1 - 24
FACTOR        -10.0        10.0    Scale plot symbols by FACTOR
                                   <0 => connect points too
DOBLANK        -1.0        24.0    > 0, show blanked values with
                                   symbol type DOBLANK
CUTOFF                             Table weights <= CUTOFF will
                                   not be plotted, flagged data
                                   are not plotted.
DOSCAN         -1.0         2.0    = 1 -> plot full boundaries
                                   = 2 -> plot ticks at scans
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        88.0    Main graphics channel
                                      + 10 * label graphics chan
XYRATIO         0.0                X/Y ratio 0 -> fit TV or 1 PL

HELP SECTION

SNPLT
Type:  Task
Use:   Plots selected calibration data versus time from a specified SN,
       TY, PC or CL table.

       To examine SN or CL tables with a new reference antenna, run
       SNREF with DOKEEP=1 and then use SNPLT.

       NOTE: FILLM and FITLD used to fill VLA and VLBA (resp) data
       with CL tables having weight 0.  These "data" (actually just
       (1,0) for (real,imag) gain) are "flagged" and that may be the
       reason for a failure to find any data to plot.  Of course, you
       are wasting time looking at (1,0)'s.  CL tables with
       interesting values in them will not be flagged in this way.
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......'SN','TY, 'PC', 'SY', or 'CL' table to be plotted
  INVERS.....Version number of table to plot, 0=>highest no.
  SOURCES....Source list.  '*' = all; a "-" before a source name means
             all except ANY source named.
  QUAL.......Only sources with a source qualifier number in the SU table
             matching QUAL will be used if QUAL is not -1.
  TIMERANG...Time range of the data to be plotted. In order: Start day,
             hour, min. sec, end day, hour, min. sec. Days relative to
             reference date.  If a start and stop time are given and
             the XAXIS is 1 (time), then all plots will be from the
             given start time to the given stop time.  Otherwise, the
             X-axis is plotted over the range of X values found in the
             data.  All plots in a given execution will be on the same
             X scale in any case.
  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
             'DIFF' = vector difference between RCP and LCP or between
                 VLP and HLP.  Thus, if OPTYPE='AMP', the result will
                 not be zero even when both polarizations have the
                 same amplitude if the phases differ.
             'RATO' = ratio between RCP and LCP or VLP and HLP - done
                 for amplitudes, system and antenna temperatures, and
                 SNRs only.
  SELBAND....Bandwidth of data to be selected.  If more than one IF is
             present SELBAND is the width of the first IF required.
             Units = kHz.
  SELFREQ....Frequency of data to be selected. If more than one IF is
             present SELFREQ is the frequency of the first IF required.
             Units = MHz.
  FREQID.....Frequency identifier to select (you may determine which is
             applicable from the OPTYPE='SCAN' listing produced by
             LISTR).  If either SELBAND or SELFREQ are set, their values
             overide that of FREQID.  However, setting SELBAND and
             SELFREQ may result in an ambiguity.  In that case, the task
             will request that you use FREQID.  -1 => all, 0 => first
  SUBARRAY...Limit display to specific subarray.  -1 -> all, 0 -> 1.
  BIF........First IF IF to plot
  EIF........Last IF to plot.
             If OPCODE = 'IFDF'/'IFRA' will plot difference/ratio of
             specified quantity between BIF and EIF.
  ANTENNAS...A list of the antennas to be plotted. All 0 => all.  If any
             number is negative then all antennas listed are NOT to be
             plotted and all others are.
  PIXRANGE...If PIXR(1) < PIXR(2), all plots will be from PIXR(1) to
             PIXR(2).  Otherwise each plot will be self-scaling.
  NPLOTS.....Number of antennas to plot per page (try 5).
  XINC.......Plot every XINC'th point, 0 => 1.
  OPTYPE.....Data to be plotted:
             1.  'PHAS' = phase,
             2.  'AMP ' = amplitude,
             3.  'DELA' = singleband delay (SN & CL)
             4.  'RATE' = rate (SN, CL & PC)
             5.  'TSYS' = sys. temp. (TY)  (for VLA is nominal
                          sensitivity)
             6.  'SUM ' = all ampl. and all phases on a single plot.
                          PIXRANGE controls amplitude scaling  and
                          phases are auto scaled.
             7.  'DOPL' = doppler offset (CL)
             8.  'SNR'  = signal/noise (SN & CL)
             9.  'MDEL' = multiband delay (SN & CL)
             10. 'TANT' = ant. temp. (TY)  (for VLA either back- or
                          front-end system temperature)
             11. 'ATM'  = atm. delay (CL)
             12. 'GEO'  = geometric delay (CL)
             13. 'CCAL' = cable cal (PC)
             14. 'DDLY' = dispersive delay (SN & CL)
             15. 'REAL' = real part
             16. 'IMAG' = imag part
             17. 'IFR ' = Ionospheric Faraday rotation (affects pol
                          cal) (SN & CL)
             18. 'PDIF' = EVLA Gb * (Pon - Poff)  (SY)
             19. 'PSUM' = EVLA Gb * (Pon + Poff)  (SY)
             20. 'PGN ' = EVLA post sync-detector gain = Gb   (SY)
             21. 'PON ' = EVLA Pon  (noise tube on) (SY)
             22. 'POFF' = EVLA Poff  (noise tube off) (SY)
                          Note that PON and POFF give numbers smaller
                          than PDIF and PSUM by the factor Gb which
                          is, by default, 512 and usually ranges in
                          the 400's when it has been set.
             23. 'PSYS' = EVLA PSUM/PDIF/2 * Tcal (=Tsys) (SY)
                          uses values from the CD table
             24  'PDGN' = EVLA Pdif / (4096 * Pgain * Pgain)
             25  'PSGN' = EVLA Psum / (4096 * Pgain * Pgain)
             26. 'POWR' = (1/Gain amp)^2
             27. 'PODB' = Log10 (1/Gain amp)^2
             '    ' => 'PHAS'
                 'RPHS' = plot phase re-referenced to REFANT
                 'RDLY' = plot delay re-referenced to REFANT
               . 'MULT' => plot multiple types as listed in APARM
                           using the type numbers given above.
  OPCODE.....Type of plot:
             'IFDF' => will plot differences between IF's of OPTYPE
                    data, i.e. if OPCODE= 'IFDF', OPTYPE ='DELA' and
                    BIF = 3, EIF = 6, will plot delay difference
                    between IF's 3 and 6.
             'IFRA' = ratio between IF's BIF and EIF - done for
                    amplitudes, system and antenna temperatures, and
                    SNRs only.  Changes to IFDF for others.
             'ALIF' => will plot OPTYPE data for all IFs (BIF through
                    EIF) on a single plot (antennas and polarizations
                    are plotted separately).
             'ALST' => will plot OPTYPE data for both polarizations (R
                    and L) on a single plot (antennas and IFs are
                    plotted separately).
             'ALSI' => will plot OPTYPE data for both polarizations (R
                    and L) and all IFs (BIF through EIF) on a single
                    plot (antennas are plotted separately).
             other  => will plot each request polarization, each
                    requested IF and each each requested antenna
                    individually looping in that order.
  APARM......OPTYPE = 'MULT' only: Up to 10 types to be plotted.  They
             are identified by the numbers given in the OPTYPE
             section.  Note that all requested types must be present
             in the same extension file.  Asking for delay and Psys
             will cause the task to quit.
  BPARM......Corresponding minima of each plotted type.
  CPARM......Corresponding maxima of each plotted type. 0's =>
             self-scale.
  DO3COLOR...<= 0 => use line type 4 for all points plotted.
             > 0 => use 3-color to separate IFs and Stokes in the
                 ALIF, ALST, ALSI modes.    The actual logic is:
                    COLOR = 0
                    DO IF = BIF,EIF
                       DO POL = 1,Npol
                       set and use COLOR
                       COLOR = COLOR + DeltaColor
                       END DO POL
                    END DO IF
                 where COLOR=0 is pure red, DeltaColor is set so that
                 the last value of COLOR is 0.97 which is almost pure
                 blue.  Thus, if there are 4 IFs and one polarization,
                 the plot will be of red, yellow, cyan, and blue for
                 IFs 1 through 4, resp.  If there are 2 IFs and 2
                 polarizations (RR and LL say) in the panel, then red
                 is RR in IF 1, yellow is LL in IF 1, cyan is RR in IF
                 2, and blue is LL in IF 2. Note that the blue is
                 plotted after the red and so may overlap and obscure
                 the red.
             DO3COL = 2 tells SNPLT to separate the plotted points
                 with color representing source.  The list of source
                 numbers actually occurring in the table, time range,
                 source list, et al. is translated into consecutive
                 integers (in the same order) and then assigned red
                 through dark blue.  Thus source numbers 1,2,5,10
                 become red, yellow, cyan, and blue, resp. no matter
                 what order they appear in the table.
  BCOUNT.....If INEXT ='PC', and OPTYPE = 'AMP' or 'PHAS' then BCOUNT
             specifies the phase cal tone number to be plotted. 0 -> 1.
  XAXIS......Variable data is to be plotted against. 0=> 1
              (1) = Data label time
              (2) = Antenna elevation
              (3) = Hour angle
              (4) = Local Sidereal Time
              (5) = Parallactic angle
              (6) = Antenna azimuth
                      Moving sources are supported for XAXIS 2-6 if a
                      PO table is attached.
  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.
  DOBLANK....> 0 => plot blanked solutions with a symbol of type
             DOBLANK (see symbol types above).  They will be plotted
             along the lower edge of each plot.  NOTE: if DOTV true
             and GRCHAN 0 and DO3COL <= 0, then the blanked samples
             will be in the color of graphics channel 3 (pink) and the
             good samples in the color of graphics channel 4 (blue).
             DOBLANK > 0 is forced to be different than SYMBOL by
             adding 1.
  CUTOFF.....If >= 0, the task will examine the weight column of the
             table and if the weight <= CUTOFF, the task will not plot
             that sample.  If = 0, will plot all good points; flagged
             data are not plotted.  CUTOFF is ignored for TY and PC
             tables and OPTYPEs MDEL, ATM, GEO, and CCAL.
  DOSCAN.....> 0 => plot scan boundaries when there is an NX table and
             the X axis is time.  The boundary is a tick mark when
             DOSCAN=2 and a full line when DOSCAN=1.
             <= 0 -> do not plot boundaries.
  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.  To specify a channel to be used for plot labels
             add 10 * that graphics channel number.  If the label
             channel is zero, it is set to GRCHAN.  See HELP GRCHAN
             for additional discussion.
  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