Skip to content

Quantum Equilibria API

The public surface separates the compact statevector circuit, external circuit adapter, image reducer, equilibrium model, and result object. The derivation and source-scale protocol are in Quantum Equilibria.

silva_networks.quantum_equilibria

Quantum-circuit transitions solved as SILVA equilibria.

The architecture follows Schleich et al., "Quantum Deep Equilibrium Models" (NeurIPS 2024): image features are injected into a quantum-circuit transition, the measured state is solved implicitly or by finite tied steps, and a classical readout produces task outputs. A compact statevector circuit keeps small experiments executable; any shape-compatible circuit module can replace it.

SILVAStatevectorQuantumCircuit

Bases: Module

Small differentiable circuit matching the QDEQ transition contract.

The default uses amplitude encoding, a deterministic fixed circuit, the source trainable RX/RY/RZ/CRX pattern, fixed H/SX/CNOT gates, Pauli-Z measurements, and interpolation back to output_dim features.

SILVAQuantumCircuitAdapter

Bases: Module

Validate an external circuit module against the SILVA state contract.

SILVAQuantumImageFilter

Bases: Module

Source-aligned grayscale image reduction to n_qubits**2 features.

SILVAQuantumDEQOutput dataclass

Task prediction, measured equilibrium state, and solver diagnostics.

SILVAQuantumDEQ

Bases: Module

Quantum-circuit equilibrium with direct, warmup, and implicit execution.

Where to Go Next

Question Page
How is the circuit transition derived? Quantum Equilibria
How is the source architecture reconstructed? Source Architecture Mapping
Where is it executed end to end? QDEQ Lab