Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1488

News	FAQ
Search	Home

regionmanager.fromtabletorecord - Function

	Package	general
	Module	images
	Tool	regionmanager

Restore regions from a Table to a record

Synopsis
fromtabletorecord(tablename, verbose, regionname, numberfields)

Arguments

tablename	in	The table
		Allowed:	Image tool, table tool or String
verbose	in	Report successful restores
		Allowed:	T or F
		Default:	T
regionname	in	Name of the region(s) to restore
		Allowed:	Vector of strings
		Default:	All
numberfields	in	Number the fields ?
		Allowed:	T or F
		Default:	T

Returns
Record or fail

Description

This function restores a region from an AIPS++ Table to the global name space.

For the tablename argument, you can specify an image tool, a table tool, or a string. If you give a string, it should be the name of an existing AIPS++ table on disk (any kind of table).

If numberfields is F, then the field names of the record are the same as they are in the Table. Otherwise, the regions are put into numbered fields (the field names could be anything).

You can use the function namesintable to find out the names of the regions in the Table.

Example

- im := image('hcn')
- rec := drm.fromtabletorecord(im, numberfields=T)
- print is_region(rec[1])

The record fields are numbered, not named.