AIPS HELP file for PLRFI in 31DEC24
As of Fri Apr 26 3:28:35 2024
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,4) range of values in
plot of rms/mean
(5) > 0 -> label x with
channels not frequency
(6)-(9) > 0 => omit
corresponding plot
(10) > 0 -> flag to omit
mean or max and/or min
DOIFS > 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
GRCHAN > 0 use one graphics channel
NOT recommended
NPLOTS 0.0 9.0 Number plots/page
XYRATIO X/Y ratio - 0 -> TV or 1.4
BADDISK Disks to avoid for scratch
HELP SECTION
PLRFI
Task: This task reads the output of VBRFI or VLBRF to make plots (which
VBRFI and VLBRF could have made in the first place). Up to 100
such output files may be concatenated, however.
If GRCHAN = 0, the first plot for each antenna is a plot of the
mean autocorrelation in green, mean rms/mean in blue, and mean
rms in pink. The next three plots are the mean autocorrelation,
the mean rms, and the mean rms/mean. Pink is the maximum, green
the mean, and blue the minimum over scans and polarizations.
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(4) > APARM(3), use this range when plotting the
standard deviation. APARM(4) = 0 is like PIXR(2) = 0
to compress the plot range by omitting at most 5 percent of the
points.
If APARM(5) > 0, the X axis is labeled with spectral
channels rather than frequency.
If APARM(6) > 0, omit the first plot (all 3)
If APARM(7) > 0, omit the second plot (mean)
If APARM(8) > 0, omit the third plot (rms)
If APARM(9) > 0, omit the fourth plot (rms/mean)
APARM(10) is a mask to exclude the mean (1), min (2),
and/or max (4) curves. Thus APARM(10)=6 excludes both
max and min curves.
DOIFS......> 0 => do not separate IFs, do full X axis label
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.
GRCHAN.....> 0 -> use a specific graphics channel
0 -> use different colors for max (pink), mean (green), and
min (cyan) where the colors listed are the defaults
for graphics channels 3, 2, and 4, resp.
NPLOTS.....Number of plots / page (1 - 9).
XYRATIO....X to Y plot scale. 0 -> TV if DOTV true, 1.4 plot files.
BADDISK....The disk numbers to avoid for scratch files (sorting
tables mostly).
EXPLAIN SECTION