image_xpaget

sherpa.astro.ui.image_xpaget(arg)

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

Send a query to the image viewer.

Parameters:

arg (str) – A command to send to the image viewer via XPA.

Returns:

returnval

Return type:

str

Raises:

• sherpa.utils.err.DS9Err – The image viewer is not running.
• sherpa.utils.err.RuntimeErr – If the command is not recognized.

See also

image_close()

Close the image viewer.

image_getregion()

Return the region defined in the image viewer.

image_open()

Create the image viewer.

image_setregion()

Set the region to display in the image viewer.

image_xpaset()

Send an XPA command to the image viewer.

Notes

The XPA access point [1] of the ds9 image viewer lets commands and queries to be sent to the viewer.

References

[1]	http://ds9.si.edu/ref/xpa.html

Examples

Return the current zoom setting of the active frame:

>>> image_xpaget('zoom')
'1\n'