NRAO Home > CASA > CASA Cookbook and User Reference Manual
8.2.1.10 sdimaging
Keyword arguments:  
infile -- name of input SD (MS) dataset  
specunit -- units for spectral axis  
        options: (str) ’channel’,’km/s’,’GHz’,’MHz’,’kHz’,’Hz’  
        default: ’channel’  
        example: this will be the units for nchan, start, and step  
restfreq -- rest frequency  
        default: ’’ (refer input data)  
        example: 1.0e11, ’100GHz’  
scanlist -- list of scan numbers to process  
        default: [] (use all scans)  
        example: [21,22,23,24]  
        this selection is in addition to field and spw  
field -- field id or selection string for selecting scans by name  
        default: -1 (all fields)  
        example: ’FLS3a’, 0  
        this selection is in addition to scanlist and spw  
spw -- spectral window id  
        default: 0  
        example: 1  
        this selection is in addition to scanlist and field  
antenna -- select data based on antenna name(s) or id(s)  
        default: -1 (all baselines, i.e. all antenna in case of auto data)  
        example: 0, ’DV01’  
stokes -- select data based on stokes or polarization type  
        default: ’’ (use all polarizations)  
        example: ’XX’  
gridfunction -- gridding function for imaging  
        options: ’BOX’ (Box-car), ’SF’ (Spheroidal), ’PB’ (Primary-beam)  
        default: ’BOX’  
        example: ’SF’  
outfile -- output image name  
        default: none  
        example: ’mySDimage.im’  
overwrite -- overwrite option for outfile  
        default: False (not overwrite)  
        options: True, False  
        example: if True, existing file will be overwritten  
imsize -- x and y image size in pixels, symmetric for single value  
        default: [256,256]  
        example: imsize=200 (equivalent to [200,200])  
cell -- x and y cell size. default unit arcmin  
        default: [’1.0arcmin’, ’1.0arcmin’]  
        example: cell=[’0.2arcmin, 0.2arcmin’]  
                 cell=’0.2arcmin’ (equivalent to example above)  
dochannelmap -- channel map image or total power image  
        default: False (total power)  
        options: True (channel map), False  
    >>> dochannelmap=True expandable parameters  
       nchan -- number of spectral channel for created image  
           default: 1  
           options: to do total power imaging, set -1  
       start -- reference value of start channel (in units of specunit)  
           default: 0 (0th channel if specunit=’channel’)  
           example: 100  
       step -- width of each spectral channel for created image  
           default: 1 (channel width of 1 channel if specunit=’channel’)  
           aexample: 100  
phasecenter -- image phase center: direction measure or fieldid  
        default: 0  
        example: ’J2000 13h44m00 -17d02m00’, ’AZEL -123d48m29 15d41m41’  
ephemsrcname -- ephemeris source name for moving source  
        default: ’’  
        if the source name in the data matches one of the known  
        solar objects by the system, this task automatically set  
        the source name.  
        example: ’moon’  
pointingcolumn -- pointing data column to use  
        option: ’direction’, ’target’, ’pointing_offset’, ’source_offset’, ’encoder’  
        default: ’direction’

DESCRIPTION:

Task sdimaging creates an image from input single-dish data. The input can be either total power or spectral data. Currently, this task directly accesses the Measurement Set data only because of the data access efficiently. It differs from other single-dish tasks that mostly operate on the ASAP scantable data format.

Units of spectral axis can be specified via a parameter specunit. Allowed values for specunit are ’channel’, ’GHz’, ’MHz’, ’kHz’, ’Hz’, and ’km/s’. This parameter is also used as the units of the parameter start and step that specify reference value of start channel and width of each spectral channel for channel map, respectively.

Selection of the antennas can be made by setting antennaid(s) or antenna name(s) in string (e.g. ’0’, ’DV01’,etc.). Defalut value, -1, means that the task selects data from all baseline, i.e., data from all antenna when data only contains auto-correlation.

The parameter gridfunction sets gridding function for imaging. Currently, the task supports ’BOX’ (Box-car), ’SF’ (Prolate Spheroidal Wave Function), and ’PB’ (Primary Beam). For ’PB’, correct antenna information should be included in input file.


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

Copyright © 2010 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