PISAPLOT - Plots an ellipse map of the objects found by PISAFIND

Description:

This application shows the positions, shapes and sizes of the objects located by PISAFIND via a plot of ellipses, one per object. Optional annotation of the ellipses provide cross-referencing with the object list. The plot may be overlaid on an existing image for a direct comparison. In this case the plot appears within the last DATA picture in the graphics database, otherwise it is situated within the current picture.

Control of the plot allows labelled axes whose extent may be defined and the selection of the colour of the ellipses

Parameters:

ABSLAB = LITERAL (Read)

Label for the plot abscissa, may include PGPLOT escape sequences. This parameter is only used when the axes option is selected. [X]

ANNOTA = _LOGICAL (Read)

If true the ellipses are annotated with the object identification number to the top right. [TRUE]

ANNOSCALE = REAL (Read)

The scale height of the annotations. This value is a multiple of the normal text height. [1.0]

AXES = _LOGICAL (Read)

True if annotated axes are to be drawn around the displayed image. This parameter is ignored in the overlay mode, since there is no guarantee that the axes would lie entirely within the current picture. [TRUE]

CLEAR = _LOGICAL (Read)

True if the device is to be cleared first when in overlay mode. Useful if displaying different classes of objects successively. This flag acts as a switch retaining its last value. [FALSE]

DEFAXES = _LOGICAL (Read)

If set true then prompting for the axis bounds will occur, otherwise the program generated defaults will be used. [FALSE]

DEVICE = DEVICE (Read)

The name of the graphics device on which to plot the map of images found. If the overlay mode is required it is recommended that the image be displayed in KAPPA on an image display's base plane, then run this application using the device's overlay plane. [Current graphics device]

MAJTIC( 2 ) = _REAL (Read)

The parameter controlling the numbers of major tick marks for the x and y axes. A negative value for an axis makes the graphics package decide an appropriate value. This parameter is only used when the axes option is selected. [-1.,-1.]

MINTIC( 2 ) = _INTEGER (Read)

The number of minor tick marks between each major tick mark for the x and y axes. A negative value forces the graphics package to compute appropriate values. This parameter is only used when the axes option is selected. [-1.,-1.]

ORDLAB = LITERAL (Read)

Label for the plot ordinate, may include PGPLOT escape sequences. This parameter is only used when the axes option is selected. [Y]

OUTTIC = _LOGICAL (Read)

True if the axis tick marks are to appear on the outside of the axes instead of inside. This parameter is only used when the axes option is selected. [TRUE]

OVERLAY = _LOGICAL (Read)

True if the plot is to be overlaid on the last DATA picture in the graphics database. This is used to compare a displayed 2-d image with the objects detected. This flag acts as a switch retaining its last value. [FALSE]

PALNUM = _INTEGER (Read)

PISAPLOT allows the user to specify which pen number to use when plotting. Thus different classifications of objects can be identified on the same plot using different colours. The colours associated with these pens are the default PGPLOT pens (see the PGPLOT manual for a complete description). These are:

0

background colour

1

foreground colour

2

red

3

green

4

blue

5

cyan

6

magenta

7

yellow

8

orange

and so on up to pen 16 (up to the number available on the current graphics device). After PISAPLOT has been run these colours can be superseded by using the KAPPA palette facilities PALDEF and PALENTRY, but note that any subsequent runs of PISAPLOT will reinstate the PGPLOT default colours so using the KAPPA facilities should be delayed until all object classifications have been displayed. The KAPPA palette pen numbers correspond to PALNUM values (hence the parameter name). [3]

PLTITL = CHAR (Read)

The title of the plot, may include PGPLOT escape sequences. Up to about 40 characters can be accommodated. This parameter is only used when axes option is selected. [Images Detected]

RESULTS = FILENAME (Read)

The ASCII file produced by the PISAFIND application containing the parameterised data for the various objects it detected. [PISAFIND.DAT]

THICK = _REAL (Read)

The thickness of the lines in the plot, where 1.0 is the normal thickness. It should be between 0.5 and 5. This feature is only available on some devices. This parameter is only used when axes option is selected. [1.0]

XPIXS = _REAL (Read)

Initial and final pixel coordinates of plot in x-direction. [Dynamic]

YPIXS = _REAL (Read)

Initial and final pixel coordinates of plot in y-direction. [Dynamic]

Examples:

PISAPLOT OVERLAY

Using the overlay parameter allows ellipses to be plotted over a previously displayed image.

PISAPLOT OVERLAY CLEAR

Including the clear parameters clears a plot before overlaying. This is useful when displaying the overlaid ellipses in an overlay.

PISAPLOT RESULTS=STARS.DAT PALNUM=3 OVERLAY

Using this combination of parameters would use a green pen to plot the ellipse overlaying them on the displayed picture. Using sequences of this example with difference results files and palnums would result in a display which had different colours for each results file displayed over the current picture.

Notes:

• The following pictures are stored in the graphics database: a FRAME encompassing annotated axes and the plot itself, provided the overlay option is not selected; a DATA picture for the plot itself. The latter uses the standard Starlink co-ordinate system.