Developer

task_tclean.py  contains only calls to various steps and the controls for different Operating Modes (LINK).  No other logic is present in the top level task script.    task_tclean.py uses classes defined in refimagerhelper.py ( PySynthesisImager and its parallel derivatives ).

 

Script writers aiming to replicate tclean in an external script and be able to insert their own methods or connect their own modules, will be able to simply copy and paste the task tclean code (the lines containing  " imager.xxxx " )

 

The tclean task interface is meant to show (and use) subparameters only when their parent options are turned on. This way, at any given time, the only parameters a user should see via inp() are those that are relevant to the current set of algorithm and operational choices. 

 

Additional examples to be added to the Examples tab (from testing suite at https://svn.cv.nrao.edu/svn/casa/branches/release-4_7/gcwrap/python/scripts/tests/test_refimager.py):

Examples are meant to have a consistent set of values for vis, imagename, imsize,cell, with a limited number of parameters per line, to ensure readability. Note that each multiline command has to be edited outside of plone and copied in here, such that the spacing is preserved and the reader can copy/paste at the casa prompt. 

 

Make PSF and PB : 

Make only the PSF, Weight images, and the PB.

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec, niter=0

Make a residual/dirty image :

example

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',

 

Model Prediction :

example

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',

 

PB-correction :

example

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',


 

Restoration :

examples

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',

 

Restarts : 

 ( deconv only,  autonaming, etc )

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',

 

 

Data Selection : 

one MS, a list of MSs.

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',

 

Single-Field Image Shapes :

 Single Field (mfs, cube (basics), phasecenter, stokes planes ? )

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',

 

Defining Spectral Coordinate Systems :

LINK to Synthesis Imaging / Spectral Line Imaging

(examples of all the complicated ways you can do this)

 

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',
 

Examples of Multi-Field Imaging :

( 2 single, multiterm, mfs and cube, etc )

 

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',

 

Examples of Iteration Control :

niter=0,  using cycleniter,  cyclefactor...

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',

 

Using a Starting model :

single term, multi-term, with restarts, a single-dish model (units, etc).

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',

 

Saving model visibilities in preparation for self-calibration :

use savemodel of various types.

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',

 

Making masks for deconvolution :

LINK to Synthesis Imaging / Masks For Deconvolution

making masks....

 

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',
 

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',


Primary Beam correction :

LINK to Synthesis Imaging / Primary Beams

single term, wideband (connect to wb)

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',

using vpmanager to set a PB model for tclean

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',

 

Returned dictionary :

example of what is in it...

 

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',



Examples of Wide-Band Imaging :

LINK to Synthesis Imaging / Wide Band Imaging

Choose nterms, ref-freq.  Re-restore outputs. Apply widebandpbcor

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',

 

Examples of Mosaicking :

LINK to Synthesis Imaging / Mosaicking

Setting up mosaic imaging, setup vpmanager to supply external PB.

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',

 

Examples of Wide-field and Full-Beam Imaging

facets, wprojection (and wprojplanes),  A-Projection

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',

 

Parallelization for Continuum/MFS and Cube.

blah...

example

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',

 

Channel chunking for very large Spectral Cubes :

blah...

example

This box is intended for CASA Inputs. Insert your text here.

tclean(vis='test.ms', imagename='try1', imsize=100, cell='10.0arcsec',