1Pamsummcol User Manual(0) Pamsummcol User Manual(0)
2
3
4
6 pamsummcol - summarize (sum, average, etc) a Netpbm image by column
7
8
10 pamsummcol { -sum | -mean | -min | -max } [imagefile]
11
12 All options can be abbreviated to their shortest unique prefix. You
13 may use two hyphens instead of one. You may separate an option name
14 and its value with white space instead of an equals sign.
15
16
18 This program is part of Netpbm(1).
19
20 pamsummcol reads a Netpbm image (PNM or PAM) and performs a summary
21 function over all the rows in each column (sum, mean, etc.). It pro‐
22 duces an image of the same kind that the same width and depth as the
23 input, and one row high. Its sample values are the result of the sum‐
24 mary.
25
26 pamsummcol performs the summary operation on each plane independently.
27
28 pamsummcol performs the operation on the actual sample values, not on
29 the light intensities represented by them in the case that the image is
30 a PGM or PPM image.
31
32 If you want to summarize by row instead of by column, run the input
33 through pamflip first (and if you want the output to be a single column
34 instead of a single row, use pamflip again).
35
36 If you want to summarize over the entire image (getting a one-tuple
37 output image), use pamsumm to get a summary row, pamflip to turn that
38 into a column, the pamsumm again to summarize the column.
39
40 If you want to summarize the individual samples in an entire image,
41 instead of by tuple, use pamsumm.
42
43 pamsummcol performs the operation on the actual sample values, not on
44 the light intensities represented by them in the case that the image is
45 a PGM or PPM image or PAM equivalent. You can use pnmgamma to convert
46 such an image to one with samples proportional to light intensity, and
47 then use pamsummcol on the result.
48
49 You can achieve the same thing as pamsummcol -mean with pamscale. Just
50 scale vertically to a single row, without scaling horizontally at all.
51 Use the pixel mixing method.
52
53
54
56 You must specify exactly one of -sum, -mean, -min, or -max.
57
58
59
60 -sum
61
62 This option makes the summary function addition.
63 In each column and plane of the output row, the sample
64 value is the
65 sum of all the samples values in the same column and plane
66 of the input.
67 If a result is greater than the image maxval, it is clipped
68 to
69 the maxval.
70
71
72 -mean
73
74 This option makes the summary function arithmetic mean.
75 In each column and plane of the output row, the sample
76 value is the
77 mean of all the samples values in the same column and plane
78 of the input.
79
80
81 -min
82
83 This option makes the summary function arithmetic minimum.
84 In each column and plane of the output row, the sample
85 value is the
86 minimum of all the samples values in the same column and
87 plane of
88 the input.
89
90
91 -max
92
93 This option makes the summary function arithmetic maximum.
94 In each column and plane of the output row, the sample
95 value is
96 the maximum of all the samples values in the same column
97 and
98 plane of the input.
99
100
101
102
104 pamsumm(1), pamscale(1), pamfunc(1), pamarith(1), pamscale(1), pam(1),
105
106
108 pamsummcol was added to Netpbm in Release 10.21 (March 2004).
109
110
111
112netpbm documentation 25 January 2009 Pamsummcol User Manual(0)