nraonrao
 
NRAO Home > CASA > TaskRef

0.1.38 invert

Requires:

Synopsis Calculate the dirty image and dirty beam from a visibility set Description

Calculate the dirty image and dirty beam from a visibility set. Arguments





Inputs

vis

name of input visibility file

allowed:

string

Default:

imagename

Pre-name of output images

allowed:

string

Default:

mode

Type of selection (mfs, channel, velocity, frequency)

allowed:

string

Default:

nchan

Number of channels (planes) in output image

allowed:

int

Default:

1

start

First channel in input to use

allowed:

any

Default:

variant 0

width

Number of input channels to average

allowed:

any

Default:

variant 1

imsize

x and y image size in pixels, symmetric for single value

allowed:

intArray

Default:

256 256

cell

arcsec

x and y cell size. default unit radians

allowed:

doubleArrayarcsec

Default:

1.01.0

stokes

Stokes params to image (eg I,IV, QU,IQUV)

allowed:

string

Default:

I

field

Field Name

allowed:

string

Default:

spw

Spectral windows:channels: ” is all

allowed:

any

Default:

variant

weighting

Weighting to apply to visibilities

allowed:

string

Default:

natural

rmode

Robustness mode (see help clean)

allowed:

string

Default:

norm

robust

Briggs robustness parameter

allowed:

double

Default:

0.0

noise

Jy

noise parameter for briggs weighting when rmode=’abs’

allowed:

stringJy

Default:

0.0Jy

npixels

number of pixels for superuniform or briggs weighting

allowed:

int

Default:

0

restfreq

rest frequency to assign to image (see help)

allowed:

string

Default:

phasecenter

Image phase center: position or field index

allowed:

any

Default:

variant

Returns
void

Example

 
 
        A quick a dirty way to make an image and beam (point spread function)  
 
        The image and beam can also be made using taskname = ’clean’; niter=0.  
        The clean has more options (egs. uvrange, taper, etc).  
 
 
 
        Keyword arguments:  
        vis -- Name of input visibility file  
                default: none; example: vis=’ngc5921.ms’  
        imagename -- Pre-name of output images:  
                default: none; example: imagename=’n5921’ produces  
                n5921.dirty, n5921.beam  
        mode -- Frequency Specification:  
           NOTE: See examples below:  
                default: ’mfs’  
                  mode = ’mfs’ means produce one image from all specified data.  
                  mode = ’channel’; Use with nchan, start, width to specify  
                      output image cube.  See examples.  
                  mode = ’velocity’, means channels are specified in velocity.  
                  mode = ’frequency’, means channels are specified in frequency.  
     < < <  mode expandable parameters (for modes other than ’mfs’)  
               Start, width are given in units of channels, frequency or velocity  
                  as indicated by mode, but only channel now recommended.  
               nchan -- Number of channels (planes) in output image  
                 default: 1; example: nchan=3  
               start -- Start input channel (relative-0)  
                 default=0; example: start=5  
               width -- Output channel width (>1 indicates channel averaging)  
                 default=1; example: width=4  
           examples:  
               spw = ’0,1’; mode = ’mfs’  
                  will produce one image made from all channels in spw 0 and 1  
               spw=’0:5~28^2’; mode = ’mfs’  
                  will produce one image made with channels (5,7,9,...,25,27)  
               spw = ’0’; mode = ’channel’: nchan=3; start=5; width=4  
                  will produce an image with 3 output planes  
                  plane 1 contains data from channels (5+6+7+8)  
                  plane 2 contains data from channels (9+10+11+12)  
                  plane 3 contains data from channels (13+14+15+16)  
               spw = ’0:0~63^3’; nchan=21; start = 0; width = 1  
                  will produce an image with 20 output planes  
                  Plane 1 contains data from channel 0  
                  Plane 2 contains date from channel 2  
                  Plane 21 contains data from channel 61  
               spw = ’0:0~40^2’; mode = ’channel’; nchan = 3; start = 5; width = 4  
                  will produce an image with three output planes  
                  plane 1 contains channels (5,7)  
                  plane 2 contains channels (13,15)  
                  plane 3 contains channels (21,23)  
 
        --- Image Specifications  
        imsize -- Image size in pixels (x,y)  
                default = [256,256]; example: imsize=[350,350]  
                imsize = 500 is equivalent to [500,500]  
        cell -- Cell angular size (x,y)  
                default= none;  
                example: cell=[’0.5arcsec,’0.5arcsec’] or  
                cell=[’1arcmin’, ’1arcmin’]  
                cell = ’1arcmin’ is equivalent to [’1arcmin’,’1arcmin’]  
        cell = ’2’ makes default cell size of 2 radians!  
        stokes -- Stokes parameters to image  
                default=’I’; example: stokes=’IQUV’;  
                Options: ’I’,’IV’,’QU’,’IQUV’’RR’,’LL’,’RRLL’,’XX’,’YY’,’XXYY’  
        field -- Select field using field id(s) or field name(s).  
                  [run listobs to obtain the list id’s or names]  
                default: ’0’  
               If field string is a non-negative integer, it is assumed a field index  
                 otherwise, it is assumed a field name  
               field=’0~2’; field ids 0,1,2  
               field=’0,4,5~7’; field ids 0,4,5,6,7  
               field=’3C286,3C295’; field named 3C286 adn 3C295  
               field = ’3,4C*’; field id 3, all names starting with 4C  
        spw -- Select spectral window/channels  
               default: ’’=all spectral windows and channels  
               spw=’0~2,4’; spectral windows 0,1,2,4 (all channels)  
               spw=’<2’;  spectral windows less than 2 (i.e. 0,1)  
               spw=’0:5~61’; spw 0, channels 5 to 61  
               spw=’0,10,3:3~45’; spw 0,10 all channels, spw 3, channels 3 to 45.  
               spw=’0~2:2~6’; spw 0,1,2 with channels 2 through 6 in each.  
               spw=’0:0~10;15~60’; spectral window 0 with channels 0-10,15-60  
               spw=’0:0~10,1:20~30,2:1;2;4’; spw 0, channels 0-10,  
                       spw 1, channels 20-30, and spw 2, channels, 1,2 and 4  
        weighting -- Weighting to apply to visibilities:  
                default=’natural’; example: weighting=’uniform’;  
                Options: ’natural’,’uniform’,’briggs’,’radial’, ’superuniform’  
                For weighting=’briggs’, SEE Reference Manual--imager--imager.weight.  
        rmode -- Robustness mode (for use with Brigg’s weighting)  
                default=’none’; example=’abs’;  
                Options: ’norm’,’abs’,’none’  
        robust -- Brigg’s robustness parameter  
                default=0.0; example: robust=0.5;  
                Options: -2.0 to 2.0; -2 (uniform)/+2 (natural)  
        restfreq -- Specify rest frequency to use for image  
                default=’’ (i.e., try to use the restfreq specified in the visibility data)  
        phasecenter -- direction measure  or fieldid for the image center  
                default: ’’; =>center is the direction of the first field specified in field;  
                example: phasecenter=’6’  
                or phasecenter=’J2000 19h30m00.0 -40d00m00.0’  
 
 

Please send any comments or questions about CASA or AIPS++ to aips2-requests@nrao.edu

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

Updated daily during alpha development.