Dotcharts: Improved dotcharts

In shipunov: Miscellaneous Functions from Alexey Shipunov

Improved dotcharts

Description

Dotcharts, improved and extended

Usage

Dotchart1(x, labels=NULL, groups=NULL, gdata=NULL, offset=1/8,
 ann=par("ann"), xaxt=par("xaxt"),  frame.plot=TRUE, log="",
 cex=par("cex"), pt.cex=cex, pch=21, gpch=21, bg=par("bg"),
 color=par("fg"),  gcolor=par("fg"), lcolor="gray", xlim=
 range(x[is.finite(x)]), main=NULL, xlab=NULL, ylab=NULL, ...)

Dotchart(x, ...)

Dotchart3(values, left, right, pch=21, bg="white", pt.cex=1.2,
 lty=1, lwd=2, gridcol="grey", ...)

Arguments

x	Either a vector or matrix of numeric values. Inputs are coerced by 'as.numeric()', with a message.
labels	A vector of labels for each point.
groups	An optional factor indicating how the elements of 'x' are grouped.
gdata	Data values for the groups. This is typically a summary such as the median or mean of each group.
offset	Offset in inches of 'ylab' and 'labels'.
ann	Logical value indicating whether title and x and y axis labels should appear on the plot.
xaxt	String indicating the x-axis style; use 'n' to suppress and see also par("xaxt").
frame.plot	Logical indicating whether a box should be drawn around the plot.
log	Character string indicating if one or the other axis should be logarithmic, see ?plot.default.
cex	The character size to be used.
pt.cex	The 'cex' to be applied to plotting symbols.
pch	The plotting character or symbol to be used.
gpch	The plotting character or symbol to be used for group values.
bg	The background color of plotting characters.
color	The color(s) to be used for points and labels.
gcolor	The single color to be used for group labels and values.
lcolor	The color(s) to be used for the horizontal lines.
xlim	Horizontal range for the plot.
main	Overall title for the plot, see 'title'.
xlab, ylab	Axis annotations as in 'title'.
values	Centers for 'Dotchart3()'
left	Left margins for 'Dotchart3()'
right	Right margins for 'Dotchart3()'
lty	Line type for 'Dotchart3()'
lwd	Line width for 'Dotchart3()'
gridcol	Grid color for 'Dotchart3()'
...	Additional arguments

Details

For better explanations of options, see 'help(dotchart)'.

Dotchart1() is a dotchart() corrected for use with 1-dimensional tables. If the argument is a 1-dimensional table, Dotchart() converts it into numeric vector first and instead of warning, outputs the message. This is helpful to the beginners with R, and especially on macOS GUI where warnings are in red. It also allows dotcharts to show 'ylab' (this was not available in R < 4.0.3 but corrected later).

Dotchart() is a prettified dotchart with the following defaults: 'lcolor="black", bg="white", pt.cex=1.2'.

Dotchart3() is the dotchart extension which shows values together with ranges. Somewhat similar to Linechart() but more general (and does not work with grouped data).

Author(s)

Alexey Shipunov

See Also

dotchart, Linechart

Examples

## Compare:
aa <- table(c(1, 1, 1, 2, 2, 3))
dotchart(aa, ylab="Ylab") # produces warning; does not show 'ylab' if R version < 4.0.3
Dotchart1(aa, ylab="Ylab") # outputs message instead of warning; always shows 'ylab'
Dotchart(aa, ylab="Ylab") # in addition to Dotchart1(), dots and grid are more visible

iris1 <- aggregate(iris[, 1], iris[5], function(.x) fivenum(.x)[c(3, 1, 5)])
iris1x <- iris1$x
row.names(iris1x) <- iris1$Species
Dotchart3(iris1x[, 1], iris1x[, 2], iris1x[, 3])

shipunov documentation built on Feb. 16, 2023, 9:05 p.m.