NAME

       fitstopnm - convert a FITS file into a portable anymap

SYNOPSIS

       fitstopnm [-image N] [-noraw] [-scanmax] [-printmax] [-min f] [-max f] [FITSfile]

DESCRIPTION

       Reads  a  FITS  file  as input.  Produces a portable pixmap if the FITS file consists of 3
       image planes (NAXIS = 3 and NAXIS3 = 3), a portable graymap if the FITS file consists of 2
       image  planes (NAXIS = 2), or whenever the -image flag is specified.  The results may need
       to be flipped top for bottom; if so, just pipe the output through pnmflip -tb.

OPTIONS

       The -image option is for FITS files with three axes.  The assumption  is  that  the  third
       axis is for multiple images, and this option lets you select which one you want.

       Flags  -min  and -max can be used to override the min and max values as read from the FITS
       header or the image data if no DATAMIN and DATAMAX keywords are found.  Flag -scanmax  can
       be  used  to force the program to scan the data even when DATAMIN and DATAMAX are found in
       the header. If -printmax is specified, the program will just print the min and max  values
       and  quit.   Flag  -noraw  can  be  used to force the program to produce an ASCII portable
       anymap.

       The program will tell what kind of anymap is writing.  All flags  can  be  abbreviated  to
       their shortest unique prefix.

REFERENCES

       FITS  stands  for  Flexible  Image  Transport  System.  A full description can be found in
       Astronomy & Astrophysics Supplement Series 44 (1981), page 363.

SEE ALSO

       pnmtofits(1), pgm(5), pnmflip(1)

AUTHOR

       Copyright  (C)  1989   by   Jef   Poskanzer,   with   modifications   by   Daniel   Briggs
       (dbriggs@nrao.edu) and Alberto Accomazzi (alberto@cfa.harvard.edu).

                                         20 September 89                             fitstopnm(1)