The R Project SVN R

Rev

Rev 70307 | Rev 77934 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 70307 Rev 77311
Line 1... Line 1...
1
% File src/library/graphics/man/dotchart.Rd
1
% File src/library/graphics/man/dotchart.Rd
2
% Part of the R package, https://www.R-project.org
2
% Part of the R package, https://www.R-project.org
3
% Copyright 1995-2011 R Core Team
3
% Copyright 1995-2019 R Core Team
4
% Distributed under GPL 2 or later
4
% Distributed under GPL 2 or later
5
 
5
 
6
\name{dotchart}
6
\name{dotchart}
7
\alias{dotchart}
7
\alias{dotchart}
8
\title{Cleveland's Dot Plots}
8
\title{Cleveland's Dot Plots}
9
\description{
9
\description{
10
  Draw a Cleveland dot plot.
10
  Draw a Cleveland dot plot.
11
}
11
}
12
\usage{
12
\usage{
13
dotchart(x, labels = NULL, groups = NULL, gdata = NULL,
13
dotchart(x, labels = NULL, groups = NULL, gdata = NULL,
-
 
14
         ann = par("ann"), xaxt = par("xaxt"), frame.plot = TRUE, log = "",
14
         cex = par("cex"), pt.cex = cex,
15
         cex = par("cex"), pt.cex = cex,
15
         pch = 21, gpch = 21, bg = par("bg"),
16
         pch = 21, gpch = 21, bg = par("bg"),
16
         color = par("fg"), gcolor = par("fg"), lcolor = "gray",
17
         color = par("fg"), gcolor = par("fg"), lcolor = "gray",
17
         xlim = range(x[is.finite(x)]),
18
         xlim = range(x[is.finite(x)]),
18
         main = NULL, xlab = NULL, ylab = NULL, \dots)
19
         main = NULL, xlab = NULL, ylab = NULL, \dots)
Line 32... Line 33...
32
    If \code{x} is a matrix, \code{groups} will default to the columns
33
    If \code{x} is a matrix, \code{groups} will default to the columns
33
    of \code{x}.}
34
    of \code{x}.}
34
  \item{gdata}{data values for the groups.
35
  \item{gdata}{data values for the groups.
35
    This is typically a summary such as the median or mean
36
    This is typically a summary such as the median or mean
36
    of each group.}
37
    of each group.}
-
 
38
  \item{ann}{a \code{\link{logical}} value indicating whether the default annotation
-
 
39
    (title and x and y axis labels) should appear on the plot.}
-
 
40
  \item{xaxt}{a string indicating the x-axis style; use \code{"n"} to
-
 
41
    suppress and see also \code{\link{par}("xaxt")}.}
-
 
42
  \item{frame.plot}{a logical indicating whether a box should be drawn
-
 
43
    around the plot.}
-
 
44
  \item{log}{a character string indicating if one or the other axis should
-
 
45
    be logarithmic, see \code{\link{plot.default}}.}
37
  \item{cex}{the character size to be used.  Setting \code{cex}
46
  \item{cex}{the character size to be used.  Setting \code{cex}
38
    to a value smaller than one can be a useful way of avoiding label
47
    to a value smaller than one can be a useful way of avoiding label
39
    overlap.  Unlike many other graphics functions, this sets the actual
48
    overlap.  Unlike many other graphics functions, this sets the actual
40
    size, not a multiple of \code{par("cex")}.}
49
    size, not a multiple of \code{par("cex")}.}
41
  \item{pt.cex}{the \code{cex} to be applied to plotting symbols.
50
  \item{pt.cex}{the \code{cex} to be applied to plotting symbols.
Line 74... Line 83...
74
  Murrell, P. (2005) \emph{R Graphics}. Chapman & Hall/CRC Press.
83
  Murrell, P. (2005) \emph{R Graphics}. Chapman & Hall/CRC Press.
75
}
84
}
76
\examples{
85
\examples{
77
dotchart(VADeaths, main = "Death Rates in Virginia - 1940")
86
dotchart(VADeaths, main = "Death Rates in Virginia - 1940")
78
op <- par(xaxs = "i")  # 0 -- 100\%
87
op <- par(xaxs = "i")  # 0 -- 100\%
79
dotchart(t(VADeaths), xlim = c(0,100),
88
dotchart(t(VADeaths), xlim = c(0,100), bg = "skyblue",
80
         main = "Death Rates in Virginia - 1940")
89
         main = "Death Rates in Virginia - 1940")
81
par(op)
90
par(op)
82
}
91
}
83
\keyword{hplot}
92
\keyword{hplot}