# kyaw-min-lwin/quantum-computing- architecture

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

- Interactive diagram: https://gitdiagram.com/kyaw-min-lwin/quantum-computing-
- Repository: https://github.com/kyaw-min-lwin/quantum-computing-

## Overview

This is a small, learning-oriented quantum computing repository, not a production quantum platform. Its current workflow is to predict a one-qubit result, run the NumPy reference simulator, inspect amplitudes and probabilities, explain the result, and add a test. The graph includes the documented learning materials and the simulator’s main internal responsibilities. Relationships among unsampled learning documents are limited to those stated in the README.

Main entry points: [`labs/lab01_qubit.py`](https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/labs/lab01_qubit.py) (Lab entry point), [`exercises/lab01.md`](https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/exercises/lab01.md) (Practice exercises), [`notes/01_foundations.md`](https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/notes/01_foundations.md) (Foundations notes), [`PROGRESS.md`](https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/PROGRESS.md) (Learning progress)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning materials"]
  node_practice["Practice exercises<br/>[lab01.md]"]
  node_foundations["Foundations notes<br/>[01_foundations.md]"]
  node_progress["Learning progress<br/>[PROGRESS.md]"]
end

subgraph group_simulator["Qubit simulator"]
  node_lab["Lab entry point<br/>[lab01_qubit.py]"]
  node_state_checks["State validation<br/>[lab01_qubit.py]"]
  node_state_prep["State preparation<br/>[lab01_qubit.py]"]
  node_gate_ops["Gate operations<br/>[lab01_qubit.py]"]
  node_probabilities["Probability calculation<br/>[lab01_qubit.py]"]
  node_results["Printed results<br/>[lab01_qubit.py]"]
end

node_learner(("Learner"))

node_learner -->|"predict with"| node_practice
node_learner -->|"run experiment"| node_lab
node_learner -->|"study concepts"| node_foundations
node_learner -->|"track learning"| node_progress
node_lab -->|"calls normalize"| node_state_prep
node_lab -->|"calls gate checks"| node_gate_ops
node_lab -->|"applies gates"| node_gate_ops
node_lab -->|"calculates probabilities"| node_probabilities
node_lab -->|"prints"| node_results
node_state_checks -->|"validates input"| node_state_prep
node_state_checks -->|"validates state"| node_probabilities
node_state_checks -->|"checks gate"| node_gate_ops
node_gate_ops -->|"validates state"| node_state_checks

click node_practice "https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/exercises/lab01.md"
click node_foundations "https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/notes/01_foundations.md"
click node_progress "https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/PROGRESS.md"
click node_lab "https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/labs/lab01_qubit.py"
click node_state_checks "https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/labs/lab01_qubit.py"
click node_state_prep "https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/labs/lab01_qubit.py"
click node_gate_ops "https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/labs/lab01_qubit.py"
click node_probabilities "https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/labs/lab01_qubit.py"
click node_results "https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/labs/lab01_qubit.py"

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_practice,node_foundations,node_progress toneBlue
class node_lab,node_state_checks,node_state_prep,node_gate_ops,node_probabilities,node_results toneAmber
class node_learner toneIndigo
```

## Components

### Learning materials

- [Practice exercises](https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/exercises/lab01.md): `exercises/lab01.md`
- [Foundations notes](https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/notes/01_foundations.md): `notes/01_foundations.md`
- [Learning progress](https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/PROGRESS.md): `PROGRESS.md`

### Qubit simulator

- [Lab entry point](https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/labs/lab01_qubit.py): `labs/lab01_qubit.py`
- [State validation](https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/labs/lab01_qubit.py): `labs/lab01_qubit.py`
- [State preparation](https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/labs/lab01_qubit.py): `labs/lab01_qubit.py`
- [Gate operations](https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/labs/lab01_qubit.py): `labs/lab01_qubit.py`
- [Probability calculation](https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/labs/lab01_qubit.py): `labs/lab01_qubit.py`
- [Printed results](https://github.com/kyaw-min-lwin/quantum-computing-/blob/main/labs/lab01_qubit.py): `labs/lab01_qubit.py`

### Other components

- **Learner**

## Connections

- Learner → Practice exercises: predict with (evidence: `README.md`)
- Learner → Lab entry point: run experiment (evidence: `README.md`)
- Learner → Foundations notes: study concepts (evidence: `README.md`)
- Learner → Learning progress: track learning (evidence: `README.md`)
- Lab entry point → State preparation: calls normalize (evidence: `labs/lab01_qubit.py`)
- Lab entry point → Gate operations: calls gate checks (evidence: `labs/lab01_qubit.py`)
- Lab entry point → Gate operations: applies gates (evidence: `labs/lab01_qubit.py`)
- Lab entry point → Probability calculation: calculates probabilities (evidence: `labs/lab01_qubit.py`)
- Lab entry point → Printed results: prints (evidence: `README.md`)
- State validation → State preparation: validates input (evidence: `labs/lab01_qubit.py`)
- State validation → Probability calculation: validates state (evidence: `labs/lab01_qubit.py`)
- State validation → Gate operations: checks gate (evidence: `labs/lab01_qubit.py`)
- Gate operations → State validation: validates state (evidence: `labs/lab01_qubit.py`)
