ISOCAM Interactive Analysis User's Manual Version 5.0 - ISO - ESA

D.4. AUTOMATIC INCLUSION OF NEW PROCESSING ALGORITHMS IN CIA 325
• The order of keywords is not important, except that ; MODIFICATION HISTORY: must be
the last. It is recommended that ; NAME: is the first.
• Format for ; INPUTS:, ; OUTPUTS:, ; KEYED INPUTS:, ; KEYED OUTPUTS:
They can be described as you wish, but it is better to follow the following rules in order
to have a nice table. Put your general comments, if needed, on the first lines, without ‘--’
inside. Then at the beginning of a line: name of the variable ‘--’ type of the variable :
description of the variable. The separators are ‘--’ and‘:’. For the second separator you
can use ‘:’ or‘;’, but commas can’t be used. For example:
; OUTPUTS:
; imt_block -- intarr(300,n) : the IMT_block.
; CLEAN_CUBE -- Data output cube ; CUBE_INPUT with undefined
; values instead of identified glitches
• Name:
Thenameintheheadercanbeonthesamelineasthekeyword; NAME: or on a single
line after. This is compulsory.
• Calling sequence:
The calling sequence must be on the line after the keyword ; CALLING SEQUENCE:. The
calling sequence can be on a single line or on two consecutive lines. This is compulsory.
D.4 Automatic inclusion of new processing algorithms in CIA
In order for easy addition of new algorithms into CIA, the core CIA calibration routines have
been designed to automatically call new low-level processing routines. In order for this automatic
mechanism to work the name and calling sequence of new routines must conform to a standard.
As described below, this is dependent on the type of processing the new routine will perform.
In all cases additional keywords can be used by the new routine – keyword inheritance ensures
that keywords are passed by the core calibration routine down to the new low-level processing
routine.
raster scan Raster MOSAIC routines should have the calling sequence
raster method, raster pds
For example, let us say that I have a new routine which implements a raster MOSAIC
creation algorithm (or method) called xxx. Then my routine would have the calling
sequence
raster xxx, raster pds
and would take a raster PDS as input.
corr dark Dark correction routines should have the calling sequence
darkmethod, dark, dark error, ack=ack
where dark is the output DARK image and dark error is the error on dark.