Primary Beam Correction (impbcor)

NRAO Home > CASA > CASA Cookbook and User Reference Manual

5.4 Primary Beam Correction (impbcor)

The primary beam correction can be applied during the imaging with clean. It is also possible to correct after imaging using the task impbcor:

#  impbcor :: Construct a primary beam corrected image from an image and a primary beam pattern.
imagename           =         ’’        #  Name of the input image
pbimage             =         ’’        #  Name of the primary beam image which must exist or
                                        #   array of values for the pb response. Default ""
outfile             =         ’’        #  Output image name. If empty, no image is written.
                                        #   Default ""
box                 =         ’’        #  One or more boxes to use for fit region(s). Default is
                                        #   to use the entire directional plane.
     region         =         ’’        #  The region to correct. Default is entire image. If
                                        #   both box and region are specified, box is used and
                                        #   region is not.

chans               =         ’’        #  The frequency planes to correct. Default is all
                                        #   frequencies.
stokes              =        ’I’        #  The correlations to correct. Default is all.
mask                =         []        #  Boolean LEL expression or mask region.  Default is
                                        #   none.
mode                = ’velocity’        #  Divide or multiply the image by the primary beam
                                        #   image. Minimal match supported. Default "divide"
cutoff              =       -1.0        #  PB cutoff. If mode is "d", all values less than this
                                        #   will be masked. If "m", all values greater will be
                                        #   masked. Less than 0, no cutoff. Default no cutoff
wantreturn          =      False        #  Return an image tool referencing the corrected image?
async               =      False        #  If true the taskname must be started using
                                        #   impbcor(...)

The main inputs are the input image and the image of a primary beam in the pbimage parameter. The mode parameter will typically be ’divide’ but it is also possible to multiply with the beam pattern.

[next] [prev] [prev-tail] [front] [up]

More information about CASA may be found at the CASA web page

This code is available under the terms of the GNU General Public Lincense