image_getregion

sherpa.astro.ui.image_getregion(coord='')

Return the region defined in the image viewer.

The regions defined in the current frame are returned.

Parameters:

coord (str, optional) – The coordinate system to use.

Returns:

region – The region, or regions, or the empty string.

Return type:

str

Raises:

sherpa.utils.err.DS9Err – Invalid coordinate system.

See also

image_setregion

Set the region to display in the image viewer.

image_xpaget

Return the result of an XPA call to the image viewer.

image_xpaset

Send an XPA command to the image viewer.

Examples

>>> image_getregion()
'circle(123,128,12.377649);-box(130,121,14,14,329.93142);'
>>> image_getregion('physical')
'circle(3920.5,4080.5,396.08476);-rotbox(4144.5,3856.5,448,448,329.93142);'