# owlmt/qml architecture

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

- Interactive diagram: https://gitdiagram.com/owlmt/qml
- Repository: https://github.com/owlmt/qml

## Overview

This repository is a teaching collection of quantum machine-learning paper implementations. Its documented workflow is to run a paper notebook, obtain and preprocess its data, train a quantum model alongside classical baselines, and compare the results with the paper. The only implemented paper shown is Said’s DDoS-detection experiment. The notebook’s internal wiring is not available for inspection, so the graph reflects only the README’s documented stages and capabilities.

Main entry points: [`papers/2023_Said_QSVM_DDoS/QSVM_DDoS_Said2023.ipynb`](https://github.com/owlmt/qml/blob/main/papers/2023_Said_QSVM_DDoS/QSVM_DDoS_Said2023.ipynb) (Said DDoS notebook)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Data preparation"]
  node_traffic[("CICDDoS2019 traffic")]
  node_prep["Data preprocessing"]
end

subgraph group_models["Model training"]
  node_qsvm["ZZ-kernel QSVM"]
  node_classical["Linear and RBF SVMs"]
end

subgraph group_evaluation["Evaluation and teaching"]
  node_notebook["Said DDoS notebook"]
  node_comparison["Results and paper comparison"]
end

node_student(("Student or runner"))

node_student -->|"runs"| node_notebook
node_notebook -->|"downloads"| node_traffic
node_notebook -->|"performs"| node_prep
node_prep -->|"provides inputs"| node_qsvm
node_prep -->|"provides same inputs"| node_classical
node_notebook -->|"documents results"| node_comparison
node_qsvm -->|"contributes results"| node_comparison
node_classical -->|"contributes results"| node_comparison

click node_notebook "https://github.com/owlmt/qml/blob/main/papers/2023_Said_QSVM_DDoS/QSVM_DDoS_Said2023.ipynb"
click node_prep "https://github.com/owlmt/qml/blob/main/papers/2023_Said_QSVM_DDoS/QSVM_DDoS_Said2023.ipynb"
click node_qsvm "https://github.com/owlmt/qml/blob/main/papers/2023_Said_QSVM_DDoS/QSVM_DDoS_Said2023.ipynb"
click node_classical "https://github.com/owlmt/qml/blob/main/papers/2023_Said_QSVM_DDoS/QSVM_DDoS_Said2023.ipynb"
click node_comparison "https://github.com/owlmt/qml/blob/main/papers/2023_Said_QSVM_DDoS/QSVM_DDoS_Said2023.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_traffic,node_prep toneBlue
class node_qsvm,node_classical toneAmber
class node_notebook,node_comparison toneMint
class node_student toneIndigo
```

## Components

### Data preparation

- **CICDDoS2019 traffic**
- [Data preprocessing](https://github.com/owlmt/qml/blob/main/papers/2023_Said_QSVM_DDoS/QSVM_DDoS_Said2023.ipynb): `papers/2023_Said_QSVM_DDoS/QSVM_DDoS_Said2023.ipynb`

### Model training

- [ZZ-kernel QSVM](https://github.com/owlmt/qml/blob/main/papers/2023_Said_QSVM_DDoS/QSVM_DDoS_Said2023.ipynb): `papers/2023_Said_QSVM_DDoS/QSVM_DDoS_Said2023.ipynb`
- [Linear and RBF SVMs](https://github.com/owlmt/qml/blob/main/papers/2023_Said_QSVM_DDoS/QSVM_DDoS_Said2023.ipynb): `papers/2023_Said_QSVM_DDoS/QSVM_DDoS_Said2023.ipynb`

### Evaluation and teaching

- [Said DDoS notebook](https://github.com/owlmt/qml/blob/main/papers/2023_Said_QSVM_DDoS/QSVM_DDoS_Said2023.ipynb): `papers/2023_Said_QSVM_DDoS/QSVM_DDoS_Said2023.ipynb`
- [Results and paper comparison](https://github.com/owlmt/qml/blob/main/papers/2023_Said_QSVM_DDoS/QSVM_DDoS_Said2023.ipynb): `papers/2023_Said_QSVM_DDoS/QSVM_DDoS_Said2023.ipynb`

### Other components

- **Student or runner**

## Connections

- Student or runner → Said DDoS notebook: runs
- Said DDoS notebook → CICDDoS2019 traffic: downloads
- Said DDoS notebook → Data preprocessing: performs
- Data preprocessing → ZZ-kernel QSVM: provides inputs
- Data preprocessing → Linear and RBF SVMs: provides same inputs
- Said DDoS notebook → Results and paper comparison: documents results
- ZZ-kernel QSVM → Results and paper comparison: contributes results
- Linear and RBF SVMs → Results and paper comparison: contributes results