ggformula (version 0.6)

gf_ash: Average Shifted Histograms

Description

An ASH plot is the average over all histograms of a fixed bin width. geom_ash() and gf_ash() provide ways to create ASH plots using ggplot2 or ggformula.

Usage

gf_ash(object = NULL, gformula = NULL, data = NULL, geom = "line",
  stat = "ash", position = "identity", show.legend = NA,
  show.help = NULL, inherit = TRUE, ...)
stat_ash(mapping = NULL, data = NULL, geom = "line",
  position = "identity", na.rm = FALSE, show.legend = NA,
  inherit.aes = TRUE, binwidth = NULL, adjust = 1, ...)
geom_ash(mapping = NULL, data = NULL, stat = "ash",
  position = "identity", na.rm = FALSE, show.legend = NA,
  inherit.aes = TRUE, binwidth = NULL, adjust = 1, ...)

Arguments

object

When chaining, this holds an object produced in the earlier portions of the chain. Most users can safely ignore this argument. See details and examples.

gformula

A formula with shape ~x or y ~ x. y may be ..density.. or ..count.. or ..ndensity.. or ..ncount... Faceting can be achieved by including | in the formula.

data

A data frame with the variables to be plotted.

geom

A character string naming the geom used to make the layer.

stat

A character string naming the stat used to make the layer.

position

Either a character string naming the position function used for the layer or a position object returned from a call to a position function.

show.legend

A logical indicating whether this layer should be included in the legends. NA, the default, includes layer in the legends if any of the attributes of the layer are mapped.

show.help

If TRUE, display some minimal help.

inherit

A logical indicating whether default attributes are inherited.

...

Additional arguments. Typically these are (a) ggplot2 aesthetics to be set with attribute = value, (b) ggplot2 aesthetics to be mapped with attribute = ~expression, or (c) attributes of the layer as a whole, which are set with attribute = value. Available attributes include alpha, color, fill, group, linetype, size

mapping

set of aesthetic mappings created by aes() or aes_().

na.rm

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

inherit.aes

A logical indicating whether default aesthetics are inherited.

binwidth

the width of the histogram bins. If NULL (the default) the binwidth will be chosen so that approximately 10 bins cover the data. adjust can be used to to increase or decrease binwidth.

adjust

a numeric adjustment to binwidth. Primarily useful when binwidth is not specified. Increasing adjust makes the plot smoother.

Value

a gg object

See Also

geom_histogram(), link{gf_histogram}().

Examples

# NOT RUN {
gf_ash(~Sepal.Length, color = ~ Species, data = iris)
gf_ash(~Sepal.Length, color = ~ Species, data = iris, binwidth = 0.3)
gf_ash(~Sepal.Length, color = ~ Species, data = iris, adjust = 2)
ggplot(faithful, aes(x = eruptions)) +
  geom_histogram(aes(y = ..density..),
    fill = "lightskyblue", colour = "gray50", alpha = 0.2) +
  geom_ash(colour = "red") +
  geom_ash(colour = "forestgreen", adjust = 2) +
  geom_ash(colour = "navy", adjust = 1/2) +
  theme_minimal()
# }