Description:
This function creates
a new FITS binary table holding data copied from an AST FitsTable. If a binary table extension with
the given extension name already exists in the FITS file, it is replaced by the new one. Otherwise,
the table is written into the current HDU. The current HDU on exit can be selected using
MKCHDU.
Invocation
CALL CVG_FT2BT( TABLE, FUNIT, EXTNAM, ASTVER, MKCHDU,
STATUS )
Arguments
TABLE = INTEGER (Given)
A pointer to the FitsTable.
FUNIT =
INTEGER (Given)
The FITSIO unit number for the FITS file.
EXTNAM = CHARACTER
(
)
(Given)
The name of the new FITS extension containing the binary table.
ASTVER = INTEGER
(Given)
This parameter determines what to do if the FITS file already contains an extension with the
name given by EXTNAM. Normally, an error is reported, but if the extension was created by AST (i.e.
if EXTNAM is equal to the symbolic constant AST__TABEXTNAME), and the table version
for the existing table is equal to the value of ASTVER, then no error is reported and this
function returns without action.
MKCHDU = LOGICAL (Given)
If .TRUE., the new binary
table extension is made the current HDU on exit. Otherwise, the original current HDU is
unchanged on exit.
STATUS = INTEGER (Given and Returned)
The global status.