Struct TQTensorNetworkBackend 

pub struct TQTensorNetworkBackend {
    pub mps: Option<MatrixProductState>,
    pub n_wires: usize,
    pub config: TensorNetworkConfig,
    pub static_mode: bool,
    pub gate_cache: HashMap<String, Array2<CType>>,
}

TorchQuantum Tensor Network Backend

Provides MPS/PEPS simulation backend for TorchQuantum circuits.

Fields

mps: Option<MatrixProductState>

MPS representation of the state

n_wires: usize

Number of qubits

config: TensorNetworkConfig

Configuration

static_mode: bool

Static mode flag

gate_cache: HashMap<String, Array2<CType>>

Gate cache for static mode

Implementations

impl TQTensorNetworkBackend

pub fn new(n_wires: usize) -> Self

Create new tensor network backend

pub fn with_config(n_wires: usize, config: TensorNetworkConfig) -> Self

Create with custom configuration

pub fn reset(&mut self)

Reset to |0…0> state

pub fn apply_gate(&mut self, site: usize, gate: &Array2<CType>) -> Result<()>

Apply single-qubit gate

pub fn apply_two_qubit_gate( &mut self, site1: usize, site2: usize, gate: &Array2<CType>, ) -> Result<()>

Apply two-qubit gate

pub fn get_state_vector(&self) -> Result<Vec<CType>>

Get state vector (contracts MPS)

pub fn expectation_value( &self, observable: &Array2<CType>, sites: &[usize], ) -> Result<f64>

Get expectation value of observable

pub fn bond_dimension(&self) -> usize

Get current bond dimension

pub fn to_tq_device(&self) -> Result<TQDevice>

Convert to TQDevice for compatibility

pub fn from_tq_device(qdev: &TQDevice) -> Result<Self>

Create from TQDevice

Trait Implementations

impl Clone for TQTensorNetworkBackend

fn clone(&self) -> TQTensorNetworkBackend

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TQTensorNetworkBackend

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl TQModule for TQTensorNetworkBackend

fn forward(&mut self, _qdev: &mut TQDevice) -> Result<()>

Execute the forward pass on the quantum device

fn parameters(&self) -> Vec<TQParameter>

Get all trainable parameters

fn n_wires(&self) -> Option<usize>

Get number of wires this module operates on

fn set_n_wires(&mut self, n_wires: usize)

Set number of wires

fn is_static_mode(&self) -> bool

Check if module is in static mode

fn static_on(&mut self)

Enable static mode for graph optimization

fn static_off(&mut self)

Disable static mode

fn name(&self) -> &str

Module name for debugging

fn forward_with_input( &mut self, qdev: &mut TQDevice, _x: Option<&Array2<f64>>, ) -> Result<()>

Execute forward pass with optional input data (for encoders)

fn get_unitary(&self) -> Option<Array2<CType>>

Get the unitary matrix representation (if available)

fn zero_grad(&mut self)

Zero gradients of all parameters

fn train(&mut self, _mode: bool)

Set training mode

fn training(&self) -> bool

Check if in training mode