Benchmarks

Included directly from the repository README.md so it never goes stale relative to the single source of truth. See the Changelog for how these numbers evolved release to release.

Anti-OOM chunking vs. PennyLane

Measured on Windows, CPU only, 8 GB RAM — PennyLane's default.qubit allocates the full statevector; Dense Evolution's Chunk holds constant ~2 GB regardless of qubit count.

Qubits	Hilbert Space	PennyLane	Dense Evolution	Chunk Geometry
26	67,108,864	✅ 1,074 MB	✅ 2,050 MB	1× (2²⁷)
28	268,435,456	❌ OOM	✅ 2,050 MB	2× (2²⁷)
32	4,294,967,296	❌ OOM	✅ 2,048 MB	32× (2²⁷)

On Google Colab (12 GB RAM), n=28 runs in ~3s end-to-end (JIT-compiled, num_chunks=2) — the multi-chunk path is fast, not just OOM-safe. Past the real RAM ceiling (Chunk alone raises MemoryPressureError cleanly rather than crashing the process), allow_disk_overflow=True falls back to a slower disk-backed path instead of failing — correctness-first, not benchmarked for speed yet. Full measured table: docs/api/chunk.md.