Scatter plot (xy-plot) of binned elements.

Plot a scatter (xy-plot) of binned elements with binning information.

plotBinScatter(
  x,
  y,
  b,
  cols = getColsByBin(b),
  xlab = deparse(substitute(x, env = as.environment(-1))),
  ylab = deparse(substitute(y, env = as.environment(-1))),
  main = "",
  legend = "topright",
  legend.cex = 1,
  ...
)

Arguments

x

A numerical vector with x values.

y

A numerical vector with y values (the values used for binning).

b

A factor that groups elements of x,y into bins (typically the output of bin(y)).

cols

A color vector (will be computed based on b by default using getColsByBin(b)).

xlab

Label for x-axis.

ylab

Label for y-axis.

main

Main title.

legend

If not NULL, draw a legend with binning information (will be passed to legend(x=legend) to control legend position).

legend.cex

A scalar that controls the text size in the legend relative to the current par("cex") (see legend).

...

Further arguments passed to plot(x, y, ...).

Value

TRUE (invisibly).

See also

bin, getColsByBin

Examples

set.seed(1)
x <- rnorm(100)
y <- rnorm(100)
b <- bin(y, "equalN", nElements = 10)
plotBinScatter(x, y, b)