show

Section: User Manuals (1)
Updated: 22 JUL 2019
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.
-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 with the help of 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

~/.crush2/startup/show/: Location of user-specific java(1) runtime configurations.

BUGS

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

AUTHOR

Attila Kovács <attila[AT]sigmyne.com>