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

« back to all changes in this revision

Viewing changes to doc/prefab_dist.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, 02/26/02 11:56:14. -->
 
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: dist 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>dist 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 dist_prefab(PL)</title>
 
34
</head>
 
35
<body>
 
36
 
 
37
<h2>EXAMPLE 1</h2>
 
38
<p>
 
39
<center><table cellpadding=2><tr>
 
40
<td><img src="../gallery/prefab_img/dist1.gif"></td></tr>
 
41
</table></center>
 
42
<p>
 
43
<pre>
 
44
        pl -prefab dist fld=1  data=data6  curve=yes  binsize=0.05 \
 
45
          barwidth=0.08  ygrid=yes 
 
46
 
 
47
        data6 file:
 
48
                0.017
 
49
                0.269
 
50
                0.178
 
51
                ..etc.
 
52
 
 
53
 
 
54
 
 
55
</pre>
 
56
<h2>EXAMPLE 2</h2>
 
57
<center><table cellpadding=2><tr>
 
58
<td><img src="../gallery/prefab_img/dist2.gif"></td></tr>
 
59
</table></center>
 
60
<p>
 
61
<pre>
 
62
  pl -prefab dist  fld=1  data=data8  cats=yes  yrange=0  \
 
63
     stubvert=yes  barwidth=0.05   ylbl="# Hits"   order=rev 
 
64
 
 
65
  data8 file:
 
66
        home
 
67
        kwindex
 
68
        details
 
69
        browseform
 
70
        ..etc.
 
71
</pre>
 
72
<p>
 
73
<br><br><br>
 
74
<p>
 
75
<a href="prefabs.html#examples">
 
76
 How to run these examples
 
77
</a>
 
78
 
 
79
 
 
80
<br><br><br>
 
81
 
 
82
<h2>DESCRIPTION</h2>
 
83
<b>dist</b> is a 
 
84
<a href="prefabs.html">
 
85
 prefab
 
86
</a>
 
87
that computes and displays a frequency distribution (histogram)
 
88
on a data field.<tt> </tt>
 
89
The data file does not need to be ordered in any particular way.<tt> </tt>
 
90
The field may contain continuous numeric data, or alphanumeric values.<tt> </tt>
 
91
Continuous numeric data is the default, but
 
92
the <b>cats</b> option may be used to produce category distributions 
 
93
(each unique value having a bar).<tt> </tt>
 
94
With continuous numeric data, "bins" will be set up and values will
 
95
be placed into these bins (any alpha values will be lumped into one
 
96
"alpha" category).  
 
97
<p>
 
98
This prefab is based on
 
99
<a href="tabulate.html">
 
100
 proc tabulate
 
101
</a>
 
102
and
 
103
<a href="bars.html">
 
104
 proc bars
 
105
</a>
 
106
 .<tt> </tt>
 
107
 
 
108
<br><br><br>
 
109
<h2>HINT</h2>
 
110
If no bars are appearing, try specifying bar size, eg.<tt> </tt>
 
111
<tt>barsize=0.1</tt>.  This glitch is due to the fact that 
 
112
default bar widths are related to data space.<tt> </tt>
 
113
 
 
114
<br><br><br>
 
115
 
 
116
<h2>PARAMETERS</h2>
 
117
 
 
118
<dl>
 
119
<dt><dd><p>
 
120
<a href="prefab_stdparms.html">
 
121
 Standard prefab parameters
 
122
</a>
 
123
are all supported except <b>x</b>, <b>y</b>, and <b>err</b>.<tt> </tt>
 
124
<b>data</b> is required.<tt> </tt>
 
125
 
 
126
<br>
 
127
<br>
 
128
<dt><dd><p>
 
129
<b>fld</b> (required) is the 
 
130
<a href="attributetypes.html#dfield">
 
131
 data field
 
132
</a>
 
133
that the frequency distribution will be computed on
 
134
 
 
135
<br>
 
136
<br>
 
137
<dt><dd><p>
 
138
<b>binsize</b> is the size of one "bin" in numeric distributions.<tt> </tt>
 
139
 
 
140
<br>
 
141
<br>
 
142
<dt><dd><p>
 
143
<b>cats</b> may be given as <tt>yes</tt> if <b>fld</b> is not
 
144
continuous numeric data.<tt> </tt>
 
145
 
 
146
<br>
 
147
<br>
 
148
<dt><dd><p>
 
149
<b>curve</b> may be given as <tt>yes</tt> or as a 
 
150
<a href="linedetails.html">
 
151
 linedetails attribute
 
152
</a>
 
153
to cause a bspline curve to be rendered along with the histogram.<tt> </tt>
 
154
 
 
155
<br>
 
156
<br>
 
157
<dt><dd><p>
 
158
<b>color</b> is the 
 
159
<a href="color.html">
 
160
 color
 
161
</a>
 
162
of the bars (default = pink)
 
163
 
 
164
<br>
 
165
<br>
 
166
<dt><dd><p>
 
167
<b>barwidth</b> is the width of the bars in absolute units.<tt> </tt>
 
168
 
 
169
<br>
 
170
<br>
 
171
<dt><dd><p>
 
172
<b>savetable</b> may be given in order to save a text representation of
 
173
the computed frequency distribution.  It may be a file name, <tt>stderr</tt>, or
 
174
<tt>stdout</tt>.<tt> </tt>
 
175
 
 
176
<br>
 
177
<br>
 
178
<dt><dd><p>
 
179
<b>order</b> controls the order in which bars are drawn from left to right.  
 
180
By default this is <tt>natural</tt> (alphabetical order). 
 
181
Allowable values are <tt>mag</tt> (from low to high), and <tt>rev</tt> (high to low).<tt> </tt>
 
182
 
 
183
 
 
184
<br>
 
185
<br>
 
186
</td></tr>
 
187
<td align=right>
 
188
<a href="Welcome.html">
 
189
<img src="../doc/ploticus.gif" border=0></a><br><small>data display engine &nbsp; <br>
 
190
<a href="../doc/Copyright.html">Copyright Steve Grubb</a>
 
191
<br>
 
192
<br>
 
193
<center>
 
194
<img src="../gallery/all.gif">
 
195
</center>
 
196
</td></tr>
 
197
</table>
 
198
</dl>
 
199
<p><hr>
 
200
Markup created by <em>unroff</em> 1.0,&#160;<tt> </tt>&#160;<tt> </tt>February 26, 2002.
 
201
</body>
 
202
</html>