# Presentation Family Instructions

This folder is a self-contained archive of Stefan Krastanov talks and one poster about efficient entanglement modeling, entanglement purification/distillation, Bell-preserving gates, and full-stack quantum-network simulation tooling. The versions run from the 2022 Delft/IQUISE talks through 2025 Nordita/IEEE updates.

The high-level story is stable across the family: introduce noisy Bell pairs, show purification as error propagation and probability reshuffling, motivate optimized n-to-k purification circuits, then explain faster-than-Clifford simulation of purification by treating Bell-preserving gates as permutations. Later and longer versions also discuss full-stack optimization, QuantumClifford.jl, BPGates.jl, QuantumSavory.jl, discrete-event network simulation, and in 2025, multipartite GHZ-preserving or graph-state distillation.

`HEADER.md` is used by the archive index and links this family to QuantumClifford.jl, BPGates.jl, older optimized purification work, full-stack simulation work, and the IQUISE recording. Do not rewrite it unless the index text itself needs to change.

## Talk Versions

- `2022-Delft_talk_purification_and_entanglement_modeling/index.html`: early broad talk, titled "From Better Entanglement Distillation to Multi-formalism Quantum Simulation Tools for the Entire Network Stack."
- `2022-IQUISE_talk_purification_and_entanglement_modeling/presentation/index.html`: December 2022 reveal deck plus `video_recording.mp4`; similar to Delft but in a nested `presentation/` layout and without the "Entire Network Stack" title wording.
- `2023-AWS_workshop/poster.html`: HTML/CSS poster, not a reveal deck. `HEADER.md` embeds `poster.pdf` and links the poster-making writeup.
- `2023-CQN_online_seminar/presentation/index.html`: August 2023 CQN seminar, based on IQUISE and updated with JuliaCon-era content, CQN logo, QuantumSavory/QuantumClifford/BPGates repository links, and areweentangledyet iframe demos.
- `2023-Honda_overview_talk/presentation/index.html`: concise "Better Entanglement Distillation" overview from October 20, 2023; mostly purification and BPGates, with full-stack tooling largely omitted.
- `2023-JuliaCon-purification/presentation/index.html`: JuliaCon 2023 deck titled "Faster Simulation of Quantum Entanglement with BPGates.jl"; focused on the package/preprint story.
- `2023-MIT_Quantum_and_AI_workshop/presentation/index.html`: May 2023 workshop deck titled "Better Entanglement Distillation: Simulating better in order to optimize better"; a copy-family member with an AI/optimization framing.
- `2023-NY_quantum_meet_purification_and_entanglement_modeling/presentation/index.html`: March 2023 version; mostly copied from IQUISE with the same broad stack and areweentangledyet material.
- `2023-UMassAmherst_talk_purification_and_entanglement_modeling/presentation/index.html`: April 2023 UMass version; mostly copied from IQUISE.
- `2024-UMassAmherst_talk_purification_and_entanglement_modeling/presentation/index.html`: April 2024 UMass version; structurally close to the 2023 UMass/IQUISE copies.
- `2025-Nordita/presentation/index.html`: long June 2025 update titled "Better Entanglement Distillation & Bespoke Error Detection"; adds NPJ QI 2025 references, GHZ-preserving distillation, graph-state/bespoke error-detection framing, and newer team/tooling notes.
- `2025-IEEE/presentation/index.html`: shorter 2025 IEEE version of the Nordita deck.

Empty marker files such as `Mostly_a_copy_of_the_IQUISE_presentation`, `Mostly_a_copy_of_the_IQUISE_presentation_updated_with_JuliaCon_content`, `Significant_update_with_GHZ_and_Graph_states`, and `shortened version of the Nordita one` are useful provenance signals even though they contain no text.

## Content Themes

- Bell-state notation: most decks use the A/B/C/D Bell basis and repeat `alice.png`, `bob.png`, `simple_purify.png`, `simple_purify_perm.png`, `simple_purify_meas.png`, and `error_prop.png`.
- Distillation optimization: look for `pur_gates.png`, `mutation.png`, `offspring.png`, `purify_opt_results.png`, `n-to-k_population.png`, `n-to-k_rawpairs.png`, `5to2.png`, `5to2_Circuits.png`, `dist_f*.png`, and `teleported_fidelity.png`.
- Faster simulation and BP gates: recurring figures include `general_bp_gate.png`, `a_good_bp_gate.png`, and `bp_benchmark.png`. The main paper framing moves from "in preparation" in 2022/early 2023, to arXiv:2307.06354 in 2023, to NPJ QI 2025 in 2025.
- Full-stack tooling: broad decks use `savorylogo.png`, `savoryplot_*.png`, `savorycirc*.png`, `dyn_*.gif/png`, `kets.png`, `tableaux.png`, `tensornets.png`, `firstgenrepeater-07.observable.mp4`, and sometimes iframes from `areweentangledyet.com`.
- 2025 additions: Nordita and IEEE add `Generalized circuits with pauli.png` and `fin vs fout linestyle pumping.png` for GHZ-preserving optimized distillation.
- AWS poster assets include institutional logos, `poster.css`, `poster.pdf`, `qr.png`, `TeleportedFidelityLargeCodeRough*.png`, and `CircuitsPopulation.png`.

## Editing Guidance

Use `python3 tools/reveal_text.py path/to/index.html --max-chars 12000` from the archive root to inspect a reveal.js deck without reading the full HTML by hand. For AWS, run it on `2023-AWS_workshop/poster.html` if you need rough poster text.

Most decks are standalone reveal.js copies with assets next to the deck file. If an entry point is under `presentation/`, keep image, video, CSS, and relative links inside that same `presentation/` directory unless you intentionally update paths. Delft is the main exception: its `index.html` and assets live directly in the talk folder.

The decks depend heavily on inline styles, reveal fragments, MathJax/LaTeX snippets, local media, and occasional import maps for Three.js. Preserve local relative paths when editing. Check slides that use `data-background-iframe`, `data-background-interactive`, local videos, or Three.js imports in a browser because text extraction will not prove those interactive sections still render.

Do not edit or add files in vendored/generated/support trees unless the task explicitly requires it. Skip `dist/`, `plugin/`, `MathJax/`, `three.js-r145/`, `node_modules/`, `.git/`, `.vscode/`, and nested `presentation/three.js-r145/` trees. Top-level support folders such as `bootstrap/`, `js/`, `tween/`, and `original_logos/` are also not talk-version targets.

When updating scientific claims, keep the version context in mind. Older decks intentionally say "in preparation"; 2023 decks may cite arXiv:2307.06354; 2025 decks cite NPJ QI 2025 and add GHZ-preserving work. Do not normalize these references across all versions unless the goal is to modernize the archive rather than preserve a historical talk.
