dots {BHH2} | R Documentation |
The function adds to the current plot an one-dimensional scatter plot with stacking similar to a stem-leaf plot or histograms but using characters. .
dots(x = , y = 0.1, xlim = range(x,na.rm=TRUE), stacked = FALSE, hmax= 0.5, base = TRUE, axes = FALSE, pch = 21, pch.size = "x", labels = NULL, hcex = 1, cex = par("cex"), cex.axis = par("cex.axis"))
x |
numeric vector to be displayed in the dot plot. |
y |
numeric. Height of the dots (characters) at the base level. By default
y=0.1 thinking on a plot with ylim=c(0,1) . |
xlim |
numeric vector with 2 entries: xmin and xmax . These values determine
the width of the displayed dot plot not necessarily equal to the limits of the plot. |
stacked |
logical. If TRUE characters are stacked,
otherwise a scatter plot of the data is displayed at y level using character pch . |
hmax |
numeric. The maximum height in user units. By default
hmax=0.5 thinking on a plot with ylim=c(0,1) . See y . |
base |
logical. If TRUE a horizontal line is displayed at the bottom of the plot. |
axes |
logical. If TRUE an labelled axis is shown. |
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. |
Function dots
adds to the current plot a dot plot similar to a
stem-and-leaf plot using characters specified by pch
and
labels=NULL
. If labels
is not NULL
then it is
expected to be a character vector and will
will be used to display each of the points. Its use is repeated or cut short if necessary.
The function computes the width and height size using character pch.size
calling
strwidth
and strheight
, but displays pch
instead.
Mainly this is used when pch
is not given by a quoted character,
for example, pch=21
. Also, currently the par("mkh") is ignored so
hcex
is used to compute the "working" height of the characters:
hcex*strheight(pch.size,units="user")
. If stacked=TRUE
,
the base line is divided in subintervals of size strwidth(pch.size)
and computed the number of points in each subinterval. If maximum number
of stacked characters exceed hmax
then the characters are overlapped to
adjust their total height to hmax
.
Invisible data frame with columns (x,y,labels). `x' and `y' are the coordinates in user units of each point and `labels' the corresponding character displayed.
Ernesto Barrios
library(BHH2) set.seed(4) # Defines the height of the plot area between c(0,1) dotPlot(rnorm(100),xlab="x") x <- rnorm(100) # plots (possibly) overlapping points at y=0.3 dots(x,y=0.3) # plots (possibly) overlapping points at y=0.4 dots(x,y=0.4,stacked=TRUE,base=FALSE) # plots (hopefully) stacked points at y=0.5 allowing the dots to as high as 0.9 dots(x,y=0.5,stacked=TRUE,base=FALSE,hmax=.9)