# Quantum Code Map This page is the lecture-side map for the companion repository: - Future public repo: [github.com/montekkundan/quantum-code](https://github.com/montekkundan/quantum-code) - Repo code map: [COURSE_MAP.md](https://github.com/montekkundan/quantum-code/blob/main/COURSE_MAP.md) Use it the way the LLM lecture uses its code map: start in the note, run the notebook, inspect the helper, then read the test that protects the scientific invariant. ```mermaid flowchart TD A["Concept note"] --> B["Per-concept notebook"] B --> C["qcourse helper"] C --> D["pytest invariant"] B --> E["Unit notebook"] E --> F["Assignment or capstone"] ``` ## Foundations - Notes: [[concepts/Extended Church-Turing Thesis]], [[concepts/Probability Theory and Quantum Mechanics]], [[concepts/Basic Rules of Quantum Mechanics]], [[concepts/Quantum Gates and Circuits]], [[concepts/Bloch Sphere and No-Cloning Theorem]] - Unit notebook: [notebooks/01_foundations/state_rules.ipynb](https://github.com/montekkundan/quantum-code/blob/main/notebooks/01_foundations/state_rules.ipynb) - Helper modules: [qcourse/states.py](https://github.com/montekkundan/quantum-code/blob/main/qcourse/states.py), [qcourse/circuits.py](https://github.com/montekkundan/quantum-code/blob/main/qcourse/circuits.py) - Tests: [tests/test_states_density_entanglement.py](https://github.com/montekkundan/quantum-code/blob/main/tests/test_states_density_entanglement.py), [tests/test_optional_qiskit_circuits.py](https://github.com/montekkundan/quantum-code/blob/main/tests/test_optional_qiskit_circuits.py) ## Entanglement And Mixed States - Notes: [[concepts/Pure vs. Mixed States]], [[concepts/Density Matrices and Partial Trace]], [[concepts/Separable vs. Entangled States]], [[concepts/Schmidt Decomposition]], [[concepts/Entanglement Entropy]] - Unit notebook: [notebooks/02_entanglement/bell_states.ipynb](https://github.com/montekkundan/quantum-code/blob/main/notebooks/02_entanglement/bell_states.ipynb) - Helper modules: [qcourse/density.py](https://github.com/montekkundan/quantum-code/blob/main/qcourse/density.py), [qcourse/entanglement.py](https://github.com/montekkundan/quantum-code/blob/main/qcourse/entanglement.py) - Tests: [tests/test_states_density_entanglement.py](https://github.com/montekkundan/quantum-code/blob/main/tests/test_states_density_entanglement.py), [tests/test_expanded_course_primitives.py](https://github.com/montekkundan/quantum-code/blob/main/tests/test_expanded_course_primitives.py) ## Protocols, Bell, And Cryptography - Notes: [[concepts/Quantum Money and Quantum Key Distribution]], [[concepts/Superdense Coding]], [[concepts/Quantum Teleportation]], [[concepts/GHZ States, Entanglement Swapping, and Monogamy]], [[concepts/Bell's Inequality and CHSH]], [[concepts/Nonlocal Games]], [[concepts/Einstein-Certified Randomness]] - Unit notebook: [notebooks/03_protocols_bell_crypto/teleportation_chsh.ipynb](https://github.com/montekkundan/quantum-code/blob/main/notebooks/03_protocols_bell_crypto/teleportation_chsh.ipynb) - Helper modules: [qcourse/protocols.py](https://github.com/montekkundan/quantum-code/blob/main/qcourse/protocols.py), [qcourse/circuits.py](https://github.com/montekkundan/quantum-code/blob/main/qcourse/circuits.py) - Tests: [tests/test_protocols_algorithms_qec.py](https://github.com/montekkundan/quantum-code/blob/main/tests/test_protocols_algorithms_qec.py) ## Algorithms And Complexity - Notes: [[concepts/Universal Gate Sets]], [[concepts/Quantum Query Complexity and Deutsch-Jozsa]], [[concepts/Bernstein-Vazirani and Simon's Algorithm]], [[concepts/RSA, Period Finding, and Shor's Algorithm]], [[concepts/Quantum Fourier Transform]], [[concepts/Grover's Algorithm]], [[concepts/Quantum Complexity Theory]] - Unit notebook: [notebooks/04_algorithms/deutsch_bv_grover_qft.ipynb](https://github.com/montekkundan/quantum-code/blob/main/notebooks/04_algorithms/deutsch_bv_grover_qft.ipynb) - Helper modules: [qcourse/oracles.py](https://github.com/montekkundan/quantum-code/blob/main/qcourse/oracles.py), [qcourse/algorithms.py](https://github.com/montekkundan/quantum-code/blob/main/qcourse/algorithms.py), [qcourse/circuits.py](https://github.com/montekkundan/quantum-code/blob/main/qcourse/circuits.py) - Tests: [tests/test_protocols_algorithms_qec.py](https://github.com/montekkundan/quantum-code/blob/main/tests/test_protocols_algorithms_qec.py), [tests/test_expanded_course_primitives.py](https://github.com/montekkundan/quantum-code/blob/main/tests/test_expanded_course_primitives.py) ## Hamiltonians, Noise, And Adiabatic Thinking - Notes: [[concepts/Hamiltonians]], [[concepts/The Adiabatic Algorithm]] - Unit notebook: [notebooks/05_hamiltonians_noise/hamiltonian_basics.ipynb](https://github.com/montekkundan/quantum-code/blob/main/notebooks/05_hamiltonians_noise/hamiltonian_basics.ipynb) - Helper modules: [qcourse/hamiltonians.py](https://github.com/montekkundan/quantum-code/blob/main/qcourse/hamiltonians.py), [qcourse/noise.py](https://github.com/montekkundan/quantum-code/blob/main/qcourse/noise.py) - Tests: [tests/test_hamiltonians_noise.py](https://github.com/montekkundan/quantum-code/blob/main/tests/test_hamiltonians_noise.py) ## Error Correction And Stabilizers - Notes: [[concepts/Quantum Error Correction]], [[concepts/Stabilizer Formalism]] - Unit notebook: [notebooks/06_qec_stabilizers/qec_starter.ipynb](https://github.com/montekkundan/quantum-code/blob/main/notebooks/06_qec_stabilizers/qec_starter.ipynb) - Helper module: [qcourse/qec.py](https://github.com/montekkundan/quantum-code/blob/main/qcourse/qec.py) - Tests: [tests/test_protocols_algorithms_qec.py](https://github.com/montekkundan/quantum-code/blob/main/tests/test_protocols_algorithms_qec.py), [tests/test_expanded_course_primitives.py](https://github.com/montekkundan/quantum-code/blob/main/tests/test_expanded_course_primitives.py) ## Media And Animations - Animation source: [animations/](https://github.com/montekkundan/quantum-code/tree/main/animations) - Render script: [scripts/render_animations.py](https://github.com/montekkundan/quantum-code/blob/main/scripts/render_animations.py) ## Capstone - Lecture workflow: [[Final Capstone Workflow]] - Repo workflow: [capstone/README.md](https://github.com/montekkundan/quantum-code/blob/main/capstone/README.md) - Capstone notebook: [notebooks/07_advanced_projects/final_capstone_workflow.ipynb](https://github.com/montekkundan/quantum-code/blob/main/notebooks/07_advanced_projects/final_capstone_workflow.ipynb) - Report template: [capstone/final_report_template.md](https://github.com/montekkundan/quantum-code/blob/main/capstone/final_report_template.md) The capstone should force one complete research-style loop: source question, mathematical invariant, implementation, simulator evidence, noise or hardware comparison, and a written limitation section. ## Verification Commands Run these from the companion repository: ```bash uv run --extra dev ruff check . uv run --extra dev pytest uv run --extra notebooks python scripts/run_all_notebooks.py uv run python scripts/render_animations.py --check-only ``` Hardware execution is optional. Simulator tests and notebook smoke execution are the stable course baseline.