National Radio
Astronomy Observatory

6.1.5 Regions (region)

The region parameter points to a CASA region which can be directly specified or listed in a ImageRegion file. An ImageRegion file can be created with the CASA viewer’s region manager (§ 7.3.5). Or directly using the CASA region syntax (Chapter D; note: the viewer has not be fully converted for the new region format as of CASA 3.3. – old regions formats are still supported for that CASA version). Typically ImageRegion files will have the suffix ’.rgn’.

Alert: When both the region parameter and any of box/chans/stokes are specified simultaneously, the task may perform unwanted selections. Only specify one of these (sets of) parameters. We recommend the use of CASA regions and may remove the box/chans/stokes selection in CASA 3.4 releases and higher.

For example:

or

for to specify a region file.

For the most part, the region parameter in tasks only accepts strings (eg, file names, region shape descriptions) while the region parameter in ia tool methods only accepts python region dictionaries (eg produced using the rg tool).

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