plotnine is an implementation of a grammar of graphics in Python,
it is based on ggplot2. The grammar allows users to compose plots
by explicitly mapping data to the visual objects that make up the
plot.
Plotting with a grammar is powerful, it makes custom (and otherwise
complex) plots easy to think about and then create, while the
simple plots remain simple.
To find out about all building blocks that you can use to create a
plot, check out the documentation. Since plotnine has an API
similar to ggplot2, where we lack in coverage the
ggplot2 documentation may be of some help.
Our documentation could use some examples, but we are looking for something
a little bit special. We have two criteria:
Simple looking plots that otherwise require a trick or two.
Plots that are part of a data analytic narrative. That is, they provide
some form of clarity showing off the geom, stat, … at their
differential best.
If you come up with something that meets those criteria, we would love to
see it. See plotnine-examples.
If you discover a bug checkout the issues if it has not been reported,
yet please file an issue.
And if you can fix a bug, your contribution is welcome.
Testing
Plotnine has tests that generate images which are compared to baseline images known
to be correct. To generate images that are consistent across all systems you have
to install matplotlib from source. You can do that with pip using the command.
$ pipinstallmatplotlib--no-binarymatplotlib
Otherwise there may be small differences in the text rendering that throw off the
image comparisons.