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: 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