breeplot

A clean, fluent plotting package for mathematics research figures, built on matplotlib. Figure chains draw and decoration calls into a single readable sentence, and handles the figure-sizing, 2D/3D layout, and color-cycling bookkeeping you'd otherwise rewrite per figure.

import breeplot as bp

fig = bp.figure(width="textwidth", panels=(1, 2))
fig.panel(0, 0).orbit(x, y, color_by=t).xlabel("x").ylabel("y")
fig.panel(0, 1).curve(x, fit_y, label="fit").legend()
fig.save("figures/orbit")

Install

pip install breeplot

For live, interactive figures inside Jupyter (pan/zoom in 2D, drag-to-rotate in 3D):

pip install "breeplot[notebook]"

Features

• Fluent Figure API — scatter, orbit, curve, fit, separatrix, family, implicit, histogram, mark, plane, plus decoration (xlabel, ylabel, zlabel, title, legend, colorbar, xlim/ylim/ zlim, logx/logy, grid) — every call returns the Figure so calls chain.
• Multi-panel grids with mixed 2D/3D axes, sized in physical units (width="textwidth" and friends) for drop-in use in a paper.
• Figure.zoom() replays the layers already drawn onto a second panel at different axis limits — the "full view + zoomed inset" idiom common in research figures, without repeating your plotting calls.
• A house color system (breeplot.colors) with categorical, sequential, and diverging palettes.
• Live notebook viewing (breeplot.notebook.enable()) — figures stay interactive (zoom, pan, 3D rotate) inside Jupyter via ipympl.
• Figure.save() writes multiple formats (PDF + PNG by default) in one call.

Development

pip install -e ".[dev]"
pytest

License

MIT