dotPlot {BHH2}  R Documentation 
Dot plot: scatter plot with stacked dots similar to the stemandleaf plot
Description
Displays an onedimensional scatter plot with stacking similar to stemandleaf 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 onedimensional scatter plot of x, similar to 
hmax 
numeric. Height of the highest dot.

base 
logical. If 
axes 
logical. If 
frame 
logical. If 
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" ( 
labels 
character vector. If 
hcex 
numeric. Expansion (shrink) factor for character height. See Details. 
cex 
numeric. Expansion factor used for character display.
See 
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 onedimensional 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 onedimensional 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
Examples
library(BHH2)
data(tab03B1)
attach(tab03B1)
stem(yield) #stemleaf 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()