Detailed description of ARD files

The shapes of regions which can be defined are specified by the following KEYWORDS:

• PIXEL
• LINE
• ROW
• COLUMN
• BOX
• POLYGON
• CIRCLE
• ELLIPSE

Regions are specified using the keywords suffixed by the following information.

PIXEL

- a list of the pixel indices (X and Y) of the required pixels.

LINE

- the coordinates (pixel coordinates or pixel indices) of the two end points of the line, all pixels through which the line passes will be used.

ROW

- a list of row numbers (pixel indices).

COLUMN

- a list of column numbers (pixel indices).

BOX

- the coordinates of the centre of the box (pixel indices or pixel coordinates) followed by the lengths of the two sides in pixels (may be a fraction).

POLYGON

- a list of coordinates (pixel indices or pixel coordinates) of the polygon vertices.

CIRCLE

- the coordinates of the centre (pixel indices or pixel coordinates) followed by the radius in pixels (may be a fraction).

ELLIPSE

- the coordinates of the centre (pixel indices or pixel coordinates) followed by the lengths of the semi-major and semi-minor axes in pixels (may be a fraction) and the position angle of the semi-major axis (measured +X through -Y in degrees).

Only one KEYWORD is allowed per line and the parameters must be enclosed in parentheses. The parameters must be separated by commas. Any amount of white space (blanks) is allowed between keywords and numerics. Tabs are not allowed.

Comments are indicated by the characters `#' and may be in-line or whole line at any place within the file. The presence of a comment terminates the current line immediately.

Any line within the file may be continued on to another by terminating with the continuation character `-'.

Thus an ARD file might contain the following information:

#
# ARD description file for bad regions with the current CCD.
#
COLUMN (41, 177, 212)   # Three bad columns
#
PIXEL (201, 143)  
PIXEL (153, 167)   # Two Bad pixels
#
BOX (188, 313, 5, 5)   # One Hot spot
#
ELLIPSE (99, 120, 21.2, 5.4, 45.0)
#
# Polygons defining badly vignetted corners
#
POLYGON (2.2, 96.4, 12.1, 81.5, 26.9, 63.7, 47.7, 41.9, -
        61.5, 24.1, 84.3, 0.0, 0.0, 0.0)
#
POLYGON (6.2, 294.3, 27.9, 321.0, 52.6, 348.7, 74.4, 371.5, -
        80.0, 384.0, 0.0, 384.0)
#
# end

The co-ordinates used by ARD by default refer to the co-ordinate system defined by the image bounds for the current NDF. Further details are available from SUN/183.