Struct Matrix 

pub struct Matrix {
    pub data: Vec<f64>,
    pub rows: usize,
    pub cols: usize,
}

A dense row-major matrix of f64 values.

Data is stored in a flat Vec<f64> of length rows * cols.

Examples

use pc_rl_core::matrix::Matrix;

let m = Matrix::zeros(2, 3);
assert_eq!(m.rows, 2);
assert_eq!(m.cols, 3);

Fields

data: Vec<f64>

Flat row-major storage.

rows: usize

Number of rows.

cols: usize

Number of columns.

Implementations

impl Matrix

pub fn zeros(rows: usize, cols: usize) -> Self

Creates a matrix filled with zeros.

Arguments

• rows - Number of rows.
• cols - Number of columns.

Returns

A Matrix with all elements set to 0.0.

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

Creates a matrix with Xavier-uniform initialization.

Elements are drawn uniformly from [-limit, limit] where limit = sqrt(6.0 / (rows + cols)).

Arguments

• rows - Number of rows.
• cols - Number of columns.
• rng - Mutable reference to a random number generator.

Returns

A Matrix with Xavier-initialized values.

pub fn get(&self, row: usize, col: usize) -> f64

Returns the element at (row, col).

Defaults to 0.0 if indices are out of bounds.

Arguments

• row - Row index.
• col - Column index.

pub fn set(&mut self, row: usize, col: usize, val: f64)

Sets the element at (row, col) to val.

Does nothing if indices are out of bounds.

Arguments

• row - Row index.
• col - Column index.
• val - Value to set.

pub fn transpose(&self) -> Self

Returns the transpose of this matrix.

Returns

A new Matrix with rows and columns swapped.

pub fn mul_vec(&self, v: &[f64]) -> Vec<f64>

Multiplies this matrix by a column vector.

Arguments

• v - Input vector of length self.cols.

Returns

A vector of length self.rows.

Panics

Panics with “dimension” if v.len() != self.cols.

pub fn outer(a: &[f64], b: &[f64]) -> Self

Computes the outer product of two vectors.

Arguments

• a - First vector (determines rows).
• b - Second vector (determines cols).

Returns

A Matrix of shape (a.len(), b.len()). Returns a 0x0 matrix if either vector is empty.

pub fn scale_add(&mut self, other: &Matrix, scale: f64)

Adds scale * other element-wise and clamps to [-WEIGHT_CLIP, WEIGHT_CLIP].

Arguments

• other - Matrix to add (must have same dimensions).
• scale - Scalar multiplier for other.

Panics

Panics if dimensions do not match.

Trait Implementations

impl Clone for Matrix

fn clone(&self) -> Matrix

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Matrix

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Matrix

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Matrix

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

where __S: Serializer,

Serialize this value into the given Serde serializer.