Документ взят из кэша поисковой машины. Адрес оригинального документа : http://xmm.vilspa.esa.es/sas/6.5.0/doc/deceit/node13.html
Дата изменения: Tue Aug 16 04:24:25 2005
Дата индексирования: Sat Dec 22 08:41:59 2007
Кодировка:

XMM-Newton Science Analysis System


deceit (deceit-1.18.2) [xmmsas_20050815_1803-6.5.0]

Meta Index / Home Page / Description / Detailed syntax

Array

Array specifications may only appear in the body of dataset specifications. There is no limit to the number of array specifications which may appear in the array specification body. Within a dataset, array names must be unique.

The general form of an array specification is given by

    array array-dimensions name array-data-type label units optional-expression
    < 
        ... array item specifications ... 
    >

where,

• array is the array specification keyword. This keyword is used to begin a new array specification.

• array-dimensions, the dimensions of the array, is a comma-separated list of integer-valued expressions, the list being delimited by parentheses The general form is (integer-expression, integer-expression, ... ).

• name is the name of the array. There must be no other table or array with the same name in the dataset. It has type string-expression (which may be a literal string).

• array-data-type specifies the data type of the array. The available types are int8, int16, int32, real32, real64.

• label is a short description for the array. It has type string-expression (which may be a literal string).

• units is the array's units. It has type string-expression (which may be literal string).

• optional-expression is an optional expression which is evaluated after the last item in the body has been evaluated.

The header part of the array specification array array-dimensions name array-data-type label units optional-expression must be placed onto a single line. This is due to a limitation of the parser. The subsequent body, which is delimited by $<$ and $>$, is optional but, if present, must begin on a new line.

The array specification body comprises zero or more of the following specification:

• attribute

• history

• comment

The final optional expression can be used to direct deceit to execut a function. The function is executed when the interpreter reaches the end of the array specification block. The variable arr is a pointer to the array and may be referenced in the expression. For example,

    dataset "ds1" 
    < 
        array(10,20) "arr1" int32 "an integer array" "m" fillArray(arr,"somefile") 
        < 
           attribute "att1" int 10 "an integer attribute" "Nm" 
        > 
    >

where fillArray is a user-defined function (see 3.3) that takes a pointer to an array, and fills it with data from somefile.