>  Docs Center  >  Libraries  >  ASTROLIB  >  FTAB_PRINT
Libraries

FTAB_PRINT

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



© 2024 NV5 Geospatial Solutions, Inc. |  Legal
   Contact Us