Skip to content

Single-Cell Analysis — Demo Guide

Demo key: E8 · full specification in ../../demos/DEMO_CATALOG.md

Run it

.venv/bin/python scripts/run_demo.py E8

Check prerequisites without running anything:

.venv/bin/python scripts/run_demo.py --check-all

What the audience is seeing

Takes a sample of thousands of individual cells and works out how many distinct cell types are present.

Bulk measurements average across cell types and hide the population that matters. Single-cell resolution recovers it.

Say this out loud

Decision support for a qualified clinician — never autonomous diagnosis or prescribing. Every output on this page is intended to inform a clinician's judgement, not replace it.

Cluster annotation is by marker-gene overlap against a canonical panel. It is a strong heuristic, not a ground truth.

The label matters. LIVE means it ran, now, on real input, in front of the room. REPRESENTATIVE means a pre-computed or curated result is standing in for a long or gated step — and you say so. BURST means it ran live but on remote GPUs, which is "elastic burst", not "all on one box".

If it will not run

The runner refuses to execute a demo declared LIVE whose service is unreachable, rather than quietly degrading to a canned result. The failure message names the missing prerequisite:

Transcript

Each run writes demo/transcripts/E8.txt. Diff it after a change — a silent regression shows up there before anyone notices it on stage.