AIPS HELP file for SNCOR in 31DEC24
As of Wed Nov 6 8:39:27 2024
SNCOR: Task which applies various corrections to SN 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 Input UV file disk unit #
SOURCES Source list ' '=>all.
STOKES Stokes type to process
SELBAND Bandwidth to select (kHz)
SELFREQ Frequency to select (MHz)
FREQID Freq. ID to select, 0=>all
BIF 0.0 100.0 Lowest IF number 0=>all
EIF 0.0 100.0 Highest IF number 0=>all
TIMERANG Time range to use.
ANTENNAS Antennas to correct.
SUBARRAY 0.0 9999.0 Subarray; 0 => 1.
SNVER 0.0 9999.0 SN table version to update
OPCODE Operation code.See HELP
SNCORPRM Parameters (see HELP SNCOR).
PHASPRM Parameters for OPCODE=XFER
BADDISK 0.0 9999.0 Disks to aviod for scratch
HELP SECTION
SNCOR
Task: This task copies the input SN table and then makes a number of
different corrections to the new SN 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.
SOURCES....list of sources to process.
'*' = all; a "-" before a source name
means all except ANY source named.
STOKES.....The desired Stokes type of the output data:
'R ', 'L ', 'RL', ' '=> 'RL'.
FREQID.....Frequency identifier to select (you may determine
which is applicable from the OPTYPE='SCAN' listing
produced by LISTR).
BIF........First IF to process. 0=>all.
EIF........Highest IF to process. 0=>all higher than BIF
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.
SNVER......The SN table version number which is to be updated.
NOTE: 0 -> highest. It makes a new file with the
changed values.
OPCODE.....Operation code (see also EXPLAIN SNCOR):
'AVRT' => average selected fringe rates in a
record.
'CLPA' => Flag amplitudes outside of the range
SNCORPRM(1) (min) to SNCORPRM(2) (max).
'CLPP' => Flag phases outside of the range
SNCORPRM(1) (min) to SNCORPRM(2) (max).
'CLPD' => Flag delays outside of the range (nsec)
SNCORPRM(1) (min) to SNCORPRM(2) (max).
'CLPR' => Flag rates outside of the range (mHz)
SNCORPRM(1) (min) to SNCORPRM(2) (max).
'CLPW' => Flag amplitudes, phases, rates and delays
where the weight is outside the range
SNCORPRM(1) (min) to SNCORPRM(2) (max).
'XFER' => Transfers phases between frequencies with
scaling to compensate for ionospheric delays.
Also allows instrumental phase offsets
and new antenna amplitudes to be introduced.
(See SNCORPRM, PHASPRM below)
'ZPHS' => Zero phases of selected solutions
'ZRAT' => Zero residual fringe-rates of selected
solutions.
'ZDEL' => Zero residual delays of selected
solutions.
'MULA' => Multiply gain amplitudes by SNCORPRM(1)
'REFP' => Reference phases to IF SNCORPRM(1)
'CPRT' => Copy the residual fringe rate from IF
denoted by SNCORPRM(1) to all specified
IFs.
'CPSN' => Copy the whole solution from the IF
denoted by SNCORPRM(1) to all specified
IFs.
'PCOP' => Copy the whole solution from one
polarization to the other (under
control of SNCORPRM(1))
'PNEG' => Flip the sign of the gain phase for
all selected solutions.
'NORM' => Normalize amplitudes to 1
SNCORPRM...Parameters: see above and below.
PHASPRM....More parameters: see above and below
BADDISK....A list of disks on which scratch files are not to
be placed. This will not affect the output file.
EXPLAIN SECTION
SNCOR: Task to apply corrections to an SN table in a variety of
ways.
Documentor: W. D. Cotton, W. C. Erickson (for "XFER")
Related Programs: LISTR, SPLIT, TACOP, TABED
This task will compute various corrections and apply them
directly to a solution (SN) table. The operation to be done
is determined by OPCODE. Details and/or additional information
for the various models is given below.
OPCODE='AVRT'
This option will cause all selected residual fringe rates
to be averaged.
OPCODE='CLPA'
This option flags any gain entries with an amplitude outside
of the range given by SNCORPRM(1) (min) to SNCORPRM(2) (max).
OPCODE='CLPP'
This option flags any gain entries with a phase outside
of the range given by SNCORPRM(1) (min) to SNCORPRM(2) (max).
OPCODE='CLPW'
This option flags any gain entries whose weight lies outside
the range SNCORPRM(1) (min) to SNCORPRM(2) (max).
OPCODE='XFER'
This option transfers phases between frequencies and also sets
antenna amplitudes.
Antenna amplitudes: SNCORPRM(30):
If left blank, the antenna amplitude gains will be unchanged.
To manually set the antenna amplitude gains, enter
the desired amplitudes strictly in order 1 to 28 into
SNCORPRM(1) to SNCORPRM(28) and set SNCORPRM(30) to -1.
To set all antenna amplitude gains to 1.0 set SNCORPRM(30)
to +1.
Phase transfer parameters: PHASPRM(30)
PHASPRM(1) - PHASPRM(28) are the instrumental phase offsets
at the two frequencies for Antennas 1 to 28 (in radians).
[They must be strictly in order 1 to 28.]
PHASPRM(29) = The higher frequency in MHz.
PHASPRM(30) = The lower frequency in MHz.
OPCODE='CLPD'
This option flags any entries with a delay whose value in
nanoseconds is outside of the range given by SNCORPRM(1) (min) to
SNCORPRM(2) (max).
OPCODE='CLPR'
This option flags any entries with a fringe rate whose
value in milliHz is outside of the range given by SNCORPRM(1)
(min) to SNCORPRM(2) (max). The given fringe rate in mHz is at
the reference frequency.
OPCODE='ZPHS'
This option causes the phases of selected gaines to be set
to zero. This is useful for the calibration of amplitudes only.
OPCODE='ZRAT'
This option will cause the residual fringe-rates of the
selected solutions to be set to zero.
OPCODE='ZDEL'
This option will cause the residual delays of the
selected solutions to be set to zero.
OPCODE='MULA'
This option will cause the amplitudes of the selected
complex gains to be multiplied by SNCORPRM(1).
OPCODE='REFP'
This option will reference all the phases to the IF
specified by SNCORPRM(1). If the phase for this IF is flagged
all phases will be flagged. Default = IF 1.
OPCODE='CPRT'
This option will copy the residual fringe-rate from the IF
denoted by SNCORPRM(1) to all specified IFs. Obviously If the
rate for the reference IF is flagged all IFS will be flagged.
Default = IF 1.
OPCODE='CPSN'
This option will copy the whole solution from the IF
denoted by SNCORPRM(1) to all specified IFs. Obviously If the
solution for the reference IF is flagged all IFS will be flagged.
Default = IF 1.
OPCODE='PCOP'
This option will copy the whole solution from one
polarization to the other, for all specified IF's. The copy
direction is specified by SNCORPRM(1):
SNCORPRM(1) = 1 => Copy polzn. 1 (R) to 2 (L)
= 2 => Copy polzn. 2 (L) to 1 (R)
No action is taken if there is only one polarization in the
SN table.
OPCODE='PNEG'
This option will flip the sign of the gain phase for
all selected SN solutions.
OPCODE='NORM'
This option normalizes amplitudes to 1.