next up previous 264
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 up previous 264
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