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

Appendix D
Guidelines for writing CIA routines
D.1 Introduction
Users are encouraged to supply their own routines for inclusion into CIA. In such cases it is
asked that the following be understood.
• Routines should not duplicate existing code or data structures. If in doubt, please ask
before coding! Additional data structures will not be permitted.
• Supplying a routine to CIA carries with it an implicit agreement to its distribution to all
CIA sites.
• It should be clear to all parties involved with whom responsibility for the maintenance of
the routine lies.
• Routines should conform to the requirements outlined in Section D.2.
Users can also supply routines to be distributed with CIA as contributed routines (found in
the directory $cia vers/contrib. These are not supported by the CIA team. Bug reports should
be made directly to the author.
D.2 Basic requirements
Please ensure that your routine conforms to the following requirements:
• All files must contain a header (see Section D.3 below).
• A routine should display its calling parameters if it is called without any parameters.
• High and medium level routines should use the CIA error reporting conventions (CIA is
full of examples). Normally this will be routines in the ‘User’ category.
• Mask handling and the setting of undefined values should follow the appropriate conventions.
323