.TL
Fitstopnm User Manual
.SH 1
fitstopnm
.LP
Updated: 20 September 89
.br
Table Of Contents
.SH 2
NAME
.LP
fitstopnm - convert a FITS file into a PNM image
.SH 2
SYNOPSIS
.LP
\fBfitstopnm\fR
[\fB-image\fR \fIN\fR]
[\fB-scanmax\fR]
[\fB-printmax\fR]
[\fB-min\fR \fIf\fR]
[\fB-max\fR \fIf\fR]
[\fIFITSfile\fR]
.LP
All options may be abbreviated to their shortest unique prefix.
.SH 2
DESCRIPTION
.LP
.LP
This program is part of Netpbm.
.LP
\fBfitstopnm\fR reads a FITS file as input and produces a PPM
image if the FITS file consists of 3 image planes (NAXIS = 3 and
NAXIS3 = 3), or a PGM image if the FITS file consists of 2 image
planes (NAXIS = 2), or if you specify the \fB-image\fR option.  The
results may need to be flipped top for bottom; if so, just pipe the
output through \fBpamflip -tb\fR.
.SH 2
OPTIONS
.LP
.LP
The \fB-image\fR 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.
.LP
You can use options \fB-min\fR and \fB-max\fR 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.
.LP
You can use the \fB-scanmax\fR option to force the program to scan
the data even when DATAMIN and DATAMAX are found in the header. If you
specify \fB-printmax\fR, the program will just print the min and max
values and quit.
.LP
The program tells you what kind of PNM image it is writing.
.SH 2
REFERENCES
.LP
.LP
FITS stands for Flexible Image Transport System.  A full description
can be found in Astronomy & Astrophysics Supplement Series 44 (1981),
page 363.
.SH 2
SEE ALSO
.LP
pnmtofits,
pamflip,
pgm
.SH 2
AUTHOR
.LP
Copyright (C) 1989 by Jef Poskanzer, with modifications by Daniel
Briggs (dbriggs@nrao.edu) and
Alberto Accomazzi (alberto@cfa.harvard.edu).
.br
\l'5i'
.SH 2
Table Of Contents
.LP
.IP \(bu
NAME
.IP \(bu
SYNOPSIS
.IP \(bu
DESCRIPTION
.IP \(bu
OPTIONS
.IP \(bu
REFERENCES
.IP \(bu
SEE ALSO
.IP \(bu
AUTHOR
.LP