1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
|
<html>
<head>
<!-- This file has been generated by unroff 1.0, 01/15/08 14:06:29. -->
<!-- Do not edit! -->
<STYLE TYPE="text/css">
<!--
A:link{text-decoration:none}
A:visited{text-decoration:none}
A:active{text-decoration:none}
OL,UL,P,BODY,TD,TR,TH,FORM { font-family: arial,helvetica,sans-serif;; font-size:small; color: #333333; }
H1 { font-size: x-large; font-family: arial,helvetica,sans-serif; }
H2 { font-size: large; font-family: arial,helvetica,sans-serif; }
H3 { font-size: medium; font-family: arial,helvetica,sans-serif; }
H4 { font-size: small; font-family: arial,helvetica,sans-serif; }
-->
</STYLE>
<title>ploticus: dist prefab</title>
<body bgcolor=D0D0EE vlink=0000FF>
<br>
<br>
<center>
<table cellpadding=2 bgcolor=FFFFFF width=550><tr>
<td>
<table cellpadding=2 width=550><tr>
<td><br><h2>dist prefab</h2></td>
<td align=right>
<small>
<a href="../doc/welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
Version 2.40 Jan'08
</small><br><a href="../doc/prefabs.html">Prefabs</a>
<td></tr></table>
</td></tr>
<td>
<br>
<br>
<title>Manual page for dist_prefab(PL)</title>
</head>
<body>
<center><a href="prefab_dist_ex.html"><img src="../gallery/prefab_img/dist1thm.gif" border=0>
<br><b>View the dist prefab examples</a></b><br><br></center>
<p>
<b>dist</b> is a
<a href="prefabs.html">
prefab
</a>
that computes and displays a frequency distribution (histogram) on one data field.<tt> </tt>
The data file does not need to be ordered in any particular way.<tt> </tt>
The field may contain continuous numeric data, or alphanumeric values.<tt> </tt>
Continuous numeric data is the default, but
the <b>cats</b> option may be used to produce category distributions
(each unique value having a bar).<tt> </tt>
With continuous numeric data, "bins" will be set up and values will
be placed into these bins (any alpha values will be lumped into one
"alpha" category).
<p>
A user-contributed prefab called
<a href="prefab_multidist.html">
multidist
</a>
is also available; it can do multiple, overlaid frequency distributions.<tt> </tt>
<br><br><br>
<h2>Hint</h2>
If no bars are appearing, try specifying bar size, eg.<tt> </tt>
<tt>barwidth=0.1</tt>. This glitch is due to the fact that
default bar widths are related to data space.<tt> </tt>
<br><br><br>
<h2>Parameters</h2>
<table cellpadding=2 bgcolor=A0A0A0 width=600>
<tr bgcolor=FFFFEC align=center><td><b>Prefab<br>parameter<br>name</td><td>Data type</td>
<td>Default</td><td>Description</td>
<td>Examples<br><small>(ignore line wrapping)</td></tr>
<tr bgcolor=FFFFFF>
<td><b><a href="prefab_stdparms.html">Standard parameters</a></td>
<td> </td>
<td> </td>
<td colspan=2>Most of the <a href="prefab_stdparms.html">standard prefab parameters</a> may be used.
You <font color=D00000>must specify</font> <b>data</b> (the name of the input data file).
The legend parameters and <b>ptselect</b> aren't available with this prefab.
</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>x</td>
<td><a href="atypes.html#dfield">data field</a></td>
<td><font color=D00000>must be specified</font></td>
<td>Identifies the data field to be used when computing the distribution. Old name: <b>fld</b> </td>
<td><tt>x=2<br>x=pmb</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>binsize</td>
<td>numeric</td>
<td>based on data</td>
<td>The size of one "bin" for numeric distributions.</td>
<td><tt>binsize=2.5</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>cats</td>
<td><tt>yes</tt> or <tt>no</tt></td>
<td><tt>no</td>
<td>If <tt>yes</tt>, a category distribution, using alphanumeric data, will be done.</td>
<td><tt>cats=yes</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>curve</td>
<td><tt>yes</tt><br>or<br><a href="linedetails.html">linedetails</a></td>
<td> </td>
<td>If specified, a bspline curve will be fit to the histogram and displayed.</td>
<td><tt>curve=yes</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>color</td>
<td><a href="color.html">color</a></td>
<td><tt>pink</td>
<td>Color of the histogram bars.</td>
<td><tt>color=orange</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>barwidth</td>
<td><a href="atypes.html#punits">inches or cm</a></td>
<td>based on data</td>
<td>The width of the bars.</td>
<td><tt>barwidth=0.06</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>savetbl</td>
<td><tt>yes</tt> | <tt>no</tt></td>
<td> </td>
<td>If <tt>yes</tt>, a the computed frequency distribution will be dumped to the diagnostic stream
(usually standard error).</td>
<td><tt>savetbl=yes</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>order</td>
<td><tt>natural</tt><br>or<br><tt>mag</tt><br>or<br><tt>rev</tt></td>
<td><tt>natural</td>
<td>Controls the order in which bars are drawn from left to right, with <b>cats</b>.
<tt>natural</tt> shows them in alphabetical order,
<tt>mag</tt> based on magnitude from low to high, and <tt>rev</tt> shows them from high to low.</td>
<td><tt>order=mag</td>
</tr>
</table>
<br>
<br>
</td></tr>
<td align=right>
<a href="../doc/welcome.html">
<img src="../doc/ploticus.gif" border=0></a><br><small>data display engine <br>
<a href="../doc/Copyright.html">Copyright Steve Grubb</a>
<br>
<br>
<center>
<img src="../gallery/all.gif">
</center>
</td></tr>
</table>
<br>
<center>
Ploticus is hosted at http://ploticus.sourceforge.net <br>
<img src="http://sourceforge.net/sflogo.php?group_id=38453" width="88" height="31" border="0" alt="SourceForge Logo">
</center>
<p><hr>
Markup created by <em>unroff</em> 1.0, <tt> </tt> <tt> </tt>January 15, 2008.
</body>
</html>
|
