Struct IsingModel 

pub struct IsingModel {
    pub num_qubits: usize,
    /* private fields */
}

Represents an Ising model for quantum annealing

The Ising model is defined by: H = Σ h_i σ_i^z + Σ J_ij σ_i^z σ_j^z

where:

• h_i are the local fields (biases)
• J_ij are the coupling strengths
• σ_i^z are the Pauli Z operators

Fields

num_qubits: usize

Number of qubits/spins in the model

Implementations

impl IsingModel

pub fn new(num_qubits: usize) -> IsingModel

Create a new empty Ising model with the specified number of qubits

pub fn set_bias(&mut self, qubit: usize, bias: f64) -> Result<(), IsingError>

Set the bias (h_i) for a specific qubit

pub fn get_bias(&self, qubit: usize) -> Result<f64, IsingError>

Get the bias (h_i) for a specific qubit

pub fn set_coupling( &mut self, i: usize, j: usize, strength: f64, ) -> Result<(), IsingError>

Set the coupling strength (J_ij) between two qubits

pub fn get_coupling(&self, i: usize, j: usize) -> Result<f64, IsingError>

Get the coupling strength (J_ij) between two qubits

pub fn biases(&self) -> Vec<(usize, f64)>

Get all non-zero biases

pub fn couplings(&self) -> Vec<Coupling>

Get all non-zero couplings

pub fn energy(&self, spins: &[i8]) -> Result<f64, IsingError>

Calculate the energy of a specific spin configuration

The energy is calculated as: E = Σ h_i s_i + Σ J_ij s_i s_j

where s_i ∈ {-1, +1} are the spin values

pub fn to_qubo(&self) -> QuboModel

Convert the Ising model to QUBO format

The QUBO form is: E = Σ Q_ii x_i + Σ Q_ij x_i x_j

where x_i ∈ {0, 1} are binary variables

pub fn from_qubo(qubo: &QuboModel) -> IsingModel

Create an Ising model from a QUBO model

Trait Implementations

impl Clone for IsingModel

fn clone(&self) -> IsingModel

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IsingModel

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

Formats the value using the given formatter.

impl Default for IsingModel

Default implementation for IsingModel creates an empty model with 0 qubits

fn default() -> IsingModel

Returns the “default value” for a type.