dotchart2
is an enhanced version of the
dotchart
function
with several new options.
dotchart2(data, labels, groups, gdata, horizontal=TRUE, pch=16, xlab='', ylab='', auxdata, auxgdata=NULL, auxtitle, lty=if(.R.) 1 else 2, lines=TRUE, dotsize = .8, cex = par("cex"), cex.labels = cex, cex.group.labels = cex.labels*1.25, sort.=TRUE, add=FALSE, dotfont=par('font'), groupfont=if(under.unix)5 else 1, reset.par=add, xaxis=TRUE, width.factor=if(.R.)1.5 else 1, lcolor=if(.R.)'gray' else par('col'), ...)
x
. If omitted,
names(data)
are used, and if there are
no
names
, integers prefixed by
"#"
are used.
data
values are grouped
FALSE
to make the chart vertical
instead of the default
dotchart2
, of the same length
as the first (
data
) argument. If present, this
vector of values will be printed outside the right margin of the dot
chart. Usually
auxdata
represents cell sizes.
auxdata
but corresponding to the
gdata
argument. These usually represent overall sample sizes for each
group of lines.
auxdata
is given,
auxtitle
specifies a column
heading for the extra printed data in the chart, e.g.,
"N"
FALSE
to suppress drawing of reference
lines
cex
value for drawing dots. Default is 0.8. Note that the original
dotchart
function used a default of 1.2.
cex
parameter that applies only to the line labels for the
dot chart
cex
parameter for major grouping labels for
dotchart2
. Defaults to
cex
.
cex
corresponding to
gdata
FALSE
to keep
dotchart2
from sorting the input
data, i.e., it will assume that the data are already properly
arranged. This is especially useful when you are using
gdata
and
groups
and you want to control the
order that groups appear on the chart (from top to bottom).
TRUE
to add to an existing plot
-1
to
use "outline" fonts. For example,
pch=183, dotfont=-1
plots an open circle for UNIX on postscript.
pch=1
makes
an open octagon under Windows.
group
labels for
dotchart2
.
Default is
5
for UNIX, which is usually Helvetica bold. For
Microsoft Windows, the default is
1
. The font number
corresponding to some bold font is recommended, if you can figure this
out for Windows S-Plus.
FALSE
to cause
dotchart2
to not reset the
par
parameters when finished. This is useful when
add=TRUE
is about to
be used in another call. The default is to reset the
par
parameters if
add=TRUE
and not if
add=FALSE
, i.e., the
program assumes that only one set of points will be added to an
existing set. If you fail to use
reset.par=TRUE
for the
first of a series of plots, the next call to
plot
with
add=TRUE
will result in distorted x-axis scaling.
FALSE
to suppress drawing x-axis
width.factor
to get
the appropriate space for labels on horizonal charts.
"gray"
for R,
par("col")
for S-Plus.
plot.default
Frank Harrell
Department of Biostatistics
Vanderbilt University
f.harrell@vanderbilt.edu