scienceplots-toolkit 0.1.1__py3-none-any.whl

scienceplots_toolkit/__init__.py

@@ -0,0 +1,54 @@
+"""SciencePlots Toolkit - Publication-quality Matplotlib plotting utilities.
+
+A toolkit for creating consistent, publication-quality scientific plots
+using Matplotlib with SciencePlots styles and LaTeX typesetting.
+
+Example usage:
+    >>> from scienceplots_toolkit import configure_matplotlib_style, save_plot
+    >>> from scienceplots_toolkit.utils import configure_24h_axis
+    >>>
+    >>> configure_matplotlib_style(use_latex=True)
+    >>> fig, ax = plt.subplots()
+    >>> ax.plot([1, 2, 3], [4, 5, 6])
+    >>> configure_24h_axis(ax)
+    >>> save_plot(fig, "my_plot")
+"""
+
+from scienceplots_toolkit.analysis import (
+    generate_profile_grid,
+    plot_profile_with_quantiles,
+)
+from scienceplots_toolkit.style import (
+    DEFAULT_QUAL_CMAP_NAME,
+    configure_matplotlib_style,
+    qual_cmap,
+)
+from scienceplots_toolkit.utils import (
+    OUTPUT_DIR,
+    add_stats_box,
+    configure_24h_axis,
+    save_plot,
+)
+
+__version__ = "0.1.0"
+__author__ = "Jakob Buchmeier"
+__email__ = "jakob.buchmeier@tuwien.ac.at"
+
+__all__ = [
+    # Version info
+    "__version__",
+    "__author__",
+    "__email__",
+    # Style configuration
+    "configure_matplotlib_style",
+    "qual_cmap",
+    "DEFAULT_QUAL_CMAP_NAME",
+    # Utilities
+    "save_plot",
+    "configure_24h_axis",
+    "add_stats_box",
+    "OUTPUT_DIR",
+    # Analysis
+    "plot_profile_with_quantiles",
+    "generate_profile_grid",
+]

scienceplots_toolkit/analysis.py

@@ -0,0 +1,70 @@
+"""Specialized functions for time-series visualization and analysis."""
+
+from typing import Literal
+
+import matplotlib.pyplot as plt
+import numpy as np
+from matplotlib.axes import Axes
+
+
+def plot_profile_with_quantiles(
+    ax: Axes,
+    x: np.ndarray,
+    mean: np.ndarray,
+    q10: np.ndarray,
+    q90: np.ndarray,
+    label: str,
+    color: str | None = None,
+) -> None:
+    """Plot mean with 10%–90% quantile shading.
+
+    Args:
+        ax: Axes to plot on.
+        x: X-axis values (usually 0-24).
+        mean: Mean profile data.
+        q10: 10th percentile profile data.
+        q90: 90th percentile profile data.
+        label: Legend label for the mean line.
+        color: Optional fixed color for line and shading.
+
+    """
+    line = ax.plot(x, mean, label=label, color=color, linewidth=2.5)
+    c = line[0].get_color()
+    ax.fill_between(
+        x, q10, q90, alpha=0.2, color=c, edgecolor="none", label=r"10%--90% Quantile"
+    )
+
+
+def generate_profile_grid(
+    n_rows: int,
+    n_cols: int,
+    figsize: tuple[float, float] = (16, 10),
+    sharey: Literal["row", "col", "all"] | bool = "row",
+) -> tuple[plt.Figure, list[Axes]]:
+    """Generate multi-panel grids of 24h profiles with standard axis sharing.
+
+    Args:
+        n_rows: Number of rows in the grid.
+        n_cols: Number of columns in the grid.
+        figsize: Size of the complete figure.
+        sharey: Axis sharing mode (default 'row').
+
+    Returns:
+        A tuple containing (figure, list of axes).
+
+    """
+    fig, axes = plt.subplots(
+        n_rows,
+        n_cols,
+        figsize=figsize,
+        sharex=True,
+        sharey=sharey,
+    )
+
+    # Flatten axes if needed
+    if n_rows * n_cols > 1:
+        axes_list = axes.flatten()
+    else:
+        axes_list = [axes]
+
+    return fig, axes_list

scienceplots_toolkit/style.py

@@ -0,0 +1,139 @@
+"""Centralised Matplotlib styling and configuration for consistent plotting."""
+
+from typing import Literal
+
+import matplotlib.pyplot as plt
+import scienceplots  # noqa: F401 - Required for matplotlib 'science' and 'ieee' styles
+from cmap import Colormap
+from cycler import cycler
+
+# Default qualitative colormap used across plots
+DEFAULT_QUAL_CMAP_NAME = "seaborn:tab10_new"
+
+# https://cmap-docs.readthedocs.io/en/latest/catalog/qualitative/seaborn%3Atab10_new/
+# tab10_new colour codes:
+# blue  #4E79A7
+# orange #F28E2B
+# red   #E15759
+# light blue  #76B7B2
+# green #59A14E
+# yellow  #EDC949
+# lila #AF7AA1
+# rosa #FF9DA7
+# brown #9C755F
+# grey #BAB0AB
+
+
+def qual_cmap(cmap_name: str = DEFAULT_QUAL_CMAP_NAME) -> Colormap:
+    """Return the qualitative cmap of the given name (cmap.Colormap instance).
+
+    Default is 'seaborn:tab10_new'.
+    See: https://cmap-docs.readthedocs.io/en/latest/catalog/qualitative/seaborn%3Atab10_new/
+    """
+    return Colormap(cmap_name)
+
+
+def configure_matplotlib_style(
+    styles: list[str] | str = ["science", "ieee", "grid"],
+    grid_linewidth: float = 3,
+    lines_linewidth: float = 4,
+    fontsize: float = 26,
+    figsize: tuple[float, float] = (16, 10),
+    font: Literal["serif", "sans-serif"] | str = "serif",
+    sans_serif_math: bool = False,
+    cmap_name: str = DEFAULT_QUAL_CMAP_NAME,
+    use_latex: bool = False,
+    grid: bool = True,
+    legend_framealpha: float = 1.0,
+    legend_shadow: bool = True,
+) -> None:
+    """Configure matplotlib style and register the default qualitative colormap.
+
+    Args:
+        styles: list or single style name passed to plt.style.use, default
+            ["science", "ieee"], enable grid with "grid" in the list.
+        grid_linewidth: Width to use for grid lines.
+        lines_linewidth: Width for plot lines.
+        fontsize: Base font size.
+        figsize: Figure size as (width, height) in inches.
+        font: Font family to use (e.g., 'serif', 'sans-serif' or specific font
+            e.g., 'Times', 'Helvetica').
+            See: https://matplotlib.org/stable/users/explain/text/usetex.html
+        sans_serif_math: If True, use sans-serif font for math text (default
+            serif math in LaTeX).
+        cmap_name: Name of the qualitative colormap to use for default colours.
+            See: https://cmap-docs.readthedocs.io/en/latest/catalog/qualitative/seaborn%3Atab10_new/
+        use_latex: If True, use LaTeX for text rendering. If False (default), use
+            'no-latex' style and disable usetex.
+        grid: Whether to enable axis gridlines by default (`axes.grid` rcParam).
+            Disable for stuff like Heatmaps.
+        legend_framealpha: Alpha (transparency) of the legend background, 0.0
+            (transparent) to 1.0 (opaque). Default 1 because of legend_shadow.
+        legend_shadow: If True (default), draw a shadow behind the legend frame.
+
+    """
+    # Reset to default matplotlib style before applying new styles
+    plt.rcdefaults()
+
+    # Get colors from the qualitative colormap
+    cm = qual_cmap(cmap_name)
+    default_colors = [
+        cm(i / (9)) for i in range(10)
+    ]  # 10 colors from the qualitative colormap
+
+    # Handle no-latex logic
+    if not use_latex:
+        if isinstance(styles, list):
+            styles = [s if s != "ieee" else "no-latex" for s in styles]
+        elif styles == "ieee":
+            styles = "no-latex"
+
+    # Apply scienceplots style
+    plt.style.use(styles)
+
+    # Build LaTeX preamble
+    preamble = (
+        r"\usepackage{amsmath,amssymb,amsfonts}"
+        r"\usepackage{textcomp}"
+        r"\usepackage{gensymb}"
+        r"\usepackage{siunitx}"
+        r"\usepackage{graphicx}"
+    )
+    if sans_serif_math:
+        # Switch both text and math to sans-serif in LaTeX
+        preamble += (
+            r"\usepackage{sansmath}\sansmath\renewcommand{\familydefault}{\sfdefault}"
+        )
+
+    # reference: https://matplotlib.org/stable/users/explain/customizing.html
+    rc: dict = {
+        "font.size": fontsize,  # The font.size property is the default font size for text, given in points.
+        "text.usetex": use_latex,  # use latex for all text handling.
+        "text.latex.preamble": preamble,  # text.latex.preamble is a single line of LaTeX code that will be passed on to the LaTeX system.
+        "font.family": font,  # The font.family property can take either a single or multiple entries of any combination of concrete font names
+        "axes.titlesize": fontsize + 4,  # font size of the axes title
+        "axes.labelsize": fontsize + 2,  # font size of the x and y labels
+        "axes.axisbelow": False,  # draw axis gridlines and ticks: below patches (True), above patches but below lines ('line'), above all (False)
+        # Do not set "axes.grid" here when grid is True; leave it to the applied style.
+        "axes.prop_cycle": cycler(
+            "color", default_colors
+        ),  # colour cycle for plot lines as list of string colour specs: single letter, long name, or web-style hex
+        "grid.linewidth": grid_linewidth,  # in points
+        "lines.linewidth": lines_linewidth,  # line width in points
+        "legend.handlelength": 1.5,  # the length of the legend lines
+        "legend.shadow": legend_shadow,  # if True, give background a shadow effect
+        "legend.framealpha": legend_framealpha,  # legend patch transparency
+        "figure.titlesize": fontsize
+        + 4,  # size of the figure title (``Figure.suptitle()``)
+        "figure.labelsize": fontsize
+        + 2,  # size of the figure label (``Figure.sup[x|y]label()``)
+        "figure.figsize": figsize,  # figure size in inches
+        "figure.constrained_layout.use": True,  # When True, automatically make plot elements fit on the figure, is the new and improved tight_layout
+    }
+
+    # Only explicitly disable the axes grid if the user requested grid=False.
+    # If grid is True, we don't modify 'axes.grid' here so the style rules remain in effect.
+    if grid is False:
+        rc["axes.grid"] = False
+
+    plt.rcParams.update(rc)

scienceplots_toolkit/utils.py

@@ -0,0 +1,98 @@
+"""Utility functions for saving and configuring plots."""
+
+import logging
+from pathlib import Path
+
+from matplotlib.axes import Axes
+from matplotlib.figure import Figure
+
+# Constants
+OUTPUT_DIR = Path("output")
+logger = logging.getLogger(__name__)
+
+
+def save_plot(
+    fig: Figure, filename_base: str, output_dir: Path | None = None, dpi: int = 300
+) -> None:
+    """Save current figure to PNG and PDF.
+
+    Args:
+        fig: Figure to save.
+        filename_base: Base filename (no extension).
+        output_dir: Directory to save files. Defaults to OUTPUT_DIR.
+        dpi: Resolution for the PNG output.
+
+    """
+    if output_dir is None:
+        output_dir = OUTPUT_DIR
+
+    # Ensure output_dir is a Path object
+    if isinstance(output_dir, str):
+        output_dir = Path(output_dir)
+
+    output_dir.mkdir(parents=True, exist_ok=True)
+
+    png_path = output_dir / f"{filename_base}.png"
+    pdf_path = output_dir / f"{filename_base}.pdf"
+    fig.savefig(png_path, dpi=dpi)
+    fig.savefig(pdf_path, dpi=dpi)
+    logger.info("Saved %s and %s", png_path, pdf_path)
+
+
+def configure_24h_axis(ax: Axes) -> None:
+    """Standardise 24-hour time axes (0-24h with 4h ticks).
+
+    Args:
+        ax: Axes to configure.
+
+    """
+    ax.set_xticks(range(0, 25, 4))
+    ax.set_xlim(0, 24)
+
+
+def add_stats_box(
+    ax: Axes,
+    avg: float,
+    peak: float,
+    unit: str = r"\text{kW}",
+    loc: str = "upper left",
+) -> None:
+    """Add annotation boxes showing Average and Peak values.
+
+    Args:
+        ax: Axes to annotate.
+        avg: Average value.
+        peak: Peak value.
+        unit: LaTeX unit string.
+        loc: Position of the box (standard matplotlib loc strings).
+
+    """
+    stats_text = (
+        rf"$\text{{Avg}}: {avg:.1f}\ {unit}$"
+        "\n"
+        rf"$\text{{Peak}}: {peak:.1f}\ {unit}$"
+    )
+
+    # Convert loc string to coordinates if needed, or use ax.text with transform
+    props = dict(boxstyle="round", facecolor="white", alpha=0.8, edgecolor="gray")
+
+    # Mapping standard locs to coordinates for simple implementation
+    loc_map = {
+        "upper left": (0.05, 0.95),
+        "upper right": (0.95, 0.95),
+        "upper center": (0.5, 0.95),
+    }
+    x, y = loc_map.get(loc, (0.05, 0.95))
+
+    ha = "left" if "left" in loc else ("right" if "right" in loc else "center")
+    va = "top" if "upper" in loc else "bottom"
+
+    ax.text(
+        x,
+        y,
+        stats_text,
+        transform=ax.transAxes,
+        verticalalignment=va,
+        horizontalalignment=ha,
+        bbox=props,
+    )

scienceplots_toolkit-0.1.1.dist-info/METADATA

@@ -0,0 +1,260 @@
+Metadata-Version: 2.4
+Name: scienceplots-toolkit
+Version: 0.1.1
+Summary: Publication-quality Matplotlib plotting utilities with SciencePlots styles and LaTeX typesetting
+Project-URL: Homepage, https://github.com/jakobbuch/scienceplots-toolkit
+Project-URL: Bug Tracker, https://github.com/jakobbuch/scienceplots-toolkit/issues
+Project-URL: Source, https://github.com/jakobbuch/scienceplots-toolkit
+Project-URL: Changelog, https://github.com/jakobbuch/scienceplots-toolkit/blob/main/CHANGELOG.md
+Author-email: Jakob Buchmeier <jakob.buchmeier@tuwien.ac.at>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+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 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: cmap>=0.6.2
+Requires-Dist: matplotlib>=3.10.7
+Requires-Dist: scienceplots>=2.1.1
+Provides-Extra: dev
+Requires-Dist: pre-commit>=4.3.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Requires-Dist: ty; extra == 'dev'
+Provides-Extra: tests
+Requires-Dist: numpy>=1.24; extra == 'tests'
+Requires-Dist: pytest-cov>=4; extra == 'tests'
+Requires-Dist: pytest>=8; extra == 'tests'
+Description-Content-Type: text/markdown
+
+# SciencePlots Toolkit
+
+[![PyPI - Version](https://img.shields.io/pypi/v/scienceplots-toolkit.svg)](https://pypi.org/project/scienceplots-toolkit)
+[![Python Version](https://img.shields.io/pypi/pyversions/scienceplots-toolkit)](https://pypi.org/project/scienceplots-toolkit)
+[![License](https://img.shields.io/pypi/l/scienceplots-toolkit)](https://github.com/jakobbuch/scienceplots-toolkit/blob/main/LICENSE)
+
+Publication-quality Matplotlib plotting utilities with SciencePlots styles and LaTeX typesetting.
+
+## Features
+
+- **Pre-configured SciencePlots styles** with professional defaults
+- **LaTeX typesetting** for mathematical expressions and units
+- **24-hour time axis** utilities for daily profiles
+- **Statistical annotations** for average/peak values
+- **Quantile shading** for uncertainty visualization
+- **Multi-panel grid** generation for comparative plots
+
+## Installation
+
+### From PyPI
+
+```bash
+pip install scienceplots-toolkit
+```
+
+### From source with uv
+
+```bash
+git clone https://github.com/jakobbuch/scienceplots-toolkit.git
+cd scienceplots-toolkit
+uv sync
+```
+
+### From source with pip
+
+```bash
+git clone https://github.com/jakobbuch/scienceplots-toolkit.git
+cd scienceplots-toolkit
+pip install -e .
+```
+
+## Quick Start
+
+```python
+from scienceplots_toolkit import configure_matplotlib_style, save_plot
+from scienceplots_toolkit.utils import configure_24h_axis, add_stats_box
+import matplotlib.pyplot as plt
+import numpy as np
+
+# Configure the style
+configure_matplotlib_style(use_latex=True)
+
+# Create a simple plot
+fig, ax = plt.subplots()
+x = np.linspace(0, 10, 400)
+ax.plot(x, np.sin(x), label=r"$\sin(x)$")
+ax.set_xlabel(r"Time (s)")
+ax.set_ylabel(r"Amplitude")
+ax.legend()
+
+# Save the plot
+save_plot(fig, "my_first_plot")
+```
+
+## Examples
+
+### Basic Plots
+
+Run the basic examples to see all features in action:
+
+```bash
+# Without LaTeX (uses mathtext)
+uv run examples/example_basic.py
+
+# With LaTeX rendering (requires LaTeX installation)
+uv run examples/example_basic.py --latex
+```
+
+### Energy Profiles
+
+Advanced examples with 24h load profiles and quantile shading:
+
+```bash
+uv run examples/example_energy.py
+uv run examples/example_energy.py --latex
+```
+
+Generated plots are saved to the `output/` directory in both PNG and PDF formats.
+
+## API Reference
+
+### Style Configuration
+
+```python
+from scienceplots_toolkit import configure_matplotlib_style
+
+configure_matplotlib_style(
+    styles=["science", "ieee", "grid"],  # SciencePlots styles to use
+    grid_linewidth=3,                     # Grid line width in points
+    lines_linewidth=4,                    # Plot line width in points
+    fontsize=26,                          # Base font size
+    figsize=(16, 10),                     # Default figure size (inches)
+    font="serif",                         # Font family
+    sans_serif_math=False,                # Use sans-serif for math
+    cmap_name="seaborn:tab10_new",       # Qualitative colormap
+    use_latex=False,                      # Enable LaTeX rendering
+    grid=True,                            # Enable axis gridlines
+    legend_framealpha=1.0,                # Legend background transparency
+    legend_shadow=True,                   # Legend shadow effect
+)
+```
+
+### Utilities
+
+```python
+from scienceplots_toolkit.utils import (
+    save_plot,              # Save figure to PNG and PDF
+    configure_24h_axis,     # Set up 0-24h x-axis with 4h ticks
+    add_stats_box,          # Add average/peak annotation box
+)
+
+# Save a figure
+save_plot(fig, "my_plot", dpi=300)
+
+# Configure 24-hour axis
+configure_24h_axis(ax)
+
+# Add statistics box
+add_stats_box(ax, avg=5.2, peak=12.3, unit=r"\text{kW}")
+```
+
+### Analysis Tools
+
+```python
+from scienceplots_toolkit import (
+    plot_profile_with_quantiles,  # Plot mean with shaded quantiles
+    generate_profile_grid,        # Create multi-panel grid of plots
+)
+
+# Plot with uncertainty shading
+plot_profile_with_quantiles(
+    ax, x, mean, q10, q90,
+    label="Load Profile",
+    color="C0"
+)
+
+# Create a 2x2 grid of subplots
+fig, axes = generate_profile_grid(n_rows=2, n_cols=2)
+```
+
+## LaTeX Support
+
+The package supports two modes:
+
+1. **Mathtext (default)**: Uses Matplotlib's built-in math renderer. No external dependencies.
+2. **LaTeX**: Uses system LaTeX for professional typesetting. Requires:
+   - TeX Live or MiKTeX installation
+   - Packages: `amsmath`, `amssymb`, `amsfonts`, `textcomp`, `gensymb`, `siunitx`, `graphicx`
+
+Enable LaTeX mode:
+
+```python
+configure_matplotlib_style(use_latex=True)
+```
+
+Or via CLI:
+
+```bash
+uv run examples/example_basic.py --latex
+```
+
+## Project Structure
+
+```text
+scienceplots-toolkit/
+├── src/scienceplots_toolkit/
+│   ├── __init__.py          # Public API exports
+│   ├── style.py             # Matplotlib style configuration
+│   ├── utils.py             # Utility functions
+│   └── analysis.py          # Analysis and visualization tools
+├── examples/
+│   ├── example_basic.py     # Basic plotting examples
+│   └── example_energy.py    # Energy profile examples
+├── tests/
+├── pyproject.toml
+├── README.md
+└── LICENSE
+## Development
+
+### Setup
+
+```bash
+uv sync --group dev
+```
+
+### Run Tests
+
+```bash
+uv run pytest tests/ -v
+```
+
+### Linting and Formatting
+
+```bash
+uv run ruff format .
+uv run ruff check .
+uv run ty check .
+```
+
+## Acknowledgments
+
+This package builds upon the excellent [SciencePlots](https://github.com/garrettj403/SciencePlots) library by John Garrett, which is also licensed under the MIT License.
+
+SciencePlots provides Matplotlib styles for publication-quality plots. For more information, see: <https://github.com/garrettj403/SciencePlots>
+
+## License
+
+Distributed under the MIT License. See [LICENSE](LICENSE) for details.
+
+## Contact
+
+Jakob Buchmeier - <jakob.buchmeier@tuwien.ac.at>
+
+Project Link: <https://github.com/jakobbuch/scienceplots-toolkit>

scienceplots_toolkit-0.1.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+scienceplots_toolkit/__init__.py,sha256=ebbrkttVMcVAMA5fHINki7KQcAYbak-SK1mHlKaT4pI,1386
+scienceplots_toolkit/analysis.py,sha256=eZ8Bzu_q3AfEaoVYXz90Sqr6oycOeIPXUeXuw891CHI,1794
+scienceplots_toolkit/style.py,sha256=Wqwcc4sBvmqV_srJyxEUS8dqZgmQ8k0N_DXuoekQ5vk,6044
+scienceplots_toolkit/utils.py,sha256=roFZhXvn7_txMkXJKFI5Wof_gJDXt8HHfygzIbSDLdg,2534
+scienceplots_toolkit-0.1.1.dist-info/METADATA,sha256=hZ52Bwck5ouJEmHccSbPXW-3rS2ZJ6m2FwnZ2bKxXWA,7504
+scienceplots_toolkit-0.1.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+scienceplots_toolkit-0.1.1.dist-info/licenses/LICENSE,sha256=5A1dCM0wc9ndzCo5UbXkLck-2lOqwicsKeutpYeQ2Cg,1411
+scienceplots_toolkit-0.1.1.dist-info/RECORD,,

scienceplots_toolkit-0.1.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

scienceplots_toolkit-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,31 @@
+MIT License
+
+Copyright (c) 2026 Jakob Buchmeier
+
+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.
+
+---
+
+## Acknowledgments
+
+This package builds upon the excellent [SciencePlots](https://github.com/garrettj403/SciencePlots)
+library by John Garrett, which is also licensed under the MIT License.
+
+SciencePlots provides Matplotlib styles for publication-quality plots.
+For more information, see: https://github.com/garrettj403/SciencePlots