ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/total.1
(Generate patch)

Comparing ray/doc/man/man1/total.1 (file contents):
Revision 1.6 by greg, Wed Jul 13 15:21:28 2005 UTC vs.
Revision 1.12 by greg, Tue Nov 16 03:30:45 2021 UTC

# Line 19 | Line 19 | total - sum up columns
19   ][
20   .B \-o{f|d}
21   ][
22 + .B "\-in M"
23 + ][
24 + .B "\-on M"
25 + ][
26   .B \-tC
27   ][
28   .B \-N
# Line 64 | Line 68 | The
68   .I \-m
69   option can be used to compute the mean rather than the total.
70   For sums, the arithmetic mean is computed.
71 + If a power is also specified using the
72 + .I \-s
73 + option, the inverse power will be applied to the averaged result.
74   For products, the geometric mean is computed.
75   (A logarithmic sum of absolute values is used to avoid overflow, and
76   zero values are silently ignored.)
# Line 106 | Line 113 | In addition, the
113   .I \-r
114   option can be specified to override reinitialization and thus
115   give a running total every N lines (or every blank line).
116 + This option also turns off the usual output flushing at each total.
117   If the end of file is reached, the current total is printed
118   and the calculation is reset before the next file (with or without the
119   .I \-r
120   option).
121   .PP
122   The
123 + .I \-in
124 + option if present, will limit the number of input records read
125 + (per input file).
126 + The
127 + .I \-on
128 + option may be used to limit the total number of outut records produced.
129 + .PP
130 + The
131   .I \-tC
132   option can be used to specify the input and output tab character.
133   The default tab character is TAB.
134   .PP
135   If no files are given, the standard input is read.
136 < .SH EXAMPLE
136 > .SH EXAMPLES
137   To compute the RMS value of colon-separated columns in a file:
138   .IP "" .2i
139 < total -t: -m -s2 input
139 > total \-t: \-m \-s2 input
140   .PP
141   To produce a running product of values from a file:
142   .IP "" .2i
143 < total -p -1 -r input
143 > total \-p \-1 \-r input
144   .SH BUGS
145   If the input files have varying numbers of columns, mean values
146   will certainly be off.
# Line 135 | Line 151 | the tab character is white.
151   .SH AUTHOR
152   Greg Ward
153   .SH "SEE ALSO"
154 < cnt(1), neaten(1), rcalc(1), rlam(1), tabfunc(1)
154 > cnt(1), neaten(1), rcalc(1), rcollate(1), rlam(1), rsplit(1), tabfunc(1)

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines