EasyPlotLib 0.1.1__tar.gz → 0.2.0__tar.gz

{easyplotlib-0.1.1 → easyplotlib-0.2.0}/EasyPlotLib/__init__.py

@@ -7,7 +7,33 @@ import matplotlib.pyplot as plt
 import EasyPlotLib
 
 from .cartopy_helper import cartopy_plot_tickmarks
+from .export import save_pub
 from .figsizes_set import figsizes, subplot_labels
+from .helpers import journal_style
+from .palettes import (
+    COLORMAPS,
+    PALETTES,
+    SEMANTIC,
+    alpha_ramp,
+    get_palette,
+    set_palette,
+    shades,
+)
+
+__all__ = [
+    "cartopy_plot_tickmarks",
+    "figsizes",
+    "subplot_labels",
+    "journal_style",
+    "save_pub",
+    "PALETTES",
+    "SEMANTIC",
+    "COLORMAPS",
+    "get_palette",
+    "set_palette",
+    "alpha_ramp",
+    "shades",
+]
 
 # register the bundled stylesheets in the matplotlib style library
 EasyPlotLib_path = EasyPlotLib.__path__[0]

easyplotlib-0.2.0/EasyPlotLib/export.py

@@ -0,0 +1,58 @@
+"""Publication-quality figure export.
+
+Saves a figure to several formats at once with settings that keep text
+**editable** in Illustrator/Inkscape (``pdf.fonttype = 42``, ``svg.fonttype =
+none`` — configured in the bundled ``nature`` style) and rasters at journal DPI.
+"""
+
+import os
+from typing import Iterable
+
+import matplotlib.figure
+
+
+def save_pub(
+    fig: matplotlib.figure.Figure,
+    filename: str,
+    formats: Iterable[str] = ("pdf", "png"),
+    dpi: int = 600,
+    transparent: bool = False,
+    bbox_inches: str = "tight",
+    pad_inches: float = 0.02,
+    **savefig_kwargs,
+) -> list:
+    """Save ``fig`` to one file per format and return the written paths.
+
+    Parameters
+    ----------
+    filename:
+        Path *without* extension, e.g. ``"figures/fig1"``. Parent directories
+        are created if needed.
+    formats:
+        Any matplotlib-supported extensions. Vector formats (``pdf``, ``svg``,
+        ``eps``) are preferred for line art; ``tiff``/``png`` at ``dpi`` for
+        raster submission. Most journals want one vector + one high-DPI raster.
+    dpi:
+        Resolution for raster formats. 600 dpi suits line art; use 300 for
+        photographic/heatmap content if file size matters.
+    """
+    if isinstance(formats, str):  # a bare "png" must not iterate into 'p','n','g'
+        formats = (formats,)
+
+    directory = os.path.dirname(filename)
+    if directory:
+        os.makedirs(directory, exist_ok=True)
+
+    written = []
+    for fmt in formats:
+        path = f"{filename}.{fmt.lstrip('.')}"
+        fig.savefig(
+            path,
+            dpi=dpi,
+            transparent=transparent,
+            bbox_inches=bbox_inches,
+            pad_inches=pad_inches,
+            **savefig_kwargs,
+        )
+        written.append(path)
+    return written

easyplotlib-0.2.0/EasyPlotLib/helpers.py

@@ -0,0 +1,53 @@
+"""High-level convenience for setting up a journal-ready figure context."""
+
+from typing import Optional
+
+import matplotlib.pyplot as plt
+
+from .figsizes_set import figsizes
+from .palettes import DEFAULT_PALETTE, set_palette
+
+
+def journal_style(
+    journal_key: str = "nat1",
+    *,
+    palette: str = DEFAULT_PALETTE,
+    base_style: str = "nature",
+    nrows: Optional[int] = None,
+    ncols: Optional[int] = None,
+    apply: bool = True,
+    **figsize_kwargs,
+) -> dict:
+    """Apply a complete publication style in one call.
+
+    Combines the bundled ``base_style`` stylesheet, a journal column-width
+    :func:`~EasyPlotLib.figsizes` figure size, and a qualitative
+    :func:`~EasyPlotLib.set_palette` colour cycle.
+
+    Parameters
+    ----------
+    journal_key:
+        A key from ``figsizes`` (e.g. ``"nat1"``/``"nat2"`` single/double
+        column for Nature, ``"science"`` keys ``"aaas1"``/``"aaas2"``, etc.).
+    palette:
+        Qualitative palette name (see :data:`EasyPlotLib.PALETTES`).
+    base_style:
+        A registered matplotlib style; ``"nature"`` is bundled.
+    nrows, ncols:
+        Passed to ``figsizes`` to auto-pick a sensible aspect ratio for a grid.
+    apply:
+        When ``True`` (default) mutate the global rc state. Set ``False`` to
+        only compute and return the figsize dict.
+
+    Returns
+    -------
+    dict
+        The figure-size rcParams dict (the return value of ``figsizes``), handy
+        to splice into ``plt.rcParams.update`` or ``plt.style.context``.
+    """
+    fs = figsizes(journal_key, nrows=nrows, ncols=ncols, **figsize_kwargs)
+    if apply:
+        plt.style.use(base_style)
+        plt.rcParams.update(fs)
+        set_palette(palette)
+    return fs

easyplotlib-0.2.0/EasyPlotLib/palettes.py

@@ -0,0 +1,178 @@
+"""Curated, journal-friendly qualitative color palettes.
+
+The palettes are low-to-medium saturation sets that read well in print and are
+colour-vision-deficiency aware. The names follow the well-known ``ggsci``
+collections so they are familiar to anyone coming from R.
+
+Usage
+-----
+>>> import EasyPlotLib as epl
+>>> epl.set_palette("nature")          # set the global color cycle
+>>> colors = epl.get_palette("lancet") # grab the raw hex list
+"""
+
+from typing import List, Optional
+
+import matplotlib.colors as mcolors
+import matplotlib.pyplot as plt
+from cycler import cycler
+from matplotlib.axes import Axes
+
+# Qualitative palettes. Hex values mirror the canonical ggsci collections,
+# which are widely used in Nature/Science/Cell-family figures.
+PALETTES = {
+    # Nature Publishing Group
+    "nature": [
+        "#E64B35", "#4DBBD5", "#00A087", "#3C5488", "#F39B7F",
+        "#8491B4", "#91D1C2", "#DC0000", "#7E6148", "#B09C85",
+    ],
+    # Science / AAAS
+    "science": [
+        "#3B4992", "#EE0000", "#008B45", "#631879", "#008280",
+        "#BB0021", "#5F559B", "#A20056", "#808180", "#1B1919",
+    ],
+    # New England Journal of Medicine
+    "nejm": [
+        "#BC3C29", "#0072B5", "#E18727", "#20854E", "#7876B1",
+        "#6F99AD", "#FFDC91", "#EE4C97",
+    ],
+    # The Lancet
+    "lancet": [
+        "#00468B", "#ED0000", "#42B540", "#0099B4", "#925E9F",
+        "#FDAF91", "#AD002A", "#ADB6B6", "#1B1919",
+    ],
+    # JAMA
+    "jama": [
+        "#374E55", "#DF8F44", "#00A1D5", "#B24745", "#79AF97",
+        "#6A6599", "#80796B",
+    ],
+    # Low-saturation "muted" set, close to Nature Machine Intelligence aesthetics.
+    "muted": [
+        "#4C72B0", "#DD8452", "#55A868", "#C44E52", "#8172B3",
+        "#937860", "#DA8BC3", "#8C8C8C", "#CCB974", "#64B5CD",
+    ],
+    # Semantic order: blue=proposed/hero, green=gain, red=baseline/drop,
+    # teal/violet=extra signal, grey=neutral. See SEMANTIC for role lookup.
+    "semantic": [
+        "#0F4D92", "#8BCF8B", "#B64342", "#42949E", "#9A4D8E", "#CFCECE",
+    ],
+    # Nature-Machine-Intelligence pastel family: cool baselines + warm hero.
+    "nmi": [
+        "#484878", "#7884B4", "#B4C0E4", "#F0C0CC", "#E4CCD8", "#CFCECE",
+    ],
+    # Many-method comparison (e.g. a bar chart of 8-10 baselines vs. yours):
+    # soft low-saturation baselines, related methods share a hue family with
+    # graduated lightness, and the proposed method gets the one saturated hero.
+    # Put your method LAST so #3775BA lands on it.
+    "comparison": [
+        "#CFCECE", "#F4EEAC", "#FBDFE2", "#D9B9D4", "#DAA87C",
+        "#DDF3DE", "#AADCA9", "#8BCF8B", "#92E3F9", "#3775BA",
+    ],
+    # Imaging / microscopy: a couple of fluorescent accents meant to sit on a
+    # BLACK background, plus a grey context channel. Not for white-background plots.
+    "imaging": ["#22D7E6", "#FF2AD4", "#B8B8B8"],
+    # The original SciencePlots-style bright cycle (kept for backwards compat).
+    "bright": [
+        "#0C5DA5", "#00B945", "#FF9500", "#FF2C00", "#845B97",
+        "#474747", "#9e9e9e",
+    ],
+}
+
+# Role-based ("semantic") colours: assign by meaning, never remap a method to a
+# different hue family across panels. Reduce saturation before adding categories.
+SEMANTIC = {
+    "blue_main": "#0F4D92",       # proposed / hero method
+    "blue_secondary": "#3775BA",
+    "green_light": "#DDF3DE",
+    "green_mid": "#AADCA9",
+    "green_strong": "#8BCF8B",    # gain / improvement / "delta up"
+    "red_light": "#F6CFCB",
+    "red_mid": "#E9A6A1",
+    "red_strong": "#B64342",      # baseline / drop / "delta down"
+    "neutral_light": "#CFCECE",
+    "neutral_mid": "#767676",
+    "neutral_dark": "#4D4D4D",
+    "neutral_black": "#272727",
+    "accent_gold": "#FFD700",
+    "accent_teal": "#42949E",
+    "accent_violet": "#9A4D8E",
+    "accent_magenta": "#EA84DD",
+    "delta_up": "#2E9E44",
+    "delta_down": "#E53935",
+}
+
+# Recommended perceptually-uniform colormaps for continuous data (heatmaps,
+# images, density). Pass these names to ``cmap=`` in imshow/pcolormesh/etc.
+COLORMAPS = {
+    "sequential": "viridis",   # single-direction magnitude; also "mako", "cividis"
+    "sequential_warm": "magma",
+    "diverging": "RdBu_r",     # signed values around a midpoint; also "coolwarm"
+    "grayscale": "Greys",      # print-safe context layers
+}
+
+DEFAULT_PALETTE = "nature"
+
+
+def get_palette(name: str = DEFAULT_PALETTE, n: Optional[int] = None) -> List[str]:
+    """Return the list of hex colors for ``name``.
+
+    If ``n`` is given, the palette is truncated (or cycled) to that length.
+    """
+    if name not in PALETTES:
+        raise ValueError(
+            f"Unknown palette {name!r}. Available: {', '.join(sorted(PALETTES))}"
+        )
+    colors = PALETTES[name]
+    if n is None:
+        return list(colors)
+    return [colors[i % len(colors)] for i in range(n)]
+
+
+def alpha_ramp(color: str, n: int, lo: float = 0.2, hi: float = 1.0) -> List[tuple]:
+    """One hue at ``n`` graduated opacities — the standard *ablation* encoding.
+
+    Use a single color and let opacity carry the ordering (e.g. progressively
+    more complete model variants), rather than introducing more hues. Returns a
+    list of RGBA tuples ready to pass to ``color=`` in bar/line calls.
+
+    >>> alpha_ramp(epl.SEMANTIC["blue_main"], 3)   # light -> solid
+    """
+    r, g, b = mcolors.to_rgb(color)
+    if n <= 1:
+        return [(r, g, b, hi)]
+    return [(r, g, b, lo + (hi - lo) * i / (n - 1)) for i in range(n)]
+
+
+def shades(color: str, n: int, light: float = 0.82) -> List[str]:
+    """``n`` shades of one hue from light to the base color.
+
+    Mirrors the "related methods share a hue family with graduated lightness"
+    rule (e.g. a baseline trio dark/mid/soft). The lightest shade is ``color``
+    mixed ``light`` of the way toward white; the last shade is ``color`` itself.
+    Returns hex strings.
+    """
+    base = mcolors.to_rgb(color)
+    if n <= 1:
+        return [mcolors.to_hex(base)]
+    out = []
+    for i in range(n):
+        t = light * (1 - i / (n - 1))  # light at i=0 -> 0 at i=n-1
+        mix = (base[0] * (1 - t) + t, base[1] * (1 - t) + t, base[2] * (1 - t) + t)
+        out.append(mcolors.to_hex(mix))
+    return out
+
+
+def set_palette(name: str = DEFAULT_PALETTE, ax: Optional[Axes] = None) -> List[str]:
+    """Set the qualitative color cycle to ``name``.
+
+    With no ``ax`` the global :data:`matplotlib.rcParams` cycle is updated so it
+    applies to every subsequent figure. Pass an ``ax`` to scope it to a single
+    Axes. Returns the colour list that was applied.
+    """
+    colors = get_palette(name)
+    prop_cycle = cycler("color", colors)
+    if ax is None:
+        plt.rcParams["axes.prop_cycle"] = prop_cycle
+    else:
+        ax.set_prop_cycle(prop_cycle)
+    return colors

{easyplotlib-0.1.1 → easyplotlib-0.2.0}/EasyPlotLib/styles/nature.mplstyle

@@ -30,6 +30,10 @@ lines.linewidth : 1.
 lines.markersize: 3
 
 
+# Open frame: drop the top/right spines (Nature default)
+axes.spines.top : False
+axes.spines.right : False
+
 # Remove legend frame
 legend.frameon : False
 
@@ -37,6 +41,15 @@ legend.frameon : False
 savefig.bbox : tight
 savefig.pad_inches : 0.05
 
+# Resolution: crisp on-screen preview, journal-grade rasters
+figure.dpi : 200
+savefig.dpi : 600
+
+# Keep text editable in vector exports (Illustrator/Inkscape friendly)
+pdf.fonttype : 42
+ps.fonttype : 42
+svg.fonttype : none
+
 # Font sizes
 axes.labelsize: 7
 xtick.labelsize: 7

easyplotlib-0.2.0/EasyPlotLib.egg-info/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: EasyPlotLib
+Version: 0.2.0
+Summary: A simple plotting library
+Home-page: https://github.com/yourusername/EasyPlotLib
+Author: HanYuyang
+Author-email: 17766095120@163.com
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-python
+Dynamic: summary
+
+# EasyPlotLib
+
+Matplotlib styles and helpers for publication-quality SCI-journal figures
+(Nature / Science / Cell / NEJM / Lancet / PNAS / AGU / AMS).
+
+<p align="center">
+  <img src="examples/gallery/01_bar_comparison.png" height="150">
+  <img src="examples/gallery/03_line_trend.png" height="150">
+  <img src="examples/gallery/07_distributions.png" height="150">
+</p>
+<p align="center"><sub>Built with the bundled <code>nature</code> style — see the full <a href="#chart-type-gallery">gallery</a>.</sub></p>
+
+## Install
+
+```
+pip install EasyPlotLib
+```
+
+## Quick start
+
+```python
+import EasyPlotLib as epl
+import matplotlib.pyplot as plt
+import numpy as np
+
+# Style + journal column width + color palette in one call.
+epl.journal_style("nat1", palette="nature", nrows=1, ncols=2)
+
+fig, axs = plt.subplots(1, 2)
+x = np.linspace(0, 2 * np.pi, 200)
+for n, ax in enumerate(axs):
+    for k in range(3):
+        ax.plot(x, np.sin(x + k), label=f"series {k}")
+    ax.set_xlabel("x")
+    ax.set_ylabel("amplitude")
+    ax.annotate(**epl.subplot_labels(n, "a"))      # bold panel labels a, b …
+
+# Editable vector (PDF) + 600-dpi raster.
+epl.save_pub(fig, "figures/fig1", formats=("pdf", "png"))
+```
+
+## API
+
+| Function | Description |
+|----------|-------------|
+| `journal_style(key, palette=, base_style=, nrows=, ncols=, apply=)` | Apply style + size + palette in one call. Returns the figsize dict. |
+| `figsizes(key, ...)` | rcParams dict with a journal column figure size. Keys: `nat1/2`, `aaas1/2`, `pnas1..3`, `agu1..4`, `ams1..4`. |
+| `subplot_labels(n, style)` | Args for `ax.annotate(**...)`. Styles: `a`, `A`, `(a)`, `a)`, `a.` |
+| `set_palette(name, ax=None)` / `get_palette(name, n=)` | Set the color cycle / return raw hex list. |
+| `PALETTES` | Qualitative palettes: `nature`, `science`, `nejm`, `lancet`, `jama`, `muted`, `semantic`, `nmi`, `comparison`, `imaging`, `bright`. |
+| `SEMANTIC` | Role-based colors (`blue_main`=hero, `green_strong`=gain, `red_strong`=drop, `delta_up/down`, neutrals, accents). |
+| `shades(color, n)` | `n` shades of one hue, light→base — related methods (e.g. a baseline trio, stacked-area family). |
+| `alpha_ramp(color, n)` | One hue at graduated opacity — the standard ablation encoding. |
+| `COLORMAPS` | Recommended continuous colormaps for heatmaps/images: `sequential`, `sequential_warm`, `diverging`, `grayscale`. |
+| `save_pub(fig, path, formats=, dpi=)` | Save to multiple formats with editable vector text. |
+| `cartopy_plot_tickmarks(ax, gl)` | Clean lon/lat tick labels for cartopy maps. |
+
+## Color scheme guidance
+Every recurring nature-style color pattern is abstracted into one small, shared
+API so a whole figure stays consistent (the `examples/gallery.py` panels all
+draw from it):
+
+- **One restrained palette per figure.** Use a unified family across panels
+  rather than maximizing hue variety; reduce saturation before adding categories.
+- **Assign color by meaning, not by index.** `SEMANTIC` reserves `blue_main`
+  for the proposed/hero method and green/red for gains/drops. Never remap the
+  same method to a different hue in another panel.
+- **Many-method comparison** → `get_palette("comparison")`: soft pastel
+  baselines with related methods sharing a hue family, and one saturated hero
+  (put your method last).
+- **Related methods / one family** → `shades(color, n)`: graduated lightness of
+  a single hue (baseline trios, stacked-area bands).
+- **Ablations** → `alpha_ramp(color, n)`: one hue, opacity carries the ordering.
+- **Continuous data** (heatmaps, density, images) → a perceptual colormap from
+  `COLORMAPS` — sequential for magnitude, diverging for signed values.
+- **Microscopy** → `imaging` accents (cyan/magenta) on a black background.
+
+## Chart-type gallery
+`examples/gallery.py` renders one publication-styled panel per common archetype.
+Every panel sources its colors from the abstracted API above, so a method keeps
+its hue across the whole figure (blue = hero, grey = baseline):
+
+```
+python examples/gallery.py   # writes PNGs to examples/gallery/
+```
+
+<table>
+  <tr>
+    <td align="center"><img src="examples/gallery/01_bar_comparison.png" width="260"><br><sub>Method comparison · <code>get_palette("comparison")</code></sub></td>
+    <td align="center"><img src="examples/gallery/02_bar_ablation.png" width="260"><br><sub>Ablation · <code>alpha_ramp()</code></sub></td>
+    <td align="center"><img src="examples/gallery/03_line_trend.png" width="260"><br><sub>Trend + CI · <code>SEMANTIC</code></sub></td>
+  </tr>
+  <tr>
+    <td align="center"><img src="examples/gallery/04_heatmap.png" width="260"><br><sub>Heatmap · <code>COLORMAPS["sequential"]</code></sub></td>
+    <td align="center"><img src="examples/gallery/05_scatter_bubble.png" width="260"><br><sub>Scatter / bubble · <code>SEMANTIC</code></sub></td>
+    <td align="center"><img src="examples/gallery/06_radar.png" width="260"><br><sub>Radar / polar · <code>SEMANTIC</code></sub></td>
+  </tr>
+  <tr>
+    <td align="center"><img src="examples/gallery/07_distributions.png" width="260"><br><sub>Violin + box · <code>shades()</code></sub></td>
+    <td align="center"><img src="examples/gallery/08_forest.png" width="260"><br><sub>Forest / interval · <code>SEMANTIC</code></sub></td>
+    <td align="center"><img src="examples/gallery/09_stacked_area.png" width="260"><br><sub>Stacked area · <code>shades()</code></sub></td>
+  </tr>
+</table>
+
+## Style notes
+
+The bundled `nature` style uses 7 pt sans (TeX Gyre Heros / Helvetica), an open
+frame (no top/right spines), and export settings that keep text **editable** in
+Illustrator/Inkscape (`pdf.fonttype=42`, `svg.fonttype=none`) at 600 dpi.
+
+## Claude Code skill
+
+A personal `sci-figure` skill (`~/.claude/skills/sci-figure/`) walks Claude
+through the publication workflow and is auto-invoked on plotting tasks in any
+project where EasyPlotLib is installed.

{easyplotlib-0.1.1 → easyplotlib-0.2.0}/EasyPlotLib.egg-info/SOURCES.txt

@@ -2,7 +2,10 @@ README.md
 setup.py
 EasyPlotLib/__init__.py
 EasyPlotLib/cartopy_helper.py
+EasyPlotLib/export.py
 EasyPlotLib/figsizes_set.py
+EasyPlotLib/helpers.py
+EasyPlotLib/palettes.py
 EasyPlotLib.egg-info/PKG-INFO
 EasyPlotLib.egg-info/SOURCES.txt
 EasyPlotLib.egg-info/dependency_links.txt

easyplotlib-0.2.0/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: EasyPlotLib
+Version: 0.2.0
+Summary: A simple plotting library
+Home-page: https://github.com/yourusername/EasyPlotLib
+Author: HanYuyang
+Author-email: 17766095120@163.com
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-python
+Dynamic: summary
+
+# EasyPlotLib
+
+Matplotlib styles and helpers for publication-quality SCI-journal figures
+(Nature / Science / Cell / NEJM / Lancet / PNAS / AGU / AMS).
+
+<p align="center">
+  <img src="examples/gallery/01_bar_comparison.png" height="150">
+  <img src="examples/gallery/03_line_trend.png" height="150">
+  <img src="examples/gallery/07_distributions.png" height="150">
+</p>
+<p align="center"><sub>Built with the bundled <code>nature</code> style — see the full <a href="#chart-type-gallery">gallery</a>.</sub></p>
+
+## Install
+
+```
+pip install EasyPlotLib
+```
+
+## Quick start
+
+```python
+import EasyPlotLib as epl
+import matplotlib.pyplot as plt
+import numpy as np
+
+# Style + journal column width + color palette in one call.
+epl.journal_style("nat1", palette="nature", nrows=1, ncols=2)
+
+fig, axs = plt.subplots(1, 2)
+x = np.linspace(0, 2 * np.pi, 200)
+for n, ax in enumerate(axs):
+    for k in range(3):
+        ax.plot(x, np.sin(x + k), label=f"series {k}")
+    ax.set_xlabel("x")
+    ax.set_ylabel("amplitude")
+    ax.annotate(**epl.subplot_labels(n, "a"))      # bold panel labels a, b …
+
+# Editable vector (PDF) + 600-dpi raster.
+epl.save_pub(fig, "figures/fig1", formats=("pdf", "png"))
+```
+
+## API
+
+| Function | Description |
+|----------|-------------|
+| `journal_style(key, palette=, base_style=, nrows=, ncols=, apply=)` | Apply style + size + palette in one call. Returns the figsize dict. |
+| `figsizes(key, ...)` | rcParams dict with a journal column figure size. Keys: `nat1/2`, `aaas1/2`, `pnas1..3`, `agu1..4`, `ams1..4`. |
+| `subplot_labels(n, style)` | Args for `ax.annotate(**...)`. Styles: `a`, `A`, `(a)`, `a)`, `a.` |
+| `set_palette(name, ax=None)` / `get_palette(name, n=)` | Set the color cycle / return raw hex list. |
+| `PALETTES` | Qualitative palettes: `nature`, `science`, `nejm`, `lancet`, `jama`, `muted`, `semantic`, `nmi`, `comparison`, `imaging`, `bright`. |
+| `SEMANTIC` | Role-based colors (`blue_main`=hero, `green_strong`=gain, `red_strong`=drop, `delta_up/down`, neutrals, accents). |
+| `shades(color, n)` | `n` shades of one hue, light→base — related methods (e.g. a baseline trio, stacked-area family). |
+| `alpha_ramp(color, n)` | One hue at graduated opacity — the standard ablation encoding. |
+| `COLORMAPS` | Recommended continuous colormaps for heatmaps/images: `sequential`, `sequential_warm`, `diverging`, `grayscale`. |
+| `save_pub(fig, path, formats=, dpi=)` | Save to multiple formats with editable vector text. |
+| `cartopy_plot_tickmarks(ax, gl)` | Clean lon/lat tick labels for cartopy maps. |
+
+## Color scheme guidance
+Every recurring nature-style color pattern is abstracted into one small, shared
+API so a whole figure stays consistent (the `examples/gallery.py` panels all
+draw from it):
+
+- **One restrained palette per figure.** Use a unified family across panels
+  rather than maximizing hue variety; reduce saturation before adding categories.
+- **Assign color by meaning, not by index.** `SEMANTIC` reserves `blue_main`
+  for the proposed/hero method and green/red for gains/drops. Never remap the
+  same method to a different hue in another panel.
+- **Many-method comparison** → `get_palette("comparison")`: soft pastel
+  baselines with related methods sharing a hue family, and one saturated hero
+  (put your method last).
+- **Related methods / one family** → `shades(color, n)`: graduated lightness of
+  a single hue (baseline trios, stacked-area bands).
+- **Ablations** → `alpha_ramp(color, n)`: one hue, opacity carries the ordering.
+- **Continuous data** (heatmaps, density, images) → a perceptual colormap from
+  `COLORMAPS` — sequential for magnitude, diverging for signed values.
+- **Microscopy** → `imaging` accents (cyan/magenta) on a black background.
+
+## Chart-type gallery
+`examples/gallery.py` renders one publication-styled panel per common archetype.
+Every panel sources its colors from the abstracted API above, so a method keeps
+its hue across the whole figure (blue = hero, grey = baseline):
+
+```
+python examples/gallery.py   # writes PNGs to examples/gallery/
+```
+
+<table>
+  <tr>
+    <td align="center"><img src="examples/gallery/01_bar_comparison.png" width="260"><br><sub>Method comparison · <code>get_palette("comparison")</code></sub></td>
+    <td align="center"><img src="examples/gallery/02_bar_ablation.png" width="260"><br><sub>Ablation · <code>alpha_ramp()</code></sub></td>
+    <td align="center"><img src="examples/gallery/03_line_trend.png" width="260"><br><sub>Trend + CI · <code>SEMANTIC</code></sub></td>
+  </tr>
+  <tr>
+    <td align="center"><img src="examples/gallery/04_heatmap.png" width="260"><br><sub>Heatmap · <code>COLORMAPS["sequential"]</code></sub></td>
+    <td align="center"><img src="examples/gallery/05_scatter_bubble.png" width="260"><br><sub>Scatter / bubble · <code>SEMANTIC</code></sub></td>
+    <td align="center"><img src="examples/gallery/06_radar.png" width="260"><br><sub>Radar / polar · <code>SEMANTIC</code></sub></td>
+  </tr>
+  <tr>
+    <td align="center"><img src="examples/gallery/07_distributions.png" width="260"><br><sub>Violin + box · <code>shades()</code></sub></td>
+    <td align="center"><img src="examples/gallery/08_forest.png" width="260"><br><sub>Forest / interval · <code>SEMANTIC</code></sub></td>
+    <td align="center"><img src="examples/gallery/09_stacked_area.png" width="260"><br><sub>Stacked area · <code>shades()</code></sub></td>
+  </tr>
+</table>
+
+## Style notes
+
+The bundled `nature` style uses 7 pt sans (TeX Gyre Heros / Helvetica), an open
+frame (no top/right spines), and export settings that keep text **editable** in
+Illustrator/Inkscape (`pdf.fonttype=42`, `svg.fonttype=none`) at 600 dpi.
+
+## Claude Code skill
+
+A personal `sci-figure` skill (`~/.claude/skills/sci-figure/`) walks Claude
+through the publication workflow and is auto-invoked on plotting tasks in any
+project where EasyPlotLib is installed.

easyplotlib-0.2.0/README.md

@@ -0,0 +1,115 @@
+# EasyPlotLib
+
+Matplotlib styles and helpers for publication-quality SCI-journal figures
+(Nature / Science / Cell / NEJM / Lancet / PNAS / AGU / AMS).
+
+<p align="center">
+  <img src="examples/gallery/01_bar_comparison.png" height="150">
+  <img src="examples/gallery/03_line_trend.png" height="150">
+  <img src="examples/gallery/07_distributions.png" height="150">
+</p>
+<p align="center"><sub>Built with the bundled <code>nature</code> style — see the full <a href="#chart-type-gallery">gallery</a>.</sub></p>
+
+## Install
+
+```
+pip install EasyPlotLib
+```
+
+## Quick start
+
+```python
+import EasyPlotLib as epl
+import matplotlib.pyplot as plt
+import numpy as np
+
+# Style + journal column width + color palette in one call.
+epl.journal_style("nat1", palette="nature", nrows=1, ncols=2)
+
+fig, axs = plt.subplots(1, 2)
+x = np.linspace(0, 2 * np.pi, 200)
+for n, ax in enumerate(axs):
+    for k in range(3):
+        ax.plot(x, np.sin(x + k), label=f"series {k}")
+    ax.set_xlabel("x")
+    ax.set_ylabel("amplitude")
+    ax.annotate(**epl.subplot_labels(n, "a"))      # bold panel labels a, b …
+
+# Editable vector (PDF) + 600-dpi raster.
+epl.save_pub(fig, "figures/fig1", formats=("pdf", "png"))
+```
+
+## API
+
+| Function | Description |
+|----------|-------------|
+| `journal_style(key, palette=, base_style=, nrows=, ncols=, apply=)` | Apply style + size + palette in one call. Returns the figsize dict. |
+| `figsizes(key, ...)` | rcParams dict with a journal column figure size. Keys: `nat1/2`, `aaas1/2`, `pnas1..3`, `agu1..4`, `ams1..4`. |
+| `subplot_labels(n, style)` | Args for `ax.annotate(**...)`. Styles: `a`, `A`, `(a)`, `a)`, `a.` |
+| `set_palette(name, ax=None)` / `get_palette(name, n=)` | Set the color cycle / return raw hex list. |
+| `PALETTES` | Qualitative palettes: `nature`, `science`, `nejm`, `lancet`, `jama`, `muted`, `semantic`, `nmi`, `comparison`, `imaging`, `bright`. |
+| `SEMANTIC` | Role-based colors (`blue_main`=hero, `green_strong`=gain, `red_strong`=drop, `delta_up/down`, neutrals, accents). |
+| `shades(color, n)` | `n` shades of one hue, light→base — related methods (e.g. a baseline trio, stacked-area family). |
+| `alpha_ramp(color, n)` | One hue at graduated opacity — the standard ablation encoding. |
+| `COLORMAPS` | Recommended continuous colormaps for heatmaps/images: `sequential`, `sequential_warm`, `diverging`, `grayscale`. |
+| `save_pub(fig, path, formats=, dpi=)` | Save to multiple formats with editable vector text. |
+| `cartopy_plot_tickmarks(ax, gl)` | Clean lon/lat tick labels for cartopy maps. |
+
+## Color scheme guidance
+Every recurring nature-style color pattern is abstracted into one small, shared
+API so a whole figure stays consistent (the `examples/gallery.py` panels all
+draw from it):
+
+- **One restrained palette per figure.** Use a unified family across panels
+  rather than maximizing hue variety; reduce saturation before adding categories.
+- **Assign color by meaning, not by index.** `SEMANTIC` reserves `blue_main`
+  for the proposed/hero method and green/red for gains/drops. Never remap the
+  same method to a different hue in another panel.
+- **Many-method comparison** → `get_palette("comparison")`: soft pastel
+  baselines with related methods sharing a hue family, and one saturated hero
+  (put your method last).
+- **Related methods / one family** → `shades(color, n)`: graduated lightness of
+  a single hue (baseline trios, stacked-area bands).
+- **Ablations** → `alpha_ramp(color, n)`: one hue, opacity carries the ordering.
+- **Continuous data** (heatmaps, density, images) → a perceptual colormap from
+  `COLORMAPS` — sequential for magnitude, diverging for signed values.
+- **Microscopy** → `imaging` accents (cyan/magenta) on a black background.
+
+## Chart-type gallery
+`examples/gallery.py` renders one publication-styled panel per common archetype.
+Every panel sources its colors from the abstracted API above, so a method keeps
+its hue across the whole figure (blue = hero, grey = baseline):
+
+```
+python examples/gallery.py   # writes PNGs to examples/gallery/
+```
+
+<table>
+  <tr>
+    <td align="center"><img src="examples/gallery/01_bar_comparison.png" width="260"><br><sub>Method comparison · <code>get_palette("comparison")</code></sub></td>
+    <td align="center"><img src="examples/gallery/02_bar_ablation.png" width="260"><br><sub>Ablation · <code>alpha_ramp()</code></sub></td>
+    <td align="center"><img src="examples/gallery/03_line_trend.png" width="260"><br><sub>Trend + CI · <code>SEMANTIC</code></sub></td>
+  </tr>
+  <tr>
+    <td align="center"><img src="examples/gallery/04_heatmap.png" width="260"><br><sub>Heatmap · <code>COLORMAPS["sequential"]</code></sub></td>
+    <td align="center"><img src="examples/gallery/05_scatter_bubble.png" width="260"><br><sub>Scatter / bubble · <code>SEMANTIC</code></sub></td>
+    <td align="center"><img src="examples/gallery/06_radar.png" width="260"><br><sub>Radar / polar · <code>SEMANTIC</code></sub></td>
+  </tr>
+  <tr>
+    <td align="center"><img src="examples/gallery/07_distributions.png" width="260"><br><sub>Violin + box · <code>shades()</code></sub></td>
+    <td align="center"><img src="examples/gallery/08_forest.png" width="260"><br><sub>Forest / interval · <code>SEMANTIC</code></sub></td>
+    <td align="center"><img src="examples/gallery/09_stacked_area.png" width="260"><br><sub>Stacked area · <code>shades()</code></sub></td>
+  </tr>
+</table>
+
+## Style notes
+
+The bundled `nature` style uses 7 pt sans (TeX Gyre Heros / Helvetica), an open
+frame (no top/right spines), and export settings that keep text **editable** in
+Illustrator/Inkscape (`pdf.fonttype=42`, `svg.fonttype=none`) at 600 dpi.
+
+## Claude Code skill
+
+A personal `sci-figure` skill (`~/.claude/skills/sci-figure/`) walks Claude
+through the publication workflow and is auto-invoked on plotting tasks in any
+project where EasyPlotLib is installed.

easyplotlib-0.1.1/EasyPlotLib.egg-info/PKG-INFO

@@ -1,22 +0,0 @@
-Metadata-Version: 2.2
-Name: EasyPlotLib
-Version: 0.1.1
-Summary: A simple plotting library
-Home-page: https://github.com/yourusername/EasyPlotLib
-Author: HanYuyang
-Author-email: 17766095120@163.com
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: requires-python
-Dynamic: summary
-
-# Install
-pip install EasyPlotLib

easyplotlib-0.1.1/PKG-INFO

@@ -1,22 +0,0 @@
-Metadata-Version: 2.2
-Name: EasyPlotLib
-Version: 0.1.1
-Summary: A simple plotting library
-Home-page: https://github.com/yourusername/EasyPlotLib
-Author: HanYuyang
-Author-email: 17766095120@163.com
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: requires-python
-Dynamic: summary
-
-# Install
-pip install EasyPlotLib

easyplotlib-0.1.1/README.md

@@ -1,2 +0,0 @@
-# Install
-pip install EasyPlotLib