Struct QuantumDebugger 

pub struct QuantumDebugger<const N: usize> { /* private fields */ }

Main quantum algorithm debugger

Implementations

impl<const N: usize> QuantumDebugger<N>

pub fn new(config: DebugConfig) -> Result<Self>

Create a new quantum debugger

pub fn load_circuit(&mut self, circuit: Circuit<N>) -> Result<()>

Load a circuit for debugging

pub fn reset(&mut self)

Reset debugger state

pub fn add_breakpoint(&mut self, condition: BreakCondition)

Add a breakpoint

pub fn remove_breakpoint(&mut self, index: usize) -> Result<()>

Remove a breakpoint

pub fn add_watchpoint(&mut self, watchpoint: Watchpoint)

Add a watchpoint

pub fn remove_watchpoint(&mut self, id: &str) -> Result<()>

Remove a watchpoint

pub fn step(&mut self) -> Result<StepResult>

Execute the circuit step by step

pub fn run(&mut self) -> Result<StepResult>

Run until next breakpoint or completion

pub fn get_current_state(&self) -> Result<Array1<Complex64>>

Get current quantum state

Returns the full 2^N amplitude vector after the gates that have been executed so far (self.current_gate gates from the loaded circuit).

The state is reconstructed by replaying the executed prefix of the circuit through the embedded StateVectorSimulator. This always reflects the real amplitudes; if no circuit is loaded, the simulator is in the initial |0…0⟩ state, which is returned as a genuine state vector (amplitude 1 on the zero basis state) rather than a fabricated all-zero vector.

pub fn get_entanglement_entropy(&self, cut: usize) -> Result<f64>

Get entanglement entropy at the specified bipartition cut.

The cut splits the qubits into two contiguous groups; cut is the number of qubits on one side of the partition. The von Neumann entropy (in nats, consistent with the MPS path) of the reduced density matrix is returned.

Both the state-vector and MPS backends are handled through Self::get_current_state, which yields the genuine amplitudes for the current step (the MPS backend is contracted to a state vector via its to_statevector method). This computes the real entropy in every case rather than returning a placeholder.

pub fn get_pauli_expectation(&self, pauli_string: &str) -> Result<Complex64>

Get expectation value of Pauli observable

pub const fn get_metrics(&self) -> &PerformanceMetrics

Get performance metrics

pub const fn get_snapshots(&self) -> &VecDeque<ExecutionSnapshot>

Get all snapshots

pub fn get_watchpoint(&self, id: &str) -> Option<&Watchpoint>

Get watchpoint by ID

pub const fn get_watchpoints(&self) -> &HashMap<String, Watchpoint>

Get all watchpoints

pub const fn is_finished(&self) -> bool

Check if execution is finished

pub const fn is_paused(&self) -> bool

Check if execution is paused

pub const fn get_execution_state(&self) -> &ExecutionState

Get current execution state

pub fn generate_report(&self) -> DebugReport

Generate debugging report