Next: astPutTableHeader - Store new FITS headers in a FitsTable
Up: AST Function Descriptions
Previous: astPutFits - Store a FITS header card in a FitsChan
astPutTable
-
Store a single FitsTable in a FitsChan
- Description:
- This function
allows a representation of a single FITS binary table to be
stored in a FitsChan. For instance, this may provide the coordinate
look-up tables needed subequently when reading FITS-WCS headers
for axes described using the "-TAB" algorithm. Since, in general,
the calling application may not know which tables will be needed -
if any - prior to calling
astRead, the astTablesSource function
provides an alternative mechanism in which a caller-supplied
function is invoked to store a named table in the FitsChan.
- Synopsis:
- void astPutTable( AstFitsChan
this, AstFitsTable
table,
const char
extnam )
- Parameters:
-
this
-
Pointer to the FitsChan.
-
table
-
Pointer to a FitsTable to be added to the FitsChan. If a FitsTable
with the associated extension name already exists in the FitsChan,
it is replaced with the new one. A deep copy of the FitsTable is
stored in the FitsChan, so any subsequent changes made to the
FitsTable will have no effect on the behaviour of the FitsChan.
- Notes:
- Tables stored in the FitsChan may be retrieved using
astGetTables.
- The astPutTables method can add multiple FitsTables in a single call.
Next: astPutTableHeader - Store new FITS headers in a FitsTable
Up: AST Function Descriptions
Previous: astPutFits - Store a FITS header card in a FitsChan
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