Struct CpuLinAlg 

pub struct CpuLinAlg;

CPU linear algebra backend.

Uses Vec<f64> for vectors and Matrix for matrices. All trait methods delegate to existing implementations in crate::matrix and crate::activation.

Trait Implementations

impl Clone for CpuLinAlg

fn clone(&self) -> CpuLinAlg

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CpuLinAlg

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

Formats the value using the given formatter.

impl LinAlg for CpuLinAlg

type Vector = Vec<f64>

1-D vector type.

type Matrix = Matrix

2-D matrix type.

fn zeros_vec(size: usize) -> Self::Vector

Creates a zero-filled vector of the given size.

fn zeros_mat(rows: usize, cols: usize) -> Self::Matrix

Creates a zero-filled matrix with the given dimensions.

fn xavier_mat(rows: usize, cols: usize, rng: &mut impl Rng) -> Self::Matrix

Creates a matrix with Xavier-uniform initialization.

fn mat_vec_mul(m: &Self::Matrix, v: &Self::Vector) -> Self::Vector

Matrix-vector multiplication: m * v.

fn mat_transpose(m: &Self::Matrix) -> Self::Matrix

Returns the transpose of the matrix.

fn outer_product(a: &Self::Vector, b: &Self::Vector) -> Self::Matrix

Outer product of two vectors: a * b^T.

fn mat_mul(a: &Self::Matrix, b: &Self::Matrix) -> Self::Matrix

Matrix-matrix multiplication: a * b.

fn svd(m: &Self::Matrix) -> SvdResult<Self>

Singular Value Decomposition: M = U × diag(S) × V^T.

fn mat_scale_add(m: &mut Self::Matrix, other: &Self::Matrix, scale: f64)

Adds scale * other element-wise to m (in place).

fn mat_rows(m: &Self::Matrix) -> usize

Returns the number of rows.

fn mat_cols(m: &Self::Matrix) -> usize

Returns the number of columns.

fn mat_get(m: &Self::Matrix, row: usize, col: usize) -> f64

Returns the element at (row, col).

fn mat_set(m: &mut Self::Matrix, row: usize, col: usize, val: f64)

Sets the element at (row, col).

fn vec_add(a: &Self::Vector, b: &Self::Vector) -> Self::Vector

Element-wise addition: a + b.

fn vec_sub(a: &Self::Vector, b: &Self::Vector) -> Self::Vector

Element-wise subtraction: a - b.

fn vec_scale(v: &Self::Vector, s: f64) -> Self::Vector

Scalar multiplication: v * s.

fn vec_hadamard(a: &Self::Vector, b: &Self::Vector) -> Self::Vector

Element-wise (Hadamard) product: a[i] * b[i].

fn vec_dot(a: &Self::Vector, b: &Self::Vector) -> f64

Dot product: sum(a[i] * b[i]).

fn vec_len(v: &Self::Vector) -> usize

Returns the number of elements in the vector.

fn vec_get(v: &Self::Vector, i: usize) -> f64

Returns the element at index i.

fn vec_set(v: &mut Self::Vector, i: usize, val: f64)

Sets the element at index i.

fn vec_from_slice(s: &[f64]) -> Self::Vector

Creates a vector from a slice of f64.

fn vec_to_vec(v: &Self::Vector) -> Vec<f64>

Converts the vector to a Vec<f64> (copies data).

fn vec_as_slice(v: &Self::Vector) -> &[f64]

Returns a slice view of the vector data (zero-copy for CPU).

fn clip_vec(v: &mut Self::Vector, max_abs: f64)

Clamps each element to [-max_abs, max_abs] in place.

fn clip_mat(m: &mut Self::Matrix, max_abs: f64)

Clamps each matrix element to [-max_abs, max_abs] in place.

fn apply_activation(v: &Self::Vector, act: Activation) -> Self::Vector

Applies an activation function element-wise.

fn apply_derivative(v: &Self::Vector, act: Activation) -> Self::Vector

Applies an activation derivative element-wise.

fn softmax_masked(logits: &Self::Vector, mask: &[usize]) -> Self::Vector

Numerically stable masked softmax.

fn argmax_masked(values: &Self::Vector, mask: &[usize]) -> usize

Returns the index of the maximum value among masked indices.

fn sample_from_probs( probs: &Self::Vector, mask: &[usize], rng: &mut impl Rng, ) -> usize

Samples an action index from a probability distribution over masked indices.

fn rms_error(error_vecs: &[&Self::Vector]) -> f64

Combined RMS error across multiple error vectors.