oh-mpl-paper

Publication-ready Matplotlib styles, one function call away. Every academic project ends up rewriting the same 40 lines of rcParams boilerplate to get figures that satisfy a journal's font, size, and line-weight requirements — oh-mpl-paper bundles that boilerplate as a handful of named, tested .mplstyle presets and a two-line API.

Installation

pip install git+https://github.com/OscarHickman/thesis-themes.git

Usage

import oh_mpl_paper as p
import matplotlib.pyplot as plt

p.setconfig("nature")          # sets all rcParams for the chosen style

plt.plot(x, y)
plt.savefig("figure.pdf")      # sized and styled for the target venue

print(p.available())           # ['base', 'ieee', 'k.wang', 'nature', 'poster', 'presentation']

Calling setconfig with an unrecognised name raises a ValueError listing every style currently bundled with the package.

Available styles

All styles embed Type 42 (TrueType) fonts in PDF/PS output so text stays editable in Illustrator or Inkscape, and default to a colorblind-safe categorical color cycle.

Development

pip install -e ".[test]"
pytest

Releasing

Pushing a tag of the form vX.Y.Z triggers .github/workflows/publish.yml, which builds the package and publishes it to PyPI via Trusted Publishing (no API token stored in this repo). The tag's version must match the version field in pyproject.toml or the workflow fails before publishing.

# bump version in pyproject.toml, commit, then:
git tag v0.1.1
git push origin v0.1.1

PyPI-side setup (one-time, done outside this repo): add a trusted publisher on the oh-mpl-paper project pointing at this GitHub repo, workflow file publish.yml, and environment name pypi.