How xenofon-chiotopoulos/onebqf works
OneBQF is a research codebase for quantum-filter-based particle tracking. The documented workflow generates synthetic detector events, constructs a Hamiltonian tracking problem, applies a quantum linear-system algorithm, and evaluates measured solutions; a separate toy workflow aggregates reconstruction metrics. The README also describes circuit-complexity and noisy-hardware fidelity analyses. Notebook internals and unsampled subsystem wiring are not verified, so those connections are shown only where documentation supports them.
Main entry points: example.ipynb Example Workflow · data Experiment Results · plot_fidelity_results.ipynb Fidelity Analysis · HHL.py HHL Solver
Components 19
Event Simulation
- State Event Generator
toy_model/state_event_generator.py - Scattering Generator
toy_model/multi_scattering_generator.py - Event Model
toy_model/state_event_model.py - VELO Workflow
toy_model/velo_workflow.py
Tracking Model
- Hamiltonian API
toy_model/hamiltonian.py - Simple Hamiltonian
toy_model/simple_hamiltonian.py - Track Validator
toy_model/toy_validator.py
Quantum Solvers
- Example Workflow
example.ipynb - HHL Solver
quantum_algorithms/HHL.py - OneBQF Solver
quantum_algorithms/OneBQF.py
Evaluation
- Complexity Analysis
plotting_notebooks/plotting_complexity_figure4.ipynb - Fidelity Analysis
plotting_notebooks/plot_fidelity_results.ipynb - Segment Analysis
plotting_notebooks/plot_segement_analysis.ipynb - Event Display
plotting_notebooks/plot_event_display.ipynb - Experiment Results
data
Other components
- Researcher
- Quantum Simulator
- Quantum Hardware
- Quantinuum Emulators
Connections 22
- Researcher → Example Workflow: runs
- Example Workflow → State Event Generator: generates events
- Example Workflow → Scattering Generator: generates events
- State Event Generator → Event Model: creates records
- Scattering Generator → Event Model: creates records
- VELO Workflow → State Event Generator: generates events
- VELO Workflow → Track Validator: computes metrics
- Example Workflow → Simple Hamiltonian: constructs problem
- Simple Hamiltonian → Hamiltonian API: implements
- Example Workflow → HHL Solver: solves problem
- Example Workflow → OneBQF Solver: solves problem
- HHL Solver → Quantum Simulator: runs circuit
- OneBQF Solver → Quantum Simulator: runs circuit
- HHL Solver → Example Workflow: returns solution
- OneBQF Solver → Example Workflow: returns solution
- Example Workflow → Experiment Results: records results
- Complexity Analysis → Experiment Results: analyzes metrics
- Fidelity Analysis → Experiment Results: analyzes fidelity
- Segment Analysis → Experiment Results: analyzes efficiency
- Event Display → Event Model: visualizes events
- Fidelity Analysis → Quantum Hardware: uses noise models
- Fidelity Analysis → Quantinuum Emulators: compiles and runs