stat_bindot {ggplot2}R Documentation

Bin data for dot plot.

Description

Missing values are currently silently dropped. If weights are used, they must be integer values.

Usage

  stat_bindot(mapping = NULL, data = NULL,
    geom = "dotplot", position = "identity",
    binwidth = NULL, origin = NULL, width = 0.9,
    binaxis = "x", method = "dotdensity",
    binpositions = "bygroup", drop = FALSE, right = TRUE,
    na.rm = FALSE, ...)

Arguments

binaxis

The axis to bin along, "x" (default) or "y"

method

"dotdensity" (default) for dot-density binning, or "histodot" for fixed bin widths (like stat_bin)

binwidth

When method is "dotdensity, this specifies maximum bin width. When method is "histodot", this specifies bin width. Defaults to 1/30 of the range of the data

binpositions

When method is "dotdensity", "bygroup" (default) determines positions of the bins for each group separately. "all" determines positions of the bins with all the data taken together; this is used for aligning dot stacks across multiple groups.

origin

When method is "histodot", origin of first bin

right

When method is "histodot", should intervals be closed on the right (a, b], or not [a, b)

width

When binaxis is "y", the spacing of the dot stacks for dodging.

na.rm

If FALSE (the default), removes missing values with a warning. If TRUE silently removes missing values.

drop

If TRUE, remove all bins with zero counts

mapping

The aesthetic mapping, usually constructed with aes or aes_string. Only needs to be set at the layer level if you are overriding the plot defaults.

data

A layer specific dataset - only needed if you want to override the plot defaults.

geom

The geometric object to use display the data

position

The position adjustment to use for overlappling points on this layer

...

other arguments passed on to layer. This can include aesthetics whose values you want to set, not map. See layer for more details.

Value

New data frame with additional columns:

x

center of each bin, if binaxis is "x"

y

center of each bin, if binaxis is "x"

binwidth

max width of each bin if method is "dotdensity"; width of each bin if method is "histodot"

count

number of points in bin

ncount

count, scaled to maximum of 1

density

density of points in bin, scaled to integrate to 1, if method is "histodot"

ndensity

density, scaled to maximum of 1, if method is "histodot"

Aesthetics

stat_bindot understands the following aesthetics (required aesthetics are in bold):

See Also

See geom_dotplot for examples.

Examples

# See geom_dotplot for examples

[Package ggplot2 version 0.9.3.1 Index]