|NRAO Home > CASA > CASA Toolkit Reference Manual||
imager.apparentsens - Function
2.3.1 Calculate rms sensitivity directly from weights
This function calculates the point source sensitivity for the data selected by im.selectvis(...), and according to the imaging weighting parameters specified in im.weight(...) and im.defineimage(...). The calculation is performed solely using the weight information stored in the MS WEIGHT column (WEIGHT_SPECTRUM tbd), and as adjusted by the net imaging weighting function (natural, uniform, robust, taper, etc.). Therefore, it is assumed that the MS WEIGHTs have been properly initialized and calibrated along with the visibility data. As long as the WEIGHTs are in the inverse square units of the visibilities (i.e., inverse variance weights), the calculation should yield the real theoretical imaging sensitivity for data at any stage of the calibration (though data at early and intermediate stages of calibration may not be sufficiently coherent for imaging at high–or even modest–fidelity).
Two values are reported in the logger and returned (see example below). First, the apparent sensitivity (in the units implied by the WEIGHTs’ units), for the specified imaging weighting scheme. Second, a unitless factor describing the ratio of the apparent sensitivity to that obtained with pure ’natural’ weighting (the nominal peak sensitivity). When ’natural’ weighting is selected, this ratio factor will be 1.0; all other weighting choices will yield an apparent sensitivity ratio greater than 1.0.
Currently, this function reports only the continuum sensitivity for the selected data, and in particular, for the aggregate bandwidth indicated by the spectral window selection. The calculation further assumes that the visibility samples are each entirely independent (i.e., no redundant samples such as would occur for overlapping spectral windows).
A future version of this function will support reporting a sensitivity spectrum for the spectral line case (including support for WEIGHT_SPECTRUM). For now, spectral line sensitivity may be reasonably estimated by dividing the reported sensitivity by the square root of the fractional bandwidth of a single image channel, or by selecting a bandwidth matching the width of a single image channel.
Calculated apparent point source sensitivity (in units implied by the MS weights)
Ratio of apparent sensitivity relative to natural weighting
Run asynchronously in the background
# open and set up selection and image plane parameters
# report natural weighting sensitivity
print ’Natural Sensitivity =’, nat;
print ’Relative to Natural Weighting = ’, nat;
# switch to uniform weighting
print ’Uniform Sensitivity =’, uni;
print ’Relative to Natural Weighting = ’, uni;
# switch to briggs weighting
print ’Briggs Sensitivity =’, rob;
print ’Relative to Natural Weighting = ’, rob;
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