# An implementation of the Grammar of Graphics

## Documentation for package ‘ggplot2’ version 0.9.2.1

- DESCRIPTION file.
- Package NEWS.

## Help Pages

A B C D E F G H I L M O P Q R S T U X Y misc

ggplot2-package | ggplot2.

## -- A --

add_theme | Modify properties of an element in a theme object
aes | Generate aesthetic mappings that describe how variables in the data are mapped to visual properties (aesthetics) of geoms.
aes_all | Given a character vector, create a set of identity mappings
aes_auto | Automatic aesthetic mapping
aes_colour_fill_alpha | Colour related aesthetics: colour, fill and alpha
aes_group_order | Aesthetics: group, order
aes_linetype_size_shape | Differentiation related aesthetics: linetype, size, shape
aes_position | Position related aesthetics: x, y, xmin, xmax, ymin, ymax, xend, yend
aes_string | Generate aesthetic mappings from a string
alpha | Colour related aesthetics: colour, fill and alpha
annotate | Create an annotation layer.
annotation_custom | Annotation: Custom grob.
annotation_logticks | Annotation: log tick marks
annotation_map | Annotation: maps.
annotation_raster | Annotation: High-performance rectangular tiling.
autoplot | Create a complete ggplot appropriate to a particular data type

## -- B --

borders | Create a layer of map borders.

## -- C --

calc_element | Calculate the element properties, by inheriting properties from its parents
color | Colour related aesthetics: colour, fill and alpha
colour | Colour related aesthetics: colour, fill and alpha
coord_cartesian | Cartesian coordinates.
coord_equal | Cartesian coordinates with fixed relationship between x and y scales.
coord_fixed | Cartesian coordinates with fixed relationship between x and y scales.
coord_flip | Flipped cartesian coordinates.
coord_map | Map projections.
coord_polar | Polar coordinates.
coord_trans | Transformed cartesian coordinate system.
cut_interval | Cut numeric vector into intervals of equal length.
cut_number | Cut numeric vector into intervals containing equal number of points.

## -- D --

diamonds | Prices of 50,000 round cut diamonds
discrete_scale | Discrete scale constructor.

## -- E --

economics | US economic time series.
element_blank | Theme element: blank. This theme element draws nothing, and assigns no space
element_line | Theme element: line.
element_rect | Theme element: rectangle.
element_text | Theme element: text.
expand_limits | Expand the plot limits with data.

## -- F --

facet_grid | Lay out panels in a grid.
facet_null | Facet specification: a single panel.
facet_wrap | Wrap a 1d ribbon of panels into 2d.
fill | Colour related aesthetics: colour, fill and alpha
fortify | Fortify a model with data.
fortify-multcomp | Fortify methods for objects produced by 'multcomp'
fortify.cld | Fortify methods for objects produced by 'multcomp'
fortify.confint.glht | Fortify methods for objects produced by 'multcomp'
fortify.glht | Fortify methods for objects produced by 'multcomp'
fortify.Line | Fortify method for classes from the sp package.
fortify.Lines | Fortify method for classes from the sp package.
fortify.lm | Supplement the data fitted to a linear model with model fit statistics.
fortify.map | Fortify method for map objects.
fortify.Polygon | Fortify method for classes from the sp package.
fortify.Polygons | Fortify method for classes from the sp package.
fortify.sp | Fortify method for classes from the sp package.
fortify.SpatialLinesDataFrame | Fortify method for classes from the sp package.
fortify.SpatialPolygons | Fortify method for classes from the sp package.
fortify.SpatialPolygonsDataFrame | Fortify method for classes from the sp package.
fortify.summary.glht | Fortify methods for objects produced by 'multcomp'

## -- G --

geom_abline | Line specified by slope and intercept.
geom_area | Area plot.
geom_bar | Bars, rectangles with bases on x-axis
geom_bin2d | Add heatmap of 2d bin counts.
geom_blank | Blank, draws nothing.
geom_boxplot | Box and whiskers plot.
geom_contour | Display contours of a 3d surface in 2d.
geom_crossbar | Hollow bar with middle indicated by horizontal line.
geom_density | Display a smooth density estimate.
geom_density2d | Contours from a 2d density estimate.
geom_dotplot | Dot plot
geom_errorbar | Error bars.
geom_errorbarh | Horizontal error bars
geom_freqpoly | Frequency polygon.
geom_hex | Hexagon bining.
geom_histogram | Histogram
geom_hline | Horizontal line.
geom_jitter | Points, jittered to reduce overplotting.
geom_line | Connect observations, ordered by x value.
geom_linerange | An interval represented by a vertical line.
geom_map | Polygons from a reference map.
geom_path | Connect observations in original order
geom_point | Points, as for a scatterplot
geom_pointrange | An interval represented by a vertical line, with a point in the middle.
geom_polygon | Polygon, a filled path.
geom_quantile | Add quantile lines from a quantile regression.
geom_raster | High-performance rectangular tiling.
geom_rect | 2d rectangles.
geom_ribbon | Ribbons, y range with continuous x values.
geom_rug | Marginal rug plots.
geom_segment | Single line segments.
geom_smooth | Add a smoothed conditional mean.
geom_step | Connect observations by stairs.
geom_text | Textual annotations.
geom_tile | Tile plane with rectangles.
geom_violin | Violin plot.
geom_vline | Line, vertical.
ggfluctuation | Create a fluctuation plot.
ggmissing | Create a plot to illustrate patterns of missing values.
ggorder | A plot to investigate the order in which observations were recorded.
ggpcp | Make a parallel coordinates plot.
ggplot.data.frame | Create a new ggplot plot from a data frame
ggplot2 | ggplot2.
ggsave | Save a ggplot with sensible defaults
ggscale | Components of a scale:
ggstructure | A plot which aims to reveal gross structural anomalies in the data.
ggtitle | Change axis labels and legend titles
group | Aesthetics: group, order
guides | Set guides for each scale.
guide_colorbar | Contiuous colour bar guide.
guide_colourbar | Contiuous colour bar guide.
guide_legend | Legend guide.

## -- H --

hmisc | Wrap up a selection of summary functions from Hmisc to make it easy to use with 'stat_summary'.

## -- I --

is.ggplot | Reports whether x is a ggplot object
is.rel | Reports whether x is a rel object
is.theme | Reports whether x is a theme object

## -- L --

label_both | Label facets with value and variable.
label_bquote | Label facet with 'bquoted' expressions
label_parsed | Label facets with parsed label.
label_value | Label facets with their value. This is the default labelling scheme.
labs | Change axis labels and legend titles
last_plot | Retrieve the last plot to be modified or created.
linetype | Differentiation related aesthetics: linetype, size, shape

## -- M --

map_data | Create a data frame of map data.
mean_cl_boot | Wrap up a selection of summary functions from Hmisc to make it easy to use with 'stat_summary'.
mean_cl_normal | Wrap up a selection of summary functions from Hmisc to make it easy to use with 'stat_summary'.
mean_sdl | Wrap up a selection of summary functions from Hmisc to make it easy to use with 'stat_summary'.
mean_se | Calculate mean and standard errors on either side.
median_hilow | Wrap up a selection of summary functions from Hmisc to make it easy to use with 'stat_summary'.
midwest | Midwest demographics.
movies | Movie information and user ratings from IMDB.com.
mpg | Fuel economy data from 1999 and 2008 for 38 popular models of car
msleep | An updated and expanded version of the mammals sleep dataset.

## -- O --

opts | Build a theme (or partial theme) from theme elements
order | Aesthetics: group, order

## -- P --

plot.ggplot | Draw plot on current graphics device.
plotmatrix | Code to create a scatterplot matrix (experimental)
position_dodge | Adjust position by dodging overlaps to the side.
position_fill | Stack overlapping objects on top of one another, and standardise to have equal height.
position_identity | Don't adjust position
position_jitter | Jitter points to avoid overplotting.
position_stack | Stack overlapping objects on top of one another.
presidential | Terms of 10 presidents from Eisenhower to Bush W.
print.ggplot | Draw plot on current graphics device.

## -- Q --

qplot | Quick plot
quickplot | Quick plot

## -- R --

rel | Relative sizing for theme elements
resolution | Compute the "resolution" of a data vector.

## -- S --

scale_alpha | Alpha scales.
scale_alpha_continuous | Alpha scales.
scale_alpha_discrete | Alpha scales.
scale_alpha_identity | Use values without scaling.
scale_alpha_manual | Create your own discrete scale.
scale_area | Scale area instead of radius (for size).
scale_color_brewer | Sequential, diverging and qualitative colour scales from colorbrewer.org
scale_color_continuous | Smooth gradient between two colours
scale_color_discrete | Qualitative colour scale with evenly spaced hues.
scale_color_gradient | Smooth gradient between two colours
scale_color_gradient2 | Diverging colour gradient
scale_color_gradientn | Smooth colour gradient between n colours
scale_color_grey | Sequential grey colour scale.
scale_color_hue | Qualitative colour scale with evenly spaced hues.
scale_color_identity | Use values without scaling.
scale_color_manual | Create your own discrete scale.
scale_colour_brewer | Sequential, diverging and qualitative colour scales from colorbrewer.org
scale_colour_continuous | Smooth gradient between two colours
scale_colour_discrete | Qualitative colour scale with evenly spaced hues.
scale_colour_gradient | Smooth gradient between two colours
scale_colour_gradient2 | Diverging colour gradient
scale_colour_gradientn | Smooth colour gradient between n colours
scale_colour_grey | Sequential grey colour scale.
scale_colour_hue | Qualitative colour scale with evenly spaced hues.
scale_colour_identity | Use values without scaling.
scale_colour_manual | Create your own discrete scale.
scale_fill_brewer | Sequential, diverging and qualitative colour scales from colorbrewer.org
scale_fill_continuous | Smooth gradient between two colours
scale_fill_discrete | Qualitative colour scale with evenly spaced hues.
scale_fill_gradient | Smooth gradient between two colours
scale_fill_gradient2 | Diverging colour gradient
scale_fill_gradientn | Smooth colour gradient between n colours
scale_fill_grey | Sequential grey colour scale.
scale_fill_hue | Qualitative colour scale with evenly spaced hues.
scale_fill_identity | Use values without scaling.
scale_fill_manual | Create your own discrete scale.
scale_identity | Use values without scaling.
scale_linetype | Scale for line patterns.
scale_linetype_continuous | Scale for line patterns.
scale_linetype_discrete | Scale for line patterns.
scale_linetype_identity | Use values without scaling.
scale_linetype_manual | Create your own discrete scale.
scale_manual | Create your own discrete scale.
scale_shape | Scale for shapes, aka glyphs.
scale_shape_continuous | Scale for shapes, aka glyphs.
scale_shape_discrete | Scale for shapes, aka glyphs.
scale_shape_identity | Use values without scaling.
scale_shape_manual | Create your own discrete scale.
scale_size | Size scale.
scale_size_continuous | Size scale.
scale_size_discrete | Size scale.
scale_size_identity | Use values without scaling.
scale_size_manual | Create your own discrete scale.
scale_x_continuous | Continuous position scales (x & y).
scale_x_date | Position scale, date
scale_x_datetime | Position scale, date
scale_x_discrete | Discrete position.
scale_x_log10 | Continuous position scales (x & y).
scale_x_reverse | Continuous position scales (x & y).
scale_x_sqrt | Continuous position scales (x & y).
scale_y_continuous | Continuous position scales (x & y).
scale_y_date | Position scale, date
scale_y_datetime | Position scale, date
scale_y_discrete | Discrete position.
scale_y_log10 | Continuous position scales (x & y).
scale_y_reverse | Continuous position scales (x & y).
scale_y_sqrt | Continuous position scales (x & y).
seals | Vector field of seal movements.
shape | Differentiation related aesthetics: linetype, size, shape
size | Differentiation related aesthetics: linetype, size, shape
stat_bin | Bin data.
stat_bin2d | Count number of observation in rectangular bins.
stat_bindot | Bin data for dot plot.
stat_binhex | Bin 2d plane into hexagons.
stat_boxplot | Calculate components of box and whisker plot.
stat_contour | Calculate contours of 3d data.
stat_density | 1d kernel density estimate.
stat_density2d | 2d density estimation.
stat_ecdf | Empirical Cumulative Density Function
stat_function | Superimpose a function.
stat_identity | Identity statistic.
stat_qq | Calculation for quantile-quantile plot.
stat_quantile | Continuous quantiles.
stat_smooth | Add a smoother.
stat_spoke | Convert angle and radius to xend and yend.
stat_sum | Sum unique values. Useful for overplotting on scatterplots.
stat_summary | Summarise y values at every unique x.
stat_summary2d | Apply funciton for 2D rectangular bins.
stat_summary_hex | Apply funciton for 2D hexagonal bins.
stat_unique | Remove duplicates.
stat_ydensity | 1d kernel density estimate along y axis, for violin plot.

## -- T --

theme | Set theme elements
theme_blank | Deprecated theme_xx functions
theme_bw | A theme with white background and black gridlines.
theme_get | Get, set and update themes.
theme_gray | A theme with grey background and white gridlines.
theme_grey | A theme with grey background and white gridlines.
theme_line | Deprecated theme_xx functions
theme_rect | Deprecated theme_xx functions
theme_segment | Deprecated theme_xx functions
theme_set | Get, set and update themes.
theme_text | Deprecated theme_xx functions
theme_update | Get, set and update themes.
translate_qplot_base | Translating between qplot and base graphics
translate_qplot_ggplot | Translating between qplot and ggplot
translate_qplot_gpl | Translating between qplot and Graphics Production Library (GPL)
translate_qplot_lattice | Translating between qplot and lattice

## -- U --

update_element | Update theme param
update_geom_defaults | Modify geom/stat aesthetic defaults for future plots
update_labels | Update axis/legend labels
update_stat_defaults | Modify geom/stat aesthetic defaults for future plots

## -- X --

x | Position related aesthetics: x, y, xmin, xmax, ymin, ymax, xend, yend
xend | Position related aesthetics: x, y, xmin, xmax, ymin, ymax, xend, yend
xlab | Change axis labels and legend titles
xlim | Convenience functions to set the limits of the x and y axis.
xmax | Position related aesthetics: x, y, xmin, xmax, ymin, ymax, xend, yend
xmin | Position related aesthetics: x, y, xmin, xmax, ymin, ymax, xend, yend

## -- Y --

y | Position related aesthetics: x, y, xmin, xmax, ymin, ymax, xend, yend
yend | Position related aesthetics: x, y, xmin, xmax, ymin, ymax, xend, yend
ylab | Change axis labels and legend titles
ylim | Convenience functions to set the limits of the x and y axis.
ymax | Position related aesthetics: x, y, xmin, xmax, ymin, ymax, xend, yend
ymin | Position related aesthetics: x, y, xmin, xmax, ymin, ymax, xend, yend

## -- misc --

%+% | Modify a ggplot or theme object by adding on new components.
%+replace% | Modify a ggplot or theme object by adding on new components.
+.gg | Modify a ggplot or theme object by adding on new components.