Skip to main content

ggplot for python

Project description


{ggplot} from `Yhat <>`__

read more on our
`blog <>`__


from ggplot import *

ggplot(aes(x='date', y='beef'), data=meat) + \
geom_point(color='lightblue') + \
stat_smooth(span=.15, color='black', se=True) + \
ggtitle("Beef: It's What's for Dinner") + \
xlab("Date") + \
ylab("Head of Cattle Slaughtered")

.. figure::
:alt: image

What is it?

Yes, it's another port of
`ggplot2 <>`__. One of the biggest
reasons why I continue to reach for ``R`` instead of ``Python`` for data
analysis is the lack of an easy to use, high level plotting package like
``ggplot2``. I've tried other libraries like
`bokeh <>`__ and
`d3py <>`__ but what I really want is

``ggplot`` is just that. It's an extremely un-pythonic package for doing
exactly what ``ggplot2`` does. The goal of the package is to mimic the
``ggplot2`` API. This makes it super easy for people coming over from
``R`` to use, and prevents you from having to re-learn how to plot


- same API as ``ggplot2`` for ``R``
- ability to use both American and British English spellings of
- tight integration with `pandas <>`__
- pip installable

Getting Started


This package depends on the following packages, although they should be
automatically installed if you use ``pip``:

- ``matplotlib``
- ``pandas``
- ``numpy``
- ``scipy``
- ``statsmodels``
- ``patsy``


Installing ``ggplot`` is really easy. Just use ``pip``!


$ pip install ggplot

Loading ``ggplot``


# run an IPython shell (or don't)
$ ipython
In [1]: from ggplot import *

That's it! You're ready to go!



meat_lng = pd.melt(meat[['date', 'beef', 'pork', 'broilers']], id_vars='date')
ggplot(aes(x='date', y='value', colour='variable'), data=meat_lng) + \
geom_point() + \

.. figure::
:alt: image



from ggplot import *
ggplot(diamonds, aes('carat', 'price')) + \
geom_point(alpha=1/20.) + \
ylim(0, 20000)

.. figure::
:alt: image



p = ggplot(aes(x='carat'), data=diamonds)
p + geom_histogram() + ggtitle("Histogram of Diamond Carats") + labs("Carats", "Freq")

.. figure::
:alt: image



ggplot(diamonds, aes(x='price', color='cut')) + \

.. figure::
:alt: image


meat_lng = pd.melt(meat[['date', 'beef', 'broilers', 'pork']], id_vars=['date'])
p = ggplot(aes(x='value', colour='variable', fill=True, alpha=0.3), data=meat_lng)
p + geom_density()

.. figure::
:alt: image



p = ggplot(mtcars, aes('factor(cyl)'))
p + geom_bar()

.. figure::
:alt: image


To generate image test data...

In the base dir, run the tests with python, afterwards run
python visual\ (opens a page in a browser) and compare the
plots/ make sure they look as the test intended.

Then copy the missing files from result\_images/test\_whatever/\ *.png
to ggplot/tests/test\_whatever/*.png. Make sure that you DON'T copy
images with filenames ending in *-expected.png, as these are the copies
from ggplot/tests/test\_*/\*.png which the test images get compared to.


`The list is long, but
distinguished. <>`__
We're looking for contributors! Email greg at for more info.
For getting started with contributing, check out `these
docs <>`__


.. |image| image::
.. |image| image::

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
ggplot-0.6.4-py2.7.egg (8.8 MB) Copy SHA256 hash SHA256 Egg 2.7

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page