stripchart {graphics} | R Documentation |
1-D Scatter Plots
Description
stripchart
produces one dimensional scatter plots (or dot
plots) of the given data. These plots are a good alternative to
boxplot
s when sample sizes are small.
Usage
stripchart(x, ...)
## S3 method for class 'formula'
stripchart(x, data = NULL, dlab = NULL, ...,
subset, na.action = NULL)
## Default S3 method:
stripchart(x, method = "overplot", jitter = 0.1, offset = 1/3,
vertical = FALSE, group.names, add = FALSE,
at = NULL, xlim = NULL, ylim = NULL,
ylab = NULL, xlab = NULL, dlab = "", glab = "",
log = "", pch = 0, col = par("fg"), cex = par("cex"),
axes = TRUE, frame.plot = axes, ...)
Arguments
x |
the data from which the plots are to be produced. In the
default method the data can be specified as a single numeric
vector, or as list of numeric vectors, each corresponding to
a component plot. In the |
data |
a data.frame (or list) from which the variables in
|
subset |
an optional vector specifying a subset of observations to be used for plotting. |
na.action |
a function which indicates what should happen
when the data contain |
... |
additional parameters passed to the default method, or by
it to |
method |
the method to be used to separate coincident points.
The default method |
jitter |
when |
offset |
when stacking is used, points are stacked this many line-heights (symbol widths) apart. |
vertical |
when vertical is |
group.names |
group labels which will be printed alongside (or underneath) each plot. |
add |
logical, if true add the chart to the current plot. |
at |
numeric vector giving the locations where the charts should
be drawn, particularly when |
ylab , xlab |
labels: see |
dlab , glab |
alternate way to specify axis labels: see ‘Details’. |
xlim , ylim |
plot limits: see |
log |
on which axes to use a log scale: see
|
pch , col , cex |
Graphical parameters: see |
axes , frame.plot |
Axis control: see |
Details
Extensive examples of the use of this kind of plot can be found in Box, Hunter and Hunter (2005) or Wild and Seber (2000).
The dlab
and glab
labels may be used instead of xlab
and ylab
if those are not specified. dlab
applies to the
continuous data axis (the X axis unless vertical
is TRUE
),
glab
to the group axis.
References
Box G., Hunter, J. S. and Hunter, W. C. (2005). Statistics for Experimenters: Design, Innovation, and Discovery, second edition. New York: Wiley. ISBN: 978-0-471-71813-0.
Wild, C. and Seber, G. (2000). Chance Encounters: A First Course in Data Analysis and Inference. John Wiley and Sons. ISBN 0-471-32936-3.
Examples
x <- stats::rnorm(50)
xr <- round(x, 1)
stripchart(x) ; m <- mean(par("usr")[1:2])
text(m, 1.04, "stripchart(x, \"overplot\")")
stripchart(xr, method = "stack", add = TRUE, at = 1.2)
text(m, 1.35, "stripchart(round(x,1), \"stack\")")
stripchart(xr, method = "jitter", add = TRUE, at = 0.7)
text(m, 0.85, "stripchart(round(x,1), \"jitter\")")
stripchart(decrease ~ treatment,
main = "stripchart(OrchardSprays)",
vertical = TRUE, log = "y", data = OrchardSprays)
stripchart(decrease ~ treatment, at = c(1:8)^2,
main = "stripchart(OrchardSprays)",
vertical = TRUE, log = "y", data = OrchardSprays)