sciglyph

Publication-quality scientific illustration in pure matplotlib — no BioRender, no Illustrator.

Overview figures and architecture diagrams are usually drawn by hand in a subscription tool. That makes them pretty, but also unreproducible: you cannot diff them, you cannot regenerate them when the numbers change, and you cannot put them under version control.

sciglyph gives you the primitives to draw the same figures as code.

_{Both figures above are generated by the scripts in examples/ — nothing was touched by hand. The content is synthetic; swap in your own numbers and the layout carries over.}

Why

Install

pip install sciglyph

Only matplotlib and numpy. Nothing else.

Quick start

import matplotlib.pyplot as plt
from sciglyph import bio, set_canvas, report, RC

plt.rcParams.update(RC)
fig = plt.figure(figsize=(7.2, 3.0), dpi=300)
ax = fig.add_axes([0, 0, 1, 1]); ax.set_xlim(0, 1); ax.set_ylim(0, 1); ax.axis("off")
set_canvas(fig)                      # required on non-square canvases

bio.person(ax, .08, .55, s=.30)
bio.dna(ax, .25, .55, w=.05, h=.45, n=2)
bio.cell(ax, .42, .55, r=.06, seed=1)
bio.seq_logo(ax, .60, .40, [("A", .6), ("C", .9), ("G", .4), ("T", .7)], w=.03)

report(fig, ax)                      # catch text collisions before saving
fig.savefig("figure.pdf", bbox_inches="tight")

That block is runnable as it stands — it saves figure.pdf and prints the layout report on the way.

The two full examples behind the images above live in the repository rather than the wheel, so they need a clone:

git clone https://github.com/GuoCheng24/sciglyph && cd sciglyph
python examples/overview_figure.py    # -> gallery/overview_figure.png
python examples/architecture.py       # -> gallery/architecture.png

Every glyph at a glance

_{The catalogue itself is drawn by the library — docs/glyph_sheet_figure.py regenerates it, and a glyph that breaks shows up as a broken cell rather than a silently stale image.}

What's included

sciglyph.bio — glyphs for Nature/Science-style overview figures: person (cohorts) · dna · cell · lipid · metabolite · nucleosome_chain · umap_layer (the stacked atlas look) · seq_logo (information-scaled letters, no logomaker needed) · stacked_planes · rbox · arr

sciglyph.arch — glyphs for architecture diagrams: cuboid / feature_stack (3-D feature blocks) · trapezoid (encoders) · module_stack (Conv|BN|ReLU bars) · dashed_group (the (a)/(b)/(c) language) · flow · op_circle · snowflake (frozen backbone) · image_thumb · embedding_space (contrastive panels) · loss_tag · bracket

sciglyph.layout — pre-flight collision detection.

Catching layout bugs before you save

When a figure breaks, it is almost never the artwork — it is the layout. report() uses the real rendered bounding boxes to find overlapping text, so you do not have to hunt for it by eye:

report(fig, ax)
# [sciglyph.layout] 36 text objects
#   ! 'CD4 Treg/-FOXP3' x 'SMR' overlap 92%

It also works from the command line on any script that exposes fig and ax:

python -m sciglyph.layout my_figure.py

It checks three things, each of which shipped a broken figure before it existed:

Two kinds of overlap are deliberately not reported, because they are the layout working: a panel containing its contents, and an unfilled dashed shape — a ring drawn around the thing it annotates.

These are geometric checks. Whether the figure actually reads well still needs your eyes.

Notes from actually shipping these figures

• Call set_canvas(fig). In [0,1] coordinates a "circle" is r·W wide and r·H tall. On a 12×3 canvas, every circle becomes a rugby ball.
• Anchor arrows to what feature_stack returns, not to hard-coded coordinates — otherwise changing the number of blocks silently breaks them.
• Never put symbol codepoints in figure text. ❄ (U+2744) is missing from most sans fonts and renders as a tofu box. Draw it (arch.snowflake).
• Overlapping translucent fills blend into one muddy colour. Keep the fill under alpha=0.15, stroke each curve, and offset the peaks. Tuning alpha alone will not save you.
• Fonts: Arial/Helvetica are often absent on Linux. RC falls back to Liberation Sans (metric-compatible with Arial) and sets pdf.fonttype=42 so text stays editable in the PDF — a hard requirement at most journals.
• Don't move elements toward whitespace. Whitespace relocates, it does not disappear. Decide which row an element belongs to, move it as a group, then verify with the quadrant ink distribution.

Honest scope

This gets you clean flat schematics combined with data panels — the register of a Nature/Science overview figure or a TPAMI architecture diagram. It will not reproduce hand-drawn illustration (shaded organs, textured cells, gradients). For that, embed a CC-BY asset and cite it rather than fake it.

Who maintains this

Guo Cheng, University of Chinese Academy of Sciences — medical imaging and machine learning methods. This tool came out of needing to regenerate a figure every time the numbers changed, and not wanting to redraw it by hand each time.

Corrections, bug reports and feature requests all go to Issues. Please open one rather than emailing: a public answer helps whoever hits the same thing next, and it is searchable.

Other things from the same desk

Written while trying to get papers out, so they tend to be useful at the same points in that process:

• scholarcheck — verify that a citation actually exists, and audit a whole .bib in CI
• docxaudit — find what your converter silently dropped from a .docx
• world-model-map — a map of open-source world models and where their authors say they break
• kakeya-conjecture-lab — an interactive lab for the Kakeya conjecture, with a box-counting meter

License

MIT © Guo Cheng