next up previous 264
Next: AST_PUTTABLEHEADER - Store new FITS headers in a FitsTable
Up: AST Routine Descriptions
Previous: AST_PUTLINE - Store a text line read by a Channel source routine


AST_PUTTABLE - Store a single FitsTable in a FitsChan

Description:
This routine 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 AST_READ, the AST_TABLESOURCE routine provides an alternative mechanism in which a caller-supplied function is invoked to store a named table in the FitsChan.
Invocation:
CALL AST_PUTTABLE( THIS, TABLE, EXTNAM, STATUS )
Arguments:
THIS = INTEGER (Given)
Pointer to the FitsChan.
TABLE = INTEGER (Given)
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.
STATUS = INTEGER (Given and Returned)
The global status.
Notes:
  • Tables stored in the FitsChan may be retrieved using AST_GETTABLES.

  • The AST_PUTTABLES method can add multiple FitsTables in a single call.


next up previous 264
Next: AST_PUTTABLEHEADER - Store new FITS headers in a FitsTable
Up: AST Routine Descriptions
Previous: AST_PUTLINE - Store a text line read by a Channel source routine

AST A Library for Handling World Coordinate Systems in Astronomy
Starlink User Note 210
R.F. Warren-Smith & D.S. Berry
24th May 2011
E-mail:ussc@star.rl.ac.uk

Copyright (C) 2009 Science \& Technology Facilities Council