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.