AIPS HELP file for BLAPP in 31DEC25
As of Wed Dec 11 5:46:59 2024
BLAPP: Task which applies baseline corrections to CL tables.
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 #
INVERS Input BS table version number
SOURCES Source list ' '=>all.
STOKES Stokes type to process
SELBAND Bandwidth to select (kHz)
SELFREQ Frequency to select (MHz)
FREQID Freq. ID to select.
TIMERANG Time range to use.
ANTENNAS Antennas to correct.
SUBARRAY 0.0 9999.0 Subarray; 0 => 1.
REFANT Reference antenna
ANTWT Antenna weights: 0.0 => 1.0
OPCODE Operation code:
'SOLV' - produce solutions
'CAL ' - update calibration
'MK4 ' - MK4IN BS-table
GAINVER 0.0 9999.0 Input CL table: 0 => 1
GAINUSE 0.0 9999.0 Output CL table: 0 => 2
BADDISK List of disks not to be used
for scratch
HELP SECTION
BLAPP
Task: Reads baseline-based residual phases, group delays and rates
from a BS table (generated by BLING or MK4IN), obtains
least-squares solutions for antenna-based quantities as a
function of time and optionally uses these to update the CL
table.
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.
INVERS.....Input BS table version number. 0 => highest
SOURCES....list of sources to process.
'*' = all; a "-" before a source name
means all except ANY source named.
STOKES.....The desired Stokes types:
' '=> 'RRLL' or ''VVHH' depending on whether
polarizations in the UV data file are circular or linear.
SELBAND....Bandwidth of the data to be calibrated in kHz. If there
is more than one IF present SELBAND matches the bandwidth
of the first IF selected with BIF and EIF.
Default: use FREQID parameter.
SELFREQ....Frequency of the data to be selected in MHz. If more
than one IF is present SELFREQ is compared with the first
requested IF. Default: use FREQID parameter.
FREQID.....Frequency group to calibrate. May be used instead of
SELBAND and SELFREQ. If set to -1 SELFREQ and/or SELBAND
will be used if set otherwise all frequency groups will
be selected. 0 => 1
TIMERANG...Time range of the data to be used. 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 modified. If any number is
negative then all antennas listed are NOT to be modified.
All 0 => use all.
SUBARRAY...The subarray to modify. Do only one at a time.
REFANT.....The reference antenna to be used. 0 => pick any.
ANTWT......Antenna weights. A default weight of 1.0 is used for any
entries that are zero or negative. The weights in the BS
table are multiplied by the geometric mean of the antenna
weights for that baseline so that baselines involving
antennae with greater weights have more influence over
the solution.
OPCODE.....Operation code. If this is 'SOLV' then the solutions
will be determined and written to an SN table. If this
is 'CAL ' then the solutions will be automatically
applied and no SN table will be kept. Default: 'SOLV'
Data from MK4IN must have OPCODE = 'MK4'.
GAINVER....The version number of the input calibration (CL) table.
0 => 1. Times from this table are used to establish
common times for the solutions from the BS table in case
the solution times for different baselines are not
aligned (as will be the case if different solution
intervals are used for different baselines).
GAINUSE....The version number of the output CL table. 0 => 2.
Note that CL table 1 may not be used.
BADDISK....A list of disks that are not to be used to store
scratch files.
EXPLAIN SECTION
BLAPP: Task to apply baseline-based fringe solutions
Documentor: Chris Flatters, Walter Alef
Related programs: BLING, MK4IN
BLAPP is used to apply the results of a baseline-based fringe-
search to a uv data set. Baseline-based data is read from a
BS table for all requested baselines in each scan and fed
to a routine which calculates the least-squares solutions for
the antenna based parameters using singular value decomposition.
This method will work for one or more baselines. The solutions
are written to an SN table. After processing all requested scans
BLAPP updates the CL table from the SN table and deletes the SN
table if OPCODE is 'CAL '.
The acceleration term in the BS table is not transferred to the
output CL table or SN table but is used when extrapolating the
BS table solutions to times in the the input CL table. If you
have a data set where the acceleration term is important the
recommended procedure is to make sure that the CL table records
are closely spaced in time (using INDXR if necessary) before
running BLAPP: the phase corrections in the output file should
then include corrections for the acceleration.
The least-squares solution is performed using the LAPACK routine
SGELSS.