PISA2ARD - Creates an ARD description of detected objects

Description:

This routine converts the RESULTS output from PISAFIND into an ARD description. The ARD description consists of a series of ellipses, one for each detected object, which can be used to identify the area of the images on a frame.

The scale of the ellipses can be changed allowing the effective areas to be modified.

Usage:

PISA2ARD RESULTS ARDFILE SCALE

Parameters:

ARDFILE = LITERAL (Read)

The name of a text file to contain the ARD description. [PISA2ARD.DAT]

RESULTS = LITERAL (Read)

The name of the file containing the RESULTS from a run of the PISAFIND application. [PISAFIND.DAT]

SCALE = _REAL (Read)

The scale factor to apply to the ellipse major and minor axes. This value must be in the range 0.01 to 100.0. [1.0]

Examples:

PISA2ARD PISAFIND.DAT PISA2ARD.DAT 1.0

In this example an ARD description is written to file PISA2ARD.DAT. The ellipses cover exactly the same area as the ellipses fitted to the detected objects.

PISA2ARD PISAFIND.DAT PISA2ARD.DAT 2.0

In this example an ARD description is written to file PISA2ARD.DAT. The ellipses have major and minor axes which are twice as long as those which fitted the detected objects. This gives four times as much area.

Notes:

• The input to the parameter RESULTS must have the same format as the output from the PISAFIND parameter RESULTS.