STScI Logo

tvproj xray.xplot


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

NAME

tvproj-- Display an image with x and y spatial projections

USAGE

tvproj image

DESCRIPTION

Tvproj loads an image, and overlays the x and y projections on the display device. Reference the xdisplay and improj (xray.ximages) help files for a more detailed description.

Note that the xspatial package must be loaded, as the tvproj task uses the improj task.

PARAMETERS

image = "" prompt = IRAF image filename

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

(gcolor = "r") prompt = Graphics Overlay Color - r|y|b|g|w

The color of the labels to be displayed on the image device. Input r=red, y=yellow, b=blue, g=green, w=white.

(axes = "b") [string]

Indicates which axes to project. Types available are:


        b - both x and y
        x - just the x axis
        y - just the y axis
(yscale = 0.5) [real]

Fraction of the display screen to use for projection. The default uses just half screen in each dimension. Allowed range is 0-1.0.

(xlog = no) [bool]

Should the x projection be scaled logarithmically? If so, any zero values will be rejected with a warning message and not plotted. Default is linear.

(ylog = no) [bool]

Should the y projection be scaled logarithmically? If so, any zero values will be rejected with a warning message and not plotted. Default is linear.

(xdim = 512) [int]

The dimension of your image display device ( as specified with stdimage ) This task does not automatically determine the size of the display device, so it must be manually adjusted here, if stdimage is not img1 ( 512 x 512)

(ydim = 512) [int]

The dimension of your image display device ( as specified with stdimage ) This task does not automatically determine the size of the display device, so it must be manually adjusted here, if stdimage is not img1 ( 512 x 512)

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

Minimum and maximum image intensity to be mapped to the minimum and maximum display levels. These values 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.

(clobber= no) [bool]

OK to clobber the existing output files? These output files are created by the improj task called by tvproj , and are normally deleted upon completion of tvproj . Therefore, this parameter can usually be left as "no".

EXAMPLES

This example first displays and then plots projections along the x and y axes of rh110267.qp onto the image device. The xspatial package must be loaded first so that tvproj can make the projections.


	cl> xspatial
	xs> tvproj
	IRAF image filename: xdata$rh110267.qp[bl=16]
	z1 = 0., z2 = 556.

TIME REQUIREMENTS

BUGS

SEE ALSO

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

See the documentation on XSPATIAL.IMPROJ (help improj ) for a description of the projection task.

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


Source Code · Search Form · STSDAS