show(1)

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.

-nofrills
    Faster but less polished rendering. (See also hotkey 'a').

MOUSE GESTURES
You may move the image inside the display window by dragging it while holding the pressing the right mouse button (or Ctrl + button). You can zoom in and out using the mouse wheel, or the equivalent two-finger scroll. 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, which capture over 98% of the flux for point sources, by clicking the left button. Larger fixed-sized apertures can be created by clicking the middle (Alt + button) or right (Ctrl + button) mouse buttons. You can enter polygonal drawing mode by pressing 'P'. Simply click the mouse at each vertex location (or right-click [Ctrl + button] to undo last vertex), 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.

  [Display Operations]

arrows
    Move image around in steps.

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.

a   Toggle appearance between rendering speed & quality.

  [Operations for Highlighted Regions]

D   Delete last circular region.

R   Remove all regions (circles and polygons).

P   Start/Finish drawing a polygonal region.

r   Display regions (default).

n   Toggle displaying region names.

l   Level to zero as measured outside the regions.

g   Gradient removal as measured outside the regions.

f   Fit Gaussians to the circular regions.

F   Print aperture fluxes inside the regions.

N   Print RMS values inside the defined regions.

  [Miscellaneous Operations]

?   Display image information summary.

A   Print map area summary.

m   Toggle distance measure mode on/off.

Q,q Convolve/deconvolve using the default Gaussian beam.

S,s Resample onto a coarser/finer grid.

T   Fourier transform.

p   Perform a pointing fit.

E   Extended-structure filter (for point sources).

u   Change display units.

U   Undo last operation.

w   Write FITS image to disk.

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)