Dotcharts {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])