paperplot-quantum 0.1.0__py3-none-any.whl

paperplot/save.py

@@ -0,0 +1,99 @@
+"""Saving figures with publication-correct defaults.
+
+PDF default, EPS first-class. Fonts embedded (Type-42, no Type-3) for pdf+ps.
+Runs preflight() and surfaces warnings. Warns on alpha in EPS (matplotlib
+rasterizes it) and stamps the spec revision into PDF metadata.
+"""
+
+from __future__ import annotations
+
+import importlib
+import warnings
+from pathlib import Path
+
+import matplotlib as mpl
+
+# pp.style() shadows the style submodule on the package; reach it via sys.modules.
+_style = importlib.import_module("paperplot.style")
+from .lint import preflight as _preflight
+
+_VECTOR = {"pdf", "eps", "svg", "ps"}
+
+
+def _color_has_alpha(artist) -> bool:
+    """True if any face/edge color on the artist is RGBA with alpha < 1."""
+    for getter in ("get_facecolor", "get_edgecolor"):
+        fn = getattr(artist, getter, None)
+        if fn is None:
+            continue
+        try:
+            col = fn()
+        except Exception:
+            continue
+        import numpy as np
+        arr = np.atleast_2d(np.asarray(col, dtype=float))
+        if arr.ndim == 2 and arr.shape[1] == 4 and (arr[:, 3] < 1.0).any():
+            return True
+    return False
+
+
+def _has_alpha(fig) -> bool:
+    # Scan figure-level artists + every axes child for transparency, via the
+    # alpha attribute *and* RGBA face/edge colors (fill_between, scatter, etc.).
+    artists = [fig.patch, *getattr(fig, "legends", [])]
+    for ax in fig.axes:
+        artists.extend(ax.get_children())
+    for artist in artists:
+        a = getattr(artist, "get_alpha", lambda: None)()
+        if a is not None and a < 1.0:
+            return True
+        if _color_has_alpha(artist):
+            return True
+    return False
+
+
+def save(fig, path, *, dpi=None, run_preflight=True, journal=None, **savefig_kw):
+    """Save ``fig`` to ``path`` with journal-correct export settings.
+
+    Format is taken from the extension; no extension defaults to ``.pdf``.
+    Returns the preflight :class:`~paperplot.lint.Report` (or None if skipped).
+    """
+    spec = _style.resolve_spec(journal)
+    p = Path(path)
+    fmt = p.suffix.lower().lstrip(".")
+    if not fmt:
+        p = p.with_suffix(".pdf")
+        fmt = "pdf"
+
+    if fmt in ("eps", "ps") and _has_alpha(fig):
+        warnings.warn(
+            f"{fmt.upper()} target: figure has alpha<1 artists; matplotlib "
+            f"rasterizes transparency in {fmt.upper()}. Use PDF to keep them vector.",
+            stacklevel=2,
+        )
+
+    report = None
+    if run_preflight:
+        report = _preflight(fig, spec)
+        for f in report.warnings:
+            warnings.warn(f"preflight: {f.message}", stacklevel=2)
+
+    if dpi is None and fmt not in _VECTOR:
+        dpi = spec.rasterize_dpi.get("line", 600)
+
+    metadata = None
+    if fmt == "pdf":
+        metadata = {"Creator": f"paperplot ({spec.name} {spec.revision})"}
+
+    kw = dict(facecolor="white")
+    if dpi is not None:
+        kw["dpi"] = dpi
+    if metadata is not None:
+        kw["metadata"] = metadata
+    kw.update(savefig_kw)
+
+    # Embed fonts as Type-42 (never Type-3) scoped to this save — don't mutate
+    # the caller's global rcParams.
+    with mpl.rc_context({"pdf.fonttype": 42, "ps.fonttype": 42}):
+        fig.savefig(p, **kw)
+    return report

paperplot/style.py

@@ -0,0 +1,194 @@
+"""rcParams construction and the use/style/reset lifecycle.
+
+``rcparams(spec, ...)`` is the core translation layer (spec -> matplotlib rc).
+``use()`` sets a sticky global journal; ``style()`` is a scoped context manager
+(full save/restore); ``reset()`` undoes ``use()``.
+"""
+
+from __future__ import annotations
+
+import contextlib
+import copy
+from typing import Optional
+
+import matplotlib as mpl
+from cycler import cycler
+
+from . import fonts, palettes
+from .journals import JournalSpec
+from .registry import get_spec
+
+_active: Optional[JournalSpec] = None
+_snapshot: Optional[dict] = None
+
+# The styling options last set by use(); figure()/style() inherit these unless a
+# call overrides them (pass the kwarg). reset() restores the defaults.
+_DEFAULT_OPTS = {"serif": False, "palette": None, "usetex": False,
+                 "math": "cm", "font_scale": 1.0}
+_active_opts: dict = dict(_DEFAULT_OPTS)
+
+# math= names -> matplotlib mathtext.fontset. Default "cm" gives the Computer
+# Modern look physics figures expect, even with sans-serif text labels.
+_MATH_FONTSET = {
+    "cm": "cm",            # Computer Modern (LaTeX look) — default
+    "stix": "stix",        # Times-like math, pairs with serif=True
+    "stixsans": "stixsans",
+    "sans": "stixsans",    # clean sans math that pairs with Arial/Helvetica
+    "dejavusans": "dejavusans",
+}
+
+
+def _mathset(math: str, serif: bool) -> str:
+    if math == "auto":
+        return "cm" if serif else "stixsans"
+    return _MATH_FONTSET.get(math, math)
+
+
+def _effective(serif=None, palette=None, usetex=None, math=None,
+               font_scale=None) -> dict:
+    """Fill any unspecified (None) option from the active use() options."""
+    o = _active_opts
+    return {
+        "serif": o["serif"] if serif is None else serif,
+        "palette": o["palette"] if palette is None else palette,
+        "usetex": o["usetex"] if usetex is None else usetex,
+        "math": o["math"] if math is None else math,
+        "font_scale": o["font_scale"] if font_scale is None else font_scale,
+    }
+
+
+def resolve_spec(journal) -> JournalSpec:
+    """Resolve a journal arg (str / JournalSpec / None) to a spec."""
+    if isinstance(journal, JournalSpec):
+        return journal
+    if journal is not None:
+        return get_spec(journal)
+    if _active is not None:
+        return _active
+    raise RuntimeError(
+        "No active journal. Call pp.use('aps') first, or pass journal=..."
+    )
+
+
+def rcparams(spec: JournalSpec, *, serif: bool = False, usetex: bool = False,
+             palette=None, math: str = "cm", font_scale: float = 1.0) -> dict:
+    """Build the matplotlib rcParams dict for a spec.
+
+    ``math`` selects the mathtext font set (``"cm"``/``"sans"``/``"stix"``/
+    ``"auto"``); ``font_scale`` multiplies every spec point size (a deliberate
+    nudge — preflight still warns below the journal's absolute minimum).
+    """
+    fonts.register_bundled()
+    fp = spec.font_pt
+    s = float(font_scale)
+    lw = spec.min_linewidth_pt
+    cycle_colors = palettes.resolve_cycle(palette)
+    return {
+        # fonts
+        "font.family": "serif" if serif else "sans-serif",
+        "font.sans-serif": list(spec.font_family),
+        "font.serif": ["Times", "Nimbus Roman", "DejaVu Serif"],
+        "font.size": fp.base * s,
+        "axes.labelsize": fp.base * s,
+        "axes.titlesize": fp.base * s,
+        "xtick.labelsize": fp.tick * s,
+        "ytick.labelsize": fp.tick * s,
+        "legend.fontsize": fp.legend * s,
+        "legend.title_fontsize": fp.base * s,
+        "figure.titlesize": fp.base * s,
+        "mathtext.fontset": _mathset(math, serif),
+        "text.usetex": usetex,
+        "axes.unicode_minus": not usetex,
+        "axes.formatter.use_mathtext": True,
+        # lines / ticks / spines (>= min line weight). Plot lines scale with the
+        # journal's min weight so talk targets get thicker strokes for projection
+        # while APS/Nature (min 0.5) keep the 1.0 pt publication default.
+        "axes.linewidth": max(0.6, lw),
+        "lines.linewidth": max(1.0, 2.0 * lw),
+        "lines.markersize": max(3.0, 3.0 * lw / 0.5),
+        "lines.markeredgewidth": 0.5,
+        "patch.linewidth": 0.6,
+        "xtick.direction": "in",
+        "ytick.direction": "in",
+        "xtick.major.width": lw,
+        "ytick.major.width": lw,
+        "xtick.minor.width": 0.4,
+        "ytick.minor.width": 0.4,
+        "xtick.major.size": 3.0,
+        "ytick.major.size": 3.0,
+        "xtick.minor.size": 1.5,
+        "ytick.minor.size": 1.5,
+        "xtick.major.pad": 3,
+        "ytick.major.pad": 3,
+        "axes.titlepad": 3,
+        "axes.labelpad": 2,
+        "axes.xmargin": 0.02,
+        "axes.ymargin": 0.02,
+        # full box (APS); pp.despine() removes top/right on demand
+        "axes.spines.top": True,
+        "axes.spines.right": True,
+        # color cycle
+        "axes.prop_cycle": cycler(color=cycle_colors),
+        # figure / save
+        "figure.figsize": list(spec.figsize("single")),
+        "figure.facecolor": "white",
+        "figure.dpi": 150,
+        "savefig.dpi": spec.rasterize_dpi.get("line", 600),
+        "savefig.bbox": "standard",
+        "savefig.pad_inches": 0.01,
+        "savefig.transparent": False,
+        "pdf.fonttype": 42,
+        "ps.fonttype": 42,
+    }
+
+
+def apply(spec: JournalSpec, *, serif=None, palette=None, usetex=None,
+          math=None, font_scale=None) -> None:
+    """Update the global rcParams in place (used by use() and figure()).
+
+    Unspecified (None) options fall back to whatever ``use()`` last set, so
+    per-figure calls inherit the active style instead of resetting it.
+    """
+    eff = _effective(serif, palette, usetex, math, font_scale)
+    mpl.rcParams.update(rcparams(spec, **eff))
+
+
+def use(journal, *, serif: bool = False, palette=None, usetex: bool = False,
+        math: str = "cm", font_scale: float = 1.0) -> JournalSpec:
+    """Set the sticky active journal + style options and apply them globally."""
+    global _active, _snapshot, _active_opts
+    spec = resolve_spec(journal)
+    if _snapshot is None:  # remember the pre-paperplot state for reset()
+        _snapshot = copy.deepcopy(dict(mpl.rcParams))
+    _active_opts = {"serif": serif, "palette": palette, "usetex": usetex,
+                    "math": math, "font_scale": font_scale}
+    apply(spec)  # uses the just-stored active options
+    _active = spec
+    return spec
+
+
+def active() -> Optional[JournalSpec]:
+    return _active
+
+
+def reset() -> None:
+    """Restore rcParams to the state before the first use(), and clear active."""
+    global _active, _snapshot, _active_opts
+    if _snapshot is not None:
+        mpl.rcParams.update(_snapshot)
+        _snapshot = None
+    _active = None
+    _active_opts = dict(_DEFAULT_OPTS)
+
+
+@contextlib.contextmanager
+def style(journal=None, *, serif=None, palette=None, usetex=None,
+          math=None, font_scale=None):
+    """Scoped styling: applies a spec's rcParams, restores fully on exit.
+
+    Unspecified options inherit the active ``use()`` style (or the defaults).
+    """
+    spec = resolve_spec(journal)
+    eff = _effective(serif, palette, usetex, math, font_scale)
+    with mpl.rc_context(rcparams(spec, **eff)):
+        yield spec

paperplot_quantum-0.1.0.dist-info/METADATA

@@ -0,0 +1,281 @@
+Metadata-Version: 2.4
+Name: paperplot-quantum
+Version: 0.1.0
+Summary: Publication-correct matplotlib figures, journal by journal (APS, Nature, IEEE, + presentation).
+Author: Zlatko Minev
+License: MIT
+Project-URL: Homepage, https://github.com/zlatko-minev/paperplot
+Project-URL: Documentation, https://zlatko-minev.github.io/paperplot/
+Project-URL: Repository, https://github.com/zlatko-minev/paperplot
+Project-URL: Issues, https://github.com/zlatko-minev/paperplot/issues
+Keywords: matplotlib,publication,figures,physics,APS,Physical Review
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Framework :: Matplotlib
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: paperplot/data/fonts/LICENSE.md
+License-File: paperplot/data/fonts/GUST-FONT-LICENSE.txt
+Requires-Dist: matplotlib>=3.6
+Requires-Dist: numpy>=1.21
+Requires-Dist: tomli>=1.2; python_version < "3.11"
+Provides-Extra: notebook
+Requires-Dist: IPython>=7; extra == "notebook"
+Provides-Extra: seaborn
+Requires-Dist: seaborn>=0.12; extra == "seaborn"
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.5; extra == "docs"
+Requires-Dist: mkdocs-jupyter>=0.24; extra == "docs"
+Requires-Dist: jupytext>=1.16; extra == "docs"
+Requires-Dist: nbconvert>=7; extra == "docs"
+Requires-Dist: ipykernel>=6; extra == "docs"
+Dynamic: license-file
+
+# paperplot
+
+[![CI](https://github.com/zlatko-minev/paperplot/actions/workflows/ci.yml/badge.svg)](https://github.com/zlatko-minev/paperplot/actions/workflows/ci.yml)
+[![Docs](https://github.com/zlatko-minev/paperplot/actions/workflows/docs.yml/badge.svg)](https://zlatko-minev.github.io/paperplot/)
+[![Python](https://img.shields.io/badge/python-%E2%89%A53.10-blue)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/zlatko-minev/paperplot/blob/main/docs/showcase.ipynb)
+[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/zlatko-minev/paperplot/main?labpath=docs/showcase.ipynb)
+
+**Publication-correct matplotlib figures, journal by journal.**
+
+Most matplotlib styling focuses on the *look*. `paperplot` does that too — but it
+also handles the parts that decide whether a journal accepts your figure:
+
+- **sizes it to the journal's real column width** (8.6 cm, 17.8 cm, …), not a generic default;
+- **embeds fonts correctly** (Type-42, no Type-3);
+- **preflights it** for the rules figures actually get rejected over — font type,
+  line weight, lettering height, and grayscale legibility.
+
+Ships **Physical Review (APS)** (incl. PRL/PRX/PRB), **Nature**, and **IEEE**, plus a
+**presentation** target for slides. matplotlib-only core; seaborn/IPython are optional
+extras.
+
+> **Just want the look?** `pp.register_mplstyles()` then `plt.style.use("paperplot-aps")` —
+> no API to learn. You give up only the parts a style sheet *can't* do (true column
+> sizing, font embedding, preflight); `pp.figure()`/`pp.save()` add those back. See
+> [Drop-in style sheets](#drop-in-style-sheets).
+
+## Install
+
+```bash
+pip install paperplot-quantum                 # core (matplotlib + numpy)
+pip install "paperplot-quantum[notebook]"     # + IPython for pp.show()
+```
+
+The PyPI package is **`paperplot-quantum`**, but you still **`import paperplot`**.
+Python ≥ 3.10. Latest `main` from GitHub:
+`pip install "git+https://github.com/zlatko-minev/paperplot.git"`. Full matrix on
+the [Install page](https://zlatko-minev.github.io/paperplot/install/).
+
+## 30-second quickstart
+
+```python
+import numpy as np
+import paperplot as pp
+
+pp.use("aps")                          # or "nature" / "ieee" / "prl" / "talk" — set once
+
+fig, ax = pp.figure(width="single")    # 8.6 cm wide, golden ratio, styled
+ax.plot(np.linspace(0, 10, 200), np.sin(np.linspace(0, 10, 200)))
+ax.set_xlabel(r"delay $\tau$ (ns)")
+ax.set_ylabel(r"population $\langle n \rangle$")
+
+pp.save(fig, "fig1.pdf")               # embeds fonts, runs preflight()
+```
+
+## Gallery
+
+Same three-curve plot, same data — stock matplotlib versus one `pp.use("aps")`.
+paperplot fixes the column width, type scale, color cycle, ticks, and line weights
+in a single call.
+
+<table>
+<tr>
+<td align="center"><b>matplotlib defaults</b><br><img src="docs/assets/gallery/before.png" width="380"></td>
+<td align="center"><b>paperplot — <code>pp.use("aps")</code></b><br><img src="docs/assets/gallery/after.png" width="380"></td>
+</tr>
+</table>
+
+<table>
+<tr>
+<td><img src="docs/assets/gallery/aps_4panel_single.png" width="250"></td>
+<td><img src="docs/assets/gallery/hist_overlap.png" width="250"></td>
+<td><img src="docs/assets/gallery/data_fit_band.png" width="250"></td>
+</tr>
+</table>
+
+### One figure, many panels
+
+A custom `GridSpec`, four panel letters: **(a)** $T_1$ relaxation and **(b)** Ramsey
+fringes — each a fit with a **flush residual strip** — plus **(c)** outlined $T_1$
+distributions and **(d)** a chevron map. Journal styling carries through a hand-built grid.
+
+<p align="center"><img src="docs/assets/gallery/composite.png" width="720"></p>
+
+### See it on the page before you submit
+
+The part most styling packages skip: `pp.preview_in_page(fig)` drops your figure
+into a **true-to-scale mock journal page** with real body text — so you see exactly
+how big it lands in the column and whether the lettering still reads, *before* you
+submit. More in the [gallery](https://zlatko-minev.github.io/paperplot/gallery/#on-the-page).
+
+<table>
+<tr>
+<td align="center"><img src="docs/assets/gallery/in_page_aps.png" width="250"><br>single column</td>
+<td align="center"><img src="docs/assets/gallery/in_page_hist.png" width="250"><br>histograms, in context</td>
+<td align="center"><img src="docs/assets/gallery/in_page_double.png" width="250"><br>double column, across the page</td>
+</tr>
+</table>
+
+Every image is generated from [`examples/showcase.py`](examples/showcase.py) by
+[`docs/generate_gallery.py`](docs/generate_gallery.py) and regenerated by CI on each
+docs build (published to GitHub Pages). Build locally:
+
+```bash
+pip install -e ".[docs,notebook]"
+python docs/generate_gallery.py && mkdocs serve
+```
+
+## What you get
+
+| | |
+|---|---|
+| **True journal sizing** | `width="single"/"onehalf"/"double"/"full_page"` → exact column widths in inches. |
+| **Correct export** | PDF default, EPS first-class; fonts embedded as Type-42, no Type-3; RGB; revision stamped in metadata. |
+| **Preflight linter** | `pp.preflight(fig)` → structured `Report`: flags sub-spec fonts/lines and grayscale-ambiguous colors. Warn, never block. |
+| **Colorblind-safe by default** | Okabe-Ito cycle; sequential/diverging maps kept separate (`pp.cmap("BuGn")`); custom via `pp.register_palette`. Fill/stroke convention: `pp.fills()` (muted) under `pp.strokes()` (bright). `pp.show_palettes()` shows every palette tagged for colorblind-safety. |
+| **Plot helpers** | `pp.hist_outline` (translucent fill + crisp staircase outline), `pp.hist_filled`, `pp.data_fit_band` (markers + fit + CI band), `pp.swatches`. |
+| **See it on the page** | `pp.preview_in_page(fig)` drops the figure into a true-to-scale mock journal page with real body text — catch sizing/legibility before you submit (a paperplot original). Plus `pp.show(fig, zoom=2)` and `pp.grayscale_proof(fig)`. |
+| **Helpers** | `pp.panel_labels(axes)`, `pp.despine(ax)`, `pp.clean_shared_axes(fig)`. |
+
+## A bit more
+
+```python
+# multi-panel, double column
+fig, axes = pp.figure(width="double", nrows=2, ncols=2, sharex=True)
+pp.panel_labels(axes, fmt="({})")          # (a) (b) (c) (d)
+pp.clean_shared_axes(fig)
+
+# sans-serif labels with Computer Modern math is the default (the physics look);
+# math="sans" pairs Arial-style math instead, font_scale nudges every size
+pp.use("aps", math="cm", font_scale=1.1)    # sticky: pp.figure() inherits both
+
+# scoped style (doesn't leak), serif to match REVTeX Times
+with pp.style("aps", serif=True):
+    fig, ax = pp.figure(width="full_page")
+
+# per-figure overrides
+fig, ax = pp.figure("single", journal="prl", palette="mylab")
+
+# overlapping histograms, fig-3 style: muted fills, crisp outlines
+fig, ax = pp.figure("single")
+for s, c in zip((sample_a, sample_b), pp.fills()):
+    pp.hist_outline(s, ax, bins=60, rescale=True, color=c)
+ax.axvline(ideal, color=pp.strokes()[8], ls="--", lw=1.2, zorder=100)
+
+# data + fit + ±1σ band (e.g. lmfit result.eval / eval_uncertainty)
+pp.data_fit_band(ax, x, y, yerr=yerr, x_fit=xf, y_fit=yf, y_fit_err=yf_err)
+
+# pre-submission check
+report = pp.preflight(fig)
+if not report:                              # truthy == clean
+    print(report)                           # aligned table of issues
+```
+
+## Targets
+
+`pp.use(...)` / `pp.figure(journal=...)` accept any of:
+
+| key | target | single / double width |
+|---|---|---|
+| `aps` (+ `prl` `prx` `prb`) | Physical Review | 8.6 cm / 17.8 cm |
+| `nature` | Nature | 8.9 cm / 18.3 cm |
+| `ieee` | IEEE Transactions / conference | 8.9 cm (3.5″) / 18.2 cm (7.16″) |
+| `talk` | slides / presentation | larger type, thicker lines (scale with the target) |
+
+`pp.available()` lists them all. New journals are pure data — add a table to
+[`data/journals.toml`](paperplot/data/journals.toml); no code.
+
+## Drop-in style sheets
+
+The product is `pp.figure()`/`pp.save()` — they size to the real column, embed
+fonts, and preflight, which a style sheet *cannot*. But the **look** is just
+rcParams, and rcParams travel as `.mplstyle` files, so you can adopt it with zero
+buy-in and graduate later:
+
+```python
+import paperplot as pp, matplotlib.pyplot as plt
+
+pp.register_mplstyles()                 # registers paperplot-aps/-nature/-ieee/-talk
+plt.style.use("paperplot-aps")          # now use plain matplotlib
+# composable, matplotlib-native: layer a built-in modifier on top
+plt.style.use(["paperplot-nature", "ggplot"])
+
+# or write a file to commit / share / drop into ~/.config/matplotlib/stylelib/
+pp.export_mplstyle("ieee", "ieee.mplstyle", serif=True)
+```
+
+paperplot never touches matplotlib's global style library on import — registration
+is an explicit opt-in. A style sheet carries the target's *default* (single-column)
+size; reach for `pp.figure(width=...)` when you need the column-true figure.
+
+## Fonts
+
+Journals want figure lettering in **Helvetica or Arial** (Nature requires it), but
+those are proprietary and can't be redistributed. So paperplot ships **TeX Gyre
+Heros** — a free, metric-compatible Helvetica clone — and registers it
+automatically. The font preference is `Arial → Helvetica → TeX Gyre Heros →
+DejaVu Sans`: if you have the real thing installed it's used, otherwise the
+bundled clone gives the *same Helvetica look on every machine* (and embeds a
+proper Type-42 font in the PDF, instead of silently falling back to matplotlib's
+DejaVu Sans). This is why the figures look identical on your laptop, a
+collaborator's box, and CI. Bundled under the free GUST Font License
+([`paperplot/data/fonts/LICENSE.md`](paperplot/data/fonts/LICENSE.md)).
+
+## Design
+
+See [`paperplot_DESIGN.md`](paperplot_DESIGN.md) for the full design — journal specs
+as data (`data/journals.toml`), the rcParams mapping, and the registry/versioning
+model.
+
+## Layout
+
+```
+paperplot/
+  journals.py   registry.py   data/journals.toml   layout.py
+  style.py      lint.py       palettes.py          preview.py
+  fonts.py      save.py       core.py              plots.py
+  mplstyle.py
+```
+
+## Develop
+
+```bash
+pip install -e ".[dev]"
+pytest                              # tests
+python examples/run_all.py          # run every example -> examples/out/render/*.png
+```
+
+## Releasing
+
+Published to PyPI as **`paperplot-quantum`** via **Trusted Publishing** (OIDC — no
+stored tokens). To cut a release: bump `version` in `pyproject.toml`, push, then
+create a GitHub **Release** with tag `vX.Y.Z`. The
+[`release.yml`](.github/workflows/release.yml) workflow builds, runs `twine check`,
+and publishes. (One-time: register the trusted publisher on PyPI — repo
+`zlatko-minev/paperplot`, workflow `release.yml`, environment `pypi`.)

paperplot_quantum-0.1.0.dist-info/RECORD

@@ -0,0 +1,27 @@
+paperplot/__init__.py,sha256=g6mN9_2FB48JVAt90sFm0_F1nMP8enEI0ggkdN9Bfv4,2117
+paperplot/core.py,sha256=Br6v9f0n1JgJL3fLKygAeVoKMQsFbVgSxq8wu1zE2FE,8778
+paperplot/fonts.py,sha256=iusWnMj8Mw_lYigF7tR33vBpj2XrR90053z-WCT0RMg,1406
+paperplot/journals.py,sha256=dip0ve29t_w4i9DI3ZC6TpuyFZiJKi8hg78xkAfgdHw,2019
+paperplot/layout.py,sha256=EInObtV5sujqTwBJrMhIzHInvzWpMbo7aLcW_IYo_To,4205
+paperplot/lint.py,sha256=_7Tz_YMTCgzIAhXAAwk42MvPiQLwKy-R1kICOODBxZA,6191
+paperplot/mplstyle.py,sha256=JOdpiqen0eTwaLK4ZG9LIYWX2YzcneVsW7ngkv2UPkc,4330
+paperplot/palettes.py,sha256=Baku2fIvCvJPV8NR01P8h8bpjG3RSI_qdtTHHyrT0iQ,7126
+paperplot/plots.py,sha256=8_y24FVFGzENiaaENdsRjSrTeZo-2c2Xgel24ohozpk,10515
+paperplot/preview.py,sha256=pXg22V9RpqcVo_fvVU9RIgr752GfiC2mrerbVN5Pi-Y,10082
+paperplot/registry.py,sha256=pnuoxDubGe4SGyNDYMtMh5p7VdKrrOLLkNvr413GYVs,3696
+paperplot/save.py,sha256=mBcYIDTiubR3xU7Q-P2zSgDr7Vodt2L1m0siK01jPUk,3241
+paperplot/style.py,sha256=TaWtFQfVR7QMm3oTgFjjTmif4JzAx_UtzYAxYbPJv0w,7217
+paperplot/data/journals.toml,sha256=94wgnEz-j2r9CpJO34midxyWFo-sJCWNxwT1RplJRWw,3802
+paperplot/data/fonts/GUST-FONT-LICENSE.txt,sha256=XrYbuDa7GEXvZocXyxWzgumXdIziYp5DiMxeTD-k5DM,1417
+paperplot/data/fonts/LICENSE.md,sha256=y5G2z6rQEdok7kObwDETdRtExyQD0G5fd-ldtujuMu8,1022
+paperplot/data/fonts/texgyreheros-bold.otf,sha256=sXAWKDX078KIiG3UIxQG3Efhm2FM9EFoNmNVmdRKfWA,135204
+paperplot/data/fonts/texgyreheros-bolditalic.otf,sha256=Fm_G0GjZyZdCgVVcs9cwNlU3qbZ2qyabtRY_WnVJZQU,135264
+paperplot/data/fonts/texgyreheros-italic.otf,sha256=ZHPff6EHs_tL44lzcQr-IrBkDCrAdtUzfPEmvtmqEIw,139208
+paperplot/data/fonts/texgyreheros-regular.otf,sha256=auGgnVqUA2e3qqqR7ovYosMzv-GT5wluI_kxNX1iCB8,133600
+paperplot_quantum-0.1.0.dist-info/licenses/LICENSE,sha256=2bWBItGck5o3t8rMicBPLU6OKklTEG_Af-i3oMiI9SU,1078
+paperplot_quantum-0.1.0.dist-info/licenses/paperplot/data/fonts/GUST-FONT-LICENSE.txt,sha256=XrYbuDa7GEXvZocXyxWzgumXdIziYp5DiMxeTD-k5DM,1417
+paperplot_quantum-0.1.0.dist-info/licenses/paperplot/data/fonts/LICENSE.md,sha256=y5G2z6rQEdok7kObwDETdRtExyQD0G5fd-ldtujuMu8,1022
+paperplot_quantum-0.1.0.dist-info/METADATA,sha256=-SeSEWfyy02WCcaVJke6BGdp4Yu9IGMDj59MBoQ6PkA,12636
+paperplot_quantum-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+paperplot_quantum-0.1.0.dist-info/top_level.txt,sha256=wdNpTgIMXQh8QkN3Cd_oXGMKMYK2ye3vWcowAMfWrCk,10
+paperplot_quantum-0.1.0.dist-info/RECORD,,

paperplot_quantum-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

paperplot_quantum-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 The paperplot authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

paperplot_quantum-0.1.0.dist-info/licenses/paperplot/data/fonts/GUST-FONT-LICENSE.txt

@@ -0,0 +1,29 @@
+% This is version 1.0, dated 22 June 2009, of the GUST Font License.
+% (GUST is the Polish TeX Users Group, https://www.gust.org.pl)
+%
+% For the most recent version of this license see
+% https://www.gust.org.pl/fonts/licenses/GUST-FONT-LICENSE.txt
+% or
+% https://tug.org/fonts/licenses/GUST-FONT-LICENSE.txt
+%
+% This work may be distributed and/or modified under the conditions
+% of the LaTeX Project Public License, either version 1.3c of this
+% license or (at your option) any later version.
+% 
+% Please also observe the following clause:
+% 1) it is requested, but not legally required, that derived works be
+%    distributed only after changing the names of the fonts comprising this
+%    work and given in an accompanying "manifest", and that the
+%    files comprising the Work, as listed in the manifest, also be given
+%    new names. Any exceptions to this request are also given in the
+%    manifest.
+%    
+%    We recommend the manifest be given in a separate file named
+%    MANIFEST-<fontid>.txt, where <fontid> is some unique identification
+%    of the font family. If a separate "readme" file accompanies the Work, 
+%    we recommend a name of the form README-<fontid>.txt.
+%
+% The latest version of the LaTeX Project Public License is in
+% https://www.latex-project.org/lppl.txt and version 1.3c or later
+% is part of all distributions of LaTeX version 2006/05/20 or later.
+