BUGS · SEE_ALSO
tvlabel-- Display an image with a cursor readback in hh:mm:ss, dd:mm:ss
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.
- 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.
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.
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.