# poig/self-research architecture

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

- Interactive diagram: https://gitdiagram.com/poig/self-research
- Repository: https://github.com/poig/self-research

## Overview

This repository collects independent quantum-computing research projects. Its stated current work is the QLTO device-calibration line: a researcher works with QLTO’s variational circuits and calibration methods, which execute through a quantum backend. Other substantial branches cover QLTO algorithm variants, Feigenbaum experiments, thermodynamic and symmetry investigations, and quantum differential-equation work. The tree and excerpts support only a few dependency edges; unsampled project details and relationships are left unspecified.

Main entry points: [`Quantum_AI/QLTO/Application/nisq_v6.py`](https://github.com/poig/self-research/blob/main/Quantum_AI/QLTO/Application/nisq_v6.py) (QLTO V6), [`Quantum_AI/QLTO/Application/modules`](https://github.com/poig/self-research/tree/main/Quantum_AI/QLTO/Application/modules) (QLTO variants), [`Quantum_AI/QLTO/theory_test/supplementary/fluctuation_theorems/experiments`](https://github.com/poig/self-research/tree/main/Quantum_AI/QLTO/theory_test/supplementary/fluctuation_theorems/experiments) (Thermodynamic experiments), [`Quantum_AI/QLTO/Application/modules/commute_gradient.py`](https://github.com/poig/self-research/blob/main/Quantum_AI/QLTO/Application/modules/commute_gradient.py) (Gradient and FIM)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_qlto["QLTO application"]
  node_qlto_v6["QLTO V6<br/>[nisq_v6.py]"]
  node_qlto_variants["QLTO variants"]
  node_gradient_fim["Gradient and FIM"]
  node_qml["Supervised QML<br/>[qlto_qml.py]"]
end

subgraph group_feigenbaum["Feigenbaum research"]
  node_feigenbaum_core["Feigenbaum proof"]
  node_feigenbaum_experiments["Feigenbaum experiments"]
end

subgraph group_theory["Theory investigations"]
  node_theory_checks["QLTO theory checks"]
  node_dla_studies["DLA studies"]
  node_thermo_core["Demon engine<br/>[core.py]"]
  node_thermo_experiments["Thermodynamic experiments"]
end

subgraph group_qdf["Quantum differential"]
  node_deq_solver["Quantum DEQ<br/>[quantum_deq.py]"]
  node_deq_helpers["DEQ helpers<br/>[helper.py]"]
  node_differential["Differential calculation<br/>[differential.py]"]
end

node_researcher(("Researcher"))
node_quantum_backend["Quantum backend"]

node_researcher -->|"develops calibration"| node_qlto_v6
node_qlto_v6 -->|"runs circuits"| node_quantum_backend
node_qlto_variants -->|"imports methods"| node_gradient_fim
node_thermo_experiments -->|"imports core"| node_thermo_core

click node_qlto_v6 "https://github.com/poig/self-research/blob/main/Quantum_AI/QLTO/Application/nisq_v6.py"
click node_qlto_variants "https://github.com/poig/self-research/tree/main/Quantum_AI/QLTO/Application/modules"
click node_gradient_fim "https://github.com/poig/self-research/blob/main/Quantum_AI/QLTO/Application/modules/commute_gradient.py"
click node_qml "https://github.com/poig/self-research/blob/main/Quantum_AI/QLTO/Application/modules/qlto_qml.py"
click node_feigenbaum_core "https://github.com/poig/self-research/blob/main/Quantum_AI/QLTO/Feigenbaum/feigenbaum_qiskit_proof.py"
click node_feigenbaum_experiments "https://github.com/poig/self-research/tree/main/Quantum_AI/QLTO/Feigenbaum/experiments"
click node_theory_checks "https://github.com/poig/self-research/tree/main/Quantum_AI/QLTO/theory_test"
click node_dla_studies "https://github.com/poig/self-research/tree/main/Quantum_AI/QLTO/theory_test/supplementary"
click node_thermo_core "https://github.com/poig/self-research/blob/main/Quantum_AI/QLTO/theory_test/supplementary/fluctuation_theorems/experiments/core.py"
click node_thermo_experiments "https://github.com/poig/self-research/tree/main/Quantum_AI/QLTO/theory_test/supplementary/fluctuation_theorems/experiments"
click node_deq_solver "https://github.com/poig/self-research/blob/main/Quantum_df/quantum_deq.py"
click node_deq_helpers "https://github.com/poig/self-research/blob/main/Quantum_df/helper.py"
click node_differential "https://github.com/poig/self-research/blob/main/Quantum_df/differential.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_qlto_v6,node_qlto_variants,node_gradient_fim,node_qml toneBlue
class node_feigenbaum_core,node_feigenbaum_experiments toneAmber
class node_theory_checks,node_dla_studies,node_thermo_core,node_thermo_experiments toneMint
class node_deq_solver,node_deq_helpers,node_differential toneRose
class node_researcher,node_quantum_backend toneIndigo
```

## Components

### QLTO application

- [QLTO V6](https://github.com/poig/self-research/blob/main/Quantum_AI/QLTO/Application/nisq_v6.py): `Quantum_AI/QLTO/Application/nisq_v6.py`
- [QLTO variants](https://github.com/poig/self-research/tree/main/Quantum_AI/QLTO/Application/modules): `Quantum_AI/QLTO/Application/modules`
- [Gradient and FIM](https://github.com/poig/self-research/blob/main/Quantum_AI/QLTO/Application/modules/commute_gradient.py): `Quantum_AI/QLTO/Application/modules/commute_gradient.py`
- [Supervised QML](https://github.com/poig/self-research/blob/main/Quantum_AI/QLTO/Application/modules/qlto_qml.py): `Quantum_AI/QLTO/Application/modules/qlto_qml.py`

### Feigenbaum research

- [Feigenbaum proof](https://github.com/poig/self-research/blob/main/Quantum_AI/QLTO/Feigenbaum/feigenbaum_qiskit_proof.py): `Quantum_AI/QLTO/Feigenbaum/feigenbaum_qiskit_proof.py`
- [Feigenbaum experiments](https://github.com/poig/self-research/tree/main/Quantum_AI/QLTO/Feigenbaum/experiments): `Quantum_AI/QLTO/Feigenbaum/experiments`

### Theory investigations

- [QLTO theory checks](https://github.com/poig/self-research/tree/main/Quantum_AI/QLTO/theory_test): `Quantum_AI/QLTO/theory_test`
- [DLA studies](https://github.com/poig/self-research/tree/main/Quantum_AI/QLTO/theory_test/supplementary): `Quantum_AI/QLTO/theory_test/supplementary`
- [Demon engine](https://github.com/poig/self-research/blob/main/Quantum_AI/QLTO/theory_test/supplementary/fluctuation_theorems/experiments/core.py): `Quantum_AI/QLTO/theory_test/supplementary/fluctuation_theorems/experiments/core.py`
- [Thermodynamic experiments](https://github.com/poig/self-research/tree/main/Quantum_AI/QLTO/theory_test/supplementary/fluctuation_theorems/experiments): `Quantum_AI/QLTO/theory_test/supplementary/fluctuation_theorems/experiments`

### Quantum differential

- [Quantum DEQ](https://github.com/poig/self-research/blob/main/Quantum_df/quantum_deq.py): `Quantum_df/quantum_deq.py`
- [DEQ helpers](https://github.com/poig/self-research/blob/main/Quantum_df/helper.py): `Quantum_df/helper.py`
- [Differential calculation](https://github.com/poig/self-research/blob/main/Quantum_df/differential.py): `Quantum_df/differential.py`

### Other components

- **Researcher**
- **Quantum backend**

## Connections

- Researcher → QLTO V6: develops calibration
- QLTO V6 → Quantum backend: runs circuits (evidence: `Quantum_AI/QLTO/Application/nisq_v6.py`)
- QLTO variants → Gradient and FIM: imports methods (evidence: `Quantum_AI/QLTO/Application/modules/nisq_v2.py`)
- Thermodynamic experiments → Demon engine: imports core (evidence: `Quantum_AI/QLTO/theory_test/supplementary/fluctuation_theorems/experiments/exp02_jarzynski.py`)
