flist -- Convert the contents of a FITS table to ASCII format.
flist infile[ext#] outfile columns rows
This task prints the information in the header and data of a FITS table extension (either ASCII or binary table) into ASCII format which then may be displayed or printed. This task is similar to the XANADU program DUMPFITS, and performs much the same function as the FTOOLS FDUMP. FDUMP is recommended for output to a file, or for piping into other programs. By default, flist will print all the rows and columns of all extensions as well as all the header records to STDOUT (the terminal screen) or to an output ASCII file, but only selected information may be output by setting the input parameters appropriately. The output format is either a default format or specified with TDISPn keywords.
This task is primarily designed to display FITS table extensions to the screen and currently it can only output the header records of the primary array or image extensions. Use the fimgdmp task to output the data in a FITS image.
Optionally the list of column names can be placed in an ASCII file, one name per line, and then the name of the file, proceeded by an "@" character may be given to the "columns" parameter. If the first non-white character in the column list is the negation character then the output file will contain those columns NOT named in the remainder of the column list.
The 'flcol' task (with the NLIST parameter set to 1) may be used to generate a list of column names suitable for input to this task.
1. List the contents of the FITS table 'junk.fits' to the terminal:
ft> flist junk.fits STDOUT
2. List 'junk.fits', including only the columns specified in the colnames.lis file.
ft> flcol junk.fits nlist=1 outfile = colnames.lis ft> edit colnames.lis (Delete or rearrange the order of the column names) ft> flist junk.fits firstname.lastname@example.org
3. Dump only the first 100 rows of data in the 2nd extension in the file 'big.fits' to an output file 'big.dat'; do not output the header keywords.
ft> flist big.fits+2 big.dat rows=1-100 prhead=no
FLIST cannot display the data in a FITS primary array or image extension.
If the width of a scaled column in an ASCII table is less than 8 characters, the value cannot be displayed.
Complex and Double Complex datatypes cannot be displayed.
ftlist, ftcreate. fv, the interactive FITS file editor, can also be used to view the contents of a FITS table.