1Pamtofits User Manual(0) Pamtofits User Manual(0)
2
3
4
6 pamtofits - convert a Netpbm image into FITS format
7
8
10 pamtofits [-max f] [-min f] [pamfile]
11
12
14 This program is part of Netpbm(1).
15
16 pamtofits reads a PNM or PAM image as input and produces a FITS (Flexi‐
17 ble Image Transport System) file as output. The resolution of the out‐
18 put file is either 8 bits/pixel, or 16 bits/pixel, depending on the
19 value of maxval in the input file. If the input file is a PBM or PGM
20 image, the output file consists of a single plane image (NAXIS = 2). If
21 instead the input file is a PPM image, the output file will consist of
22 a three-plane image (NAXIS = 3, NAXIS3 = 3).
23
24 You can find a full description of the FITS format in Astronomy &
25 Astrophysics Supplement Series 44 (1981), page 363.
26
27
29 -min and -max tell pamtofits what 'physical values' zero and maxval
30 sample values, respectively, in the input image represent. Physical
31 values are a FITS concept. pamtofits sets up the BSCALE and BZERO FITS
32 header cards to indicate this information.
33
34 The default for -min is 0 and for -max is the maxval, which means if
35 you don't specify these options, the FITS physical values are in fact
36 the original Netpbm sample values.
37
38 pamtofits always sets up the FITS header DATAMIN and DATAMAX cards to
39 indicate that the highest physical value in the image is the one corre‐
40 sponding to the Netpbm maxval and the lowest is that corresponding to
41 Netpbm zero. This isn't really how those cards are supposed to be
42 used, since the input image doesn't necessarily contain the full possi‐
43 ble range of sample values. It is a conservative approximation.
44
45
47 pamtofits was originally pnmtofits and did not handle PAM input. It
48 was extended and renamed in Netpbm 10.30 (October 2005).
49
50
52 fitstopnm(1), pam(1)
53
54
56 Copyright (C) 1989 by Wilson H. Bent (whb@hoh-2.att.com), with modifi‐
57 cations by Alberto Accomazzi (alberto@cfa.harvard.edu).
58
59
60
61netpbm documentation 25 September 2005 Pamtofits User Manual(0)