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.
Make a residual/dirty image :
example
example
Model Prediction :
example
example
PB-correction :
example
example
Restoration :
examples
example
Restarts :
( deconv only, autonaming, etc )
example
Data Selection :
one MS, a list of MSs.
example
Single-Field Image Shapes :
Single Field (mfs, cube (basics), phasecenter, stokes planes ? )
example
Defining Spectral Coordinate Systems :
LINK to Synthesis Imaging / Spectral Line Imaging
(examples of all the complicated ways you can do this)
example
Examples of Multi-Field Imaging :
( 2 single, multiterm, mfs and cube, etc )
example
example
Examples of Iteration Control :
niter=0, using cycleniter, cyclefactor...
example
Using a Starting model :
single term, multi-term, with restarts, a single-dish model (units, etc).
example
Saving model visibilities in preparation for self-calibration :
use savemodel of various types.
example
Making masks for deconvolution :
LINK to Synthesis Imaging / Masks For Deconvolution
making masks....
example
example
Primary Beam correction :
LINK to Synthesis Imaging / Primary Beams
single term, wideband (connect to wb)
example
using vpmanager to set a PB model for tclean
example
Returned dictionary :
example of what is in it...
example
Examples of Wide-Band Imaging :
LINK to Synthesis Imaging / Wide Band Imaging
Choose nterms, ref-freq. Re-restore outputs. Apply widebandpbcor
example
Examples of Mosaicking :
LINK to Synthesis Imaging / Mosaicking
Setting up mosaic imaging, setup vpmanager to supply external PB.
example
Examples of Wide-field and Full-Beam Imaging
facets, wprojection (and wprojplanes), A-Projection
example
Parallelization for Continuum/MFS and Cube.
blah...
example
Channel chunking for very large Spectral Cubes :
blah...
example