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

« back to all changes in this revision

Viewing changes to doc/prefab_lines.html

  • 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
<html>
 
2
<head>
 
3
<!-- This file has been generated by unroff 1.0, 01/11/02 07:19:18. -->
 
4
<!-- Do not edit! -->
 
5
<STYLE TYPE="text/css">
 
6
<!--
 
7
        A:link{text-decoration:none}
 
8
        A:visited{text-decoration:none}
 
9
        A:active{text-decoration:none}
 
10
-->
 
11
</STYLE>
 
12
<title>ploticus: lines prefab</title>
 
13
<body bgcolor=D0D0EE vlink=0000FF>
 
14
<br>
 
15
<br>
 
16
<center>
 
17
<table cellpadding=2 bgcolor=FFFFFF width=550 ><tr>
 
18
<td>
 
19
  <table cellpadding=2 width=550><tr>
 
20
  <td><br><h2>lines prefab</h2></td>
 
21
  <td align=right>
 
22
  <small>
 
23
  <a href="../doc/Welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
 
24
  <a href="../doc/Welcome.html">Welcome</a> &nbsp; &nbsp;
 
25
  <a href="../gallery/index.html">Gallery</a> &nbsp; &nbsp;
 
26
  <a href="../doc/Contents.html">Handbook</a> 
 
27
  <td></tr></table>
 
28
</td></tr>
 
29
<td>
 
30
<br>
 
31
<br>
 
32
 
 
33
<title>Manual page for lines_prefab(PL)</title>
 
34
</head>
 
35
<body>
 
36
 
 
37
<a href="#desc">Skip over the examples</a>
 
38
<br><br>
 
39
 
 
40
<h2>EXAMPLE 1</h2>
 
41
<center><table cellpadding=2><tr>
 
42
<td><img src="../gallery/prefab_img/lines1.gif"></td></tr>
 
43
</table></center>
 
44
<p>
 
45
<pre>
 
46
   pl -prefab lines  data=data17  x=1 y=2  pointsym=none
 
47
 
 
48
   The data17 file:
 
49
        331 75
 
50
        331.624 83.5518
 
51
        332.105 88.7758
 
52
        ..etc.
 
53
 
 
54
 
 
55
</pre>
 
56
 
 
57
<h2>EXAMPLE 2</h2>
 
58
<center><table cellpadding=2><tr>
 
59
<td><img src="../gallery/prefab_img/lines2.gif"></td></tr>
 
60
</table></center>
 
61
<p>
 
62
<pre>
 
63
   pl  -prefab lines data=data10 delim=tab  x=1  y=2  y2=4  step=yes \
 
64
     yrange=0 name="Group A" name2="Group B" xlbl=Months
 
65
 
 
66
 
 
67
</pre>
 
68
 
 
69
<h2>EXAMPLE 3</h2>
 
70
<p>
 
71
<center><table cellpadding=2><tr>
 
72
<td><img src="../gallery/prefab_img/lines3.gif"></td></tr>
 
73
</table></center>
 
74
<p>
 
75
<pre>
 
76
   pl  -prefab lines  data=data10 delim=tab  x=1  y=2 err=3  y2=4 err2=5  \
 
77
       y3=6 err3=7  y4=8 err4=9   yrange=0  xlbl=Months \
 
78
       name="Group A" name2="Group B" name3="Group C" name4="Group D" 
 
79
 
 
80
   The data10 file:
 
81
       0        100     2       100     4       100     3       100     4
 
82
       1.5      92      4       94      7       87      6       86      5
 
83
       3        89      4       92      8       78      6       74      4
 
84
       6        86      5       91      8       65      8       61      6
 
85
       ..etc.
 
86
 
 
87
</pre>
 
88
 
 
89
<h2>EXAMPLE 4</h2>
 
90
<p>
 
91
<center>
 
92
<img src="../gallery/prefab_img/lines4.gif">
 
93
</center>
 
94
<p>
 
95
<pre>
 
96
   pl -prefab lines  data=data20  x=1  y=2 
 
97
 
 
98
   The data20 file:
 
99
      1031 20.96 6.4
 
100
      1032 19.71 5.8
 
101
      1033 19.98 5.9
 
102
      ... etc.
 
103
 
 
104
</pre>
 
105
 
 
106
<h2>EXAMPLE 5</h2>
 
107
<p>
 
108
<center>
 
109
<img src="../gallery/prefab_img/lines5.gif">
 
110
</center>
 
111
 
 
112
<p>
 
113
<pre>
 
114
  pl -prefab lines  data=data20  x=1  y=2  fill=redorange pointsym=none  \
 
115
        y2=2 pointsym2=none  
 
116
</pre>
 
117
In this example the same data field was given twice, first to do the filled
 
118
area, and again to do the blue line.<tt> </tt>
 
119
 
 
120
<br><br><br>
 
121
 
 
122
<h2>EXAMPLE 6</h2>
 
123
<p>
 
124
<center>
 
125
<img src="../gallery/prefab_img/lines6.gif">
 
126
</center>
 
127
 
 
128
<p>
 
129
<pre>
 
130
   pl -prefab lines  data=data20  x=1  y=2  gapmissing=yes 
 
131
 
 
132
</pre>
 
133
 
 
134
<h2>EXAMPLE 7</h2>
 
135
<p>
 
136
<center>
 
137
<img src="../gallery/prefab_img/lines7.gif">
 
138
</center>
 
139
 
 
140
<p>
 
141
<pre>
 
142
   pl -prefab lines  data=data20  x=1  y=2  fill=tan1  pointsym=none  \
 
143
        y2=2 pointsym2=none  y3=3  pointsym3=none  linedet3=color=black \
 
144
        yrange="0 25"  name="background" name3="interior" 
 
145
 
 
146
</pre>
 
147
 
 
148
<br><br><br>
 
149
 
 
150
<p>
 
151
<a href="prefabs.html#examples">
 
152
 How to run these examples
 
153
</a>
 
154
 
 
155
<a name=desc></a>
 
156
 
 
157
<br><br><br>
 
158
 
 
159
<h2>DESCRIPTION</h2>
 
160
<b>lines</b> is a 
 
161
<a href="prefabs.html">
 
162
 prefab
 
163
</a>
 
164
for producing line plots with optional point symbols and error bars,
 
165
for up to four groups.<tt> </tt>
 
166
For the first group data points are in data fields given in <b>x</b> and <b>y</b>, and 
 
167
optional error bar value given in <b>err</b>.<tt> </tt>
 
168
By default <b>x</b> is assumed to be continuous numeric, but it can be categories
 
169
if <b>cats</b> is specified (for chronological X data, use the
 
170
<a href="prefab_chron.html">
 
171
 chron prefab
 
172
</a>
 
173
).<tt> </tt>
 
174
To display a second curve, use <b>y2</b>, <b>err2</b>, etc.<tt> </tt>
 
175
Same for third and fourth curves.<tt> </tt>
 
176
This prefab is based on
 
177
<a href="lineplot.html">
 
178
 proc lineplot
 
179
</a>
 
180
 .<tt> </tt>
 
181
 
 
182
<br><br><br>
 
183
 
 
184
<h2>PARAMETERS</h2>
 
185
 
 
186
<dl>
 
187
<dt><dd><p>
 
188
<a href="prefab_stdparms.html">
 
189
 Standard prefab parameters
 
190
</a>
 
191
are all supported.  <b>data</b>, <b>x</b> and <b>y</b> are required.<tt> </tt>
 
192
 
 
193
<br>
 
194
<br>
 
195
<dt><dd><p>
 
196
<b>name</b> is a short description for the first curve, for
 
197
inclusion in a legend.<tt> </tt>
 
198
 
 
199
<br>
 
200
<br>
 
201
<dt><dd><p>
 
202
<b>linedet</b> controls
 
203
<a href="linedetails.html">
 
204
 line appearance details
 
205
</a>
 
206
for the first curve.  
 
207
 
 
208
<br>
 
209
<br>
 
210
<dt><dd><p>
 
211
<b>pointsym</b> controls the data points on the first curve.<tt> </tt>
 
212
<a href="symboldetails.html">
 
213
 symbol
 
214
</a>
 
215
 .  It may be given as <tt>none</tt> for no point symbol.<tt> </tt>
 
216
 
 
217
<br>
 
218
<br>
 
219
<dt><dd><p>
 
220
<b>fill</b> may be specified as a 
 
221
<a href="color.html">
 
222
 color
 
223
</a>
 
224
and causes the area under the curve to be filled.<tt> </tt>
 
225
 
 
226
<br>
 
227
<br>
 
228
<dt><dd><p>
 
229
<b>y2</b>, <b>err2</b>, <b>name2</b>, <b>linedet2</b>, <b>pointsym2</b>, and <b>fill2</b>
 
230
may be specified for a second curve.  <b>x</b> will be used for the
 
231
X component of the curve.<tt> </tt>
 
232
 
 
233
<br>
 
234
<br>
 
235
<dt><dd><p>
 
236
<b>y3</b>, <b>err3</b>, <b>name3</b>, <b>linedet3</b>, <b>pointsym3</b>, and <b>fill3</b>
 
237
may be specified for a third curve.  <b>x</b> will be used for the
 
238
X component of the curve.<tt> </tt>
 
239
 
 
240
<br>
 
241
<br>
 
242
<dt><dd><p>
 
243
<b>y4</b>, <b>err4</b>, <b>name4</b>, <b>linedet4</b>, <b>pointsym4</b>, and <b>fill4</b>
 
244
may be specified for a fourth curve.  <b>x</b> will be used for the
 
245
X component of the curve.<tt> </tt>
 
246
 
 
247
<br>
 
248
<br>
 
249
<dt><dd><p>
 
250
<b>step</b> may be specified as <tt>yes</tt> to get stairstep curves.<tt> </tt>
 
251
This turns off point symbols.  Applies to all curves.<tt> </tt>
 
252
 
 
253
 
 
254
<br>
 
255
<br>
 
256
<dt><dd><p>
 
257
<b>gapmissing</b> may be specified as <tt>yes</tt> or <tt>small</tt>.<tt> </tt>
 
258
If <tt>yes</tt>, missing data will cause a gap in the line (normally
 
259
the line connects plottable points without a gap).  <tt>small</tt> is
 
260
the same as <tt>yes</tt> except that it leaves a small overhang.<tt> </tt>
 
261
Applies to all curves.<tt> </tt>
 
262
 
 
263
<br>
 
264
<br>
 
265
<dt><dd><p>
 
266
<b>cats</b> may be specified as <tt>yes</tt> to signify that X values
 
267
are categories rather than numeric.<tt> </tt>
 
268
 
 
269
<br>
 
270
<br>
 
271
<dt><dd><p>
 
272
<b>errcolor</b> is the error bar 
 
273
<a href="color.html">
 
274
 color
 
275
</a>
 
276
(default = black)
 
277
 
 
278
<br>
 
279
<br>
 
280
<dt><dd><p>
 
281
<b>errwidth</b> is the width of error bar tails (default = 0.08)
 
282
 
 
283
<br>
 
284
<br>
 
285
<dt><dd><p>
 
286
<b>errthick</b> is the thickness of the error bar lines (default = 0.5)
 
287
 
 
288
<br>
 
289
<br>
 
290
<dt><dd><p>
 
291
<b>legend</b> controls the 
 
292
<a href="attributetypes.html#xy">
 
293
 location
 
294
</a>
 
295
of the legend.  Example: <tt>"legend=1 0.5"</tt>   Default is <tt>min+0.4 max</tt>.<tt> </tt>
 
296
 
 
297
<br>
 
298
<br>
 
299
</td></tr>
 
300
<td align=right>
 
301
<a href="Welcome.html">
 
302
<img src="../doc/ploticus.gif" border=0></a><br><small>data display engine &nbsp; <br>
 
303
<a href="../doc/Copyright.html">Copyright Steve Grubb</a>
 
304
<br>
 
305
<br>
 
306
<center>
 
307
<img src="../gallery/all.gif">
 
308
</center>
 
309
</td></tr>
 
310
</table>
 
311
</dl>
 
312
<p><hr>
 
313
Markup created by <em>unroff</em> 1.0,&#160;<tt> </tt>&#160;<tt> </tt>January 11, 2002.
 
314
</body>
 
315
</html>