121 Scientific Diagrams

Illustrating concepts in physics, chemistry and machine learning.

janosh.github.io/diagrams allows searching, sorting, opening in Overleaf and downloading figures (PDF/SVG/PNG) from this collection.

Have a TikZ/CeTZ diagram you'd like to share? Submit a PR with a .tex or .typ and a corresponding metadata .yml file in the assets/ directory and add yourself to the citation.cff file.

Title-row icons: references · creator · original source.

Scripts

Export diagrams as PDF, SVG, PNG, and AVIF:

uv run --no-project --with pyyaml scripts/render_typst.py assets/bloch-sphere/bloch-sphere.typ
uv run --no-project --with pyyaml scripts/render_tikz.py assets/bloch-sphere/bloch-sphere.tex

Requires Typst or LaTeX (latexmk), ImageMagick, and ZopfliPNG. TikZ also needs Ghostscript; pdf2svg enables SVG export. Set preserve_colors: true in metadata to disable dark-mode recoloring.

Python and metadata checks

uv run --no-project --python 3.14 --with pytest --with pyyaml pytest -q
prek run --all-files

Rendering tests need the tools above and the artwork's fonts. Metadata requires title, description, and unique tags.

Site visual checks

cd site
pnpm exec playwright install --only-shell chromium
pnpm build
pnpm test:visual

For intentional visual changes, run pnpm test:visual:update and review the PNG diffs.

📖   How to cite

You can cite the Zenodo record using the following BibTeX entry:

@software{riebesell_diagrams_2020,
  title = {Collection of scientific diagrams},
  author = {Riebesell, Janosh and Bringuier, Stefan},
  date = {2020-08-09},
  year = {2020},
  doi = {10.5281/zenodo.7486911},
  url = {https://github.com/janosh/diagrams},
  note = {10.5281/zenodo.7486911 - https://github.com/janosh/diagrams},
  version = {0.2.0},
  urldate = {2023-01-01}, % optional, replace with your date of access
}