Learn R Programming

⚠️There's a newer version (3.5.0) of this package.Take me there.

ggplot2

ggplot2 is a plotting system for R, based on the grammar of graphics, which tries to take the good parts of base and lattice graphics and avoid bad parts. It takes care of many of the fiddly details that make plotting a hassle (like drawing legends) as well as providing a powerful model of graphics that makes it easy to produce complex multi-layered graphics.

Find out more at http://ggplot2.org, and check out the nearly 500 examples of ggplot in use. If you're interested, you can also sign up to the ggplot2 mailing list at.

Installation

Get the released version from CRAN:

install.packages("ggplot2")

Or the development version from github:

# install.packages("devtools")
devtools::install_github("hadley/ggplot2")

Copy Link

Version

Install

install.packages('ggplot2')

Monthly Downloads

1,879,771

Version

2.1.0

License

GPL-2

Issues

Pull Requests

Stars

Forks

Repository

https://github.com/hadley/ggplot2

Homepage

http://ggplot2.org

Maintainer

Last Published

March 1st, 2016

Functions in ggplot2 (2.1.0)

Munch coordinates data

Cut up numeric vector into useful groups.

Define aesthetic mappings.

Cartesian coordinates with fixed relationship between x and y scales.

annotation_logticks

Annotation: log tick marks

Key drawing functions

Calculate mean and standard errors on either side.

Map projections.

Horizontal error bars

Bars, rectangles with bases on x-axis

Reports whether x is a theme object

Create an annotation layer.

annotation_custom

Annotation: Custom grob.

scale_colour_brewer

Sequential, diverging and qualitative colour scales from colorbrewer.org

scale_colour_grey

Sequential grey colour scale.

Set guides for each scale.

aes_colour_fill_alpha

Colour related aesthetics: colour, fill and alpha

Polar coordinates.

Reports whether x is a ggplot object

Vertical intervals: lines, crossbars & errorbars.

Textual annotations.

Build ggplot for rendering.

Scale size (area or radius).

Add quantile lines from a quantile regression.

ggplot2-ggproto

Base ggproto classes for ggplot2

Add heatmap of 2d bin counts.

The zero grob draws nothing and has zero size.

Fuel economy data from 1999 and 2008 for 38 popular models of car

Identity statistic.

geom_density_2d

Contours from a 2d density estimate.

US economic time series.

A line segment parameterised by location, direction and distance.

Get, set and update themes.

scale_x_discrete

Discrete position.

update_geom_defaults

Modify geom/stat aesthetic defaults for future plots

scale_colour_hue

Qualitative colour scale with evenly spaced hues.

Benchmark plot creation time. Broken down into construct, build, render and draw times.

Generate grid grob from theme element

Histograms and frequency polygons.

Define aesthetic mappings from strings, or quoted calls and formulas.

colors() in Luv space.

Position related aesthetics: x, y, xmin, xmax, ymin, ymax, xend, yend

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

Reports whether x is a rel object

Given a character vector, create a set of identity mappings

Create a new ggplot plot.

Create a complete ggplot appropriate to a particular data type

Convenience functions to set the axis limits.

Define margins.

Save a ggplot (or other grid object) with sensible defaults

Facet specification.

Draw rectangles.

Change axis labels and legend titles

Box and whiskers plot.

Is this object a coordinate system?

Annotation: maps.

position_jitter

Jitter points to avoid overplotting.

scale_colour_gradient

Smooth gradient between two colours

Line segments and curves.

Generic labeller function for facets

as.list.ggproto

Convert a ggproto object to a list

Is this object a facetting specification?

Modify properties of an element in a theme object

Create a new layer

Remove duplicates.

annotation_raster

Annotation: High-performance rectangular tiling.

Facet specification: a single panel.

Display contours of a 3d surface in 2d.

Theme element: text.

Polygon, a filled path.

Add a smoothed conditional mean.

Transformed cartesian coordinate system.

Connect observations.

Calculate the element properties, by inheriting properties from its parents

Create your own discrete scale.

Blank, draws nothing.

Display a smooth density estimate.

Create a data frame of map data.

fortify-multcomp

Fortify methods for objects produced by multcomp

Stack overlapping objects on top of one another.

Discrete scale constructor.

Plot data ellipses.

Fortify method for classes from the sp package.

Adjust position by dodging overlaps to the side.

An updated and expanded version of the mammals sleep dataset.

Theme element: rectangle.

Terms of 11 presidents from Eisenhower to Obama.

Calculation for quantile-quantile plot.

coord_cartesian

Cartesian coordinates.

stat_summary_bin

Summarise y values at unique/binned x x.

Flipped cartesian coordinates.

Give a deprecation error, warning, or message, depending on version number.

Theme element: line.

Points, as for a scatterplot

Position scale, date & date times

Convenience function to remove missing values from a data.frame

Superimpose a function.

Set theme elements

Lay out panels in a grid.

Wrap a 1d ribbon of panels into 2d.

Relative sizing for theme elements

Is an object a ggproto object?

Marginal rug plots.

Expand the plot limits with data.

Update axis/legend labels

translate_qplot_ggplot

Translating between qplot and ggplot

Fortify method for map objects.

Supplement the data fitted to a linear model with model fit statistics.

Points, jittered to reduce overplotting.

Add a new component to a ggplot or theme object.

Use values without scaling.

Print a ggproto object

aes_group_order

Aesthetics: group

Scale for line patterns.

Backquoted labeller

Create a layer of map borders.

Automatic aesthetic mapping

Labeller functions

position_identity

Don't adjust position

Hexagon binning.

Lines: horizontal, vertical, and specified by slope and intercept.

Retrieve the last plot to be modified or created.

Midwest demographics.

Generate a ggplot2 plot grob.

Theme element: blank. This theme element draws nothing, and assigns no space

Build a plot with all the usual bits and pieces.

Housing sales in TX.

Used in examples to illustrate when errors should occur.

stat_summary_2d

Bin and summarise in 2d (rectangle & hexagons)

Create a new ggproto object

Draw plot on current graphics device.

Prices of 50,000 round cut diamonds

position_jitterdodge

Adjust position by simultaneously dodging and jittering

Polygons from a reference map.

Generate correct scale type for specified limits

scale_continuous

Continuous position scales (x & y).

Displays a useful description of a ggplot object

translate_qplot_lattice

Translating between qplot and lattice

Vector field of seal movements.

A waiver object.

Compute the "resolution" of a data vector.

Coerce to labeller function

continuous_scale

Continuous scale constructor.

aes_linetype_size_shape

Differentiation related aesthetics: linetype, size, shape

Fortify a model with data.

Ribbons and area plots.

guide_colourbar

Continuous colour bar guide.

Format a ggproto object

2d density estimate of Old Faithful data

Count the number of observations at each location.

graphical-units

Graphical units

Empirical Cumulative Density Function

Objects exported from other packages

Scale for shapes, aka glyphs.

transform_position

Convenience function to transform all position variables.