dotPlot: Dot plot: scatter plot with stacked dots similar to the...

In BHH2: Useful Functions for Box, Hunter and Hunter II

Description

Displays an one-dimensional scatter plot with stacking similar to stem-and-leaf plot or histograms.

Usage

dotPlot(x, y = 0, xlim = range(x,na.rm=TRUE), xlab = NULL, 
    scatter = FALSE, hmax = 1, base = TRUE, axes = TRUE, frame = FALSE, 
    pch = 21, pch.size = "x", labels = NULL, hcex = 1, cex =par("cex"), 
    cex.axis = par("cex.axis"),...)

Arguments

x	numeric vector to be displayed.
y	numeric. Height of the basis of the plot.
xlim	numeric. Range of the x axis.
xlab	character string. label for the horizontal axis.
scatter	logical. If TRUE a one-dimensional scatter plot of x, similar to rug, is displayed at the base of the plot.
hmax	numeric. Height of the highest dot. hmax=1 as default. See Details.
base	logical. If TRUE (default) a base line for the dots (characters) is displayed.
axes	logical. If TRUE labelled axis is displayed.
frame	logical. If FALSE the plot frame is omitted.
pch	numeric or character. Character number or character to be used for the display.
pch.size	numeric. Character to be used to distribute the "dots" (pch). See Details.
labels	character vector. If NULL (default) each point (dot) is displayed using character pch, otherwise vector labels is used for the display. See Details.
hcex	numeric. Expansion (shrink) factor for character height. See Details.
cex	numeric. Expansion factor used for character display. See par.
cex.axis	numeric. Expansion factor used in case of labelling the axis.
...	additional graphical parameters.

Details

Basically function dotPlot calls function dots to display a stacked one-dimensional scatter plot within vertical limits 0 and 1. See dots for more details.

Value

The function is called for its side effect which is to produce one-dimensional scatter plot with stacking as described, for example, in Chambers et al. (1983) It returns invisible a data frame with the actual coordinates (in users units).

Note

Since the dots are stacked vertically, their alignment is subject to rounding errors. Dots may be slightly moved in either side from their actual value.

Author(s)

Ernesto Barrios

References

Chambers, J. M., Cleveland, W. S., Kleiner, B. and Tukey, P. A. (1983) Graphical Methods for Data Analysis. New York: Chapman \& Hall

See Also

dots, stem,hist,dotchart

Examples

library(BHH2)
data(tab03B1)
attach(tab03B1)
stem(yield) #stem-leaf plot
plt <- dotPlot(yield) # equivalent dotPlot

# same dot plot with max and min observations labelled
plt <- dotPlot(yield,xlim=c(75,95),xlab="yield",pch.size="x",hcex=1)
text(c(min(yield),max(yield),80),rep(0.05,3),c("min","max",80))
segments(80,min(plt$y),80,max(plt$y),lty=2)
detach()

Example output

  The decimal point is at the |

  76 | 5
  77 | 59
  78 | 14
  79 | 0355566778
  80 | 0012233455667799
  81 | 00144566678888999
  82 | 00012222333344566778899
  83 | 000000111233333455555556667789
  84 | 00112223344445566777778888899
  85 | 0000011222344445666778899
  86 | 01222234555666667777788
  87 | 12222233478
  88 | 002246899
  89 | 034779
  90 | 04558
  91 | 7

BHH2 documentation built on May 1, 2019, 6:27 p.m.