dfits(1) [debian man page]

dfits(1)						      General Commands Manual							  dfits(1)

NAME

       dfits - display FITS file header information

SYNOPSIS

       dfits [-x xtnum] <list>
       dfits [-x xtnum] -

DESCRIPTION

       dfits  displays FITS header informations on stdout. Header information can be found in the main header only (default), in extensions, or in
       both.  See the -x option below.	dfits accepts multi-file input.  'dfits -' expects single file data coming from stdin.	dfits also accepts
       now 'HDR' files. These are identified from the fact that they contain a line feed in one of the 80 first characters.

OPTIONS

       -x xtnum
	      Specifies the extension to print out. Extensions are numbered starting from 1. If this option is not specified, only the main header
	      is printed out. If this option specifies an extension that does not exist, nothing is printed out.
	      Specify 0 as extension number to get a print of the main header plus all extension headers.

       Examples :
       dfits *.fits
       dfits *.fits | grep NAXIS3
       gzip -d < star.fits.gz | dfits - | more
       dfits -x 0 *.fits
       dfits -x 3 *.fits

SEE ALSO

       fitsort can be combined with dfits output to sort out keyword values of a group of FITS files.

FILES

       Files shall all comply with FITS format

								    30 Mar 2000 							  dfits(1)

fitsort(1)						      General Commands Manual							fitsort(1)

NAME

       fitsort - sort FITS header information from a list of files

SYNOPSIS

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

DESCRIPTION

       fitsort	extract keyword values from a set of FITS headers and outputs it in an ASCII table format, which is compatible with most data pro-
       cessing software packages. It shall only be used in combination with the dfits utility.

       The ASCII output is shown in columns. Columns are aligned with blank characters and also separated by tabulations. Blank  alignment  allows
       human readers to visualize the output in a pretty format, tabulations are there for spreadsheet compatibility. If you want to load out fit-
       sort output into any spreadsheet, specify that fields shall be separated by tabulations and entries separated by linefeeds.

       Examples :
       dfits *.fits | fitsort BITPIX NAXIS NAXIS1 NAXIS2

       The output would look like:
       FILE	      BITPIX   NAXIS	NAXIS1	 NAXIS2
       file0001.fits  16       2	128	 128
       file0002.fits  32       2	512	 512
       ...

       ESO specific features in the FITS header are also supported. To get values for 'HIERARCH ESO' keywords, just give the complete names within
       double quotes. e.g.

       dfits *.fits | fitsort "HIERARCH ESO INS LENS"

       Another way of giving HIERARCH ESO keywords is to use the short FITS notation, the above example can be given as:

       dfits *.fits | fitsort INS.LENS

       Example: to retrieve the DPR keywords from an ESO FITS header, you would use:

       dfits *.fits | fitsort To be completed...  DPR.CATG DPR.TYPE DPR.TECH

       This  second way of requesting HIERARCH ESO keywords is not only shorter to type, it also avoids typing quotes or double-quotes on the com-
       mand-line, making it easier to script with fitsort.

       Notice that the keywords you give on the command-line are case-insensitive.  The above line is equivalent to:

       dfits *.fits | fitsort dpr.catg dpr.type dpr.tech

OPTIONS

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

FILES

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

SEE ALSO

       dfits (1)

								    25 Jun 2001 							fitsort(1)