AIPS HELP file for VLBRF in 31DEC22
As of Sat Dec 2 9:11:34 2023
VLBRF: Plots spectral statistics of a subset of a uv data set
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 #
SOURCES Source name
QUAL -10.0 Calibrator qualifier -1=>all
CALCODE Calibrator code ' '=>all
TIMERANG Time range to include
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
FLAGVER Flag table version
SMOOTH Smoothing function. See
HELP SMOOTH for details.
DOALL > 0 get max/min over time
<=0 max/min compares RR
and LL only.
DOSCAN > 0 do stats on each scan
then do averages
<= 0 do stats over all
OUTFILE Printed output file
DOPLOT -1.0 > 0 Make plots = 2 omit mean
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
(3) > 0 -> label x with
channels not frequency
FACTOR Scale points by abs(FACTOR)
< 0 -> points
DOTV > 0 -> plot on TV, else make
a plot file
GRCHAN > 0 -> use one graphics chan
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
Task: This task reeads calibrated autocorrelation data to determine
This task is based on VBRFI but does the statistical portion
as a median and MAD over all times on a per channel basis.
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.
SOURCES....Source to be included. ' '=> all; if any starts with a
'-' then all except ANY source named.
QUAL.......Qualifier of source to be included. -1 => all.
CALCODE....Calibrator code of sources to include. ' '=> all.
TIMERANG...Time range of the data to be included. In order:
Start day, hour, min. sec, end day, hour, min. sec.
Days relative to reference date.
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
FLAGVER....specifies the version of the flagging table to be applied.
0 => highest numbered table.
<0 => no flagging to be applied.
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 VLBRF. VBPLT will allow later
smoothing if desired from plots.
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
DOALL......> 0 => the max and min of the autocorrelation spectrum
are computed using individual times and
<= 0 => the max and min of the autocorrelation are done
over the time average (median) and so compares
RR and LL only.
DOSCAN.....> 0 => compute the median and MAD/median on a per scan
basis and then average them together
<= 0 => compute the median and MAD/median over all data
lumped together (all times and sources)
OUTFILE....Text file for detailed RFI report
DOPLOT.....> 0 -> make plots of the RFI spectra, following adverbs
apply. NOTE: if OUTFILE=' ' and DOPLOT<=0, nothing comes
out of this task. If DOPLOT >= 2.0, the mean plot line
is not plotted. Note that if the mean is exactly the
average of the max and min, the line is also not plotted.
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
If APARM(3) > 0, the X axis is labeled with spectral
channels rather than frequency.
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).
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.
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