Struct QuboModel 

pub struct QuboModel {
    pub num_variables: usize,
    pub offset: f64,
    /* private fields */
}

Represents a Quadratic Unconstrained Binary Optimization (QUBO) problem

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

where x_i ∈ {0, 1} are binary variables

Fields

num_variables: usize

Number of binary variables in the model

offset: f64

Constant offset term

Implementations

impl QuboModel

pub fn new(num_variables: usize) -> QuboModel

Create a new empty QUBO model with the specified number of variables

pub fn set_linear(&mut self, var: usize, value: f64) -> Result<(), IsingError>

Set the linear coefficient (Q_ii) for a specific variable

pub fn add_linear(&mut self, var: usize, value: f64) -> Result<(), IsingError>

Add to the linear coefficient (Q_ii) for a specific variable

pub fn get_linear(&self, var: usize) -> Result<f64, IsingError>

Get the linear coefficient (Q_ii) for a specific variable

pub fn set_quadratic( &mut self, var1: usize, var2: usize, value: f64, ) -> Result<(), IsingError>

Set the quadratic coefficient (Q_ij) for a pair of variables

pub fn get_quadratic(&self, var1: usize, var2: usize) -> Result<f64, IsingError>

Get the quadratic coefficient (Q_ij) for a pair of variables

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

Get all non-zero linear terms

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

Get all non-zero quadratic terms

pub fn to_dense_matrix(&self) -> ArrayBase<OwnedRepr<f64>, Dim<[usize; 2]>>

Convert to dense QUBO matrix for sampler compatibility

pub fn variable_map(&self) -> HashMap<String, usize>

Create variable name mapping for sampler compatibility

pub fn objective(&self, binary_vars: &[bool]) -> Result<f64, IsingError>

Calculate the objective value for a specific binary configuration

The objective value is calculated as: f(x) = Σ Q_ii x_i + Σ Q_ij x_i x_j + offset

where x_i ∈ {0, 1} are the binary variables

pub fn to_ising(&self) -> (IsingModel, f64)

Convert the QUBO model to Ising form

The Ising form is: H = Σ h_i σ_i^z + Σ J_ij σ_i^z σ_j^z + c

where σ_i^z ∈ {-1, +1} are the spin variables

pub fn to_qubo_model(&self) -> QuboModel

Convert to QUBO model (returns self since this is already a QUBO model)

Trait Implementations

impl Clone for QuboModel

fn clone(&self) -> QuboModel

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QuboModel

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

Formats the value using the given formatter.

impl Default for QuboModel

Default implementation for QuboModel creates an empty model with 0 variables

fn default() -> QuboModel

Returns the “default value” for a type.

impl QuboFormulation for QuboModel

Implementation of QuboFormulation for QuboModel

fn to_qubo(&self) -> Result<(QuboModel, HashMap<String, usize>), QuboError>

Formulate the problem as a QUBO

fn interpret_solution( &self, binary_vars: &[bool], ) -> Result<Vec<(String, bool)>, QuboError>

Interpret the solution to the QUBO in the context of the original problem