How omkarbihani/quantum-resource-analysis works
This repository is an experimental toolkit for measuring sparse Pauli decompositions of random operators and matrices arising in Max-Cut SDP solvers. The main workflow runs configured experiments, generates operators or graph instances, invokes IPM/ADMM where applicable, measures matrix and decomposition properties, and saves tabular results; notebooks use those results to create analysis figures. The graph separates the three experiment branches and shared numerical utilities. Notebook behavior is documented in the README; unsampled notebook internals are not inferred.
Main entry points: IPM/experiment.py Schur Matrix Experiment · ADMM/experiment.py KKT Matrix Experiment · operator_analysis/experiment.py Random Operator Scan · spd_utils.py Pauli Decomposition
Components 21
Operator Experiments
- Operator Config
operator_analysis/config.py - Operator Runner
operator_analysis/run.py - Random Operator Scan
operator_analysis/experiment.py - Operator CSV Results
operator_analysis/results
IPM Experiments
- IPM Config
IPM/config.py - IPM Runner
IPM/run.py - Schur Matrix Experiment
IPM/experiment.py - Primal-Dual IPM
IPM/ipm.py - IPM CSV Results
IPM/results
ADMM Experiments
- ADMM Config
ADMM/config.py - ADMM Runner
ADMM/run.py - KKT Matrix Experiment
ADMM/experiment.py - ADMM SDP Solver
ADMM/admm.py - ADMM CSV Results
ADMM/results
Shared Utilities
- Graph SDP Helpers
utils/graph_utils.py - Matrix Diagnostics
utils/matrix_metrics.py - Pauli Decomposition
utils/spd_utils.py
Result Analysis
- Operator Analysis
operator_analysis/notebooks - IPM Analysis
IPM/notebooks - ADMM Analysis
ADMM/notebooks
Other components
- Experimenter
Connections 28
- Experimenter → Operator Runner: runs
README.md - Experimenter → IPM Runner: runs
README.md - Experimenter → ADMM Runner: runs
README.md - Operator Runner → Operator Config: loads settings
operator_analysis/run.py - Operator Runner → Random Operator Scan: starts scan
operator_analysis/run.py - Random Operator Scan → Operator Config: uses settings
operator_analysis/experiment.py - Random Operator Scan → Pauli Decomposition: generates and measures
operator_analysis/experiment.py - Random Operator Scan → Operator CSV Results: writes CSV
operator_analysis/experiment.py - IPM Runner → IPM Config: loads settings
IPM/run.py - IPM Runner → Schur Matrix Experiment: starts experiment
IPM/run.py - Schur Matrix Experiment → IPM Config: uses settings
IPM/experiment.py - Schur Matrix Experiment → Graph SDP Helpers: builds Laplacian
IPM/experiment.py - Schur Matrix Experiment → Primal-Dual IPM: solves SDP
IPM/experiment.py - Schur Matrix Experiment → Matrix Diagnostics: measures matrices
IPM/experiment.py - Schur Matrix Experiment → Pauli Decomposition: decomposes matrices
IPM/experiment.py - Schur Matrix Experiment → IPM CSV Results: writes CSV
IPM/experiment.py - ADMM Runner → ADMM Config: loads settings
ADMM/run.py - ADMM Runner → KKT Matrix Experiment: starts experiment
ADMM/run.py - KKT Matrix Experiment → ADMM Config: uses settings
ADMM/experiment.py - KKT Matrix Experiment → Graph SDP Helpers: builds Laplacian
ADMM/experiment.py - KKT Matrix Experiment → ADMM SDP Solver: solves SDP
ADMM/experiment.py - KKT Matrix Experiment → Matrix Diagnostics: measures matrices
ADMM/experiment.py - KKT Matrix Experiment → Pauli Decomposition: decomposes matrices
ADMM/experiment.py - KKT Matrix Experiment → ADMM CSV Results: writes CSV
ADMM/experiment.py - Pauli Decomposition → Matrix Diagnostics: computes condition
utils/spd_utils.py - Operator Analysis → Operator CSV Results: reads results
README.md - IPM Analysis → IPM CSV Results: reads results
README.md - ADMM Analysis → ADMM CSV Results: reads results
README.md