scidraw-ai 0.1.0__tar.gz

scidraw_ai-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+dist/
+build/
+*.egg-info/
+__pycache__/
+*.pyc
+.venv/

scidraw_ai-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SciDraw AI (sci-draw.com)
+
+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.

scidraw_ai-0.1.0/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: scidraw-ai
+Version: 0.1.0
+Summary: Publication-ready matplotlib styles and figure helpers by SciDraw AI — colorblind-safe palettes, journal figure sizes, and panel labels for Nature, Science, Cell, PLOS, and ACS.
+Project-URL: Homepage, https://sci-draw.com
+Project-URL: Documentation, https://sci-draw.com/tools
+Project-URL: Chart Maker, https://sci-draw.com/scientific-figure-maker
+Author-email: SciDraw AI <davie@daviechen.com>
+License: MIT
+License-File: LICENSE
+Keywords: colorblind,figures,journal,matplotlib,okabe-ito,publication,scientific,styles,visualization
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: Matplotlib
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+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
+Requires-Python: >=3.9
+Requires-Dist: matplotlib>=3.5
+Description-Content-Type: text/markdown
+
+# scidraw-ai
+
+Publication-ready matplotlib styles and figure helpers, maintained by
+[SciDraw AI](https://sci-draw.com) — the AI scientific illustration and
+data visualization platform.
+
+The color cycles and journal specs in this package are the same ones used
+by the [SciDraw AI chart tools](https://sci-draw.com/tools), so Python code
+exported from the platform reproduces identically on your machine.
+
+## Install
+
+```bash
+pip install scidraw-ai
+```
+
+## Quick start
+
+```python
+import matplotlib.pyplot as plt
+import scidraw_ai  # registers the styles
+
+plt.style.use('scidraw')                      # publication (light)
+plt.style.use('scidraw-dark')                 # slides & screens
+plt.style.use(['scidraw', 'scidraw-poster'])  # posters & talks
+```
+
+The `scidraw` style gives you:
+
+- **Okabe-Ito colorblind-safe color cycle** — the standard recommended for
+  scientific publishing (pair the yellow with distinct markers on white
+  backgrounds)
+- Clean axes: no top/right spines, outward ticks, frameless legends
+- Journal-friendly type sizes (7–9 pt) with Arial/Helvetica preferred
+- 300 DPI tight-bbox saving out of the box
+- **Editable text in exports** — `pdf.fonttype 42` / `svg.fonttype none`,
+  so labels stay editable in Illustrator, Inkscape, or PowerPoint
+
+## Journal figure sizes
+
+Widths follow each journal's author guidelines (Nature, Science, Cell,
+PLOS, ACS):
+
+```python
+fig, ax = plt.subplots(figsize=scidraw_ai.figsize('nature', 'single'))
+fig, ax = plt.subplots(figsize=scidraw_ai.figsize('science', 'double'))
+```
+
+## Panel labels
+
+Each journal formats panel labels differently — Nature wants bold
+lowercase `a`, Science wants `(A)`, PLOS wants `A.`:
+
+```python
+fig, axs = plt.subplots(1, 3)
+scidraw_ai.label_panels(axs, journal='nature')
+```
+
+## Palettes
+
+Four colorblind-safe palettes, identical to the SciDraw AI platform:
+
+```python
+scidraw_ai.set_palette('okabe-ito')   # default
+scidraw_ai.set_palette('wong')
+scidraw_ai.set_palette('tol-bright')
+scidraw_ai.set_palette('tol-muted')
+```
+
+## Generate figures from data, no code
+
+Prefer not to write plotting code at all? [SciDraw AI](https://sci-draw.com)
+turns CSV/Excel data into journal-quality charts — box plots, heatmaps,
+regression and violin plots — and exports editable SVG/PDF plus the
+matplotlib code to reproduce them:
+
+- [Scientific figure maker](https://sci-draw.com/scientific-figure-maker)
+- [Free scientific diagram & chart tools](https://sci-draw.com/tools)
+
+## License
+
+MIT

scidraw_ai-0.1.0/README.md

@@ -0,0 +1,82 @@
+# scidraw-ai
+
+Publication-ready matplotlib styles and figure helpers, maintained by
+[SciDraw AI](https://sci-draw.com) — the AI scientific illustration and
+data visualization platform.
+
+The color cycles and journal specs in this package are the same ones used
+by the [SciDraw AI chart tools](https://sci-draw.com/tools), so Python code
+exported from the platform reproduces identically on your machine.
+
+## Install
+
+```bash
+pip install scidraw-ai
+```
+
+## Quick start
+
+```python
+import matplotlib.pyplot as plt
+import scidraw_ai  # registers the styles
+
+plt.style.use('scidraw')                      # publication (light)
+plt.style.use('scidraw-dark')                 # slides & screens
+plt.style.use(['scidraw', 'scidraw-poster'])  # posters & talks
+```
+
+The `scidraw` style gives you:
+
+- **Okabe-Ito colorblind-safe color cycle** — the standard recommended for
+  scientific publishing (pair the yellow with distinct markers on white
+  backgrounds)
+- Clean axes: no top/right spines, outward ticks, frameless legends
+- Journal-friendly type sizes (7–9 pt) with Arial/Helvetica preferred
+- 300 DPI tight-bbox saving out of the box
+- **Editable text in exports** — `pdf.fonttype 42` / `svg.fonttype none`,
+  so labels stay editable in Illustrator, Inkscape, or PowerPoint
+
+## Journal figure sizes
+
+Widths follow each journal's author guidelines (Nature, Science, Cell,
+PLOS, ACS):
+
+```python
+fig, ax = plt.subplots(figsize=scidraw_ai.figsize('nature', 'single'))
+fig, ax = plt.subplots(figsize=scidraw_ai.figsize('science', 'double'))
+```
+
+## Panel labels
+
+Each journal formats panel labels differently — Nature wants bold
+lowercase `a`, Science wants `(A)`, PLOS wants `A.`:
+
+```python
+fig, axs = plt.subplots(1, 3)
+scidraw_ai.label_panels(axs, journal='nature')
+```
+
+## Palettes
+
+Four colorblind-safe palettes, identical to the SciDraw AI platform:
+
+```python
+scidraw_ai.set_palette('okabe-ito')   # default
+scidraw_ai.set_palette('wong')
+scidraw_ai.set_palette('tol-bright')
+scidraw_ai.set_palette('tol-muted')
+```
+
+## Generate figures from data, no code
+
+Prefer not to write plotting code at all? [SciDraw AI](https://sci-draw.com)
+turns CSV/Excel data into journal-quality charts — box plots, heatmaps,
+regression and violin plots — and exports editable SVG/PDF plus the
+matplotlib code to reproduce them:
+
+- [Scientific figure maker](https://sci-draw.com/scientific-figure-maker)
+- [Free scientific diagram & chart tools](https://sci-draw.com/tools)
+
+## License
+
+MIT

scidraw_ai-0.1.0/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "scidraw-ai"
+version = "0.1.0"
+description = "Publication-ready matplotlib styles and figure helpers by SciDraw AI — colorblind-safe palettes, journal figure sizes, and panel labels for Nature, Science, Cell, PLOS, and ACS."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "SciDraw AI", email = "davie@daviechen.com" }]
+keywords = [
+    "matplotlib",
+    "styles",
+    "scientific",
+    "publication",
+    "figures",
+    "colorblind",
+    "okabe-ito",
+    "journal",
+    "visualization",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Visualization",
+    "Framework :: Matplotlib",
+]
+dependencies = ["matplotlib>=3.5"]
+
+[project.urls]
+Homepage = "https://sci-draw.com"
+Documentation = "https://sci-draw.com/tools"
+"Chart Maker" = "https://sci-draw.com/scientific-figure-maker"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/scidraw_ai"]

scidraw_ai-0.1.0/src/scidraw_ai/__init__.py

@@ -0,0 +1,146 @@
+"""SciDraw AI — publication-ready matplotlib styles and figure helpers.
+
+Official companion package for `SciDraw AI <https://sci-draw.com>`_.
+Importing this package registers three matplotlib styles::
+
+    import matplotlib.pyplot as plt
+    import scidraw_ai  # noqa: F401  (registers styles)
+
+    plt.style.use('scidraw')                      # publication (light)
+    plt.style.use('scidraw-dark')                 # slides / screens
+    plt.style.use(['scidraw', 'scidraw-poster'])  # posters & talks
+
+The color cycles and journal specs match the figures generated by the
+SciDraw AI chart tools at https://sci-draw.com/tools, so code exported
+from the platform reproduces identically with this package installed.
+"""
+
+from pathlib import Path
+
+import matplotlib
+import matplotlib.style
+
+__version__ = '0.1.0'
+
+__all__ = [
+    'PALETTES',
+    'JOURNALS',
+    'set_palette',
+    'figsize',
+    'label_panels',
+]
+
+_STYLE_DIR = Path(__file__).parent / 'styles'
+
+#: Colorblind-safe palettes, identical to the ones used by SciDraw AI
+#: chart generation (https://sci-draw.com/tools).
+PALETTES = {
+    'okabe-ito': [
+        '#E69F00', '#56B4E9', '#009E73', '#F0E442',
+        '#0072B2', '#D55E00', '#CC79A7', '#000000',
+    ],
+    'wong': [
+        '#000000', '#E69F00', '#56B4E9', '#009E73',
+        '#F0E442', '#0072B2', '#D55E00', '#CC79A7',
+    ],
+    'tol-bright': [
+        '#4477AA', '#EE6677', '#228833', '#CCBB44',
+        '#66CCEE', '#AA3377', '#BBBBBB',
+    ],
+    'tol-muted': [
+        '#332288', '#88CCEE', '#44AA99', '#117733', '#999933',
+        '#DDCC77', '#CC6677', '#882255', '#AA4499',
+    ],
+}
+
+#: Journal figure widths in inches (single / double column) and panel
+#: label conventions, following each journal's author guidelines.
+JOURNALS = {
+    'nature': {'single': 3.50, 'double': 7.20, 'label': '{a}'},
+    'science': {'single': 2.17, 'double': 6.89, 'label': '({A})'},
+    'cell': {'single': 3.35, 'double': 7.01, 'label': '{A}'},
+    'plos': {'single': 3.27, 'double': 6.81, 'label': '{A}.'},
+    'acs': {'single': 3.25, 'double': 7.00, 'label': '({a})'},
+}
+
+
+def _register_styles():
+    for path in sorted(_STYLE_DIR.glob('*.mplstyle')):
+        style = matplotlib.rc_params_from_file(
+            path, use_default_template=False
+        )
+        matplotlib.style.library[path.stem] = style
+    matplotlib.style.core.available[:] = sorted(matplotlib.style.library)
+
+
+def set_palette(name='okabe-ito'):
+    """Set the active color cycle to one of :data:`PALETTES`.
+
+    >>> import scidraw_ai
+    >>> scidraw_ai.set_palette('tol-bright')
+    """
+    try:
+        colors = PALETTES[name]
+    except KeyError:
+        raise ValueError(
+            f'Unknown palette {name!r}. '
+            f'Available: {", ".join(sorted(PALETTES))}'
+        ) from None
+    matplotlib.rcParams['axes.prop_cycle'] = matplotlib.cycler(color=colors)
+    return colors
+
+
+def figsize(journal='nature', columns='single', aspect=0.75):
+    """Return ``(width, height)`` in inches for a journal figure.
+
+    ``journal`` is one of :data:`JOURNALS`; ``columns`` is ``'single'``
+    or ``'double'``; ``aspect`` is height/width (default 3:4).
+
+    >>> import matplotlib.pyplot as plt, scidraw_ai
+    >>> fig, ax = plt.subplots(figsize=scidraw_ai.figsize('nature'))
+    """
+    try:
+        spec = JOURNALS[journal]
+    except KeyError:
+        raise ValueError(
+            f'Unknown journal {journal!r}. '
+            f'Available: {", ".join(sorted(JOURNALS))}'
+        ) from None
+    if columns not in ('single', 'double'):
+        raise ValueError("columns must be 'single' or 'double'")
+    width = spec[columns]
+    return (width, width * aspect)
+
+
+def label_panels(axes, journal='nature', x=-0.12, y=1.05, **text_kwargs):
+    """Label panels a, b, c… following a journal's convention.
+
+    Nature: bold lowercase ``a``; Science: ``(A)``; Cell: ``A``;
+    PLOS: ``A.``; ACS: ``(a)``.
+
+    >>> fig, axs = plt.subplots(1, 3)
+    >>> scidraw_ai.label_panels(axs, journal='nature')
+    """
+    template = JOURNALS[journal]['label']
+    try:
+        flat = list(axes.flat)
+    except AttributeError:
+        flat = [axes] if not isinstance(axes, (list, tuple)) else list(axes)
+    kwargs = {
+        'fontweight': 'bold',
+        'fontsize': matplotlib.rcParams['axes.titlesize'],
+        'va': 'bottom',
+        'ha': 'right',
+    }
+    kwargs.update(text_kwargs)
+    labels = []
+    for i, ax in enumerate(flat):
+        letter = chr(ord('a') + i)
+        text = template.format(a=letter, A=letter.upper())
+        labels.append(
+            ax.text(x, y, text, transform=ax.transAxes, **kwargs)
+        )
+    return labels
+
+
+_register_styles()

scidraw_ai-0.1.0/src/scidraw_ai/styles/scidraw-dark.mplstyle

@@ -0,0 +1,61 @@
+# scidraw-dark — dark style for slides & screens by SciDraw AI (https://sci-draw.com)
+# Same Okabe-Ito cycle (black slot swapped for white), stepped for dark surfaces.
+
+figure.figsize: 3.5, 2.625
+figure.dpi: 110
+figure.facecolor: 171717
+
+savefig.dpi: 300
+savefig.bbox: tight
+savefig.pad_inches: 0.02
+savefig.facecolor: 171717
+
+font.family: sans-serif
+font.sans-serif: Arial, Helvetica, DejaVu Sans
+font.size: 8
+mathtext.default: regular
+
+text.color: e5e5e5
+
+axes.titlesize: 9
+axes.labelsize: 8
+axes.linewidth: 0.8
+axes.facecolor: 171717
+axes.edgecolor: a3a3a3
+axes.labelcolor: e5e5e5
+axes.spines.top: False
+axes.spines.right: False
+axes.grid: False
+axes.prop_cycle: cycler('color', ['E69F00', '56B4E9', '009E73', 'F0E442', '0072B2', 'D55E00', 'CC79A7', 'FFFFFF'])
+axes.axisbelow: True
+
+xtick.labelsize: 7
+ytick.labelsize: 7
+xtick.direction: out
+ytick.direction: out
+xtick.major.size: 3
+ytick.major.size: 3
+xtick.major.width: 0.8
+ytick.major.width: 0.8
+xtick.minor.size: 1.5
+ytick.minor.size: 1.5
+xtick.minor.width: 0.6
+ytick.minor.width: 0.6
+xtick.color: e5e5e5
+ytick.color: e5e5e5
+
+lines.linewidth: 1.5
+lines.markersize: 4
+errorbar.capsize: 2
+
+grid.color: 333333
+grid.linewidth: 0.5
+
+legend.fontsize: 7
+legend.title_fontsize: 8
+legend.frameon: False
+legend.handlelength: 1.5
+
+pdf.fonttype: 42
+ps.fonttype: 42
+svg.fonttype: none

scidraw_ai-0.1.0/src/scidraw_ai/styles/scidraw-poster.mplstyle

@@ -0,0 +1,25 @@
+# scidraw-poster — size overrides for posters & talks by SciDraw AI (https://sci-draw.com)
+# Compose on top of a base style: plt.style.use(['scidraw', 'scidraw-poster'])
+# or plt.style.use(['scidraw-dark', 'scidraw-poster'])
+
+figure.figsize: 7, 5.25
+
+font.size: 14
+
+axes.titlesize: 16
+axes.labelsize: 14
+axes.linewidth: 1.2
+
+xtick.labelsize: 12
+ytick.labelsize: 12
+xtick.major.size: 5
+ytick.major.size: 5
+xtick.major.width: 1.2
+ytick.major.width: 1.2
+
+lines.linewidth: 2.5
+lines.markersize: 7
+errorbar.capsize: 3
+
+legend.fontsize: 12
+legend.title_fontsize: 14

scidraw_ai-0.1.0/src/scidraw_ai/styles/scidraw.mplstyle

@@ -0,0 +1,59 @@
+# scidraw — publication-ready light style by SciDraw AI (https://sci-draw.com)
+# Okabe-Ito colorblind-safe cycle, clean spines, journal-friendly type sizes.
+
+figure.figsize: 3.5, 2.625
+figure.dpi: 110
+figure.facecolor: white
+
+savefig.dpi: 300
+savefig.bbox: tight
+savefig.pad_inches: 0.02
+savefig.facecolor: white
+
+font.family: sans-serif
+font.sans-serif: Arial, Helvetica, DejaVu Sans
+font.size: 8
+mathtext.default: regular
+
+axes.titlesize: 9
+axes.labelsize: 8
+axes.linewidth: 0.8
+axes.edgecolor: black
+axes.labelcolor: black
+axes.spines.top: False
+axes.spines.right: False
+axes.grid: False
+axes.prop_cycle: cycler('color', ['E69F00', '56B4E9', '009E73', 'F0E442', '0072B2', 'D55E00', 'CC79A7', '000000'])
+axes.axisbelow: True
+
+xtick.labelsize: 7
+ytick.labelsize: 7
+xtick.direction: out
+ytick.direction: out
+xtick.major.size: 3
+ytick.major.size: 3
+xtick.major.width: 0.8
+ytick.major.width: 0.8
+xtick.minor.size: 1.5
+ytick.minor.size: 1.5
+xtick.minor.width: 0.6
+ytick.minor.width: 0.6
+xtick.color: black
+ytick.color: black
+
+lines.linewidth: 1.5
+lines.markersize: 4
+errorbar.capsize: 2
+
+grid.color: e5e5e5
+grid.linewidth: 0.5
+
+legend.fontsize: 7
+legend.title_fontsize: 8
+legend.frameon: False
+legend.handlelength: 1.5
+
+# Keep text editable in Illustrator / Inkscape exports
+pdf.fonttype: 42
+ps.fonttype: 42
+svg.fonttype: none