heatboxplot {LSD}

Heatboxplot: a colored boxplot

Description

A boxplot with an additional color stripe based on a kernel density estimate.

Usage

heatboxplot(
  x,
  horizontal = FALSE,
  add = FALSE,
  colpal = "standard",
  rev = FALSE,
  simulate = FALSE,
  daltonize = FALSE,
  cvd = "p",
  alpha = NULL,
  colpals = NULL,
  nrcol = 75,
  lwd = 1.75,
  axes = TRUE,
  labels = NULL,
  xlim = NULL,
  ylim = NULL,
  xlab = NULL,
  ylab = "",
  main = "heatboxplot",
  nolab = FALSE,
  outline = TRUE,
  boxonly = FALSE,
  adjust = 1,
  quant.from = 0.25,
  quant.to = 0.75,
  range = 1.5,
  border = "black",
  plot.boxplot = TRUE,
  add.quartiles = TRUE,
  add.box = FALSE,
  n.density = 1024,
  cexbox = 0.6,
  ...
)

Arguments

x

data as vector, matrix, list or data.frame.

horizontal

logical: if TRUE (FALSE by default), rotation of 90 degrees is applied.

add

logical: if TRUE (FALSE by default), the boxplot is added to an existing plot.

colpal

a character vector containing R built-in color names or a name of a LSD colorpalette as a character string (see disco() or disco) (defaults to "heat", if not specified).

rev

logical: if TRUE (FALSE by default), a reversed colorpalette is used.

simulate

logical: if TRUE (FALSE by default), a converted colorpalette is used to simulate dichromat vision according to http://www.daltonize.org (see daltonize).

daltonize

logical: if TRUE (FALSE by default), a converted colorpalette is used to enhance dichromat vision according to http://www.daltonize.org (see daltonize).

cvd

character string implying the type of color vision deficiency ("p" for protanope, "d" for deuteranope or "t" for tritanope).

alpha

alpha value: a two-digit integer between 01 and 99 for color opacity, i.e. appearance of partial or full transparency (usage omitted by default).

colpals

a character vector containing names of LSD colorpalettes (see disco() or disco).

nrcol

a non-negative integer specifying the number of colors to be used (defaults to 100, if not specified).

lwd

linewidth of the box and whiskers.

axes

logical: if TRUE (by default), the axes are plotted.

labels

a character vector of labels.

xlim

x limits, standard graphics parameter.

ylim

y limits, standard graphics parameter.

xlab

x label, standard graphics parameter.

ylab

y label, standard graphics parameter.

main

title(s) of the plot, standard graphics parameter.

nolab

logical: if TRUE (FALSE by default), the title and ylab are suppressed.

outline

logical: if TRUE (by default), outliers are plotted.

boxonly

logical: if TRUE (FALSE by default), the density is only be plotted in the box.

adjust

a numeric value giving the scaling factor for the used bandwidth (defaults to 1).

quant.from

a numeric value (between 0 and 1) giving the quantile from which the density lane should be plotted.

quant.to

a numeric value (between 0 and 1) giving the quantile to which the density lane should be plotted.

range

a numeric value to determine how far the plot whiskers extend out from the box.

border

an R build-in color for the box and whiskers.

plot.boxplot

logical: if TRUE (by default), the boxplot is added to the density.

add.quartiles

if TRUE (FALSE by default), only the box of the boxplot is added (if plot.boxplot = FALSE).

add.box

logical: if TRUE (by default), the box is added to the plot.

n.density

an integer specifying the number of equally spaced points at which the density is to be estimated.

cexbox

a numerical value giving the amount by which the boxes should be magnified relative to the default.

...

additional parameters to be passed to points and plot.

Author(s)

Bjoern Schwalb

See Also

comparisonplot, demotour, disco, colorpalette

Examples

f = c(rnorm(200),rnorm(200)+4)
h = rf(500,15,15)*10
g = rnorm(300)+1

heatboxplot(h)

heatboxplot(list(f=f,g=g),colpals=c("rdpu","greens"),labels=c("bimodal","unimodal"))