Content-type: text/html Manpage of show

show

Section: User Manuals (1)
Updated: 20 JUN 2012
Index Return to Main Contents
 

NAME

show - Display & Manipulation Utility for CRUSH maps and more.  

SYNOPSIS

show [options] <filename>  

DESCRIPTION

show is a tool to display the FITS images produced by crush(1) (and also by BoA). It accepts all options of imagetool(1) for processing images before displaying them. Once the display is active, show provides an interactive interface with hotkeys (see below) and mouse gestures that enable further image manipulation and mask creation/operations.  

OPTIONS

All options of imagetool(1) are also used by show. Additionally show defines the following option(s):
-help
Provides a basic help screen, similar to this one.
 

MOUSE GESTURES

Dragging with left button pressed defines a circular region of the desired size. Simple click the left mouse button where you want the center of the region, and hold it while dragging to where you want the outer edge of the circular region to reside.

You can also create standard, beam-sized (radius = FWHM), regions using the middle button, which capture over 98% of the flux for point sources. Slightly larger fixed-sized apertures can be created by clicking the right mouse button.

You can enter polygonal drawing mode by pressing 'P'. Simply click the mouse at each vertex location, then finish the polygon by pressing 'P' once again.

Further manipulation of regions is possible via the hotkeys described below.

 

HOTKEYS

Hotkeys can be used to perform various operations from the image display window. (Note, the image window must be the active window or else the hotkeys will not work!)
h
Help with hotkeys.
?
Same as above.
 

[Display Operations]

Z,z
Zoom in/out.
B,b
Brightness increment/decrement.
C,c
Contrast increment/decrement.
K, k
Toggle back & forth between color schemes.
i
Invert colors.
x
Toggle between linear, logarithmic, and square-root scaling.
<,>
Toggle between Source, RMS, and S/N maps.
 

[Operations for Highlighted Regions]

R
Remove all regions (circles and polygons) defined so far.
P
Start/Finish drawing a polygonal region.
r
Circle the defined regions (default).
m
Mask the defined regions by a partially opaque disk.
n
Toggle displaying region names.
l
Level to zero as measured outside the defined regions.
g
Gradient removal as measured outside defined regions.
f
fit Gaussians to the defined source regions.
F
Fluxes inside the apertures defined by the regions.
N
RMS values inside the defined regions.
 

[Miscellaneous Operations]

Q
Qonvolve to beam size.
q
Deconvolve with a standard Gaussian beam.
s
Resample onto a 1 arcsec grid.
T
Fourier Transform.
p
Perform a pointing fit.
E
Extended Structure filter. May improve point source appearance.
u
Change display units.
U
Undo last operation.
w
write file.
W
Write regions (mask) file.

 

FILES

/usr/share/crush/example.mask  

BUGS

If you find them, please report them to the author (see below).  

AUTHOR

Attila Kovacs <attila[AT]submm.caltech.edu>  

SEE ALSO

crush(1), imagetool(1), coadd(1), detect(1), difference(1)


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
MOUSE GESTURES
HOTKEYS
[Display Operations]
[Operations for Highlighted Regions]
[Miscellaneous Operations]
FILES
BUGS
AUTHOR
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 23:07:21 GMT, June 20, 2012