SCUPLOT - Interactive display and despiking

Description:

Scuplot is a wrapper script around a number of KAPPA utilities. Since it understands the Scuba NDF file format, it hides most of the complicated syntax from the user. Mode = `p' and `r' are wrappers around plotting utilities and facilitate the inspection of the data of each bolometer. The utility allows change to the plot scales via the menu but will keep the scales the same for all bolometers which makes is easy to compare bolometers. Mode = `d' allows for interactive despiking. Please read the note below the description of the menu on the use of the mouse.

Mode = `p' or pltbol (or any p$*$ link to scuplot) is a wrapper around the KAPPA utility linplot. It allows plots of a whole series of bolometers one by one, optionally overlaying them with the same bolometer from a second file. Obvious overlays are despiked on non-despiked data or data from different exposures to check the noise.

Mode = `r' or rlinplot (or any r$*$ link to scuplot) is a wrapper around the KAPPA utility mlinplot. It provides plots of sets of bolometers in a single window with optionally data from a second file in a second window. Obvious files are despiked and non-despiked data or data from different exposures to check the noise.

Mode = `d' or dspbol (or any d$*$ link to scuplot) can be used to interactively despike bolometers. While it is not as fast as a completely integrated routine would be, it makes interactive despiking much easier by hiding the cycle between linplot and change_quality for the user. The most common use is to zoom in on the region with the spike via the `X' menu option (either typing the input or using the cursor) and subsequently to flag the offending point (just type the coordinate of the point, a range, or use the cursor; in general the coordinate is to the right of the plotted point). The routine will overlay the despiked data, prompt the user to accept the new set and de-zoom to the original scale. To reset a previously flagged point, flag the point again but do not accept it: the point will be set to GOOD again. Please read the note below the description of the menu on the use of the mouse.

For each mode the menu items are a subset of:

[M. H]	Redisplay menu
[Q]	Quit
[N]	Next bolometer
[B#]	Switch to bol #
[X min max], [X cen]	X-axis from min:max or cen+/-10
	Just `x' activates the cursor.
[R]	Reset X-axis
[Y min max], [Y lim]	Y-axis from min:max or -lim:+lim
[U]	Reset Y-axis
[#], [#:#], [#-#]	Despike point or range of points;
	Just `p' activates the cursor.
Option $>$

Note that a X center defined with the cursor or [X cen] defaults to a 20 points window around cen, the position of the spike. Using the CURSOR, the Left Mouse button always defines the point, the Right Mouse button exits the cursor task while accepting the last point clicked.

Usage:

scuplot [-m mode ] [-f sdf_file] [-d sdf_file2] [-s min max] [-l #] [bol [bol [bol] ... ]]

Parameters:

-h[elp]

Print the help information.

-m mode:

Select usage mode: p: plot bolometers one by one, optionally overlaid with data from the second input file (equivalent to pltbol) d: interactively despike the data for the bolometers in specified file (equivalent to dspbol). r: same as 'p' except that a whole set of bolometers is plotted in a window (equivalent to rlinplot).

-f file

name of NDF file (.sdf may be included in the name).

-d file2

name of a second file: e.g. the despiked version of the NDF file. The same bolometers will be plotted in a second window or overlaid for comparison.

-s min max

Y-axis scales for plot (can be changed via menu).

-l #

number of bolometers per window

bol

list of bolometers to plot. Type `all' for 1..37 and `alls' for 1..91. Can be added via menu if mode = `r'.

Examples:

scuplot

The user will be asked for a mode and input file before proceeding.

scuplot -m d -f o39_lon_ext

Interactive despiking on o39_lon_ext.sdf (see also dspbol)

scuplot -m p -f s14_lon_ext 12 13 18 20 25 26 19

Enter p mode and use file s14_lon_ext.sdf. Plot bolometers 12,13, 18, 20, 25, 26 and 19.

Notes:

• If the overlay comes up scrambled, delete the agi_xxx files in your home directory and if that does not work also files like linplot.sdf in the /home/you/adam subdirectory.

Related Applications

SURF: pltbol, dspbol, rlinplot, change_quality, despike;
KAPPA: linplot, mlinplot, cursor

Bugs:

Freezes when asked to plot a bad bolometer.