Next: [VARIANT] = `SPARSE'
Up: ARRAYStructure
Previous: [VARIANT] = `SCALED'
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:
where
is the element number of the
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: [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