STScI Logo

ximtool xray.xplot



ximtool -- Choose and bring up an X-windows display tool ( SAOIMAGE | XIMTOOL | SAOTNG )


ximtool display_node


Ximtool invokes the X-windows display tool ( choice of SAOIMAGE, XIMTOOL or SAOTNG ) in preparation for using the display/xdisplay task in IRAF. The release version has reverted to using system pipes (/dev/imt1) as the default FIFO pipe for SAOimage and Ximtool, since personal pipes are no longer as necessary with the Ximtool available.


display_type = "ximtool"
prompt = Display Type - saoimage/ximtool/saotng(ximtool)

This is the user's choice of display tool.

(geometry = "516x704-2-2") [string]

This is the specification of the size and placement of the SAOIMAGE window. The default corresponds to the .twmrc X-window default at SAO/HEAD.

(pipename = "/dev/imt1") [string]

The pipenam must correspond to the imt1 path defined in graphcap in IRAF. This can be verified with page graphcap$ | match imt1. There will be multiple listings showing a path name containing /dev/imt1. This entire pathname should be entered as the value for pipename, including the imt1.

(userpar= "")
(userpar= "")

These are placeholders for any other command-line arguments the user wishes to supply. Note: ximtool does not support command-line arguments.

(background = yes) [boolean]

Run the XIMTOOL ( SAOIMAGE ) in the background so that IRAF is not blocked.


	cl> xray
	xr> xplot
	xp> show graphcap
	graphcap = dev$graphcap
	xp> ximtool 
	Display Type - saoimage/ximtool/saotng (saotng): saoimage
	using SAOimage
	xterm -e saoimage -pros -idev /dev/imt1o  -odev /dev/imt1i  &
	Attempting Display on: :0.0
	[1] 20788
	xp> xdisplay xdata$rp110590.qp[bl=30]


When invoked on a remote machine, all the image tools require the setting of the DISPLAY environment variable.


SAOIMAGE does not always terminate properly. It's possible that

the DISPLAY window will disappear, but the UNIX process will remain. If this happens XIMTOOL will give a message that 'saoimage is already running' with the specified device. In this case, the old saoimage process must be killed from the UNIX environment. Try ps -guwax | grep saoimage This should allow you to see the process and it's ID. Then use: kill <id-no> to terminate this dead process. SEE ALSO See the documentation on SAOIMAGE(!man saoimage ) for a description of the SAOIMAGE Task.

Source Code · Search Form · STSDAS