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

NAME

6       fitsort - sort FITS header information from a list of files
7

SYNOPSIS

9       dfits <FITS files...> | fitsort <FITS keywords...>
10

DESCRIPTION

12       fitsort  extract  keyword values from a set of FITS headers and outputs
13       it in an ASCII table format, which is compatible with  most  data  pro‐
14       cessing  software  packages.  It shall only be used in combination with
15       the dfits utility.
16
17       The ASCII output is shown in columns. Columns are  aligned  with  blank
18       characters  and  also  separated by tabulations. Blank alignment allows
19       human readers to visualize the output in a pretty  format,  tabulations
20       are  there  for spreadsheet compatibility. If you want to load out fit‐
21       sort output into any spreadsheet, specify that fields  shall  be  sepa‐
22       rated by tabulations and entries separated by linefeeds.
23
24       Examples :
25       dfits *.fits | fitsort BITPIX NAXIS NAXIS1 NAXIS2
26
27       The output would look like:
28       FILE           BITPIX   NAXIS    NAXIS1   NAXIS2
29       file0001.fits  16       2        128      128
30       file0002.fits  32       2        512      512
31       ...
32
33       ESO  specific  features  in  the FITS header are also supported. To get
34       values for 'HIERARCH ESO' keywords, just give the complete names within
35       double quotes. e.g.
36
37       dfits *.fits | fitsort "HIERARCH ESO INS LENS"
38
39       Another  way  of  giving HIERARCH ESO keywords is to use the short FITS
40       notation, the above example can be given as:
41
42       dfits *.fits | fitsort INS.LENS
43
44       Example: to retrieve the DPR keywords from  an  ESO  FITS  header,  you
45       would use:
46
47       dfits *.fits | fitsort To be completed...  DPR.CATG DPR.TYPE DPR.TECH
48
49       This second way of requesting HIERARCH ESO keywords is not only shorter
50       to type, it also avoids typing quotes or double-quotes on the  command-
51       line, making it easier to script with fitsort.
52
53       Notice that the keywords you give on the command-line are case-insensi‐
54       tive.  The above line is equivalent to:
55
56       dfits *.fits | fitsort dpr.catg dpr.type dpr.tech
57

OPTIONS

59       -d     Do not print out the first output line. This option is useful to
60              get  only  the  query  results, without the top line (giving all
61              column names). This makes it easy to script  fitsort  from  pro‐
62              grams like awk or perl.
63

FILES

65       Input  files  to dfits shall all comply with FITS format.  fitsort also
66       supports HIERARCH ESO FITS format.
67

SEE ALSO

69       dfits (1)
70
71
72
73                                  25 Jun 2001                       fitsort(1)
Impressum