Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1488

News	FAQ
Search	Home

regionmanager.copyregions - Function

	Package	general
	Module	images
	Tool	regionmanager

Copy regions from one Table to another

Synopsis
copyregions(tableout, tablein, confirm)

Arguments

tableout	inout	The output table
		Allowed:	Image tool, table tool or String
tablein	in	The input table
		Allowed:	Image tool, table tool or String
confirm	in	Prompt for confirmation
		Allowed:	T or F
		Default:	F

Returns
Bool or fail

Description

This function copies all the regions from one AIPS++ Table to another.

For the Table tool arguments, 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) or a new table (for tableout) which will be created for you. The new table has no useful structure beyond housing the regions for you.

If desired, you can request confirmation prompting to prevent accidental overwrite of existing regions.

Example

- im := image('hcn')
- drm.copyregions('newtable', im)

Creates the output table and copies all the regions housed by the image hcn via the Image tool im.