next up previous 62
Next: [VARIANT] = `SPARSE'
Up: ARRAYStructure
Previous: [VARIANT] = `SCALED'

[VARIANT] = `SPACED'

A spaced $<$ARRAY$>$ is one where the data values vary linearly with array index. An example where this variant could be used is axis data, which are often equally spaced.

General-purpose applications will handle these structures. However, extra time will be expended (though probably much less than for a scaled $<$ARRAY$>$) whilst conversion to and from a $<$narray$>$ is performed. They do not contain magic-value bad pixels.


Table: Components of $<$ARRAY$>$ Structure, [VARIANT] = `SPACED'
Component Name TYPE Brief Description
[VARIANT] $<$_CHAR$>$ `SPACED'
[ORIGIN(NAXIS)] $<$integer$>$ origin of the data array
[DIMENSIONS(NAXIS)] $<$integer$>$ dimensions of equivalent numeric array
[SCALE(NAXIS)] $<$numeric$>$ scale factors
[BASE(NAXIS)] $<$numeric$>$ zero points

The value of an element of the equivalent $<$numeric$>$ array would be:

\begin{displaymath}{\rm VALUE} = \sum_{i=1}^{\rm NAXIS} ({\rm BASE}(i) + (k_i-1) * {\rm SCALE}(i) ) \end{displaymath}

where $k_i$ is the element number of the $i^{\rm th}$ dimension.
NAXIS
The number of axes in the array being represented.
[ORIGIN]
The pixel origin in each dimension. If this object is not present, each origin is assumed to be 1.
[SCALE]
The scale factor for each dimension used to convert the corresponding array index of [DATA] to its $<$numeric$>$ form. If it is not present, or is undefined, a value of 1 is assumed for each dimension.
[BASE]
The zero point for each dimension used to convert the corresponding array index of [DATA] to its $<$numeric$>$ form. If it is not present, or is undefined, a value of 0 is assumed for each dimension.
[DIMENSIONS]
The axis dimensions of the full array. Mandatory. The equivalent primitive type is the TYPE of [BASE], or if [BASE] is absent, the TYPE of [SCALE]. If both [BASE] and [SCALE] are missing, the equivalent $<$numeric$>$ array defaults to TYPE $<$_REAL$>$.



next up previous 62
Next: [VARIANT] = `SPARSE'
Up: ARRAYStructure
Previous: [VARIANT] = `SCALED'

Starlink Standard Data Structures
Starlink General Paper 38
Malcolm J Currie, P T Wallace &
R F Warren-Smith
1989 January 20
E-mail:ussc@star.rl.ac.uk

Copyright © 2008 Science and Technology Facilities Council