Chandra X-Ray Observatory
Skip to the navigation links
Last modified: December 2010

Jump to: Description · Example · Bugs · See Also

AHELP for CIAO 4.3 Sherpa v1


Context: visualization


Send data to ds9 using XPA.


image_xpaset( arg )


The image_xpaset() function is used to send data to the SAO imager, ds9; it provides a simple, user-friendly interface which is similar to the xpaset command-line tool [] from the XPA package. A call to the function image_xpaset("file foo.fits") would translate to 'xpaset -p ds9 file foo.fits' on the command line.

  • arg - string value; "arg" in the command-line syntax 'xpaget -p ds9 arg'.


sherpa> image_xpaset("file foo.fits")
sherpa> image_xpaset("frame new")
sherpa> image_xpaset("grid yes")
sherpa> image_xpaset("regions foo.reg")
sherpa> image_xpaset("saveimage jpeg foo.jpg")
sherpa> image_xpaset("wcs replace file foo.wcs")

The image_xpaset function accepts one string argument, using it as the command 'xpaset -p ds9 arg'. For example, to send ds9 an image file to display (foo.fits), one would use "file foo.fits" as the argument. Likewise, "frame new" will replace the current frame displayed in ds9 with a new, blank frame; "regions foo.reg" will load the region "foo.reg" to the display, and so on.


See the bugs pages on the Sherpa website for an up-to-date listing of known bugs.

See Also

load_image, pack_image, unpack_image
image_model, image_model_component, image_source, image_source_component
contour, contour_data, contour_model, contour_ratio, contour_resid, image_close, image_data, image_deleteframes, image_fit, image_getregion, image_open, image_ratio, image_resid, image_setregion, image_xpaget

Last modified: December 2010
Smithsonian Institute Smithsonian Institute

The Chandra X-Ray Center (CXC) is operated for NASA by the Smithsonian Astrophysical Observatory. 60 Garden Street, Cambridge, MA 02138 USA.   Email: Smithsonian Institution, Copyright © 1998-2019. All rights reserved.