QSBench commited on
Commit
ab598e2
·
verified ·
1 Parent(s): 1971b4a

Update GUIDE.md

Browse files
Files changed (1) hide show
  1. GUIDE.md +22 -0
GUIDE.md CHANGED
@@ -59,6 +59,9 @@ In QML, the **structure ("shape") of a circuit directly impacts performance**.
59
  The most critical complexity metric.
60
  On NISQ devices, CNOT gates are **10x–100x noisier** than single-qubit gates.
61
 
 
 
 
62
  ---
63
 
64
  ## 🎯 3. Multi-Target Regression (The Bloch Vector)
@@ -67,6 +70,15 @@ Unlike traditional benchmarks that focus on a single observable, QSBench targets
67
 
68
  [⟨X⟩global, ⟨Y⟩global, ⟨Z⟩global]
69
 
 
 
 
 
 
 
 
 
 
70
  ---
71
 
72
  ### Why predict all three?
@@ -109,6 +121,16 @@ The Hub uses a **Random Forest Regressor** to establish a baseline of predictabi
109
  - X/Y depend more on circuit structure
110
  - reveals architectural biases (HEA vs QFT, etc.)
111
 
 
 
 
 
 
 
 
 
 
 
112
  ---
113
 
114
  ## 🔗 5. Project Resources
 
59
  The most critical complexity metric.
60
  On NISQ devices, CNOT gates are **10x–100x noisier** than single-qubit gates.
61
 
62
+ **Note on Feature Correlation:** While structural metrics (like `gate_entropy` or `depth`) describe the complexity of the circuit, they do not encode the specific rotation angles of individual gates.
63
+ Therefore, predicting the exact expectation value using only structural features is an **extremely challenging task** (Non-Trivial Mapping).
64
+
65
  ---
66
 
67
  ## 🎯 3. Multi-Target Regression (The Bloch Vector)
 
70
 
71
  [⟨X⟩global, ⟨Y⟩global, ⟨Z⟩global]
72
 
73
+ ```text
74
+ | +Z (0)
75
+ |
76
+ -----|---- +Y
77
+ /|
78
+ / | -Z (1)
79
+ +X
80
+ ```
81
+
82
  ---
83
 
84
  ### Why predict all three?
 
121
  - X/Y depend more on circuit structure
122
  - reveals architectural biases (HEA vs QFT, etc.)
123
 
124
+ 📉 **How to Interpret "Bad" Metrics?**
125
+
126
+ If you see a **negative** R2 or clustering around zero, don't panic. This is the expected behavior for standard regression on quantum data:
127
+
128
+ - **Mean Predictor Baseline:** In complex circuits (n=8, depth=6), expectation values naturally concentrate around 0. A model that simply predicts "0" for everything will have a low MAE but a zero/negative R2.
129
+
130
+ - **The Complexity Gap:** A negative R2 proves that the relationship between circuit shape and quantum output is highly non-linear.
131
+
132
+ - **Research Challenge:** Use these baseline results to justify the need for more advanced architectures like **Graph Neural Networks (GNNs)** or **Recursive Quantum Filters** that can process the gate sequence itself.
133
+
134
  ---
135
 
136
  ## 🔗 5. Project Resources