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
139
140
141
142
|
\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it! If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pamsummcol User Manual" 0 "25 January 2009" "netpbm documentation"
.SH NAME
pamsummcol - summarize (sum, average, etc) a Netpbm image by column
.UN synopsis
.SH SYNOPSIS
\fBpamsummcol\fP
{
\fB-sum\fP |
\fB-mean\fP |
\fB-min\fP |
\fB-max\fP
}
[\fIimagefile\fP]
.PP
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.
.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBpamsummcol\fP reads a Netpbm image (PNM or PAM) and performs a
summary function over all the rows in each column (sum, mean, etc.).
It produces an image of the same kind that the same width and depth as
the input, and one row high. Its sample values are the result of the
summary.
.PP
\fBpamsummcol\fP performs the summary operation on each plane
independently.
.PP
\fBpamsummcol\fP 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.
.PP
If you want to summarize by row instead of by column, run the input
through \fBpamflip\fP first (and if you want the output to be a single
column instead of a single row, use \fBpamflip\fP again).
.PP
If you want to summarize over the entire image (getting a one-tuple
output image), use \fBpamsumm\fP to get a summary row, \fBpamflip\fP
to turn that into a column, the \fBpamsumm\fP again to summarize the
column.
.PP
If you want to summarize the individual samples in an entire image,
instead of by tuple, use \fBpamsumm\fP.
.PP
\fBpamsummcol\fP 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. You can use
\fBpnmgamma\fP to convert such an image to one with samples proportional
to light intensity, and then use \fBpamsummcol\fP on the result.
.PP
You can achieve the same thing as \fBpamsummcol -mean\fP with
\fBpamscale\fP. Just scale vertically to a single row, without scaling
horizontally at all. Use the pixel mixing method.
.UN options
.SH OPTIONS
.PP
In addition to the options common to all programs based on libnetpbm
(most notably \fB-quiet\fP, see
.UR index.html#commonoptions
Common Options
.UE
\&), \fBpamsummcol\fP recognizes the following
command line options:
.PP
You must specify exactly one of \fB-sum\fP, \fB-mean\fP,
\fB-min\fP, or \fB-max\fP.
.TP
\fB-sum\fP
.sp
This option makes the summary function addition.
In each column and plane of the output row, the sample value is the
sum of all the samples values in the same column and plane of the input.
If a result is greater than the image maxval, it is clipped to
the maxval.
.TP
\fB-mean\fP
.sp
This option makes the summary function arithmetic mean.
In each column and plane of the output row, the sample value is the
mean of all the samples values in the same column and plane of the input.
.TP
\fB-min\fP
.sp
This option makes the summary function arithmetic minimum.
In each column and plane of the output row, the sample value is the
minimum of all the samples values in the same column and plane of
the input.
.TP
\fB-max\fP
.sp
This option makes the summary function arithmetic maximum.
In each column and plane of the output row, the sample value is
the maximum of all the samples values in the same column and
plane of the input.
.UN seealso
.SH SEE ALSO
.BR "pamsumm" (1)\c
\&,
.BR "pamflip" (1)\c
\&,
.BR "pamfunc" (1)\c
\&,
.BR "pamarith" (1)\c
\&,
.BR "pamscale" (1)\c
\&,
.BR "pam" (1)\c
\&,
.UN history
.SH HISTORY
.PP
\fBpamsummcol\fP was added to Netpbm in Release 10.21 (March
2004).
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source. The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/pamsummcol.html
.PP
|
