1dtfits(1)                   General Commands Manual                  dtfits(1)
2
3
4

NAME

6       dtfits - display FITS table
7

SYNOPSIS

9       dtfits <table>
10

DESCRIPTION

12       dtfits  dumps  the  contents of a FITS table in an ASCII format, either
13       into a user-specified file or on stdout. The output is formatted  on  a
14       fixed number of columns to make it readable by human beings. Additional
15       informations are printed out before the table values are dumped,  these
16       informations can be skipped by using the -d option.
17
18       Last, if you want to dump the table into an easily parsable format (for
19       a piece of software), you might want to use the -s option which  speci‐
20       fies  a  character to use as separator. All data fields will be printed
21       out separated by this character only. This allows to use string parsers
22       to cut down the output lines into tokens by looking for this separator.
23       Fields (lines) will still be delimited by  the  end-of-line  character.
24       This  option  produces ASCII tables which are easy to parse for a piece
25       of software but mostly unreadable to human beings.
26
27       Notice that dtfits only accepts one single FITS table in input.
28

OPTIONS

30       -d     Skip information output about the table and column  names.  Out‐
31              puts  only  the  table values. Beware that if the FITS file con‐
32              tains  several  extensions,  they  will  all  appear  one  after
33              another,  separated  only  by  two blank lines. In that case, it
34              would be preferrable to keep the complete output and  parse  out
35              the returned stream to differentiate which data come from where.
36
37       -s <char>
38              Use  the character <char> as separator in output. This option is
39              useful if you want to produce a table that should be parsed by a
40              piece  of  software  (see  above description). The separator can
41              only be a single non-null character. To avoid special characters
42              being  interpreted  by  the  shell, it is recommended to provide
43              this character always between simple or double quotes. Example:
44              dtfits -s '&' table.tfits
45
46       If you want to use a special character as separator, such as a tab, use
47       ^V to insert your character, such as:
48       dtfits -s '^V<TAB>' table.tfits
49
50       which means: you type CTRL-V and then the tab key.
51

SEE ALSO

53       dfits
54

FILES

56       FITS  tables are stored into extensions. If there are several tables in
57       a file, they will all be displayed one after another in the same output
58       stream.
59
60
61
62                                  22 Dec 1999                        dtfits(1)