AIPS HELP file for BLPCL in 31DEC24
As of Wed Nov 13 8:00:22 2024
BLPCL: I, Q, U, V model circular polarization spectral BLCAL
INPUTS
INNAME Input UV data name (name)
INCLASS Input UV data name (class)
INSEQ 0.0 9999.0 Input UV data name (seq. #)
INDISK 0.0 9.0 Input UV data disk unit #
IN2NAME Input I model UV (name)
IN2CLASS Input I model UV (class)
IN2SEQ 0.0 9999.0 Input I model UV (seq. #)
IN2DISK 0.0 9.0 Input I model disk unit #
IN3NAME Input Q model UV (name)
IN3CLASS Input Q model UV (class)
IN3SEQ 0.0 9999.0 Input Q model UV (seq. #)
IN3DISK 0.0 9.0 Input Q model disk unit #
IN4NAME Input U model UV (name)
IN4CLASS Input U model UV (class)
IN4SEQ 0.0 9999.0 Input U model UV (seq. #)
IN4DISK 0.0 9.0 Input U model disk unit #
IN5NAME Input V model UV (name)
IN5CLASS Input V model UV (class)
IN5SEQ 0.0 9999.0 Input V model UV (seq. #)
IN5DISK 0.0 9.0 Input V model disk unit #
SRCNAME Calibration source name
SUBARRAY 0.0 Subarray, 0 => 1
DOCALIB -1.0 101.0 > 0 calibrate data & weights
> 99 do NOT calibrate weights
GAINUSE CL (or SN) table to apply
FLAGVER Flag table version
DOBAND -1.0 10.0 If >0 apply bandpass cal.
Method used depends on value
of DOBAND (see HELP file).
BPVER Bandpass table version
DOPOL -1.0 10.0 if >0 correct polarization.
PDVER PD table to apply (DOPOL>0)
SMOOTH Smoothing function. See
HELP SMOOTH for details.
OUTVERS BD table output version
-1 none, 0 new
OUTNAME Output UV data name (name)
OUTCLASS Output UV data name (class)
OUTSEQ Output UV data name (seq)
OUTDISK Output UV data disk unit #
BADDISK Disk to avoid for scratch
HELP SECTION
BLPCL
Task: This task takea an input UV data set in linear polarization and
divides by a model taken from matching I, Q, and U model data
sets. Typically, the procedure BLPOLCAL produces these from the
input data set and model images using SPLIT and UVSUB. The
tasks then sums the divided data to determine correction factors
and writes these into a BD table. Finally, it applies the
factors to the input data set writing a corrected data set
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.
IN2NAME....Input I UV model name (name). Standard defaults.
IN2CLASS...Input I UV model name (class). Standard defaults.
IN2SEQ.....Input I UV model name (seq. #). 0 => highest.
IN2DISK....Disk drive # of input I UV model. 0 => any.
IN3NAME....Input Q UV model name (name). Standard defaults.
IN3CLASS...Input Q UV model name (class). Standard defaults.
IN3SEQ.....Input Q UV model name (seq. #). 0 => highest.
IN3DISK....Disk drive # of input Q UV model. 0 => any.
IN4NAME....Input U UV model name (name). Standard defaults.
IN4CLASS...Input U UV model name (class). Standard defaults.
IN4SEQ.....Input U UV model name (seq. #). 0 => highest.
IN4DISK....Disk drive # of input U UV model. 0 => any.
IN5NAME....Input V UV model name (name). Standard defaults.
only if not blank
IN5CLASS...Input V UV model name (class). Standard defaults.
IN5SEQ.....Input V UV model name (seq. #). 0 => highest.
IN5DISK....Disk drive # of input V UV model. 0 => any.
SRCNAME....Calibration source name.
SUBARRAY...Subarray number to use. 0 => 1. can only do one at a
time.
DOCALIB....If true (>0), calibrate the data using information in the
specified Cal (CL) table for multi-source or SN table for
single-source data. Also calibrate the weights unless
DOCALIB > 99 (use this for old non-physical weights).
GAINUSE....version number of the CL table to apply to
multi source files or the SN table for single
source files. 0 => highest.
FLAGVER....Specifies the version of the flagging table to be
applied. 0 => highest numbered table. <0 => no flagging
to be applied.
DOBAND.....If true (>0) then correct the data for the shape of the
antenna bandpasses using the BP table specified by BPVER.
The correction has five modes:
(a) if DOBAND=1 all entries for an antenna in the table
are averaged together before correcting the data.
(b) if DOBAND=2 the entry nearest in time (including
solution weights) is used to correct the data.
(c) if DOBAND=3 the table entries are interpolated in
time (using solution weights) and the data are then
corrected.
(d) if DOBAND=4 the entry nearest in time (ignoring
solution weights) is used to correct the data.
(e) if DOBAND=5 the table entries are interpolated in
time (ignoring solution weights) and the data are then
corrected.
BPVER......Specifies the version of the BP table to be applied if
DOBAND > 0. 0 => highest numbered table.
<0 => no bandpass correction to be applied.
DOPOL......If > 0 then correct data for instrumental polarization as
represented in the AN or PD table. This correction is
only useful if PCAL has been run or feed polarization
parameters have been otherwise obtained. See HELP DOPOL
for available correction modes: 1 is normal, 2 and 3 are
for VLBI. 1-3 use a PD table if available; 6, 7, 8 are
the same but use the AN (continuum solution) even if a PD
table is present.
PDVER......PD table to apply if PCAL was run with SPECTRAL true and
0 < DOPOL < 6. <= 0 => highest.
SMOOTH.....Specifies the type of spectral smoothing to be applied to
a uv database . The default is not to apply any smoothing.
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).
OUTVERS....BD table output version. <0 => do not write one.
0 => write a new one. = N > 0 => add to version N.
OUTNAME....Output UV file name (name). Standard defaults.
OUTCLASS...Output UV file name (class). Standard defaults.
OUTSEQ.....Output UV file name (seq. #). 0 => highest unique
OUTDISK....Disk drive # of output UV file. 0 => highest w room
BADDISK....The disk numbers to avoid for scratch files (sorting
EXPLAIN SECTION