STScI Logo

tvlabel xray.xplot


NAME · USAGE · DESCRIPTION · PARAMETERS · EXAMPLES · TIME_REQUIREMENTS
BUGS · SEE_ALSO

NAME

tvlabel-- Display an image with a cursor readback in hh:mm:ss, dd:mm:ss

USAGE

tvlabel image

DESCRIPTION

Tvlabel loads an image, and displays it on the tv display device. The program is then left in IMCUR cursor readback mode. When the Image Cursor is positioned and the character d is typed the World Coordinates at the cursor position will be displayed.

Reference the xdisplay and rimcursor help files for a more detailed description.

PARAMETERS

image = "" prompt = IRAF image filename

The image filename. This can be any valid IRAF image file, including X-ray QPOE files. WCS Parameters are read from the header.

(wcs = "world") [string]

The parameter set that defines a world coordinate system.

(xwxform = "%.4H") [string]

Format for x axis readout. See the documentation on the rimcursor task (help rimcursor ) for a description of the output formats.

(xwyform = "%.4h") [string]

Format for y axis readout. See the documentation on the rimcursor task (help rimcursor ) for a description of the output formats.

(z1=0.0, z2=30.0) [real]

Minimum and maximum image intensity to be mapped to the minimum and maximum display levels. These are ignored if zrange=yes.

(ztrans = "linear") [string]
Transformation of the image intensity levels to the display levels. The choices are:
"linear"
   Map the minimum and maximum image intensities linearly to the
   minimum and maximum display levels.

"log"
   Map  the  minimum  and maximum image intensities linearly to
   the range 1 to 1000, take the logrithm (base 10),  and  then
   map the logarithms to the display range.

"none"
   Apply no mapping of the image intensities (regardless of the
   values of zcale, zrange, z1, and z2).  For most image displays,
   values exceeding the maximum display value are truncated by
   masking the highest bits.  This corresponds to applying a
   modulus operation to the intensity values and produces
   "wrap-around" in the display levels.
(zrange = yes) [bool]

If set to yes, map the full range of the image intensity to the full range of the display. Map between z1 and z2 below if zrange=no.

EXAMPLES

This example first displays rh110267.qp on the image device. The user then moves the cursor and strikes d for the world coordinate read-out.


	cl> tvlabel
	IRAF image filename: xdata$rh110267.qp[bl=8]
	z1 = 0., z2 = 218.
	After the blinking image cursor appears ---
	Move cursor to object and type 'd' for hh:mm:ss, dd:mm:ss
	     ( Type <cntl-d> to quit )
	22h08m36.97s  +45o31'23.62"

For detailed explanation and other examples reference the rimcursor help file.

TIME REQUIREMENTS

BUGS

SEE ALSO

See the documentation on rimcursor (help rimcursor ) for a description of the rimcursor task.

See the documentation on cursor mode (help cursor ) for a description of the IRAF graphics user interface.

See the documentation on QPOE filtering (help qpoe ) for a description of the spatial filter user interface.


Source Code · Search Form · STSDAS