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

Chapter 16
Data structure manipulation
In Chapter 15 we looked at the high-level architecture of the CIA data structures and how to
create them. As a user, you don’t have to worry too much about the low-level architecture of
the data structures. Manipulation such as extraction of data is done via CIA routines. In this
chapter the use of these routines are described and examples are given.
16.1 CIA data structure interface routines
Below is a list of user interface routines that are used to manipulate CIA data structure. In
usage, replace the stem structure with the name of the data structure type. The following
sections provide examples and descriptions of their use. A formal and more comprehensive
description of each routine, and additional routines of this type not documented here, can be
found in the on-line help (see Section 2.3.2).
• structure init initialises a structure in memory, and returns its name.
• structure extract extracts the data from a structure and places it in a regular IDL structure.
• structure put fills a field of this structure.
• structure get returns a field of this structure.
• structure write writes this structure to a file.
• structure read reads this structure from a file.
• structure list returns the names of all existing structures of this type.
• structure del deletes a structure.
• structure find returns names of structures with a field equal to a given value.
• structure info returns information about a structure’s fields.
• structure elem returns the names of the SADs/SCDs contained in an SSAD/SSCD. Applies
to SSADs/SSCDs only.
187