plotnine

Latest Release
License
DOI
Build Status
Coverage
Documentation

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.

Example

from plotnine import *
from plotnine.data import mtcars

Building a complex plot piece by piece.

Scatter plot

(ggplot(mtcars, aes('wt', 'mpg'))
 + geom_point())

Scatter plot colored according some variable

(ggplot(mtcars, aes('wt', 'mpg', color='factor(gear)'))
 + geom_point())

Scatter plot colored according some variable and smoothed with a linear model with confidence intervals.

(ggplot(mtcars, aes('wt', 'mpg', color='factor(gear)'))
 + geom_point()
 + stat_smooth(method='lm'))

Scatter plot colored according some variable, smoothed with a linear model with confidence intervals and plotted on separate panels.

(ggplot(mtcars, aes('wt', 'mpg', color='factor(gear)'))
 + geom_point()
 + stat_smooth(method='lm')
 + facet_wrap('~gear'))

Adjust the themes

5.1 Make it playful

(ggplot(mtcars, aes('wt', 'mpg', color='factor(gear)'))
 + geom_point()
 + stat_smooth(method='lm')
 + facet_wrap('~gear')
 + theme_xkcd())

5.2 Or professional

(ggplot(mtcars, aes('wt', 'mpg', color='factor(gear)'))
 + geom_point()
 + stat_smooth(method='lm')
 + facet_wrap('~gear')
 + theme_tufte())

Installation

Official release

# Using pip
$ pip install plotnine             # 1. should be sufficient for most
$ pip install 'plotnine[extra]'    # 2. includes extra/optional packages
$ pip install 'plotnine[test]'     # 3. testing
$ pip install 'plotnine[doc]'      # 4. generating docs
$ pip install 'plotnine[dev]'      # 5. development (making releases)
$ pip install 'plotnine[all]'      # 6. everyting

# Or using conda
$ conda install -c conda-forge plotnine

Development version

$ pip install git+https://github.com/has2k1/plotnine.git

Contributing

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.

$ pip install matplotlib --no-binary matplotlib

Otherwise there may be small differences in the text rendering that throw off the image comparisons.

Metadata

Release files for plotnine 0.9.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for plotnine 0.9.0
File	Size	Uploaded	Provenance
plotnine-0.9.0.tar.gz	4.9 MB	Jul 1, 2022	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for plotnine 0.9.0
File	Interpreter	ABI	Platform	Reset
plotnine-0.9.0-py3-none-any.whl 1.2 MB Jul 1, 2022 Without provenance	Python 3	none	any	Details

Total release size: 6.2 MB

Release files / plotnine-0.9.0.tar.gz

Download URL	plotnine-0.9.0.tar.gz
Size	4.9 MB
Tags	Source
SHA-256 checksum How to use checksums	`0e89a93015f3c71d6844ac7aa9fb0da09b908f5f7dfa7dd5d68a5ca32b2ebcea`
BLAKE2b-256 checksum How to use checksums	`595573deed34f0c58eafd563f95b0dfa990f0c4a4e05bb6b0ee781f4f722726d`
Upload date	Jul 1, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.0 CPython/3.10.4`

Release files / plotnine-0.9.0-py3-none-any.whl

Download URL	plotnine-0.9.0-py3-none-any.whl
Size	1.2 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`340ff64601cddb78ccbca9d4a5dd1a7c56d89cd88c0729d065c30bcb1382cb36`
BLAKE2b-256 checksum How to use checksums	`6fc9009dc392e404fbe1ae929c631460e11a27d22b53de76dc71b6aa4f34d13b`
Upload date	Jul 1, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.0 CPython/3.10.4`

Security for plotnine 0.9.0

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.