1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML><HEAD><TITLE>Pamsumm User Manual</TITLE></HEAD>
<BODY>
<H1>pamsumm</H1>
Updated: 07 February 2004
<BR>
<A HREF="#index">Table Of Contents</A>
<A NAME="lbAB"> </A>
<H2>NAME</H2>
pamsumm - Summarize the samples in a Netpbm image arithmetically
<A NAME="lbAC"> </A>
<H2>SYNOPSIS</H2>
<B>pamsumm</B>
{
<b>-sum</b> |
<b>-mean</b> |
<b>-min</b> |
<b>-max</b>
}
[<b>-normalize</b>]
[<b>-brief</b>]
[<I>imagefile</I>]
<P>All options can be abbreviated to their shortest unique prefix.
You may use two hyphens instead of one. You may separate an option
name and its value with white space instead of an equals sign.
<A NAME="lbAD"> </A>
<H2>DESCRIPTION</H2>
<p>This program is part of <a href="index.html">Netpbm</a>.
<p><b>pamsumm</b> reads a Netpbm image (PNM or PAM) and performs a
summary function over all the samples in all the rows, columns, and planes
and prints the result to Standard Output.
<p><b>pamsumm</b> performs the operation on the actual sample values,
not on the light intensities represented by them in the case that the
image is a PGM or PPM image or PAM equivalent. If you want to do
arithmetic on light intensities of such a visual image, you can use
<b>pnmgamma</b> to convert it to one with samples proportional to
light intensity, and then use <b>pamsumm</b> on the result.
<p>If you want to summarize by column (e.g. add up the columns
separately), use <b>pamsummcol</b>. If you want to summarize by row,
use a combination of <b>pamsummcol</b> and <b>pamflip</b>. If you
want to summarize a particular plane, use <b>pamchannel</b> to
extract it and then <b>pamsumm</b>.
<A NAME="options"> </A>
<H2>OPTIONS</H2>
<p>You must specify exactly one of <b>-sum</b>, <b>-mean</b>,
<b>-min</b>, or <b>-max</b>.
<DL COMPACT>
<DT><B>-sum</b>
<DD>
<P>This option makes the summary function addition.
<DT><B>-mean</b>
<DD>
<P>This option makes the summary function arithmetic mean.
<DT><B>-min</b>
<DD>
<P>This option makes the summary function arithmetic minimum.
<DT><B>-max</b>
<DD>
<P>This option makes the summary function arithmetic maximum.
<DT><B>-normalize</b>
<DD>
<P>This option causes each sample to be normalized to a fraction
(in the range 0..1) so the result is independent of the image's
maxval. E.g. if you request the mean of an image which has maxval
200 and all the samples have value 50, <b>pamsumm</b> will give you
50 as an answer. But <b>pamsumm -normalize</b> will give you .25.
<p>If instead you want a result that is independent of maxval but still
in integers, and your input is PNM, you can use <b>pamdepth</b> to
convert the input to some standard maxval and not use <b>-normalize</b>.
For example, if you want the mean intensity of a PPM image, on a scale of
0 to 99, do
<pre>
<kbd>
pamdepth 99 myimage.ppm | pamsumm -mean
</kbd>
</pre>
<p>This option was new in Netpbm 10.22 (April 2004)
<dt><b>-brief</b>
<dd>
<p>This option causes <b>pamsumm</b> to display the answer as a bare
number, rather than in a complete sentence.
<p>This option was new in Netpbm 10.22 (April 2004)
</DL>
<A NAME="lbAE"> </A>
<H2>SEE ALSO</H2>
<B><A HREF="pamsummcol.html">pamsumm</A></B>,
<B><A HREF="pam.html">pam</A></B>,
<A NAME="history"> </A>
<h2>HISTORY</h2>
<p><b>pamsumm</b> was added to Netpbm in Release 10.21 (March
2004).
<HR>
<A NAME="index"> </A>
<H2>Table Of Contents</H2>
<UL>
<LI><A HREF="#lbAB">NAME</A>
<LI><A HREF="#lbAC">SYNOPSIS</A>
<LI><A HREF="#lbAD">DESCRIPTION</A>
<LI><A HREF="#options">OPTIONS</A>
<LI><A HREF="#lbAE">SEE ALSO</A>
<LI><A HREF=#history>HISTORY</A>
</UL>
</BODY>
</HTML>
|