oh-mpl-paper 0.1.0__tar.gz

oh_mpl_paper-0.1.0/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: oh-mpl-paper
+Version: 0.1.0
+Summary: Publication-ready Matplotlib styles for scientific papers, posters, and presentations.
+Author: Oscar Hickman
+License: MIT
+Project-URL: Homepage, https://github.com/OscarHickman/thesis-themes
+Project-URL: Repository, https://github.com/OscarHickman/thesis-themes
+Project-URL: Issues, https://github.com/OscarHickman/thesis-themes/issues
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: matplotlib>=3.3.0
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+
+# oh-mpl-paper
+
+![Python](https://img.shields.io/badge/python-3.8%2B-blue)
+
+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
+
+```bash
+pip install git+https://github.com/OscarHickman/thesis-themes.git
+```
+
+## Usage
+
+```python
+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
+
+| Style          | Use case                                                                 |
+|----------------|---------------------------------------------------------------------------|
+| `base`         | Generic scientific-paper defaults (Type 42 fonts, colorblind-safe cycle). |
+| `nature`       | Single-column Nature-family figures, 89mm wide, 8pt sans-serif fonts.    |
+| `ieee`         | IEEE transactions single-column format, 3.5in wide, Times New Roman.     |
+| `k.wang`       | SaUCE/`sauce_xi` MNRAS paper-figures house style (single-column, serif + Computer Modern math, muted inward ticks). |
+| `presentation` | 16:9 slide decks — large fonts, thick lines, transparent background.    |
+| `poster`       | A0 conference posters — very large fonts, thick lines for ~2m viewing.   |
+
+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
+
+```bash
+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](https://docs.pypi.org/trusted-publishers/) (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.
+
+```bash
+# 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`.

oh_mpl_paper-0.1.0/README.md

@@ -0,0 +1,72 @@
+# oh-mpl-paper
+
+![Python](https://img.shields.io/badge/python-3.8%2B-blue)
+
+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
+
+```bash
+pip install git+https://github.com/OscarHickman/thesis-themes.git
+```
+
+## Usage
+
+```python
+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
+
+| Style          | Use case                                                                 |
+|----------------|---------------------------------------------------------------------------|
+| `base`         | Generic scientific-paper defaults (Type 42 fonts, colorblind-safe cycle). |
+| `nature`       | Single-column Nature-family figures, 89mm wide, 8pt sans-serif fonts.    |
+| `ieee`         | IEEE transactions single-column format, 3.5in wide, Times New Roman.     |
+| `k.wang`       | SaUCE/`sauce_xi` MNRAS paper-figures house style (single-column, serif + Computer Modern math, muted inward ticks). |
+| `presentation` | 16:9 slide decks — large fonts, thick lines, transparent background.    |
+| `poster`       | A0 conference posters — very large fonts, thick lines for ~2m viewing.   |
+
+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
+
+```bash
+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](https://docs.pypi.org/trusted-publishers/) (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.
+
+```bash
+# 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`.

oh_mpl_paper-0.1.0/oh_mpl_paper/__init__.py

@@ -0,0 +1,51 @@
+"""oh_mpl_paper: publication-ready Matplotlib styles for scientific papers.
+
+Usage
+-----
+>>> import oh_mpl_paper as p
+>>> import matplotlib.pyplot as plt
+>>> p.setconfig("nature")
+>>> plt.plot(x, y)
+>>> plt.show()
+"""
+from __future__ import annotations
+
+from pathlib import Path
+from typing import List
+
+import matplotlib.pyplot as plt
+
+__version__ = "0.1.0"
+
+_STYLES_DIR = Path(__file__).resolve().parent / "styles"
+
+
+def available() -> List[str]:
+    """Return the sorted list of valid style names for :func:`setconfig`."""
+    return sorted(f.stem for f in _STYLES_DIR.glob("*.mplstyle"))
+
+
+def setconfig(config_name: str) -> None:
+    """Apply the named publication style globally via ``plt.style.use``.
+
+    Parameters
+    ----------
+    config_name:
+        Name of a style bundled under ``oh_mpl_paper/styles/`` (without the
+        ``.mplstyle`` extension), e.g. ``"nature"``, ``"ieee"``, ``"k.wang"``.
+
+    Raises
+    ------
+    ValueError
+        If ``config_name`` does not match any bundled style. The error lists
+        every currently available style.
+    """
+    style_path = _STYLES_DIR / f"{config_name}.mplstyle"
+    if not style_path.is_file():
+        raise ValueError(
+            f"Unknown style {config_name!r}. Available styles: {available()}"
+        )
+    plt.style.use(str(style_path))
+
+
+__all__ = ["setconfig", "available", "__version__"]

oh_mpl_paper-0.1.0/oh_mpl_paper/styles/base.mplstyle

@@ -0,0 +1,63 @@
+# base.mplstyle — shared foundation for all oh_mpl_paper styles.
+# Editable, embedded (Type 42) fonts; colorblind-safe categorical cycle
+# (Okabe-Ito); inward ticks; clean two-spine axes.
+
+# --- Fonts (editable in Illustrator/Inkscape) -------------------------------
+pdf.fonttype: 42
+ps.fonttype: 42
+font.family: serif
+font.weight: normal
+font.size: 9
+mathtext.fontset: cm
+mathtext.default: it
+
+# --- Axes --------------------------------------------------------------------
+axes.linewidth: 0.8
+axes.labelsize: 9
+axes.labelweight: normal
+axes.titlesize: 9
+axes.spines.top: False
+axes.spines.right: False
+axes.grid: False
+axes.axisbelow: True
+
+# Okabe-Ito colorblind-safe categorical palette
+axes.prop_cycle: cycler('color', ['000000', 'E69F00', '56B4E9', '009E73', 'F0E442', '0072B2', 'D55E00', 'CC79A7'])
+
+# --- Ticks ---------------------------------------------------------------
+xtick.direction: in
+xtick.labelsize: 8
+xtick.major.size: 3.0
+xtick.major.width: 0.6
+xtick.minor.size: 1.6
+xtick.minor.width: 0.5
+xtick.minor.visible: True
+xtick.top: False
+
+ytick.direction: in
+ytick.labelsize: 8
+ytick.major.size: 3.0
+ytick.major.width: 0.6
+ytick.minor.size: 1.6
+ytick.minor.width: 0.5
+ytick.minor.visible: True
+ytick.right: False
+
+# --- Lines & markers -----------------------------------------------------
+lines.linewidth: 1.2
+lines.markersize: 4
+patch.linewidth: 0.5
+errorbar.capsize: 2
+
+# --- Legend ----------------------------------------------------------------
+legend.fontsize: 7
+legend.title_fontsize: 7
+legend.frameon: False
+legend.handlelength: 1.6
+legend.labelspacing: 0.3
+
+# --- Figure / saving -------------------------------------------------------
+figure.figsize: 3.5, 2.625
+figure.dpi: 150
+savefig.dpi: 300
+savefig.bbox: tight

oh_mpl_paper-0.1.0/oh_mpl_paper/styles/ieee.mplstyle

@@ -0,0 +1,55 @@
+# ieee.mplstyle — strict IEEE transactions single-column format.
+# Column width 3.5in, Times New Roman, 8pt fonts.
+
+pdf.fonttype: 42
+ps.fonttype: 42
+font.family: serif
+font.serif: Times New Roman, Times, DejaVu Serif
+font.size: 8
+mathtext.fontset: stix
+mathtext.rm: serif
+
+axes.linewidth: 0.8
+axes.labelsize: 8
+axes.labelweight: normal
+axes.titlesize: 8
+axes.spines.top: True
+axes.spines.right: True
+axes.grid: False
+axes.axisbelow: True
+axes.prop_cycle: cycler('color', ['000000', 'E69F00', '56B4E9', '009E73', 'F0E442', '0072B2', 'D55E00', 'CC79A7'])
+
+xtick.direction: in
+xtick.labelsize: 7
+xtick.major.size: 3.0
+xtick.major.width: 0.6
+xtick.minor.size: 1.5
+xtick.minor.width: 0.4
+xtick.minor.visible: True
+xtick.top: True
+
+ytick.direction: in
+ytick.labelsize: 7
+ytick.major.size: 3.0
+ytick.major.width: 0.6
+ytick.minor.size: 1.5
+ytick.minor.width: 0.4
+ytick.minor.visible: True
+ytick.right: True
+
+lines.linewidth: 1.0
+lines.markersize: 4
+patch.linewidth: 0.5
+errorbar.capsize: 2
+
+legend.fontsize: 7
+legend.title_fontsize: 7
+legend.frameon: True
+legend.framealpha: 0.9
+legend.handlelength: 1.6
+legend.labelspacing: 0.3
+
+figure.figsize: 3.5, 2.625
+figure.dpi: 150
+savefig.dpi: 600
+savefig.bbox: tight

oh_mpl_paper-0.1.0/oh_mpl_paper/styles/k.wang.mplstyle

@@ -0,0 +1,76 @@
+# k.wang.mplstyle — faithful reproduction of the SaUCE/sauce_xi MNRAS
+# paper-figures house style (galform_analysis.utils.matplotlib_config
+# defaults, as overridden by paper_figures/_shared.py, 2026-07 revision).
+# Single-column MNRAS width (3.31in / ~84mm); serif + Computer Modern math.
+
+pdf.fonttype: 42
+ps.fonttype: 42
+font.family: serif
+font.weight: normal
+font.size: 8
+mathtext.fontset: cm
+mathtext.default: it
+
+figure.figsize: 3.31, 2.648
+figure.subplot.wspace: 0.25
+figure.subplot.hspace: 0.25
+figure.constrained_layout.use: True
+
+axes.labelsize: 11
+axes.labelweight: normal
+axes.titlesize: 11
+axes.linewidth: 0.735
+axes.edgecolor: (0.0, 0.0, 0.0, 0.8)
+axes.grid: False
+axes.axisbelow: True
+
+xtick.color: (0.0, 0.0, 0.0, 0.8)
+xtick.labelsize: 9
+xtick.direction: in
+xtick.top: True
+xtick.major.size: 3.5
+xtick.major.width: 0.7
+xtick.minor.size: 2.0
+xtick.minor.width: 0.5
+xtick.minor.visible: True
+
+ytick.color: (0.0, 0.0, 0.0, 0.8)
+ytick.labelsize: 9
+ytick.direction: in
+ytick.right: True
+ytick.major.size: 3.5
+ytick.major.width: 0.7
+ytick.minor.size: 2.0
+ytick.minor.width: 0.5
+ytick.minor.visible: True
+
+grid.color: gray
+grid.alpha: 0.5
+grid.linestyle: (0, (1.6, 1.6))
+grid.linewidth: 0.8
+
+patch.edgecolor: (0.0, 0.0, 0.0, 0.8)
+patch.linewidth: 0.5
+
+lines.linewidth: 1.2
+errorbar.capsize: 2
+
+legend.numpoints: 2
+legend.scatterpoints: 3
+legend.markerscale: 1.0
+legend.fontsize: 7
+legend.title_fontsize: 7
+legend.loc: best
+legend.handlelength: 2.0
+legend.handleheight: 0.5
+legend.labelspacing: 0.1
+legend.handletextpad: 0.5
+legend.borderpad: 0.25
+legend.borderaxespad: 0.8
+legend.columnspacing: 1.0
+legend.shadow: False
+legend.frameon: False
+legend.framealpha: 0.8
+
+savefig.dpi: 300
+savefig.bbox: tight

oh_mpl_paper-0.1.0/oh_mpl_paper/styles/nature.mplstyle

@@ -0,0 +1,54 @@
+# nature.mplstyle — single-column Nature/Nature-family figure format.
+# Column width 3.46in (~89mm), 8pt fonts, tight constrained layout.
+
+pdf.fonttype: 42
+ps.fonttype: 42
+font.family: sans-serif
+font.sans-serif: Arial, Helvetica, DejaVu Sans
+font.size: 8
+mathtext.fontset: dejavusans
+
+axes.linewidth: 0.8
+axes.labelsize: 8
+axes.labelweight: normal
+axes.titlesize: 8
+axes.spines.top: False
+axes.spines.right: False
+axes.grid: False
+axes.axisbelow: True
+axes.prop_cycle: cycler('color', ['000000', 'E69F00', '56B4E9', '009E73', 'F0E442', '0072B2', 'D55E00', 'CC79A7'])
+
+xtick.direction: in
+xtick.labelsize: 7
+xtick.major.size: 2.5
+xtick.major.width: 0.6
+xtick.minor.size: 1.5
+xtick.minor.width: 0.4
+xtick.minor.visible: True
+xtick.top: False
+
+ytick.direction: in
+ytick.labelsize: 7
+ytick.major.size: 2.5
+ytick.major.width: 0.6
+ytick.minor.size: 1.5
+ytick.minor.width: 0.4
+ytick.minor.visible: True
+ytick.right: False
+
+lines.linewidth: 1.0
+lines.markersize: 4
+patch.linewidth: 0.5
+errorbar.capsize: 2
+
+legend.fontsize: 6.5
+legend.title_fontsize: 6.5
+legend.frameon: False
+legend.handlelength: 1.4
+legend.labelspacing: 0.3
+
+figure.figsize: 3.46, 2.6
+figure.dpi: 150
+figure.constrained_layout.use: True
+savefig.dpi: 300
+savefig.bbox: tight

oh_mpl_paper-0.1.0/oh_mpl_paper/styles/poster.mplstyle

@@ -0,0 +1,51 @@
+# poster.mplstyle — A0 conference poster format.
+# Very large fonts, thick lines, readable from ~2m distance.
+
+pdf.fonttype: 42
+ps.fonttype: 42
+font.family: sans-serif
+font.sans-serif: Arial, Helvetica, DejaVu Sans
+font.size: 24
+mathtext.fontset: dejavusans
+
+axes.linewidth: 2.4
+axes.labelsize: 28
+axes.labelweight: bold
+axes.titlesize: 32
+axes.titleweight: bold
+axes.spines.top: False
+axes.spines.right: False
+axes.grid: False
+axes.axisbelow: True
+axes.prop_cycle: cycler('color', ['E69F00', '56B4E9', '009E73', 'D55E00', '0072B2', 'CC79A7', 'F0E442', '000000'])
+
+xtick.direction: in
+xtick.labelsize: 22
+xtick.major.size: 8.0
+xtick.major.width: 2.0
+xtick.minor.visible: False
+xtick.top: False
+
+ytick.direction: in
+ytick.labelsize: 22
+ytick.major.size: 8.0
+ytick.major.width: 2.0
+ytick.minor.visible: False
+ytick.right: False
+
+lines.linewidth: 4.0
+lines.markersize: 12
+patch.linewidth: 1.5
+errorbar.capsize: 5
+
+legend.fontsize: 22
+legend.title_fontsize: 22
+legend.frameon: False
+legend.handlelength: 2.0
+legend.labelspacing: 0.5
+
+figure.figsize: 16, 12
+figure.dpi: 100
+figure.constrained_layout.use: True
+savefig.dpi: 150
+savefig.bbox: tight

oh_mpl_paper-0.1.0/oh_mpl_paper/styles/presentation.mplstyle

@@ -0,0 +1,52 @@
+# presentation.mplstyle — 16:9 slide deck format.
+# Large fonts, thick lines, high contrast for projector viewing.
+
+pdf.fonttype: 42
+ps.fonttype: 42
+font.family: sans-serif
+font.sans-serif: Arial, Helvetica, DejaVu Sans
+font.size: 18
+mathtext.fontset: dejavusans
+
+axes.linewidth: 1.8
+axes.labelsize: 20
+axes.labelweight: bold
+axes.titlesize: 22
+axes.titleweight: bold
+axes.spines.top: False
+axes.spines.right: False
+axes.grid: False
+axes.axisbelow: True
+axes.prop_cycle: cycler('color', ['E69F00', '56B4E9', '009E73', 'D55E00', '0072B2', 'CC79A7', 'F0E442', '000000'])
+
+xtick.direction: in
+xtick.labelsize: 16
+xtick.major.size: 6.0
+xtick.major.width: 1.5
+xtick.minor.visible: False
+xtick.top: False
+
+ytick.direction: in
+ytick.labelsize: 16
+ytick.major.size: 6.0
+ytick.major.width: 1.5
+ytick.minor.visible: False
+ytick.right: False
+
+lines.linewidth: 3.0
+lines.markersize: 9
+patch.linewidth: 1.0
+errorbar.capsize: 4
+
+legend.fontsize: 16
+legend.title_fontsize: 16
+legend.frameon: False
+legend.handlelength: 1.8
+legend.labelspacing: 0.4
+
+figure.figsize: 12.8, 7.2
+figure.dpi: 120
+figure.constrained_layout.use: True
+savefig.dpi: 200
+savefig.bbox: tight
+savefig.transparent: True

oh_mpl_paper-0.1.0/oh_mpl_paper.egg-info/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: oh-mpl-paper
+Version: 0.1.0
+Summary: Publication-ready Matplotlib styles for scientific papers, posters, and presentations.
+Author: Oscar Hickman
+License: MIT
+Project-URL: Homepage, https://github.com/OscarHickman/thesis-themes
+Project-URL: Repository, https://github.com/OscarHickman/thesis-themes
+Project-URL: Issues, https://github.com/OscarHickman/thesis-themes/issues
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: matplotlib>=3.3.0
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+
+# oh-mpl-paper
+
+![Python](https://img.shields.io/badge/python-3.8%2B-blue)
+
+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
+
+```bash
+pip install git+https://github.com/OscarHickman/thesis-themes.git
+```
+
+## Usage
+
+```python
+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
+
+| Style          | Use case                                                                 |
+|----------------|---------------------------------------------------------------------------|
+| `base`         | Generic scientific-paper defaults (Type 42 fonts, colorblind-safe cycle). |
+| `nature`       | Single-column Nature-family figures, 89mm wide, 8pt sans-serif fonts.    |
+| `ieee`         | IEEE transactions single-column format, 3.5in wide, Times New Roman.     |
+| `k.wang`       | SaUCE/`sauce_xi` MNRAS paper-figures house style (single-column, serif + Computer Modern math, muted inward ticks). |
+| `presentation` | 16:9 slide decks — large fonts, thick lines, transparent background.    |
+| `poster`       | A0 conference posters — very large fonts, thick lines for ~2m viewing.   |
+
+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
+
+```bash
+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](https://docs.pypi.org/trusted-publishers/) (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.
+
+```bash
+# 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`.

oh_mpl_paper-0.1.0/oh_mpl_paper.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+README.md
+pyproject.toml
+oh_mpl_paper/__init__.py
+oh_mpl_paper.egg-info/PKG-INFO
+oh_mpl_paper.egg-info/SOURCES.txt
+oh_mpl_paper.egg-info/dependency_links.txt
+oh_mpl_paper.egg-info/requires.txt
+oh_mpl_paper.egg-info/top_level.txt
+oh_mpl_paper/styles/base.mplstyle
+oh_mpl_paper/styles/ieee.mplstyle
+oh_mpl_paper/styles/k.wang.mplstyle
+oh_mpl_paper/styles/nature.mplstyle
+oh_mpl_paper/styles/poster.mplstyle
+oh_mpl_paper/styles/presentation.mplstyle
+tests/test_styles.py

oh_mpl_paper-0.1.0/oh_mpl_paper.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

oh_mpl_paper-0.1.0/oh_mpl_paper.egg-info/requires.txt

@@ -0,0 +1,4 @@
+matplotlib>=3.3.0
+
+[test]
+pytest>=7.0.0

oh_mpl_paper-0.1.0/oh_mpl_paper.egg-info/top_level.txt

@@ -0,0 +1 @@
+oh_mpl_paper

oh_mpl_paper-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "oh-mpl-paper"
+version = "0.1.0"
+description = "Publication-ready Matplotlib styles for scientific papers, posters, and presentations."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [
+    { name = "Oscar Hickman" },
+]
+dependencies = [
+    "matplotlib>=3.3.0",
+]
+
+[project.optional-dependencies]
+test = [
+    "pytest>=7.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/OscarHickman/thesis-themes"
+Repository = "https://github.com/OscarHickman/thesis-themes"
+Issues = "https://github.com/OscarHickman/thesis-themes/issues"
+
+[tool.setuptools.packages.find]
+include = ["oh_mpl_paper*"]
+
+[tool.setuptools.package-data]
+"oh_mpl_paper" = ["styles/*.mplstyle"]

oh_mpl_paper-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

oh_mpl_paper-0.1.0/tests/test_styles.py

@@ -0,0 +1,72 @@
+"""Tests for oh_mpl_paper style loading and rendering."""
+from pathlib import Path
+
+import matplotlib
+
+matplotlib.use("Agg")
+import matplotlib.pyplot as plt
+import numpy as np
+import pytest
+
+import oh_mpl_paper as p
+
+
+@pytest.fixture(autouse=True)
+def _reset_style():
+    yield
+    plt.style.use("default")
+
+
+def test_available_returns_bundled_styles():
+    names = p.available()
+    assert isinstance(names, list)
+    assert names == sorted(names)
+    for expected in ("base", "nature", "ieee", "presentation", "poster", "k.wang"):
+        assert expected in names
+
+
+@pytest.mark.parametrize("style_name", p.available())
+def test_setconfig_loads_every_bundled_style(style_name):
+    p.setconfig(style_name)
+    fig, ax = plt.subplots()
+    ax.plot([0, 1, 2], [0, 1, 0])
+    plt.close(fig)
+
+
+def test_setconfig_raises_valueerror_for_unknown_style():
+    with pytest.raises(ValueError) as exc_info:
+        p.setconfig("not-a-real-style")
+    message = str(exc_info.value)
+    assert "not-a-real-style" in message
+    for name in p.available():
+        assert name in message
+
+
+def test_sample_grid_pdf_per_style(tmp_path: Path):
+    """Render a line/scatter/bar grid per style for visual inspection."""
+    rng = np.random.default_rng(0)
+    x = np.linspace(0, 10, 50)
+    y = np.sin(x)
+    scatter_y = y + rng.normal(scale=0.1, size=x.shape)
+    categories = ["A", "B", "C", "D"]
+    values = [3, 7, 4, 6]
+
+    for style_name in p.available():
+        p.setconfig(style_name)
+        fig, axes = plt.subplots(1, 3)
+        axes[0].plot(x, y, label="sin(x)")
+        axes[0].legend()
+        axes[0].set_title("Line")
+
+        axes[1].scatter(x, scatter_y, s=10)
+        axes[1].set_title("Scatter")
+
+        axes[2].bar(categories, values)
+        axes[2].set_title("Bar")
+
+        out_path = tmp_path / f"sample_{style_name}.pdf"
+        fig.savefig(out_path)
+        plt.close(fig)
+
+        assert out_path.is_file()
+        assert out_path.stat().st_size > 0