https://github.com/clauswilke/ggridges
Revision cf76c423009f530dc84a8960a8e7247e40bc1d02 authored by Claus Wilke on 17 August 2017, 23:02:21 UTC, committed by Claus Wilke on 17 August 2017, 23:02:21 UTC
1 parent 00e472b
Tip revision: cf76c423009f530dc84a8960a8e7247e40bc1d02 authored by Claus Wilke on 17 August 2017, 23:02:21 UTC
removing cowplot dependency b/c cowplot depends on ggjoy.
removing cowplot dependency b/c cowplot depends on ggjoy.
Tip revision: cf76c42
README.Rmd
---
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-"
)
```
# ggjoy
[![Build Status](https://travis-ci.org/clauswilke/ggjoy.svg?branch=master)](https://travis-ci.org/clauswilke/ggjoy)
[![Coverage Status](https://img.shields.io/codecov/c/github/clauswilke/ggjoy/master.svg)](https://codecov.io/github/clauswilke/ggjoy?branch=master)
[![CRAN_Status_Badge](http://www.r-pkg.org/badges/version/ggjoy)](https://CRAN.R-project.org/package=ggjoy)
[![CRAN_Downloads_Badge](http://cranlogs.r-pkg.org/badges/grand-total/ggjoy?color=brightgreen)](http://cranlogs.r-pkg.org/downloads/total/last-month/ggjoy)
Geoms to make joyplots using ggplot2, written by Claus O. Wilke
This package has now been officially relased on CRAN. Most things should work as expected, and the API should now be relatively stable. For feedback and feature requests, please open issues on github.
## About joyplots
Joyplots are partially overlapping line plots that create the impression of a mountain range. They can be quite useful for visualizing changes in distributions over time or space. The name "joyplot" was [proposed](
https://twitter.com/JennyBryan/status/856674638981550080) by Jenny Bryan on Twitter on April 24, 2017, in reference to the [iconic cover art](https://blogs.scientificamerican.com/sa-visual/pop-culture-pulsar-origin-story-of-joy-division-s-unknown-pleasures-album-cover-video/) for Joy Division's album _Unknown Pleasures_.
## Installation
Stable release:
```{r eval = FALSE}
install.packages("ggjoy")
```
Latest development version:
```{r eval = FALSE}
library(devtools)
install_github("clauswilke/ggjoy")
```
## Usage
```{r diamonds}
library(ggplot2)
library(ggjoy)
ggplot(diamonds, aes(x = price, y = cut)) +
geom_joy(scale = 4) + theme_joy() +
scale_y_discrete(expand = c(0.01, 0)) + # will generally have to set the `expand` option
scale_x_continuous(expand = c(0, 0)) # for both axes to remove unneeded padding
```
## Documentation and Examples
First read the [package vignette.](https://cran.r-project.org/web/packages/ggjoy/vignettes/introduction.html) Then read the [reference manual.](https://cran.r-project.org/web/packages/ggjoy/ggjoy.pdf)
![swh spinner](/static/img/swh-spinner.gif)
Computing file changes ...