Struct MatRef 

pub struct MatRef<'a, S: TropicalSemiring> { /* private fields */ }

Immutable view over scalar data interpreted as a tropical matrix.

This is a lightweight view type that can be copied freely. It references scalar data and interprets operations using the specified semiring type.

use tropical_gemm::{MatRef, MaxPlus};

let data = [1.0f32, 2.0, 3.0, 4.0, 5.0, 6.0];
let a = MatRef::<MaxPlus<f32>>::from_slice(&data, 2, 3);

assert_eq!(a.nrows(), 2);
assert_eq!(a.ncols(), 3);
assert_eq!(a.get(0, 0), 1.0);

Implementations

impl<'a, S: TropicalSemiring> MatRef<'a, S>

pub fn from_slice(data: &'a [S::Scalar], nrows: usize, ncols: usize) -> Self

Create a matrix reference from a slice of scalars.

The data must be in column-major order with length nrows * ncols.

pub fn nrows(&self) -> usize

Number of rows.

pub fn ncols(&self) -> usize

Number of columns.

pub fn as_slice(&self) -> &[S::Scalar]

Get the underlying scalar data.

pub fn get(&self, i: usize, j: usize) -> S::Scalar

where S::Scalar: Copy,

Get the scalar value at position (i, j).

pub fn to_owned(&self) -> Mat<S>

where S::Scalar: Copy,

Convert to an owned matrix.

impl<'a, S: TropicalSemiring + KernelDispatch> MatRef<'a, S>

pub fn matmul(&self, b: &MatRef<'_, S>) -> Mat<S>

Perform tropical matrix multiplication: C = A ⊗ B.

Computes C[i,j] = ⊕_k (A[i,k] ⊗ B[k,j])

Panics

Panics if dimensions don’t match (self.ncols != b.nrows).

impl<'a, S> MatRef<'a, S>

where S: TropicalWithArgmax<Index = u32> + KernelDispatch,

pub fn matmul_argmax(&self, b: &MatRef<'_, S>) -> MatWithArgmax<S>

Perform tropical matrix multiplication with argmax tracking.

Returns both the result matrix and the argmax indices indicating which k-index produced each optimal value.

Panics

Panics if dimensions don’t match (self.ncols != b.nrows).

Trait Implementations

impl<'a, S: TropicalSemiring> Clone for MatRef<'a, S>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a, S: Debug + TropicalSemiring> Debug for MatRef<'a, S>

where S::Scalar: Debug,

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

Formats the value using the given formatter.

impl<'a, S> Mul<&'a MatRef<'a, S>> for &Mat<S>

where S: TropicalSemiring + KernelDispatch, S::Scalar: Copy,

type Output = Mat<S>

The resulting type after applying the * operator.

fn mul(self, rhs: &'a MatRef<'a, S>) -> Mat<S>

Performs the * operation.

impl<'a, 'b, S> Mul<&'b MatRef<'b, S>> for &'a MatRef<'a, S>

where S: TropicalSemiring + KernelDispatch,

type Output = Mat<S>

The resulting type after applying the * operator.

fn mul(self, rhs: &'b MatRef<'b, S>) -> Mat<S>

Performs the * operation.

impl<'a, 'b, S> Mul<MatRef<'b, S>> for MatRef<'a, S>

where S: TropicalSemiring + KernelDispatch,

type Output = Mat<S>

The resulting type after applying the * operator.

fn mul(self, rhs: MatRef<'b, S>) -> Mat<S>

Performs the * operation.

impl<'a, S: TropicalSemiring> Copy for MatRef<'a, S>