ggridges v0.5.2


Monthly downloads



Ridgeline Plots in 'ggplot2'

Ridgeline plots provide a convenient way of visualizing changes in distributions over time or space. This package enables the creation of such plots in 'ggplot2'.


ggridges: Ridgeline plots in ggplot2

Status AppVeyor build
status Coverage
Status CRAN\_Status\_Badge CRAN\_Downloads\_Badge

Ridgeline plots 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. These types of plots have also been called “joyplots”, in reference to the iconic cover art for Joy Division’s album Unknown Pleasures. However, given the unfortunate origin of the name Joy Division, the term “joyplot” is now discouraged.


Please install the stable release from CRAN:


Alternatively, you can install the latest development version from github:




ggplot(diamonds, aes(x = price, y = cut)) +
  geom_density_ridges(scale = 4) + 
  scale_y_discrete(expand = c(0, 0)) +     # will generally have to set the `expand` option
  scale_x_continuous(expand = c(0, 0)) +   # for both axes to remove unneeded padding
  coord_cartesian(clip = "off") + # to avoid clipping of the very top of the top ridgeline
#> Picking joint bandwidth of 458

Documentation and Examples

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

Functions in ggridges

Name Description
geom_density_ridges Create ridgeline plot
stat_binline Stat for histogram ridgeline plots
stat_density_ridges Stat for density ridgeline plots
theme_ridges A custom theme specifically for use with ridgeline plots
position_raincloud Create a cloud of randomly jittered points below a ridgeline plot
position_points_sina Randomly distribute points in a ridgeline plot between baseline and ridgeline
scale_point Scales for point aesthetics
scale_vline Scales for vline aesthetics
scale_cyclical Create a discrete scale that cycles between values
reduce Reduce a list to a single value by iteratively applying a binary function
geom_ridgeline Plot a ridgeline (line with filled area underneath)
Aus_athletes Australian athletes
geom_density_line Smoothed density estimates drawn with a ridgeline rather than area
geom_ridgeline_gradient Plot ridgelines and ridgeline plots with fill gradients along the x axis
geom_vridgeline Plot a vertical ridgeline (ridgeline rotated 90 degrees)
ggridges Ridgeline plots with ggplot2
position_points_jitter Randomly jitter the points in a ridgeline plot
lincoln_weather Weather in Lincoln, Nebraska in 2016.
Catalan_elections Results from Catalan regional elections (1980-2015)
No Results!

Vignettes of ggridges

No Results!

Last month downloads


Type Package
License GPL-2 | file LICENSE
LazyData true
VignetteBuilder knitr
Collate 'data.R' 'ggridges.R' 'geoms.R' 'geomsv.R' 'geoms-gradient.R' 'geom-density-line.R' 'position.R' 'scale-cyclical.R' 'scale-point.R' 'scale-vline.R' 'stats.R' 'theme.R' 'utils_ggplot2.R' 'utils.R'
RoxygenNote 7.0.2
NeedsCompilation no
Packaged 2020-01-11 23:38:10 UTC; clauswilke
Repository CRAN
Date/Publication 2020-01-12 06:00:18 UTC

Include our badge in your README