plotstyle 1.2.1__tar.gz → 1.2.2__tar.gz

{plotstyle-1.2.1 → plotstyle-1.2.2}/CHANGELOG.md

@@ -13,6 +13,32 @@ _Nothing yet._
 
 ---
 
+## [1.2.2] - 2026-04-27
+
+Patch release: docs improvements, README example quality, and CI action bump.
+
+### Added
+
+- **`LatexNotFoundError` catch pattern in API docs** (`docs/api/style.md`): new "Catching LaTeX errors" section shows how to import and handle `LatexNotFoundError` directly, with a note on catching the base `RuntimeError` as an alternative.
+- **`examples/output/accessibility_deuteranopia.png`**: new reference output image generated by the `simulate_cvd` section of `04_accessibility_checks.py`.
+
+### Changed
+
+- **README overlay examples use realistic data**: notebook and okabe-ito overlay snippets now use `np.linspace` / `np.sin` / `np.cos` plots instead of trivial `[1, 2, 3]` lists; axes labels updated to match.
+- **README overlay snippet import cleanup**: removed stray `import matplotlib.pyplot as plt` from the minimal overlay example where it was unused.
+- **README validation report output updated**: sample terminal output now reflects a two-column figure width rather than a single-column one.
+- **README `diff` output adds `Avoid: none`**: accessibility block in the `plotstyle diff` sample output now shows the `Avoid` field.
+- **`download-artifact` action bumped to v8** in `.github/workflows/release.yml` (was v4).
+- **Version references bumped to 1.2.2** in `README.md` (citation note) and `docs/installation.md` (version-check snippet).
+
+### Fixed
+
+- **HiDPI/Retina crash in `_fig_to_rgb_array`** (`src/plotstyle/color/_rendering.py`): `get_width_height()` now passes `physical=True` so the returned pixel dimensions match the `buffer_rgba()` byte count on high-DPI displays, preventing a `ValueError` during the reshape.
+- **Same HiDPI fix in `simulate_cvd` example** (`examples/04_accessibility_checks.py`): the inline canvas-to-array snippet now uses `get_width_height(physical=True)` to stay consistent with the library fix above.
+- **Typo in `06_export_submission.py` docstring**: `"smit_"` author prefix corrected to `"smith_"`.
+
+---
+
 ## [1.2.1] - 2026-04-26
 
 Patch release: `simulate_cvd` example, warning quality improvements, and docs/example content fixes.
@@ -146,7 +172,8 @@ First public alpha release.
 - **Dynamic versioning**: version derived from git tags via `hatch-vcs` and `importlib.metadata`.
 - **CI/CD pipeline**: GitHub Actions workflows for lint, type-check, test matrix, and automated PyPI release via OIDC Trusted Publishing.
 
-[Unreleased]: https://github.com/rahulkaushal04/plotstyle/compare/v1.2.1...HEAD
+[Unreleased]: https://github.com/rahulkaushal04/plotstyle/compare/v1.2.2...HEAD
+[1.2.2]: https://github.com/rahulkaushal04/plotstyle/compare/v1.2.1...v1.2.2
 [1.2.1]: https://github.com/rahulkaushal04/plotstyle/compare/v1.2.0...v1.2.1
 [1.2.0]: https://github.com/rahulkaushal04/plotstyle/compare/v1.1.0...v1.2.0
 [1.1.0]: https://github.com/rahulkaushal04/plotstyle/compare/v1.0.0...v1.1.0

{plotstyle-1.2.1 → plotstyle-1.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plotstyle
-Version: 1.2.1
+Version: 1.2.2
 Summary: Matplotlib/seaborn style presets matching scientific journal requirements, with validation, export safety, and preview capabilities.
 Project-URL: Homepage, https://github.com/rahulkaushal04/plotstyle
 Project-URL: Documentation, https://plotstyle.readthedocs.io
@@ -280,7 +280,6 @@ Overlays are additive patches that layer on top of a journal preset. They let yo
 Pass overlay names in the same list as the journal key:
 
 ```python
-import matplotlib.pyplot as plt
 import plotstyle
 
 # Strip top/right spines for a clean editorial look
@@ -298,15 +297,19 @@ with plotstyle.use(["nature", "minimal"]) as style:
 </p>
 
 ```python
+import numpy as np
 import matplotlib.pyplot as plt
 import plotstyle
 
+x = np.linspace(0, 2 * np.pi, 100)
+
 # Larger figure and fonts for Jupyter notebooks
 with plotstyle.use(["nature", "notebook"]) as style:
     fig, ax = plt.subplots()   # plt.subplots() picks up the notebook figsize
-    ax.plot([1, 2, 3], label="data")
-    ax.set_xlabel("x")
-    ax.set_ylabel("y")
+    ax.plot(x, np.sin(x), label="sin(x)")
+    ax.plot(x, np.cos(x), label="cos(x)")
+    ax.set_xlabel("Phase (rad)")
+    ax.set_ylabel("Amplitude")
     ax.legend()
     style.savefig(fig, "notebook_figure.pdf")
 ```
@@ -316,13 +319,16 @@ with plotstyle.use(["nature", "notebook"]) as style:
 </p>
 
 ```python
-import matplotlib.pyplot as plt
+import numpy as np
 import plotstyle
 
+x = np.linspace(0, 2 * np.pi, 100)
+
 # Swap the colour cycle to a specific palette
 with plotstyle.use(["ieee", "okabe-ito"]) as style:
     fig, ax = style.figure(columns=1)
-    ax.plot([1, 2, 3], label="data")
+    for i in range(4):
+        ax.plot(x, np.sin(x + i * 0.5), label=f"Series {i + 1}")
     ax.set_xlabel("x")
     ax.set_ylabel("y")
     ax.legend()
@@ -442,15 +448,15 @@ with plotstyle.use("nature") as style:
 ┌──────────────────────────────────────────────────────┐
 │         PlotStyle Validation Report: Nature          │
 ├──────────┬───────────────────────────────────────────┤
-│ ✓ PASS   │ Figure width 89.0mm matches single colu...│
-│ ✓ PASS   │ Figure height 55.0mm is within the Natu...│
+│ ✗ FAIL   │ Figure width 162.6mm does not match Nat...│
+│ ✓ PASS   │ Figure height 121.9mm is within the Nat...│
 │ ✗ FAIL   │ pdf.fonttype = 3; must be 42 for TrueTy...│
 │ ✗ FAIL   │ ps.fonttype = 3; must be 42 for TrueTyp...│
 │ ⚠ WARN   │ savefig.dpi = 'figure'; Nature requires...│
 │ ✓ PASS   │ All plotted lines and spines meet the N...│
-│ ✗ FAIL   │ 14 text element(s) outside the Nature r...│
+│ ✗ FAIL   │ 23 text element(s) outside the Nature r...│
 └──────────┴───────────────────────────────────────────┘
-3/7 checks passed, 1 warning(s), 3 failure(s)
+2/7 checks passed, 1 warning(s), 4 failure(s)
 
 passed: False
 
@@ -580,6 +586,7 @@ Export:
 Accessibility:
   Colorblind safe: Not required
   Grayscale safe:  Not required
+  Avoid:           none
 ```
 
 **`plotstyle diff nature science`**
@@ -673,7 +680,7 @@ If PlotStyle helps your research, a citation or star is appreciated:
   title   = {PlotStyle: Publication-ready scientific figure presets for Matplotlib},
   year    = {2026},
   url     = {https://github.com/rahulkaushal04/plotstyle},
-  note    = {Version 1.2.1},
+  note    = {Version 1.2.2},
 }
 ```
 

{plotstyle-1.2.1 → plotstyle-1.2.2}/README.md

@@ -199,7 +199,6 @@ Overlays are additive patches that layer on top of a journal preset. They let yo
 Pass overlay names in the same list as the journal key:
 
 ```python
-import matplotlib.pyplot as plt
 import plotstyle
 
 # Strip top/right spines for a clean editorial look
@@ -217,15 +216,19 @@ with plotstyle.use(["nature", "minimal"]) as style:
 </p>
 
 ```python
+import numpy as np
 import matplotlib.pyplot as plt
 import plotstyle
 
+x = np.linspace(0, 2 * np.pi, 100)
+
 # Larger figure and fonts for Jupyter notebooks
 with plotstyle.use(["nature", "notebook"]) as style:
     fig, ax = plt.subplots()   # plt.subplots() picks up the notebook figsize
-    ax.plot([1, 2, 3], label="data")
-    ax.set_xlabel("x")
-    ax.set_ylabel("y")
+    ax.plot(x, np.sin(x), label="sin(x)")
+    ax.plot(x, np.cos(x), label="cos(x)")
+    ax.set_xlabel("Phase (rad)")
+    ax.set_ylabel("Amplitude")
     ax.legend()
     style.savefig(fig, "notebook_figure.pdf")
 ```
@@ -235,13 +238,16 @@ with plotstyle.use(["nature", "notebook"]) as style:
 </p>
 
 ```python
-import matplotlib.pyplot as plt
+import numpy as np
 import plotstyle
 
+x = np.linspace(0, 2 * np.pi, 100)
+
 # Swap the colour cycle to a specific palette
 with plotstyle.use(["ieee", "okabe-ito"]) as style:
     fig, ax = style.figure(columns=1)
-    ax.plot([1, 2, 3], label="data")
+    for i in range(4):
+        ax.plot(x, np.sin(x + i * 0.5), label=f"Series {i + 1}")
     ax.set_xlabel("x")
     ax.set_ylabel("y")
     ax.legend()
@@ -361,15 +367,15 @@ with plotstyle.use("nature") as style:
 ┌──────────────────────────────────────────────────────┐
 │         PlotStyle Validation Report: Nature          │
 ├──────────┬───────────────────────────────────────────┤
-│ ✓ PASS   │ Figure width 89.0mm matches single colu...│
-│ ✓ PASS   │ Figure height 55.0mm is within the Natu...│
+│ ✗ FAIL   │ Figure width 162.6mm does not match Nat...│
+│ ✓ PASS   │ Figure height 121.9mm is within the Nat...│
 │ ✗ FAIL   │ pdf.fonttype = 3; must be 42 for TrueTy...│
 │ ✗ FAIL   │ ps.fonttype = 3; must be 42 for TrueTyp...│
 │ ⚠ WARN   │ savefig.dpi = 'figure'; Nature requires...│
 │ ✓ PASS   │ All plotted lines and spines meet the N...│
-│ ✗ FAIL   │ 14 text element(s) outside the Nature r...│
+│ ✗ FAIL   │ 23 text element(s) outside the Nature r...│
 └──────────┴───────────────────────────────────────────┘
-3/7 checks passed, 1 warning(s), 3 failure(s)
+2/7 checks passed, 1 warning(s), 4 failure(s)
 
 passed: False
 
@@ -499,6 +505,7 @@ Export:
 Accessibility:
   Colorblind safe: Not required
   Grayscale safe:  Not required
+  Avoid:           none
 ```
 
 **`plotstyle diff nature science`**
@@ -592,7 +599,7 @@ If PlotStyle helps your research, a citation or star is appreciated:
   title   = {PlotStyle: Publication-ready scientific figure presets for Matplotlib},
   year    = {2026},
   url     = {https://github.com/rahulkaushal04/plotstyle},
-  note    = {Version 1.2.1},
+  note    = {Version 1.2.2},
 }
 ```
 

{plotstyle-1.2.1 → plotstyle-1.2.2}/src/plotstyle/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '1.2.1'
-__version_tuple__ = version_tuple = (1, 2, 1)
+__version__ = version = '1.2.2'
+__version_tuple__ = version_tuple = (1, 2, 2)
 
 __commit_id__ = commit_id = None

{plotstyle-1.2.1 → plotstyle-1.2.2}/src/plotstyle/color/_rendering.py

@@ -30,9 +30,8 @@ def _fig_to_rgb_array(fig: Figure) -> NDArray[np.uint8]:
     """
     fig.canvas.draw()
 
-    # get_width_height() reads actual canvas pixel dimensions; avoids
-    # off-by-one from float rounding in int(fig_in * dpi).
-    width, height = fig.canvas.get_width_height()
+    # physical=True matches the buffer_rgba() byte count on HiDPI/Retina screens.
+    width, height = fig.canvas.get_width_height(physical=True)
 
     # buffer_rgba() returns a read-only memoryview; .copy() makes it writeable
     rgba = np.frombuffer(fig.canvas.buffer_rgba(), dtype=np.uint8).reshape(height, width, 4)