1.1.2.0 regionmanager.fromrecordtotable

NRAO Home > CASA > CASA Toolkit Reference Manual

regionmanager.fromrecordtotable - Function

1.1.2 Save regions stored in a record into a Table

Description

This function saves regions into an casa Table For the tablename argument the user should be the name of an existing CASA Table on disk (any kind of table).

If the parameter asmask is True then the table has to be an image table. A mask makes sense with an image only.

You can specify the name the region will have (regionname) when it is saved in the Table. If you don’t specify this, a digit based name is assigned to it or if specify a name that already exists a new one will be generated which is close but different. The function returns you the name the region is assigned

Arguments


Inputs
tablename	The table
	allowed:	string
	Default:	Image tool, table tool or String
regionname	Name(s) of the region(s) when saved in the table
	allowed:	any
	Default:	variant Vector of strings
regionrec	Region(s) to save
	allowed:	record
	Default:	Record of region tool(s)
asmask	save region as a mask rather than region
	allowed:	bool
	Default:	false false
verbose	Report successful saves
	allowed:	bool
	Default:	true True

Returns
string

Example

- ia.open(’hcn’)
- cs=ia.coordsys()
- blc = "16:28:25.50 +040.49.05.61"
- trc = "16:24:28.67 +041.45.28.43"
- r1 = rg.wbox(blc="10pix 20pix",trc="30pix 40pix",pixelaxes=[0,1],csys=cs.torecord())
- r2 = rg.wbox(blc=blc,trc=trc,pixelaxes=[0,1],csys=cs.torecord())
- rg.fromrecordtotable(’hcn’, "x", r1)
x
- rg.fromrecordtotable(’hcn’, "x", r2)
x0
- rg.namesintable(’hcn’)
x x0

Example

2 CASA image files on disk ’hcn1’ ’hcn2’

- names = rg.namesintable(’hcn1’)
- r = rg.fromtabletorecord(’hcn1’, names[0])
- rg.namesintable(’hcn2’)
- rg.fromrecordtotable(’hcn2’, names[0], r)

In this example, we recover a region into a record
from one image, and then copy them to another.

Example

####In this example a region is saved as a mask
ia.open(’myfancy.image’)
csys=ia.coordsys()
ia.done()
##Lets make a world-box region
wbox=rg.wbox([’10pix’, ’10pix’, ’0pix’, ’0pix’], [’20pix’, ’20pix’, ’0pix’, ’0pix’], csys=csys.torecord())
###save that into the image as a mask rather than just a region and assign it the name
###mask1
rg.fromrecordtotable(’myfancy.image’, ’mask1’, wbox, asmask=True)
###now let us set that as default mask
ia.open(’myfancy.image’)
ia.maskhandler(’set’, ’mask1’)
ia.done()
###and now let us view that image
viewer(’myfancy.image’)

__________________________________________________________________

[next] [prev] [prev-tail] [front] [up]

More information about CASA may be found at the CASA web page

This code is available under the terms of the GNU General Public Lincense