# trinexis-quantum/quantum-concepts architecture

> Architecture diagram of the GitHub repository trinexis-quantum/quantum-concepts, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/trinexis-quantum/quantum-concepts
- Repository: https://github.com/trinexis-quantum/quantum-concepts

## Overview

This repository is an educational quantum-computing lab series, not a conventional application: the learner progresses through 15 Jupyter notebooks, from quantum-physics foundations to programming tools and canonical algorithms. The README explicitly says to complete the acts in order and that each notebook builds on the last, supporting the documented learning sequence. The supplied README excerpt describes only the early foundations in detail, so later notebook topics and their grouping rely on the roadmap and notebook filenames; no implementation-level calls or data flows are evidenced.

Main entry points: [`Handson1&2_Double_Slit_and_Stern_Gerlach.ipynb`](https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson1%262_Double_Slit_and_Stern_Gerlach.ipynb) (Double Slit, Stern-Gerlach), [`Handson3_QMPostulates_BraKet_Bloch.ipynb`](https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson3_QMPostulates_BraKet_Bloch.ipynb) (QM Postulates, Bloch), [`Handson4_BlochSphere_DensityMatrix.ipynb`](https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson4_BlochSphere_DensityMatrix.ipynb) (Bloch Sphere, Density Matrix), [`Handson5_Purity_Coherence_Entanglement.ipynb`](https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson5_Purity_Coherence_Entanglement.ipynb) (Purity, Coherence, Entanglement)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundations["Physics Foundations"]
  node_lab1["Double Slit, Stern-Gerlach"]
  node_lab3["QM Postulates, Bloch"]
  node_lab4["Bloch Sphere, Density Matrix"]
  node_lab5["Purity, Coherence, Entanglement"]
  node_lab6["Noise, Information Measures"]
end

subgraph group_tools["Quantum Tools"]
  node_lab7["Quantum Gates"]
  node_lab8["Circuits, Entangling Gates, WHT"]
  node_lab9["Qiskit Introduction"]
  node_lab10["PennyLane Introduction"]
  node_lab11["Synthesis, Comparison"]
end

subgraph group_algorithms["Quantum Algorithms"]
  node_lab12["Oracles, Deutsch-Jozsa"]
  node_lab13["Bernstein-Vazirani"]
  node_lab14["Simon's Algorithm"]
  node_lab15["Grover Search"]
end

node_learner(("Learner"))

node_learner -->|"starts learning"| node_lab1
node_lab1 -->|"builds on"| node_lab3
node_lab3 -->|"builds on"| node_lab4
node_lab4 -->|"builds on"| node_lab5
node_lab5 -->|"builds on"| node_lab6
node_lab6 -->|"builds on"| node_lab7
node_lab7 -->|"builds on"| node_lab8
node_lab8 -->|"builds on"| node_lab9
node_lab9 -->|"builds on"| node_lab10
node_lab10 -->|"builds on"| node_lab11
node_lab11 -->|"builds on"| node_lab12
node_lab12 -->|"builds on"| node_lab13
node_lab13 -->|"builds on"| node_lab14
node_lab14 -->|"builds on"| node_lab15

click node_lab1 "https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson1%262_Double_Slit_and_Stern_Gerlach.ipynb"
click node_lab3 "https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson3_QMPostulates_BraKet_Bloch.ipynb"
click node_lab4 "https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson4_BlochSphere_DensityMatrix.ipynb"
click node_lab5 "https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson5_Purity_Coherence_Entanglement.ipynb"
click node_lab6 "https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson6_Noise_and_Information_Measures.ipynb"
click node_lab7 "https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson7_Quantum_Gates_Demo.ipynb"
click node_lab8 "https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson8_QuantumCircuits_EntanglingGates_WHT.ipynb"
click node_lab9 "https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson9_Qiskit_Introduction.ipynb"
click node_lab10 "https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson10_PennyLane_Introduction_Hands_On.ipynb"
click node_lab11 "https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson11_Qiskit_PennyLane_Synthesis_and_Comparison.ipynb"
click node_lab12 "https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson12_Qiskit_Oracles_Primitives_DJ.ipynb"
click node_lab13 "https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson13_Bernstein_Vazirani_Qiskit.ipynb"
click node_lab14 "https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson14_Simons_Algorithm_Qiskit.ipynb"
click node_lab15 "https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson15_Grover_Qiskit.ipynb"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_lab1,node_lab3,node_lab4,node_lab5,node_lab6 toneBlue
class node_lab7,node_lab8,node_lab9,node_lab10,node_lab11 toneAmber
class node_lab12,node_lab13,node_lab14,node_lab15 toneMint
class node_learner toneIndigo
```

## Components

### Physics Foundations

- [Double Slit, Stern-Gerlach](https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson1%262_Double_Slit_and_Stern_Gerlach.ipynb): `Handson1&2_Double_Slit_and_Stern_Gerlach.ipynb`
- [QM Postulates, Bloch](https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson3_QMPostulates_BraKet_Bloch.ipynb): `Handson3_QMPostulates_BraKet_Bloch.ipynb`
- [Bloch Sphere, Density Matrix](https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson4_BlochSphere_DensityMatrix.ipynb): `Handson4_BlochSphere_DensityMatrix.ipynb`
- [Purity, Coherence, Entanglement](https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson5_Purity_Coherence_Entanglement.ipynb): `Handson5_Purity_Coherence_Entanglement.ipynb`
- [Noise, Information Measures](https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson6_Noise_and_Information_Measures.ipynb): `Handson6_Noise_and_Information_Measures.ipynb`

### Quantum Tools

- [Quantum Gates](https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson7_Quantum_Gates_Demo.ipynb): `Handson7_Quantum_Gates_Demo.ipynb`
- [Circuits, Entangling Gates, WHT](https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson8_QuantumCircuits_EntanglingGates_WHT.ipynb): `Handson8_QuantumCircuits_EntanglingGates_WHT.ipynb`
- [Qiskit Introduction](https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson9_Qiskit_Introduction.ipynb): `Handson9_Qiskit_Introduction.ipynb`
- [PennyLane Introduction](https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson10_PennyLane_Introduction_Hands_On.ipynb): `Handson10_PennyLane_Introduction_Hands_On.ipynb`
- [Synthesis, Comparison](https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson11_Qiskit_PennyLane_Synthesis_and_Comparison.ipynb): `Handson11_Qiskit_PennyLane_Synthesis_and_Comparison.ipynb`

### Quantum Algorithms

- [Oracles, Deutsch-Jozsa](https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson12_Qiskit_Oracles_Primitives_DJ.ipynb): `Handson12_Qiskit_Oracles_Primitives_DJ.ipynb`
- [Bernstein-Vazirani](https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson13_Bernstein_Vazirani_Qiskit.ipynb): `Handson13_Bernstein_Vazirani_Qiskit.ipynb`
- [Simon's Algorithm](https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson14_Simons_Algorithm_Qiskit.ipynb): `Handson14_Simons_Algorithm_Qiskit.ipynb`
- [Grover Search](https://github.com/trinexis-quantum/quantum-concepts/blob/main/Handson15_Grover_Qiskit.ipynb): `Handson15_Grover_Qiskit.ipynb`

### Other components

- **Learner**

## Connections

- Learner → Double Slit, Stern-Gerlach: starts learning (evidence: `README.md`)
- Double Slit, Stern-Gerlach → QM Postulates, Bloch: builds on (evidence: `README.md`)
- QM Postulates, Bloch → Bloch Sphere, Density Matrix: builds on (evidence: `README.md`)
- Bloch Sphere, Density Matrix → Purity, Coherence, Entanglement: builds on (evidence: `README.md`)
- Purity, Coherence, Entanglement → Noise, Information Measures: builds on (evidence: `README.md`)
- Noise, Information Measures → Quantum Gates: builds on (evidence: `README.md`)
- Quantum Gates → Circuits, Entangling Gates, WHT: builds on (evidence: `README.md`)
- Circuits, Entangling Gates, WHT → Qiskit Introduction: builds on (evidence: `README.md`)
- Qiskit Introduction → PennyLane Introduction: builds on (evidence: `README.md`)
- PennyLane Introduction → Synthesis, Comparison: builds on (evidence: `README.md`)
- Synthesis, Comparison → Oracles, Deutsch-Jozsa: builds on (evidence: `README.md`)
- Oracles, Deutsch-Jozsa → Bernstein-Vazirani: builds on (evidence: `README.md`)
- Bernstein-Vazirani → Simon's Algorithm: builds on (evidence: `README.md`)
- Simon's Algorithm → Grover Search: builds on (evidence: `README.md`)
