Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1488

News	FAQ
Search	Home

regionmanager.complement - Function

	Package	general
	Module	images
	Tool	regionmanager

Create the complement of a world region

Synopsis
complement(region, comment)

Arguments

region	in	The world region
		Allowed:	Region tool
comment	in	A comment stored with the region
		Allowed:	String

Returns
Region tool or fail

Description

This function (short-hand name comp) creates the complement of a world region.

Example

- im := image('hcn')
- cs := im.coordsys()
- im.shape()
[155 178]
-
- blc := "17:42:29.303 -28.59.18.600"
- trc := "17:42:28.303 -28.59.10.600"
- r2 := drm.wbox(blc,trc,[1,2],cs)
- r3 := drm.complement(r2);
-
- im.stats(region=r2)                          # Some output discarded 
Selected bounding box [90, 90] to [103, 98]         
No pts   = 126
-
- im.stats(region=r3)
Selected bounding box [1, 1] to [155, 178]     # Some output discarded 
No pts   = 27464

As expected, the number of pixels in the complement is (155*178) - 126 = 27464