Subversion Repositories planix.SVN

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
2 - 1 
.TH HISTOGRAM 8
2 
.SH NAME
3 
histogram \- draw a histogram
4 
.SH SYNOPSIS
5 
.B histogram
6 
[
7 
.B -h
8 
]
9 
[
10 
.B -c
11 
.I index
12 
]
13 
[
14 
.B -r
15 
.I minx,miny,maxx,maxy
16 
]
17 
[
18 
.B -s
19 
.I scale
20 
]
21 
[
22 
.B -t
23 
.I title
24 
]
25 
[
26 
.B -v
27 
.I maxv
28 
]
29 
.SH DESCRIPTION
30 
.I Histogram
31 
reads numbers, one per line, from its standard input
32 
and draws them as bars in a histogram.
33 
.PP
34 
Use
35 
.B -c
36 
to set the color
37 
.I index
38 
for the graph.
39 
A modulus operation on the value keeps the color index within the available range.
40 
.PP
41 
Unless
42 
.B -h
43 
.RI ( hold )
44 
is given,
45 
.I histogram
46 
will exit when it reaches the end-of-file.
47 
It will exit immediately if it is interrupted
48 
or if the
49 
.I exit
50 
menu option is chosen.
51 
.PP
52 
.B -r
53 
sets the initial window
54 
.I rectangle
55 
coordinates.
56 
.PP
57 
.B -s
58 
sets the
59 
.I scaling
60 
factor.
61 
.PP
62 
.B -t
63 
sets the
64 
.I title
65 
displayed on a line above the histogram.
66 
The last value read is displayed to the right of the title.
67 
.PP
68 
.B -v
69 
sets the maximum
70 
.I value
71 
that can be expected.
72 
.SH EXAMPLE
73 
Plot a sine wave:
74 
.IP
75 
.EX
76 
hoc -e 'for(i=0.0;i<20*PI;i=i+0.1) print (10+10*sin(i)), "\\n"'|
77 
	histogram -t 'sin(t), 0 ≤ t ≤ 20π' -v 20 -h
78 
.EE
79 
.PP
80 
Show the Dow Jones adjusted daily closing price back to January 1, 2000:
81 
.IP
82 
.EX
83 
site=http://ichart.finance.yahoo.com
84 
hget $site'/table.csv?s=^DJI&a=00&b=1&c=2000' |
85 
	awk -F, '{print $NF}' | histogram -t DJI -v 15000 -h
86 
.EE
87 
.SH SOURCE
88 
.B /sys/src/cmd/histogram.c
89 
.SH SEE ALSO
90 
.IR statusbar (8)