~ubuntu-branches/ubuntu/maverick/ploticus/maverick

« back to all changes in this revision

Viewing changes to man/manpl/prefab_vbars

  • Committer: Bazaar Package Importer
  • Author(s): James W. Penny
  • Date: 2002-04-10 23:02:04 UTC
  • Revision ID: james.westby@ubuntu.com-20020410230204-64em4ns2f57c5u3l
Tags: 2.0.3-1
* The "That Tears it, Now You Have to Update Docs Package" Release.
* New upstream release (well, not so new :-( )   closes: Bug#137578
* Correct missing libpng2-dev in build-depends.  closes: Bug#142205
* Use correct syntax to:
* close URL type.                                closes: Bug#137577
* fix Architecture                               closes: Bug#141657
* close ITP                                      closes: Bug#132878

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.ig >>
 
2
<STYLE TYPE="text/css">
 
3
<!--
 
4
        A:link{text-decoration:none}
 
5
        A:visited{text-decoration:none}
 
6
        A:active{text-decoration:none}
 
7
-->
 
8
</STYLE>
 
9
<title>ploticus: vbars prefab</title>
 
10
<body bgcolor=D0D0EE vlink=0000FF>
 
11
<br>
 
12
<br>
 
13
<center>
 
14
<table cellpadding=2 bgcolor=FFFFFF width=550 ><tr>
 
15
<td>
 
16
  <table cellpadding=2 width=550><tr>
 
17
  <td><br><h2>vbars prefab</h2></td>
 
18
  <td align=right>
 
19
  <small>
 
20
  <a href="../doc/Welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
 
21
  <a href="../doc/Welcome.html">Welcome</a> &nbsp; &nbsp;
 
22
  <a href="../gallery/index.html">Gallery</a> &nbsp; &nbsp;
 
23
  <a href="../doc/Contents.html">Handbook</a> 
 
24
  <td></tr></table>
 
25
</td></tr>
 
26
<td>
 
27
<br>
 
28
<br>
 
29
.>>
 
30
 
 
31
.TH vbars_prefab PL "08-JAN-2002   PL ploticus.sourceforge.net"
 
32
 
 
33
.SH EXAMPLE 1
 
34
.LP
 
35
.ig >>
 
36
<center><table cellpadding=2><tr>
 
37
<td><img src="../gallery/prefab_img/vbars1.gif"></td></tr>
 
38
</table></center>
 
39
.>>
 
40
.LP
 
41
.nf
 
42
  pl  -prefab vbars  data=data4  delim=tab  x=1  y=2  vals=yes\\
 
43
       yrange=0  yinc=20  ygrid=yes  barwidth=0.3 
 
44
 
 
45
        data4 file:
 
46
                Group A 78      7
 
47
                Group B 84      12
 
48
                Group C 56      6
 
49
 
 
50
.fi
 
51
.SH EXAMPLE 2
 
52
.ig >>
 
53
<center><table cellpadding=2><tr>
 
54
<td><img src="../gallery/prefab_img/vbars2.gif"></td></tr>
 
55
</table></center>
 
56
.>>
 
57
.LP
 
58
.nf
 
59
   pl -prefab vbars  data=data5  delim=tab  x=1  y=2  err=3  \\
 
60
   y2=4  err2=5  errunder=yes  ygrid=yes  barwidth=0.1  \\
 
61
     name=Treatment  name2=Control stubvert=yes 
 
62
 
 
63
    data5 file:
 
64
        Test 3  76      19      84      14
 
65
        Test 4  83      12      64      9
 
66
        Test 5  95      11      92      13
 
67
        ...etc..
 
68
 
 
69
.fi
 
70
.SH EXAMPLE 3
 
71
.ig >>
 
72
<center><table cellpadding=2><tr>
 
73
<td><img src="../gallery/prefab_img/vbars3.gif"></td></tr>
 
74
</table></center>
 
75
.>>
 
76
.LP
 
77
.nf
 
78
  pl -prefab vbars  data=data5  delim=tab  x=1  y=2  err=3  y2=4  \\
 
79
  err2=5   erronly=yes   name=Treatment  name2=Control  stubvert=yes \\
 
80
  errcolor=red  errcolor2=blue  sep=0.08  xgrid=yes  ylog=log
 
81
 
 
82
.fi
 
83
 
 
84
.SH EXAMPLE 4
 
85
.ig >>
 
86
<center><table cellpadding=2><tr>
 
87
<td><img src="../gallery/prefab_img/vbars4.gif"></td></tr>
 
88
</table></center>
 
89
.>>
 
90
.nf
 
91
   pl -prefab vbars  data=data18  x=1  y=2  crossover=0  \\
 
92
   color=blue  vals=yes
 
93
 
 
94
   The data18 file:
 
95
        1992    -47
 
96
        1993    -63
 
97
        1994    -24
 
98
        1995    12
 
99
        ..etc.
 
100
.fi
 
101
 
 
102
.LP
 
103
.ig >>
 
104
<a href="prefabs.html#examples">
 
105
.>>
 
106
\0How to run these examples
 
107
.ig >>
 
108
</a>
 
109
.>>
 
110
 
 
111
.ig >>
 
112
<br><br><br>
 
113
.>>
 
114
 
 
115
.SH DESCRIPTION
 
116
\fCvbars\fR is a 
 
117
.ig >>
 
118
<a href="prefabs.html">
 
119
.>>
 
120
\0prefab
 
121
.ig >>
 
122
</a>
 
123
.>>
 
124
for producing bar graphs with vertical solid bars for one or two groups.
 
125
Two groups of values may be displayed if \fBy2\fR (etc) are used, as in the second example.
 
126
Error bars may be added above or below the bar graph, or error bars alone may be rendered.
 
127
By default the X axis is categories, but it may be continuous numeric if \fBxnumeric\fR is used
 
128
(for chronological data use the
 
129
.ig >>
 
130
<a href="prefab_chron.html">
 
131
.>>
 
132
\0chron prefab
 
133
.ig >>
 
134
</a>
 
135
.>>
 
136
).
 
137
This prefab is based on
 
138
.ig >>
 
139
<a href="bars.html">
 
140
.>>
 
141
\0proc bars
 
142
.ig >>
 
143
</a>
 
144
.>>
 
145
\0.
 
146
 
 
147
.ig >>
 
148
<br><br><br>
 
149
.>>
 
150
 
 
151
.SH PARAMETERS
 
152
.IP
 
153
.ig >>
 
154
<a href="prefab_stdparms.html">
 
155
.>>
 
156
\0Standard prefab parameters
 
157
.ig >>
 
158
</a>
 
159
.>>
 
160
are all supported.  \fBdata\fR, \fBx\fR and \fBy\fR are required.
 
161
\fBy\fR values should be numeric and will determine the height of bars.
 
162
\fBx\fR values determine bar locations.
 
163
 
 
164
.br
 
165
.br
 
166
.IP
 
167
\fBcolor\fR is the 
 
168
.ig >>
 
169
<a href="color.html">
 
170
.>>
 
171
\0color
 
172
.ig >>
 
173
</a>
 
174
.>>
 
175
of the first set of filled bars (default = orange)
 
176
 
 
177
.br
 
178
.br
 
179
.IP
 
180
\fBbarwidth\fR is the width of the filled bars.  This is a value in inches,
 
181
or may be given as \fCline\fR for very thin bars.
 
182
 
 
183
.br
 
184
.br
 
185
.IP
 
186
\fBerrcolor\fR is the error bar 
 
187
.ig >>
 
188
<a href="color.html">
 
189
.>>
 
190
\0color
 
191
.ig >>
 
192
</a>
 
193
.>>
 
194
for the error bars associated with the first set of bars
 
195
(default = black).
 
196
 
 
197
.br
 
198
.br
 
199
.IP
 
200
\fBerrwidth\fR is the width of error bar tails in inches (default = 0.08)
 
201
 
 
202
.br
 
203
.br
 
204
.IP
 
205
\fBerrthick\fR is the thickness of the error bar lines (default = 0.5)
 
206
 
 
207
.br
 
208
.br
 
209
.IP
 
210
\fBerrunder\fR may be set to \fCyes\fR if error bars should be drawn "under"
 
211
the filled bars (only the upward error bar is thus visible).
 
212
 
 
213
.br
 
214
.br
 
215
.IP
 
216
\fBerronly\fR may be set to \fCyes\fR if error bars only are desired,
 
217
without any filled bars.
 
218
 
 
219
.br
 
220
.br
 
221
.IP
 
222
\fBxnumeric\fR may be specified as \fCyes\fR to signify that X values
 
223
are numeric and not categories.
 
224
 
 
225
.br
 
226
.br
 
227
.IP
 
228
\fBvals\fR may be specified as \fCyes\fR to indicate that the
 
229
numeric values should be displayed near the top of each bar.
 
230
 
 
231
.br
 
232
.br
 
233
.IP
 
234
\fBcrossover\fR may be specified as the value in Y where bars begin
 
235
to point downward instead of upward.  For instance, \fCcrossover=0\fR
 
236
is often useful when dealing with financial income, to show loss
 
237
using downward bars.
 
238
 
 
239
.br
 
240
.br
 
241
.IP
 
242
\fBcurve\fR may be given as \fCyes\fR, or as a
 
243
.ig >>
 
244
<a href="linedetails.html">
 
245
.>>
 
246
\0linedetails
 
247
.ig >>
 
248
</a>
 
249
.>>
 
250
attribute, which causes a moving average curve to be fit to bars, and drawn behind 
 
251
the bars.  Not applicable to a second set of bars.
 
252
The \fBorder\fR parameter may be set to the number of preceding data points 
 
253
to be considered when computing averages (default = 5).
 
254
 
 
255
.LP
 
256
The following parameters are used when displaying two groups of values.
 
257
The second example above illustrates.
 
258
 
 
259
.IP
 
260
\fBy2\fR, \fBcolor2\fR, \fBerr2\fR, and \fBerrcolor2\fR control the size and color
 
261
of the second set of bars, and the magnitude and color of error bars
 
262
associated with the second set.  Default color2 is green.
 
263
 
 
264
.br
 
265
.br
 
266
.IP
 
267
\fBsep\fR controls bar separation (default=0.15)
 
268
 
 
269
.br
 
270
.br
 
271
.IP
 
272
\fBname\fR and \fBname2\fR should be given as legend labels for the two groups
 
273
 
 
274
.br
 
275
.br
 
276
.IP
 
277
\fBlegend\fR controls the 
 
278
.ig >>
 
279
<a href="attributetypes.html#xy">
 
280
.>>
 
281
\0location
 
282
.ig >>
 
283
</a>
 
284
.>>
 
285
of the legend.  Example: \fC"legend=1 0.5"\fR   Default is \fCmin+0.4 max\fR.
 
286
 
 
287
 
 
288
.ig >>
 
289
<br>
 
290
<br>
 
291
</td></tr>
 
292
<td align=right>
 
293
<a href="Welcome.html">
 
294
<img src="../doc/ploticus.gif" border=0></a><br><small>data display engine &nbsp; <br>
 
295
<a href="../doc/Copyright.html">Copyright Steve Grubb</a>
 
296
<br>
 
297
<br>
 
298
<center>
 
299
<img src="../gallery/all.gif">
 
300
</center>
 
301
</td></tr>
 
302
</table>
 
303
.>>