# mirandacarou/qutrits-for-physics-at-lhc architecture

> Architecture diagram of the GitHub repository mirandacarou/qutrits-for-physics-at-lhc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mirandacarou/qutrits-for-physics-at-lhc
- Repository: https://github.com/mirandacarou/qutrits-for-physics-at-lhc

## Overview

This research repository investigates qutrit-based quantum-machine-learning anomaly detection for LHC physics, with qubit models as a benchmark. Its intended workflow is event-data preparation, model evaluation, and statistical comparison. The tree exposes ROOT/HDF5 conversion scripts and Qutrit/Qubit experiment scripts, plus an analysis notebook and saved datasets/plots. Most experiment code was not sampled, so those stages and their connections are represented at directory level and are unverified; the diagram does not claim a directly wired runtime pipeline.

Main entry points: [`Project/Analisys_and_Stadistics/npz`](https://github.com/mirandacarou/qutrits-for-physics-at-lhc/tree/main/Project/Analisys_and_Stadistics/npz) (Experiment results), [`Project/HPC_Testing_Scripts/Conversion_to_json/from_h5_to_json.py`](https://github.com/mirandacarou/qutrits-for-physics-at-lhc/blob/main/Project/HPC_Testing_Scripts/Conversion_to_json/from_h5_to_json.py) (HDF5 conversion), [`Project/HPC_Testing_Scripts/Conversion_to_json/from_root_to_json.py`](https://github.com/mirandacarou/qutrits-for-physics-at-lhc/blob/main/Project/HPC_Testing_Scripts/Conversion_to_json/from_root_to_json.py) (ROOT conversion), [`Project/HPC_Testing_Scripts/Test/Qutrits`](https://github.com/mirandacarou/qutrits-for-physics-at-lhc/tree/main/Project/HPC_Testing_Scripts/Test/Qutrits) (Qutrit models)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_prep["Data preparation"]
  node_converters["Format converters"]
  node_h5convert["HDF5 conversion<br/>[from_h5_to_json.py]"]
  node_rootconvert["ROOT conversion"]
  node_prepared["Prepared events"]
end

subgraph group_models["Model experiments"]
  node_experiments["HPC experiments"]
  node_qutrit["Qutrit models"]
  node_qubit["Qubit benchmark"]
end

subgraph group_analysis["Analysis"]
  node_results["Experiment results"]
  node_analysisnotebook["Statistical analysis<br/>[Plots.ipynb]"]
  node_plots["Comparison plots"]
end

node_researcher(("Researcher"))
node_lhcdata["LHC event data"]

node_researcher -.->|"selects events"| node_lhcdata
node_lhcdata -.->|"reads HDF5"| node_h5convert
node_lhcdata -.->|"reads ROOT"| node_rootconvert
node_h5convert -.->|"writes JSON"| node_prepared
node_rootconvert -.->|"writes JSON"| node_prepared
node_prepared -.->|"evaluates"| node_qutrit
node_prepared -.->|"evaluates"| node_qubit
node_qutrit -.->|"records metrics"| node_results
node_qubit -.->|"records metrics"| node_results
node_results -.->|"compares results"| node_analysisnotebook
node_analysisnotebook -.->|"produces plots"| node_plots

click node_converters "https://github.com/mirandacarou/qutrits-for-physics-at-lhc/tree/main/Project/HPC_Testing_Scripts/Conversion_to_json"
click node_h5convert "https://github.com/mirandacarou/qutrits-for-physics-at-lhc/blob/main/Project/HPC_Testing_Scripts/Conversion_to_json/from_h5_to_json.py"
click node_rootconvert "https://github.com/mirandacarou/qutrits-for-physics-at-lhc/blob/main/Project/HPC_Testing_Scripts/Conversion_to_json/from_root_to_json.py"
click node_experiments "https://github.com/mirandacarou/qutrits-for-physics-at-lhc/tree/main/Project/HPC_Testing_Scripts/Test"
click node_qutrit "https://github.com/mirandacarou/qutrits-for-physics-at-lhc/tree/main/Project/HPC_Testing_Scripts/Test/Qutrits"
click node_qubit "https://github.com/mirandacarou/qutrits-for-physics-at-lhc/tree/main/Project/HPC_Testing_Scripts/Test/Qubits"
click node_results "https://github.com/mirandacarou/qutrits-for-physics-at-lhc/tree/main/Project/Analisys_and_Stadistics/npz"
click node_analysisnotebook "https://github.com/mirandacarou/qutrits-for-physics-at-lhc/blob/main/Project/Analisys_and_Stadistics/Plots.ipynb"
click node_plots "https://github.com/mirandacarou/qutrits-for-physics-at-lhc/tree/main/Project/Analisys_and_Stadistics/Plots"

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_converters,node_h5convert,node_rootconvert,node_prepared toneBlue
class node_experiments,node_qutrit,node_qubit toneAmber
class node_results,node_analysisnotebook,node_plots toneMint
class node_researcher,node_lhcdata toneIndigo
```

## Components

### Data preparation

- [Format converters](https://github.com/mirandacarou/qutrits-for-physics-at-lhc/tree/main/Project/HPC_Testing_Scripts/Conversion_to_json): `Project/HPC_Testing_Scripts/Conversion_to_json`
- [HDF5 conversion](https://github.com/mirandacarou/qutrits-for-physics-at-lhc/blob/main/Project/HPC_Testing_Scripts/Conversion_to_json/from_h5_to_json.py): `Project/HPC_Testing_Scripts/Conversion_to_json/from_h5_to_json.py`
- [ROOT conversion](https://github.com/mirandacarou/qutrits-for-physics-at-lhc/blob/main/Project/HPC_Testing_Scripts/Conversion_to_json/from_root_to_json.py): `Project/HPC_Testing_Scripts/Conversion_to_json/from_root_to_json.py`
- **Prepared events**

### Model experiments

- [HPC experiments](https://github.com/mirandacarou/qutrits-for-physics-at-lhc/tree/main/Project/HPC_Testing_Scripts/Test): `Project/HPC_Testing_Scripts/Test`
- [Qutrit models](https://github.com/mirandacarou/qutrits-for-physics-at-lhc/tree/main/Project/HPC_Testing_Scripts/Test/Qutrits): `Project/HPC_Testing_Scripts/Test/Qutrits`
- [Qubit benchmark](https://github.com/mirandacarou/qutrits-for-physics-at-lhc/tree/main/Project/HPC_Testing_Scripts/Test/Qubits): `Project/HPC_Testing_Scripts/Test/Qubits`

### Analysis

- [Experiment results](https://github.com/mirandacarou/qutrits-for-physics-at-lhc/tree/main/Project/Analisys_and_Stadistics/npz): `Project/Analisys_and_Stadistics/npz`
- [Statistical analysis](https://github.com/mirandacarou/qutrits-for-physics-at-lhc/blob/main/Project/Analisys_and_Stadistics/Plots.ipynb): `Project/Analisys_and_Stadistics/Plots.ipynb`
- [Comparison plots](https://github.com/mirandacarou/qutrits-for-physics-at-lhc/tree/main/Project/Analisys_and_Stadistics/Plots): `Project/Analisys_and_Stadistics/Plots`

### Other components

- **Researcher**
- **LHC event data**

## Connections

- Researcher → LHC event data: selects events
- LHC event data → HDF5 conversion: reads HDF5
- LHC event data → ROOT conversion: reads ROOT
- HDF5 conversion → Prepared events: writes JSON
- ROOT conversion → Prepared events: writes JSON
- Prepared events → Qutrit models: evaluates
- Prepared events → Qubit benchmark: evaluates
- Qutrit models → Experiment results: records metrics
- Qubit benchmark → Experiment results: records metrics
- Experiment results → Statistical analysis: compares results
- Statistical analysis → Comparison plots: produces plots
