plotlet 0.5.0

Python library for SVG plots, with multi-panel composition and an extension API for custom plot types.

plotlet

plotlet is a Python library for SVG plots. It provides reproducible, byte-identical multi-panel scientific figures with a standard plotting vocabulary and a first-class extension story for custom plot types.

Documentation

Hands-on tour with executable examples:

• notebooks/00_introduction.ipynb — long-form data, aesthetic inheritance, layering, composition

Reference docs in docs/:

• API reference — mark methods, frame options, scales, tick overrides
• Philosophy — what's in core, what's not, and why
• Subplots — multi-panel composition, shared scales
• Extending — write your own plot type
• Themes — visual presets
• AI attributes — data-plotlet-* schema for automation

Reference plot types beyond the standard vocabulary live in src/plotlet/extensions/ (single-file) and cookbook/ (multi-file projects).

Dependencies

plotlet supports Python 3.10+.

Required: fonttools, scipy (used by regression, qq, pointplot, dendrogram). numpy / pandas / polars inputs work transparently.

Optional: cairosvg for PNG / PDF export.

Installation

pip install plotlet

Testing

pip install -e ".[test]"
pytest tests/                  # check vs. committed baselines
pytest tests/ --update         # regenerate (review the diff!)

Development

Development takes place on GitHub. Please submit bugs to the issue tracker with a reproducible example.

License

MIT