File: rangebar.html

package info (click to toggle)
ploticus 2.0.3-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 3,696 kB
  • ctags: 2,035
  • sloc: ansic: 40,100; perl: 456; sh: 186; makefile: 129
file content (678 lines) | stat: -rw-r--r-- 19,332 bytes parent folder | download | duplicates (2)
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
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
<html>
<head>
<!-- This file has been generated by unroff 1.0, 03/01/02 09:13:43. -->
<!-- Do not edit! -->
<STYLE TYPE="text/css">
<!--
        A:link{text-decoration:none}
        A:visited{text-decoration:none}
        A:active{text-decoration:none}
-->
</STYLE>
<title>ploticus: proc rangebar</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>proc rangebar</h2></td>
  <td align=right>
  <small>
  <a href="../doc/Welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
  <a href="../doc/Welcome.html">Welcome</a> &nbsp; &nbsp;
  <a href="../gallery/index.html">Gallery</a> &nbsp; &nbsp;
  <a href="../doc/Contents.html">Handbook</a> 
  <td></tr></table>
</td></tr>
<td>
<br>
<br>

<title>Manual page for proc_rangebar(PL)</title>
</head>
<body>
 
<center>
<img src="../gallery/rangebar0.gif">
</center>

<h2>DESCRIPTION</h2>
<b>proc rangebar</b> draws one boxplot (also known as box-and-whisker plot).<tt> </tt>
This is a compact way to display the range and distribution of data.<tt> </tt>
A rangebar includes a box.  The median is displayed within the box, and
the extent of the box shows the interquartile range (the 25th and 75th percentiles).<tt> </tt>
Tails at either end show either the 5th and 95th percentiles, the minima and maxima,
or the extent of 1.5 interquartile ranges.<tt> </tt>
<b>proc rangebar</b> may also be used to show means and standard deviations.<tt> </tt>

<h2>FEATURES</h2>
Can compute the necessary statistics, or accept externally calculated ones.<tt> </tt>
Can output the computed statistics; two formats available.<tt> </tt>
Can produce rangebars based on median and quartiles, or
mean and standard deviations.<tt> </tt>
Rangebars may be vertical or horizontal.<tt> </tt>
Allows appearance control over all lines, the bar, and the median indicator.<tt> </tt>
Automatic display of N as well as number of missing observations.<tt> </tt>
Display and reporting of outliers.<tt> </tt>

<h2>EXAMPLES</h2>
See the Gallery Rangebar page
<a href="../gallery/gall.rangebar.html"><img src="../gallery/btn/here.gif"></a>

<h2>VARIABLES THAT ARE SET</h2>
<b>NVALUES</b> is set to N.  If nothing was plotted, this will be equal to 0.<tt> </tt>
<p>
The following variables are set as soon as statistics are computed, whether or
not a plot is actually drawn.<tt> </tt>
<p>
<b>RANGEBARMEDIAN</b> is set to hold the median value.<tt> </tt>
This might be useful in drawing a line for comparing medians.<tt> </tt>
Not set when using <tt>meanmode</tt>.<tt> </tt>
<p>
<b>RANGEBARMEAN</b> is set to hold the mean value.<tt> </tt>
This might be useful in drawing a line for comparing means.<tt> </tt>
Set only when using <tt>meanmode</tt>.<tt> </tt>
<p>
<b>RANGEBARIQRMIN</b> and <b>RANGEBARIQRMAX</b> are set to hold the
values of the bottom and top of the box.  Not set when using <tt>meanmode</tt>.<tt> </tt>
<p>
<b>RANGEBARMIN</b> and <b>RANGEBARMAX</b> are set to hold the
values at the ends of the tails.<tt> </tt>
<p>

<h2>UNPLOTTABLE DATA</h2>
Invalid values are omitted (however the number of invalids may be shown
using the <tt>printm</tt> option).  
Rangebars that lie completely out of the plotting
area are omitted with a warning.<tt> </tt>
If outliers are being plotted, outliers that are out of range
are omitted with a warning.<tt> </tt>
Unless <tt>truncate</tt> is set to <tt>no</tt>,
bars and tails are truncated to the bounds of the
plotting area. 


<h2>MODES</h2>
This proc can calculate the median, quartiles, etc.<tt> </tt>
(use the <tt>datafield</tt> attribute) before drawing the box plot.<tt> </tt>
Or it can plot from pre-calculated descriptive statistic values,
if the <tt>values</tt> or <tt>plotfields</tt> attributes are used.<tt> </tt>
<p>
There is also <tt>meanmode</tt> which just calculates mean &amp; 
standard deviation and draws an error bar.<tt> </tt>
<p>
To turn on display of outliers, set <tt>showoutliers</tt> to <tt>yes</tt>.<tt> </tt>
<p>
Computed statistics may be written to a file, stderr, etc.<tt> </tt>
This proc may also be used <i>only</i> to compute statistics
(and set variables)
without doing any plotting at all-- see <tt>statsonly</tt>.<tt> </tt>


<h2>PREREQUISITES</h2>
A plotting area must be set up using <b>proc areadef</b> 
and <b>proc getdata</b> must be executed to 
access or define some data.<tt> </tt>



<h2>MANDATORY ATTRIBUTES</h2>
None.  Default behavior is for statistics to be calculated from
data field 1 to produce a vertical rangebar against the Y axis
at X location 1.0  and for an <tt>N=</tt> label to be placed just
above the X axis.<tt> </tt>

<h2>ATTRIBUTES</h2>
<p>
<b>axis</b> <tt>x</tt> | <tt>y</tt>
<dl>
<dt><dd><p>
Determines which axis to plot against.<tt> </tt>
<tt>x</tt> results in horizontal rangebars, while
<tt>y</tt> results in vertical ones.  Default is <tt>y</tt>.<tt> </tt>
Example: <tt>axis: x</tt>

</dl>
<p>
<b>datafield</b> 
<a href="attributetypes.html#dfield">
<i> dfield </i>
</a>
<dl>
<dt><dd><p>
Specifies the data field on which to compute descriptive statistics.<tt> </tt>
Example: <tt>datafield: 2</tt>

</dl>
<p>
<b>barloc</b> 
<a href="attributetypes.html#plotvalue">
<i> plotvalue </i>
</a>
<dl>
<dt><dd><p>
Location where the rangebar is to be rendered.<tt> </tt>
For vertical boxplots this is a plottable value in X;
for horizontal boxplots this is a plottable value in Y.<tt> </tt>
Example: <tt>barloc: 3</tt>

</dl>
<p>
<b>barwidth</b> <i>n</i>
<dl>
<dt><dd><p>
The width of the box portion of the rangebar in 
<a href="attributetypes.html#positionunits">
absolute units
</a>
  .  Default is 0.2 inches.<tt> </tt>
Example: <tt>barloc: 0.1</tt>

</dl>
<p>
<b>mediansym</b> 
<a href="symboldetails.html">
<i> symboldetails </i>
</a>
 | line
<dl>
<dt><dd><p>
Specifies the symbol that will be displayed to show the median.<tt> </tt>
May be a symbol specification (to get dots, etc.) or <tt>line</tt> which
is the default.<tt> </tt>
Example: <tt>mediansym: shape=diamond</tt>

</dl>
<p>
<b>values</b> <i>5thpercentile 25th median 75th 95th [N]</i>
<dl>
<dt><dd><p>
Specify pre-computed descriptive statistics that should just
be plotted.  5 plottable values should be given.  If a 6th value
is given it is taken to be N, and <tt>printn</tt> is implied.<tt> </tt>
Min/max may be substituted for the 5th and 95th percentiles
if desired.<tt> </tt>
<br>
Example: <tt>values: 0.3 3.0 5.3 6.2 9.4 236</tt>

</dl>
<p>
<b>plotfields</b> <i>5thpercentile 25th median 75th 95th [N]</i>
<br>
or with <tt>meanmode</tt>: <b>plotfields</b> <i>mean stddev [N]</i>  
<dl>
<dt><dd><p>
Similar to <tt>values</tt> but rather than literal values, a set of 
<a href="attributetypes.html#dfield">
<i> dfields </i>
</a>
are given.  The data will be accessed from one row, which may be
specified using <tt>plotrecord</tt>.  (If <tt>plotrecord</tt> not specified,
data will be taken from the first row by default.  Proc processdata
action: select may be used to isolate one row of data.)
Example: 
<br>
<tt>plotfields: 1 2 3 4 5
<br>
plotrecord: 1</tt>

</dl>
<p>
<b>plotrecord</b> <i>n</i>
<dl>
<dt><dd><p>
Used with <tt>plotfields</tt>; indicates which data row to get the values from.<tt> </tt>
First row is <tt>1</tt>.  Example: see <tt>plotfields</tt> above.<tt> </tt>
If not specified, first row is assumed.<tt> </tt>

</dl>
<p>
<b>tailmode</b> <tt>5/95 | minmax | 1.5iqr</tt>
<dl>
<dt><dd><p>
Specifies whether the rangebar tails are to extend to the 5th and 95th percentile,
to the min and max, or using 1.5 x IQR.<tt> </tt>
Only relevant when statistics are computed internally.<tt> </tt>
Default is <tt>5/95</tt>.<tt> </tt>
<br>
Note: 1.5irq mode causes the tails to be rendered using the IQR, which is the
interquartile range (the difference between 75th and 25th percentiles).  
This follows the formal Tukey specification, in that the
lower tail will extend from the bottom of the box downward to the nearest data 
point on or above (25th - (1.5 x IQR)).  Similar for upper tail.<tt> </tt>

Example: <tt>tailmode: minmax</tt>

</dl>
<p>
<b>95tics</b> <tt>yes </tt>|<tt> no</tt>
<dl>
<dt><dd><p>
If <tt>tailmode</tt> is <tt>minmax</tt>, allows display of 5th and 95th percentile
by adding tics.<tt> </tt>
Example: <tt>95tics: yes</tt>

</dl>
<p>
<b>taildetails</b> 
<a href="linedetails.html">
<i> linedetails </i>
</a>
<dl>
<dt><dd><p>
Controls color, width, etc. of tail lines.<tt> </tt>
<br>
Example: <tt>taildetails: color=blue width=1.8</tt>

</dl>
<p>
<b>outline</b> <tt>yes </tt>| <tt>no</tt>
<dl>
<dt><dd><p>
If <tt>yes</tt>, box is outlined with a line.<tt> </tt>

</dl>
<p>
<b>outlinedetails</b> 
<a href="linedetails.html">
<i> linedetails </i>
</a>
<dl>
<dt><dd><p>
Controls color, width, etc. of box outline.<tt> </tt>

</dl>
<p>
<b>color</b> 
<a href="color.html">
<i> color </i>
</a>
<dl>
<dt><dd><p>
Specifies the color of the box area.<tt> </tt>
Example: <tt>color: yellow</tt>

</dl>
<p>
<b>truncate</b>  <tt>yes</tt> | <tt>no</tt>
<dl>
<dt><dd><p>
If <tt>yes</tt>, bars are truncated to plotting area.<tt> </tt>
Default is <tt>yes</tt>.<tt> </tt>

</dl>
<p>
<b>ticlen</b> <i>n</i>
<dl>
<dt><dd><p>
Length, in 
<a href="attributetypes.html#positionunits">
<i> absolute units </i>
</a>
 , of the tics which appear at the end of the tails.<tt> </tt>
Default is 70% of the width of the bar.<tt> </tt>

</dl>
<p>
<b>meanmode</b> <tt>yes</tt> | <tt>no</tt>
<dl>
<dt><dd><p>
If yes, mean and standard deviation are computed and drawn as
an error bar, instead of a boxplot of median/quartiles, etc.<tt> </tt>
Mean is shown as a point (style can be controlled using <tt>mediansym</tt>).<tt> </tt>
Number of standard deviations may be controlled using <tt>nstddevs</tt>.<tt> </tt>
Cannot be used with <tt>values</tt>; use <b>proc bars</b> instead.<tt> </tt>
Appearance of the lines may be controlled using <tt>taildetails</tt>.<tt> </tt>

</dl>
<p>
<b>logmean</b>  <tt>yes</tt> | <tt>no</tt>
<dl>
<dt><dd><p>
If yes, mean and standard deviation are computed in log space.<tt> </tt>
Useful with data having log characteristics; when plotted in
log space the standard deviations will appear equidistant from the mean.<tt> </tt>
If log+1 scaling is in effect for the plot, then this feature 
will operate in log+1 space (allowing 0.0 values).<tt> </tt>

</dl>
<p>
<b>skipmed</b> <tt>yes</tt> | <tt>no</tt>
<dl>
<dt><dd><p>
When using <tt>meanmode</tt>, this attribute may be specified as <tt>yes</tt> to speed things
up a bit by avoiding computation of medians and percentiles.<tt> </tt>
Default is always <tt>no</tt>.<tt> </tt>

</dl>
<p>
<b>nstddevs</b> <i>n</i>
<dl>
<dt><dd><p>
Used with <tt>meanmode</tt>.  Specifies the number of standard deviations
to use in each direction when drawing the error bar.  Default is 1.<tt> </tt>

</dl>
<p>
<b>meansym</b>  <tt>yes</tt> | 
<a href="symboldetails.html">
<i> symboldetails </i>
</a>
<dl>
<dt><dd><p>
Specifies a symbol to be placed at the mean, when a median-based rangebar
is being rendered.  If <tt>yes</tt>, a default symbol (a small black dot)
will be placed at the mean  
(its symbol specification is: <tt>shape=circle style=filled fillcolor=black radius=0.02</tt>)
Other symbols may be rendered by giving
other symboldetails specifications.  If <tt>no</tt>, a mean symbol will not 
be rendered.  Default is <tt>no</tt>.<tt> </tt>
<br>
Example: <tt>symboldetails: yes</tt>

</dl>
<p>
<b>select</b> 
<a href="condex.html">
<i> conditional-expresion</i>
</a>
<dl>
<dt><dd><p>
Only relevant when computing statistics internally.<tt> </tt>
Allows cases to be selected for inclusion using a selection expression.<tt> </tt>

</dl>
<p>
<b>statsonly</b> <tt>yes</tt> | <tt>no</tt>
<dl>
<dt><dd><p>
If yes, statistics will be computed and internal @variables set, but nothing
will be plotted.<tt> </tt>


</dl>
<h2>PERTAINING TO OUTPUT OF COMPUTED STATS</h2>
<p>
<b>showstats</b> <tt>yes </tt>| <tt>no</tt> | <tt>only</tt>
<dl>
<dt><dd><p>
If <tt>yes</tt> or <tt>only</tt>, all the computed descriptive statistics 
will be written to the showstatsfile.<tt> </tt>
If <tt>only</tt>, the statistics will be printed but no bars will be drawn.<tt> </tt>

</dl>
<p>
<b>showbriefstats</b> <tt>yes </tt>| <tt>no</tt> | <tt>only</tt>
<dl>
<dt><dd><p>
If yes, and if N &gt; 0, the most important computed descriptive statistics 
will be written to the showstatsfile.  All fields are on one line, TAB-delimited,
for convenient use by other programs.<tt> </tt>
The fields are in this order: 
<dt><dd><p>
tag, datafield, N, mean, standard deviation, median, min, max, #missing.<tt> </tt>
<dt><dd><p>
The tag contents may be set using the <tt>briefstatstag</tt> attribute; if this attribute is not
set then the first result field will be datafield. 

</dl>
<p>
<b>briefstatstag</b> text
<dl>
<dt><dd><p>
Set the contents of the tag that will be written at the beginning of each 'briefstats' record.<tt> </tt>
This may be useful in identifying cases and groups in the 'brief stats' output.<tt> </tt>

</dl>
<p>
<b>showstatsfile</b> <i>filename</i>
<dl>
<dt><dd><p>
If specified, statistics will be written to this file.<tt> </tt>
If not specified, statistics will be written to the diagnostic stream,
usually stderr.<tt> </tt>
File will be opened in <b>append</b> mode, so the caller may want 
to remove previous contents of the file before invoking ploticus.<tt> </tt>



</dl>
<h2>PERTAINING TO THE N= and MISSING= LABELS</h2>
<p>
<b>printn</b> <tt>yes </tt>| <tt>no</tt>
<dl>
<dt><dd><p>
If <tt>yes</tt>, a label showing N (the number of observations) is produced.<tt> </tt>
Default is <tt>yes</tt>.<tt> </tt>
Example: <tt>printn: no</tt>

</dl>
<p>
<b>nlocation</b> 
<a href="attributetypes.html#locvalue">
<i> locvalue </i>
</a>
<dl>
<dt><dd><p>
Where to position the N label.  The label will be aligned with the rangebar.<tt> </tt>
For vertical rangebars <tt>location</tt> indicates where to place the label
in Y; for horizontal, X.<tt> </tt>
Example: <tt>nlocation: -4</tt>

</dl>
<p>
<b>nword</b> 
<a href="attributetypes.html#string">
<i> string </i>
</a>
<dl>
<dt><dd><p>
A template that determines the format of the N label.<tt> </tt>
Default is <tt>N=@N</tt>.<tt> </tt>
The N value is substituted for the <tt>@N</tt> symbol.<tt> </tt>
Example: <tt>(N = @N)</tt>


</dl>
<p>
<b>printmissing</b> <tt>yes</tt> | <tt>no</tt>
<dl>
<dt><dd><p>
If <tt>yes</tt>, a label showing the number of non-plottable (missing) values is produced.<tt> </tt>
Only relevant if statistics are calculated internally.<tt> </tt>
Example: <tt>printmissing: yes</tt>

</dl>
<p>
<b>mlocation</b> 
<a href="attributetypes.html#locvalue">
<i> locvalue </i>
</a>
<dl>
<dt><dd><p>
Where to position the missing values label.  
The label will be aligned with the rangebar.<tt> </tt>
For vertical rangebars <tt>location</tt> indicates where to place the label
in Y; for horizontal, X.<tt> </tt>

</dl>
<p>
<b>mword</b> 
<a href="attributetypes.html#string">
<i> string </i>
</a>
<dl>
<dt><dd><p>
A template that determines the format of the label showing number of
missing values.<tt> </tt>
Default is <tt>M=@M</tt>.<tt> </tt>
The N value is substituted for the <tt>@M</tt> symbol.<tt> </tt>
Example: <tt>(@M missing)</tt>


</dl>
<p>
<b>ntextdetails</b> 
<a href="textdetails.html">
<i> textdetails </i>
</a>
<dl>
<dt><dd><p>
Set the size, color, font or fine-tune the position of the N labels.<tt> </tt>
Alternate name for backward compatibility: <tt>textdetails</tt>.<tt> </tt>
<br>
Example: <tt>ntextdetails: size=8 style=I</tt>

</dl>
<p>
<b>mtextdetails</b> 
<a href="textdetails.html">
<i> textdetails </i>
</a>
<dl>
<dt><dd><p>
Set the size, color, font or fine-tune the position of the missing labels.<tt> </tt>
<br>
Example: <tt>mtextdetails: size=8 adjust=0,0.05</tt>

</dl>
<p>
<b>mwhenexists</b> <tt> yes|no</tt>
<dl>
<dt><dd><p>
If <tt>yes</tt>, the missing label will be displayed only if the number of
missing observations is greater than 0.  Default is <tt>no</tt>.<tt> </tt>



</dl>
<h2>OUTLIER HANDLING OPTIONS</h2>

<p>
<b>showoutliers</b> <tt>yes</tt> | <tt>no</tt>
<dl>
<dt><dd><p>
If <tt>yes</tt>, outliers will be displayed and/or reported upon.<tt> </tt>
An outlier is any point that is beyond the end of either of the rangebar's tails.<tt> </tt>
The default way of displaying outliers is circles for the near outliers
and asterisks for the far outliers.  The default boundary between near
and far is 3 times the interquartile range.<tt> </tt>

</dl>
<p>
<b>outlierprint</b> <tt>yes</tt> | <tt>no</tt>
<dl>
<dt><dd><p>
If <tt>yes</tt>, a report on each outlier will be printed to standard error.<tt> </tt>

</dl>
<p>
<b>outliernearsym</b>
<a href="symboldetails.html">
<i> symboldetails </i>
</a>
 | <tt>none</tt>
<dl>
<dt><dd><p>
Specifies the symbol for displaying near outliers.<tt> </tt>
Default is a small circle: <tt>shape=circle style=outline radius=0.05</tt>.<tt> </tt>
Use <tt>none</tt> if you are displaying outliers as lines or labels
and don't want any geometric symbol.<tt> </tt>

</dl>
<p>
<b>outlierfarsym</b>
<a href="symboldetails.html">
<i> symboldetails </i>
</a>
 | <tt>none</tt>
<dl>
<dt><dd><p>
Specifies the symbol for displaying far outliers.<tt> </tt>
Default is an asterisk: <tt>shape=circle style=spokes radius=0.05</tt>
Use <tt>none</tt> if you are displaying outliers as lines or labels
and don't want any geometric symbol.<tt> </tt>

</dl>
<p>
<b>outliernearfarcutoff</b>  <i>n</i>
<dl>
<dt><dd><p>
The boundary between near outliers and far outliers will be <i>n</i> times
the interquartile range.  Default is 3.0.<tt> </tt>

</dl>
<p>
<b>outlierlinelen</b>  <i>n</i>
<dl>
<dt><dd><p>
Display outliers as line segments.<tt> </tt>
If specified, all outliers (near and far) 
are displayed as short line segments rather than symbols.<tt> </tt>
<i>n</i> will be the length of these segments, in 
<a href="attributetypes.html#positionunits">
<i>absolute space</i>
</a>
 .  The color and width of these line segments may be controlled using
<tt>outlierlinedetails</tt>.<tt> </tt>
<br>
Example: <tt>outlierlinelen: 0.1</tt>

</dl>
<p>
<b>outlierlabelfield</b> 
<a href="attributetypes.html#dfield">
<i> dfield </i>
</a>
<dl>
<dt><dd><p>
If specified, the contents of this field will appear as a text label for each outlier.<tt> </tt>
For vertical rangebars the label will appear a bit to the right 
of the point.<tt> </tt>
For horizontal rangebars the label will appear in rotated text, a bit above
the point.<tt> </tt>
The size, style, and location may be adjusted if desired using the <tt>outlierlabeldetails</tt>
attribute.<tt> </tt>

</dl>
<p>
<b>outlierlabeldetails</b>
<a href="textdetails.html">
<i> textdetails </i>
</a>
<dl>
<dt><dd><p>
Details related to the outlier labels.  

</dl>
<p>
<b>outlierlinedetails</b>
<a href="linedetails.html">
<i> linedetails </i>
</a>
<dl>
<dt><dd><p>
When outliers are being rendered as line segments, specifies
color, line width, etc. of these line segments.<tt> </tt>

<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 &nbsp; <br>
<a href="../doc/Copyright.html">Copyright Steve Grubb</a>
<br>
<br>
<center>
<img src="../gallery/all.gif">
</center>
</td></tr>
</table>
</dl>
<p><hr>
Markup created by <em>unroff</em> 1.0,&#160;<tt> </tt>&#160;<tt> </tt>March 01, 2002.
</body>
</html>