forked from tidyverse/ggplot2
-
Notifications
You must be signed in to change notification settings - Fork 1
/
README.Rmd
96 lines (70 loc) · 4.48 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, echo = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-"
)
```
# ggplot2 <img src="man/figures/logo.png" align="right" />
[](https://travis-ci.org/tidyverse/ggplot2)
[](https://ci.appveyor.com/project/tidyverse/ggplot2)
[](https://codecov.io/github/tidyverse/ggplot2?branch=master)
[](https://cran.r-project.org/package=ggplot2)
## Overview
ggplot2 is a system for declaratively creating graphics, based on [The Grammar of Graphics](http://amzn.to/2ef1eWp). You provide the data, tell ggplot2 how to map variables to aesthetics, what graphical primitives to use, and it takes care of the details.
## Installation
```{r, eval = FALSE}
# The easiest way to get ggplot2 is to install the whole tidyverse:
install.packages("tidyverse")
# Alternatively, install just ggplot2:
install.packages("ggplot2")
# Or the the development version from GitHub:
# install.packages("devtools")
devtools::install_github("tidyverse/ggplot2")
```
## Usage
It's hard to succinctly describe how ggplot2 works because it embodies a deep philosophy of visualisation. However, in most cases you start with `ggplot()`, supply a dataset and aesthetic mapping (with `aes()`). You then add on layers (like `geom_point()` or `geom_histogram()`), scales (like `scale_colour_brewer()`), faceting specifications (like `facet_wrap()`) and coordinate systems (like `coord_flip()`).
```{r example}
library(ggplot2)
ggplot(mpg, aes(displ, hwy, colour = class)) +
geom_point()
```
As well as the components built-in to ggplot2, there are many packages that provide extensions. See a comprehensive list at <http://www.ggplot2-exts.org>.
## Learning ggplot2
If you are new to ggplot2 you are better off starting with a systematic introduction, rather than trying to learn from reading individual documentation pages. Currently, there are three good places to start:
1. The [data visualisation][r4ds-vis] and
[graphics for communication][r4ds-comm] chapters in
[R for data science][r4ds]. R for data science is designed to
give you a comprehensive introduction to the
[tidyverse](http://tidyverse.org), and these two chapters will
you get up to speed with the essentials of ggplot2 as quickly as
possible.
1. If you'd like to take an interactive online course, try
[Data visualisation with ggplot2][datacamp] by Rick Scavetta
on datacamp.
1. If you want to dive into making common graphics as quickly
as possible, I recommend [The R Graphics Cookbook][cookbook]
by Winston Chang. It provides a set of recipes to solve common
graphics problems. A 2nd edition is due out in 2017.
If you've mastered the basics and want to learn more, read [ggplot2: Elegant Graphics for Data Analysis][ggplot2-book]. It describes the theoretical underpinnings of ggplot2 and shows you how all the pieces fit together. This book helps you understand the theory that underpins ggplot2, and will help you create new types of graphic specifically tailored to your needs. The book is not available for free, but you can find the complete source for the book at <https://github.com/hadley/ggplot2-book>.
## Getting help
There are two main places to get help with ggplot2:
1. The [ggplot2 mailing list][ml] is a friendly place to ask any
questions about ggplot2. You must be a member to post messages,
but anyone can read the archived discussions.
1. [stackoverflow][so] is a great source of answers to common ggplot2
questions. It is also a great place to get help, once you have
created a reproducible example that illustrates your problem.
[ggplot2-book]: http://amzn.to/2fncG50
[gg-book]: http://amzn.to/2ef1eWp
[ml]: https://groups.google.com/forum/?fromgroups#!forum/ggplot2
[so]: http://stackoverflow.com/questions/tagged/ggplot2?sort=frequent&pageSize=50
[cookbook]: http://amzn.to/2dVfMfn
[r4ds]: http://r4ds.had.co.nz
[r4ds-vis]: http://r4ds.had.co.nz/data-visualisation.html
[r4ds-comm]: http://r4ds.had.co.nz/graphics-for-communication.html
[datacamp]: https://www.datacamp.com/courses/data-visualization-with-ggplot2-1