latexDotchart is a translation of the dotchart3 function
for producing a vector of character strings containing LaTeX picture
environment markup that mimics dotchart3 output. The LaTeX
epic and color packages are required. The add and
horizontal=FALSE options are not available for
latexDotchart, however.
latexDotchart(data, labels, groups=NULL, gdata=NA,
xlab='', auxdata, auxgdata=NULL, auxtitle,
w=4, h=4, margin,
lines=TRUE, dotsize = .075, size='small', size.labels='small',
size.group.labels='normalsize', ttlabels=FALSE, sort.=TRUE,
xaxis=TRUE, lcolor='gray', ...)
a numeric vector whose values are shown on the x-axis
a vector of labels for each point, corresponding to
x. If omitted, names(data) are used, and if there are
no names, integers prefixed by "#" are used.
an optional categorical variable indicating how
data values are grouped
data values for groups, typically summaries such as group medians
x-axis title
a vector of auxiliary data, 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.
similar to auxdata but corresponding to the gdata
argument. These usually represent overall sample sizes for each
group of lines.
if auxdata is given, auxtitle specifies a column
heading for the extra printed data in the chart, e.g., "N"
width of picture in inches
height of picture in inches
a 4-vector representing, in inches, the margin to the
left of the x-axis, below the y-axis, to the right of the x-axis,
and above the y-axis. By default these are computed making educated
cases about how to accommodate auxdata etc.
set to FALSE to suppress drawing of reference
lines
diameter of filled circles, in inches, for drawing dots
size of text in picture. This and the next two arguments
are LaTeX font commands without the opening backslash, e.g.,
'normalsize', 'small', 'large', smaller[2].
size of labels
size of labels corresponding to groups
set to TRUE to use typewriter monospaced font
for labels
set to FALSE to keep latexDotchart 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).
set to FALSE to suppress drawing x-axis
color for horizontal reference lines. Default is "gray"
ignored
Frank Harrell
Department of Biostatistics
Vanderbilt University
fh@fharrell.com