AIPS NRAO AIPS HELP file for PLRFI in 31DEC22



As of Fri Dec 1 12:03:13 2023


PLRFI: Plots spectral statistics from output of VBRFI

INPUTS

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 #
ANTENNAS                           Antennas to include 0=>all
BIF                                Low IF number included
EIF                                Highest IF number included
BCHAN             0.0              First channel included
ECHAN             0.0              last channel included
SMOOTH                             Smoothing function. See
                                   HELP SMOOTH for details.
INFILE                             VBRFI text file
BCOUNT                             Start number of input text
ECOUNT                             End number of input text
PIXRANGE                           Range of values in plot of
                                   mean.  =-1 for full range
                                   = 0 for most of full range
APARM                              (1,2) range of values in
                                   plot of standard deviation
                                   (as PIXRANGE)
                                   (3) > 0 -> label x with
                                   channels not frequency
                                   (4) > 0 -> do not separate
                                   IFs, label full X axis
FACTOR                             Scale points by abs(FACTOR)
                                   < 0 -> points
DOTV                               > 0 -> plot on TV, else make
                                   a plot file
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
BADDISK                            Disks to avoid for scratch

HELP SECTION

PLRFI
Task:  This task reads the output of VBRFI to make plots (which VBRFI
       could have made in the first place).  Up to 100 such output files
       may be concatenated, however.
Adverbs:
  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.
  ANTENNAS...A list of the antennas to be included.  All 0 => all.
             If any number is negative then all antennas listed are NOT
             included and all others are.
  BIF........First IF to include.  0 -> 1.
  EIF........Last IF to include.   0 -> max.
  BCHAN......First channel to include. 0=>all.
  ECHAN......Highest channel to include. 0=>all higher than BCHAN
  SMOOTH.....Specifies the type of spectral smoothing to be applied to
             a uv database . The default is not to apply any smoothing.
             SMOOTH=0 IS RECOMMENDED IN VBRFI.  VBPLT will allow later
             smoothing if desired from plots although the results will
             differ especially for the rms/mean spectra.
             The elements of SMOOTH are as follows:
             SMOOTH(1) = type of smoothing to apply: 0 => no smoothing
               To smooth before applying bandpass calibration
                 1 => Hanning, 2 => Gaussian, 3 => Boxcar, 4 => Sinc
               To smooth after applying bandpass calibration
                 5 => Hanning, 6 => Gaussian, 7 => Boxcar, 8 => Sinc
             SMOOTH(2) = the "diameter" of the function, i.e. width
               between first nulls of Hanning triangle and sinc
               function, FWHM of Gaussian, width of Boxcar. Defaults
               (if < 0.1) are 4, 2, 2 and 3 channels for SMOOTH(1) =
               1 - 4 and 5 - 8, resp.
             SMOOTH(3) = the diameter over which the convolving
               function has value - in channels.  Defaults: 1,3,1,4
               times SMOOTH(2) used when input SMOOTH(3) < net
               SMOOTH(2).
  INFILE.....Text file with detailed RFI report.  The task initially
             tries to open the file as named.  If that fails, then
             it appends a BCOUNT to the name and tries again.  NOTE: if
             ECOUNT > BCOUNT, then this form of naming is required.
  BCOUNT.....Multiple files may be read if they are named INFILE with an
             integer appended from BCOUNT to ECOUNT.  It is a good idea to
             have the files be in increasing frequency order, but is not
             required (i.e. there is likely to be overlap on occasion).
             0 -> 1.
  ECOUNT.....Highest file number.  < BCOUNT -> BCOUNT.
  PIXRANGE...Range of values in plot of mean.  <0 -> min to max
             Actually PIXR(2) <= PIXR(1) causes the plot to do the
             full range of values if PIXR(2) < 0.  PIXR(2) = 0 causes
             the plot to scale to omit up to 5 percent of the samples.  This
             often makes the plot show the remaining points much
             better.  The number of points in each IF that is omitted is
             plotted (twice) in each IF panel and printed.
  APARM......If APARM(2) > APARM(1), use this range when plotting the
             standard deviation.  APARM(2) = 0 is like PIXR(2) = 0
             to compress the plot range by omitting at most 5 percent of the
             points.
             If APARM(3) > 0, the X axis is labeled with spectral
             channels rather than frequency.
             If you must plot the min, mean, and max spectra in the
             same color, set APARM(10) to the desired GRCHAN.
  FACTOR.....>= 0 -> Plot data with connected lines
             < 0  -> Scale plotted points by abs(FACTOR).  0 -> 1.0
  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).
  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.
  BADDISK....The disk numbers to avoid for scratch files (sorting
             tables mostly).

EXPLAIN SECTION


AIPS