/ggjoy

Geoms to make joy plots using ggplot2

Primary LanguageHTMLGNU General Public License v2.0GPL-2.0

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 by Jenny Bryan on Twitter on April 24, 2017, in reference to the iconic cover art for Joy Division's album Unknown Pleasures.

Installation

Stable release:

install.packages("ggjoy")

Latest development version:

library(devtools)
install_github("clauswilke/ggjoy")

Usage

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
#> Picking joint bandwidth of 458

Documentation and Examples

First read the package vignette. Then read the reference manual.