dotPlot {BHH2}

Dot plot: scatter plot with stacked dots similar to the stem-and-leaf plot

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()