SCUOVER - Routine to overlay the bolometer names onto a rebinned image

Description:

This routine is used to overlay the array layout onto a rebinned SCUBA image. The displayed image is read from the graphics database unless a command line value is given. In order to calculate the bolometer positions it is also necessary to read in the extinction corrected data file that was used to regrid the data (in fact any extinction corrected file can be used, possibly with strange results). By default the position of the bolometers at the start of the first integration and zero jiggle offset is plotted. Optionally, it is possible to plot the bolometer positions at any point during the observation (still with zero jiggle offset).

Usage:

scuover

Parameters:

DEVICE = DEVICE (Read)

The graphics device on which the bolometers are to be drawn. The global default (set with KAPPA gdset) will be used unless specified otherwise.

EXPOSURE = INTEGER (Read)

Ues the bolometer positions at the specified exposure within the specified INTEGRATION and MEASUREMENT. For SCAN/MAP data the middle of an exposure (ie scan) is used. Default is exposure 1.

EXT = NDF (Read)

The name of the extinction corrected data from which the bolometer positions should be taken.

INTEGRATION = INTEGER (Read)

Use the bolometer positions at the specified integration. Default is measurement 1.

MEASUREMENT = INTEGER (Read)

Use the bolometer positions at the specified exposure. Default is measurement 1.

MSG_FILTER = CHAR (Read)

Message filter level. Default is NORM.

NDF = NDF (Read)

The name of the regridded data set (taken from the AGI graphics database).

NAME = LOGICAL (Read)

Label with bolometer name if true, else bolometer number. The default is true. If a null response is given the bolometer label is not drawn.

STYLE = LITERAL (Read)

Plotting style to be used for the bolometers. The relevant key to use for adjusting the plotting style is `bolometer'. This is a synonym for curve and can be abbreviated to `bol'. The most useful attribute to change is the colour. Explicit control of the style of the text labels is provided using the `text' attribute. If this attribute is not supplied all plotting styles are inherited from the `bol' style.

Examples:

scuover

The bolometer names will be overlaid using the default colour.

scuover style='colour(bol)=red' noname

This command will overlay bolometer numbers over the image in red.

scuover style='colour(bol)=yellow,font(text)=3,colour(text)=cyan'

Draw yellow circles but draw the labels in cyan using font 3 (italics).

scuover integration=2 name=!

Overlay the bolometer positions at the start of the second integration but do not label them

Notes:

• An image must have already been displayed before using SCUOVER.

• The image must have been displayed using an AST aware application (such as KAPPA display). Otherwise the alignment will not occur.

• The array position is always shown with zero jiggle offset.

• This routine does not take into account the use of SHIFT_DX or SHIFT_DY in rebin. (the relevant information is not stored in the rebinned image).

• Pointing shifts are taken into account.

• It is assumed that the displayed image id regridded to the default map centre. scuover aligns the image using AXIS coordinates and not SKY coordinates therefore there will be an error if incorrect sky coordinates are assumed.

Related Applications

SURF: rebin, scupa;
KAPPA: display, gdset;
FIGARO: image