|NRAO Home > CASA > CASA Toolkit Reference Manual||
2.3.1 Calculate images by gridding, etc.
This tool function actually does gridding (and Fourier inversion if needed) of visibility data to make an image. It allows calculation of various types of image:
- Make the dirty image from the DATA column (default)
- Make the dirty image from the MODEL_DATA column
- Make the dirty image from the CORRECTED_DATA column
- Make the dirty image from the difference of the CORRECTED_DATA and MODEL_DATA columns
- Make the point spread function
- Make a single dish image
- Make a single dish coverage image
- Make a complex holography image
- Make the primary beam as defined by setvp
Note the full imager equation is not used and so, for example, the primary beam correction is not performed. Use restore to get a residual image using the full imager equation where primary beam correction is performed.
A position shift can be applied when specifying the image parameters with defineimage. If a shift is specified then the uvw coordinates are reprojected prior to gridding, and a phase rotation is applied. If the image is a PSF then no phase shift is applied but the uvw are recomputed. To see the effects of the uvw reprojected, you can use the plotuv function.
If desired, the full complex image (before conversion to stokes I,Q,U,V) may be retained. Note that the image tool cannot load a complex image directly. Instead, use the imagecalc constructor to take e.g. the real and imaginary parts of the image.
For making single dish and holography images, the data are convolved onto the grid using a one of a number of options:
- Circularly symmetric prolate spheroidal wavefunction. This is always the same function in pixels. To get this to match to the antenna primary beam, the optimum cellsize to use in constructing the image is the antenna primary beam half-width-half-maximum times 1.20192.
- Nearest neighbor gridding.
- The telescope primary beam is used as the convolution function. This function is the same in arcseconds, independent of the cellsize. This choice is optimum in the least squares sense. To override the default choice of telescope primary beam for a given telescope, use the function setvp. Usually the default will be acceptable.
To make a reasonable approximation to the sky, one should divide the type=’singledish’ image by the type=’coverage’ image, thresholding at some level. For example:
threshold = s.max / 10.0;
’]/scanweight[scanweight>’, threshold, ’]’))
Type of output image
Name of output image
Name of output complex image
Report things like the center frequency to the logger
Run asynchronously in the background
Fill in the MODEL\_DATA column from Fourier transforming the model and
the componentlist. Make the residual image and write it to
im.setvp(dovp=T, usedefaultvp=T, telescope=’GBT’);
In the above we may want to see what the primary beam we are using
look like. May also be useful to deconvolve single dish images in the
More information about CASA may be found at the CASA web page
Copyright © 2010 Associated Universities Inc., Washington, D.C.