Struct SparseMatrixCompression 

pub struct SparseMatrixCompression { /* private fields */ }

Sparse Matrix Compression.

A configuration assigns one zero-based shift value to each row. The implementation reconstructs the implied storage vector internally instead of enumerating storage-vector entries directly, so brute-force search runs over bound_k ^ num_rows shift assignments.

Implementations

impl SparseMatrixCompression

pub fn new(matrix: Vec<Vec<bool>>, bound_k: usize) -> Self

Create a new SparseMatrixCompression instance.

Panics

Panics if bound_k == 0 or if the matrix rows are ragged.

pub fn matrix(&self) -> &[Vec<bool>]

Return the binary matrix.

pub fn bound_k(&self) -> usize

Return the shift bound K.

pub fn num_rows(&self) -> usize

Return the number of rows m.

pub fn num_cols(&self) -> usize

Return the number of columns n.

pub fn storage_len(&self) -> usize

Return the storage-vector length n + K.

pub fn decode_shifts(&self, config: &[usize]) -> Option<Vec<usize>>

Decode a zero-based config into the one-based shifts used in the mathematical definition.

pub fn storage_vector(&self, config: &[usize]) -> Option<Vec<usize>>

Construct the implied storage vector for a shift assignment.

Returns None if the shifts are malformed or if the overlay is invalid. Row labels are stored as 1..=m; 0 denotes an unused storage slot.

Trait Implementations

impl BruteForceProblem for SparseMatrixCompression

fn dimensions(&self) -> Vec<usize>

Cardinality of each coordinate in the brute-force search space.

fn num_variables(&self) -> usize

Number of coordinates in the brute-force search space.

impl Clone for SparseMatrixCompression

fn clone(&self) -> SparseMatrixCompression

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SparseMatrixCompression

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

Formats the value using the given formatter.

impl DeclaredVariant for SparseMatrixCompression

impl<'de> Deserialize<'de> for SparseMatrixCompression

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Problem for SparseMatrixCompression

const NAME: &'static str = "SparseMatrixCompression"

Base name of this problem type (e.g., “MaximumIndependentSet”).

type Solution = Vec<usize>

Mathematical witness type for this problem.

type Value = Or

The evaluation value type.

fn parameter_names() -> &'static [&'static str]

Canonical parameter names for this problem model.

fn parameters(&self) -> ProblemParameters

Measure the complete canonical parameters of this concrete instance.

fn evaluate(&self, config: &Self::Solution) -> Result<Or, EvaluationError>

Evaluate the problem on a solution.

fn variant() -> Vec<(&'static str, &'static str)>

Returns variant attributes derived from type parameters.

fn problem_type() -> ProblemType

Look up this problem’s catalog entry.

impl ReduceTo<ILP> for SparseMatrixCompression

type Result = ReductionSMCToILP

The reduction result type.

fn reduce_to(&self) -> Result<Self::Result, ReductionError>

Reduce this problem to the target problem type.

fn target_construction(error: ConstructionError) -> ReductionError

where Self: Sized,

Attach this reduction edge to a target-construction failure.

fn exact_i64( value: usize, operation: impl Into<String>, ) -> Result<i64, ReductionError>

where Self: Sized,

Convert a structural count used by the target’s exact integer algebra.

impl Serialize for SparseMatrixCompression

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.