plotnine-polars

Documentation and examples for plotnine_polars

This site collects examples and guides for the plotnine_polars package.

The focus here is slightly different from the original site:

• examples use Polars data frames directly
• plots are built with df.ggplot() where that reads naturally
• the fluent API comes from plotnine_polars, not from a fork of plotnine

Importing plotnine_polars registers the Polars dataframe namespace:

import polars as pl
import plotnine_polars

df = pl.DataFrame({"x": [1, 2, 3], "y": [3, 2, 1]})

(
    df.ggplot()
    .aes("x", "y")
    .geom_point()
    .geom_line()
)

Gallery adaptations

Anscombe’s Quartet

Recreates Anscombe’s classic quartet with plotnine_polars, polars, and scikit-learn, including faceted regression lines and a polished final chart.

Please, I Want Some More Labels

Shows how to add titles, subtitles, captions, and legend labels with plotnine_polars.

A Bar Plot With 2 Variables

Builds a grouped bar chart step by step, using Polars for the data and layer-specific label mappings for the dodged text annotations.

Facets (Subplots)

Demonstrates facet_wrap(), facet_grid(), formula syntax, and free scales in a compact subplot-focused notebook.

Citi Bike Trips

Recreates the chapter 1 daily Citi Bike trips area chart with a compact, pre-aggregated dataset and the plotnine_polars API.

NYC Neighborhoods and Stations

Recreates the chapter 1 neighborhood-and-stations map with compact parquet files and the plotnine_polars API.

Guide adaptations

Geometric Objects

Condenses the plotnine geoms guide into a notebook covering points, bars, rectangles, lines, ribbons, distributions, position adjustments, and summaries.

Aesthetic Mappings

Focuses on global versus layer-local aes(), literal settings, grouping, and expression-based mappings.

Scales, Legends, and Guides

Covers manual scales, breaks, labels, limits, legend merging, guide placement, and guide customization in the plotnine_polars style.

Source material

Most notebooks on this site are adapted from the official plotnine gallery and plotnine guides.