Joyplots in Python with matplotlib & pandas
Clone or download
sbebo Merge pull request #27 from sbebo/bug/workaround-hist-legend
Workaround to fix #26 due to bug 11702 in matplotlib
Latest commit 8ea2214 Oct 8, 2018


PyPI version Build Status License: MIT

JoyPy is a one-function Python package based on matplotlib + pandas with a single purpose: drawing joyplots.

A joyplot.

The code for JoyPy borrows from the code for kdes in pandas.plotting, and uses a couple of utility functions therein. (This could be probably avoided with a little bit of extra effort.)

What are joyplots?

Joyplots are stacked, partially overlapping density plots, simple as that. They are a nice way to plot data to visually compare distributions, especially those that change across one dimension (e.g., over time). Though hardly a new technique, they have become very popular lately thanks to the R package ggjoy (which is clearly much better developed/maintained than this one -- and I strongly suggest you use that if you can use R and ggplot.) Update: the ggjoy package has now been renamed ggridges.

Why are they called joyplots?

If you don't know Joy Division, you are lucky: you can still listen to them for the first time! Here's a hint: google "Unknown Pleasures". This kind of plot is now also known as ridgeline plot, since the original name is controversial.


Take a look at this jupyter notebook for a couple of simple examples.


Not sure what are the oldest supported versions. As long as you have somewhat recent versions, you should be fine.


It's actually on PyPI, because why not:

pip install joypy

To install from github, run:

git clone
cd joypy
pip install .


Released under the MIT license.

Disclaimer + contributing

This is just a sunday afternoon hack, so no guarantees! If you want to contribute or just copy/fork, feel free to.