1Pamsummcol User Manual(0)                            Pamsummcol User Manual(0)
2
3
4

NAME

6       pamsummcol - summarize (sum, average, etc) a Netpbm image by column
7
8

SYNOPSIS

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

DESCRIPTION

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 instead of over columns
37       separately, use pamsumm.
38
39       pamsummcol performs the operation on the actual sample values,  not  on
40       the light intensities represented by them in the case that the image is
41       a PGM or PPM image or PAM equivalent.  You can use pnmgamma to  convert
42       such  an image to one with samples proportional to light intensity, and
43       then use pamsummcol on the result.
44
45       You can achieve the same thing as pamsummcol -mean with pamscale.  Just
46       scale  vertically to a single row, without scaling horizontally at all.
47       Use the pixel mixing method.
48
49
50

OPTIONS

52       You must specify exactly one of -sum, -mean, -min, or -max.
53
54
55
56       -sum
57
58              This option makes the summary function addition.
59                   In each column and plane of  the  output  row,  the  sample
60              value is the
61                   sum  of all the samples values in the same column and plane
62              of the input.
63                   If a result is greater than the image maxval, it is clipped
64              to
65                   the maxval.
66
67
68       -mean
69
70              This option makes the summary function arithmetic mean.
71                   In  each  column  and  plane  of the output row, the sample
72              value is the
73                   mean of all the samples values in the same column and plane
74              of the input.
75
76
77       -min
78
79              This option makes the summary function arithmetic minimum.
80                   In  each  column  and  plane  of the output row, the sample
81              value is the
82                   minimum of all the samples values in the  same  column  and
83              plane of
84                   the input.
85
86
87       -max
88
89              This option makes the summary function arithmetic maximum.
90                   In  each  column  and  plane  of the output row, the sample
91              value is
92                   the maximum of all the samples values in  the  same  column
93              and
94                   plane of the input.
95
96
97
98

SEE ALSO

100       pamsumm(1), pamscale(1), pamfunc(1), pamarith(1), pamscale(1), pam(1),
101
102

HISTORY

104       pamsummcol was added to Netpbm in Release 10.21 (March 2004).
105
106
107
108netpbm documentation           07 February 2004      Pamsummcol User Manual(0)
Impressum