Next: astAddFrame - Add a Frame to a FrameSet to define a new coordinate system
Up: AST Function Descriptions
Previous: astSet - Set attribute values for an Object
astAddColumn
-
Add a new column definition to a table
- Description:
- Adds the definition of a new column to the supplied table. Initially,
the column is empty. Values may be added subsequently using the
methods of the KeyMap class.
- Synopsis:
- void astAddColumn( AstTable
this, const char
name, int type, int ndim,
int
dims, const char
unit )
- Parameters:
-
this
-
Pointer to the Table.
-
name
-
The column name. Trailing spaces are ignored (all other spaces
are significant). The supplied string is converted to upper case.
-
type
-
The data type associated with the column. See "Applicability:"
below.
-
ndim
-
The number of dimensions spanned by the values stored in a single
cell of the column. Zero if the column holds scalar values.
-
dims
-
An array holding the the lengths of each of the axes spanned by
the values stored in a single cell of the column. Ignored if the
column holds scalara values.
-
unit
-
A string specifying the units of the column. Supply a blank
string if the column is unitless.
- Class Applicability:
-
Table
-
Tables can hold columns with any of the following data types -
AST__INTTYPE (for integer), AST__SINTTYPE (for
short int),
AST__BYTETYPE (for
unsigned bytes - i.e. unsigned chars),
AST__DOUBLETYPE (for double
precision floating point), AST__FLOATTYPE (for single
precision floating point), AST__STRINGTYPE (for character string),
AST__OBJECTTYPE (for AST Object pointer), AST__POINTERTYPE (for
arbitrary C pointer) or AST__UNDEFTYPE (for undefined values
created by
astMapPutU).
-
FitsTable
-
FitsTables can hold columns with any of the following data types -
AST__INTTYPE (for integer), AST__SINTTYPE (for
short int),
AST__BYTETYPE (for
unsigned bytes - i.e. unsigned chars),
AST__DOUBLETYPE (for double
precision floating point), AST__FLOATTYPE (for single
precision floating point), AST__STRINGTYPE (for character string).
- Notes:
- This
function
returns without action if a column already exists in the Table
with the supplied name and properties. However an error is
reported if any of the properties differ.
Next: astAddFrame - Add a Frame to a FrameSet to define a new coordinate system
Up: AST Function Descriptions
Previous: astSet - Set attribute values for an Object
AST A Library for Handling World Coordinate Systems in Astronomy
Starlink User Note 211
R.F. Warren-Smith & D.S. Berry
24th May 2011
E-mail:ussc@star.rl.ac.uk
Copyright (C) 2009 Science \& Technology Facilities Council