|
|||
NRAO Home > CASA > CASA Task Reference Manual |
|
0.1.65 initweights
Requires:
Synopsis
Initializes weight information in the MS
Arguments
Inputs |
| ||
vis |
| Name of input visibility file (MS)
| |
| allowed: | string |
|
| Default: |
| |
wtmode |
| Initialization mode
| |
| allowed: | string |
|
| Default: | nyq |
|
tsystable |
| Tsys calibration table to apply on the fly
| |
| allowed: | string |
|
| Default: |
| |
gainfield |
| Select a subset of calibrators from Tsys table
| |
| allowed: | string |
|
| Default: |
|
|
interp |
| Interpolation type in time[,freq]. default==linear,linear
| |
| allowed: | string |
|
| Default: |
|
|
spwmap |
| Spectral windows combinations to form for gaintables(s)
| |
| allowed: | intArray |
|
| Default: |
|
|
dowtsp |
| Initialize the WEIGHT_SPECTRUM column.
| |
| allowed: | bool |
|
| Default: | False |
|
void
Example
This task provides for initialization of the weight information
in the MS. For ALMA interferometry and EVLA data, it should not
generally be necessary to use this task, as the weight information
should have been initialized properly at fill time (v4.2.2 and later).
Several initialization modes are supported via the wtmode parameter.
If wtmode=’nyq’ (the default), SIGMA and WEIGHT will be
initialized according to bandwidth and integration time. This
is the theoretically correct mode for raw normalized visibilities.
(e.g., ALMA). For the EVLA, this is correct if switched-power
and bandpass calibration will later be applied.
If wtmode=’sigma’, WEIGHT will be initialized according to the
existing SIGMA column.
If wtmode=’weight’, WEIGHT_SPECTRUM will be initialized according
to the existing WEIGHT column; dowtspec=T must be specified in
this case.
If wtmode=’ones’, SIGMA and WEIGHT will be initialized with 1.0,
globally. This is a traditional means of initializing weight
information, and is adequate when the integration time and
bandwidth are uniform. It is not recommended for modern
instruments (ALMA, EVLA), where variety in observational setups
is common, and properly initialized and calibrated weights
will be used for imaging sensitivity estimates.
There are two EXPERIMENTAL modes, wtmode=’tsys’ and ’tinttsys’.
In the modes, SIGMA and WEIGHT will be initialized according to
Tsys, bandwidth, and integration time (used only in ’tinttsys’),
i.e.,
tsys : weight=bw/Tsys^2
tinttsys: weight=bw*t_int/Tsys^2
These modes use Tsys values to calculate weight as is done in
Tsys calibration. Tsys values are taken from a tsys calibration
table given as tsystable. Selection of gain field (gainfield),
interpolation method (interp), and spectral window mapping (spwmap)
are supported, too.
Available types of interpolation are,
Time: ’nearest’, ’linear’, the variation of those with ’perobs’,
e.g., ’linearperobs’ (enforce obsId boundaries in interpolation)
Freq: ’nearest’, ’linear’, ’cubic’, ’spline’, and the variation
of those with ’flag’, e.g., ’linearflag’ (with
channelized flag).
See the help of applycal for details of interpolations.
Note if the weight in an MS is initialized with these modes and
Tsys calibration table is applied with calwt=True after that, the
weight would be contaminated by being devided by square of Tsys
twice.
!!! USERS ARE ADVICED TO USE THESE EXPERIMENTAL MODES WITH CARE !!!
For the above wtmodes, if dowtsp=T (or if the WEIGHT_SPECTRUM
column already exists), the WEIGHT_SPECTRUM column will be
initialized (uniformly in channel in wtmode=’nyq’, ’sigma’,
’weight’, and ’ones’), in a manner consistent with the
disposition of the WEIGHT column. If the WEIGHT_SPECTRUM
column does not exist, dowtsp=T will force its creation.
Use of the WEIGHT_SPECTRUM column is only meaningful
for ALMA data which will be calibrated with channelized
Tsys information, or if the weights will become channelized
after calibration, e.g., via averaging over time- and
channel-dependent flagging. (A task for channel-dependent
weight estimation from the data itself is also currently under
development).
In non-channelized modes (wtmode=’nyq’, ’sigma’, ’weight’, and
’ones’) or when dowtsp=F, SIGMA_SPECTRUM column will be removed
from MS. On the other hand, SIGMA_SPECTRUM column is added and
initialized in channelized modes (wtmode=’tsys’ and ’tinttsys’)
if dowtsp=T or WEIGHT_SPECTRUM already column exists.
Two additional modes are available for managing the spectral
weight info columns; these should be used with extreme care: If
wtmode=’delwtsp’, the WEIGHT_SPECTRUM column will be deleted (if
it exists). If wtmode=’delsigsp’, the SIGMA_SPECTRUM column
will be deleted (if it exists). Note that creation of
SIGMA_SPECTRUM is not supported via this method.
Note that this task does not support any prior selection.
Intialization of the weight information must currently be done
globally or not at all. This is to maintain consistency.
More information about CASA may be found at the
CASA web page
Copyright © 2016 Associated Universities Inc., Washington, D.C.
This code is available under the terms of the GNU General Public Lincense
Home |
Contact Us |
Directories |
Site Map |
Help |
Privacy Policy |
Search