FTAB_PRINT
Name
FTAB_PRINT
Purpose
Print the contents of a FITS (binary or ASCII) table extension.
Explanation
User can specify which rows or columns to print
Calling Sequence
FTAB_PRINT, filename, columns, rows,
[ TEXTOUT=, FMT=, EXTEN_NO= NUM_HEADER_LINES ]
Inputs
filename - scalar string giving name of a FITS file containing a
binary or ASCII table
columns - string giving column names, or vector giving
column numbers (beginning with 1). If a string
supplied then column names should be separated by comma's.
if not supplied, then all columns are printed.
If set to '*' then all columns are printed in table format
(1 row per line, binary tables only).
rows - (optional) vector of row numbers to print (beginning with 0).
If not supplied or set to scalar, -1, then all rows
are printed.
Optional Keyword Input
EXTEN_NO - Extension number to read. If not set, then the first
extension is printed (EXTEN_NO=1)
FMT = Format string for print display (binary tables only). If not
supplied, then any formats in the TDISP keyword fields will be
used, otherwise IDL default formats. For ASCII tables, the
format used is always as stored in the FITS table.
NUM_HEADER_LINES - Number of lines to display the column headers (default
= 1). By setting NUM_HEADER_LINES to an integer larger than 1,
one can avoid truncation of the headers. In addition, setting
NUM_HEADER_LINES will display commented lines indicating
a FORMAT for reading the data, and a suggested call to
readfmt.pro. Works for binary tables only
NVAL_PER_LINE - The maximum number of values displayed from a
multivalued column when printing in table format. Default = 6
TEXTOUT - scalar number (0-7) or string (file name) determining
output device (see TEXTOPEN). Default is TEXTOUT=1, output
to the user's terminal
Example
(1) Print all rows of the first 5 columns of the first extension of the
file 'wfpc.fits'
IDL> ftab_print,'vizier.fits',indgen(5)+1
(2) Print all columns of the first row to a file 'vizier.dat' in
'table' format
IDL> ftab_print,'vizier.fits',t='vizier.dat','*',0
System Variables
Uses the non-standard system variables !TEXTOUT and !TEXTUNIT
which must be defined (e.g. with ASTROLIB) prior to compilation.
Procedures Used
FITS_CLOSE, FITS_OPEN, FITS_READ, FTPRINT, TBPRINT
History
version 1 W. Landsman August 1997
Check whether data exists W. Landsman Feb 2007
Check whether extension exists W. Landsman Mar 2010
Added NUM_HEADER_LINES, NVAL_PER_LINE keywords for binary tables
W. Landsman Apr 2010