Next: AST_QUADAPPROX - Obtain a quadratic approximation to a 2D Mapping
Up: AST Routine Descriptions
Previous: AST_PUTTABLEHEADER - Store new FITS headers in a FitsTable
AST_PUTTABLES
-
Store one or more FitsTables in a FitsChan
- Description:
- This routine
allows representations of one or more FITS binary tables to be
stored in a FitsChan. For instance, these 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_PUTTABLES( THIS, TABLES, STATUS )
- Arguments:
-
THIS = INTEGER (Given)
-
Pointer to the FitsChan.
-
TABLES = INTEGER (Given)
-
Pointer to a KeyMap holding the tables that are to be added
to the FitsChan. Each entry should hold a scalar value which is a
pointer to a FitsTable to be added to the FitsChan. Any unusable
entries are ignored. The key associated with each entry should be
the name of the FITS binary extension from which the table was
read. If a FitsTable with the associated key already exists in the
FitsChan, it is replaced with the new one. A deep copy of each
usable FitsTable is stored in the FitsChan, so any subsequent
changes made to the FitsTables 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 tables in the supplied KeyMap are added to any tables already
in the FitsChan.
- The AST_PUTTABLE
method provides a simpler means of adding a single table to a FitsChan.
Next: AST_QUADAPPROX - Obtain a quadratic approximation to a 2D Mapping
Up: AST Routine Descriptions
Previous: AST_PUTTABLEHEADER - Store new FITS headers in a FitsTable
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