Struct MatrixV 

pub struct MatrixV {
    pub matrix: Arc<Matrix>,
    pub offset: usize,
    pub len: usize,
}

MatrixView

Row window over a Matrix covering rows [offset .. offset + len).

Fields

• matrix: backing matrix shared through Arc.
• offset: index of the first row in the backing matrix.
• len: number of rows in the window.

Behaviour

• Construction and re-windowing do not copy column data. Use MatrixV::to_matrix to materialise the window as an independent Matrix.
• MatrixV::as_strided returns (data, lda) for BLAS and LAPACK, with data positioned at the first row of the window.
• MatrixV::as_tuple returns (data, offset, length, stride) for kernels that operate without the view type.
• Columns are positional and have no names or null masks. Column selection is not supported. Use MatrixV::col for individual columns or convert to Table for named-column operations.

Fields

matrix: Arc<Matrix>

Backing matrix shared by all views over the same data.

offset: usize

Index of the first row in the backing matrix.

len: usize

Number of rows in the window.

Implementations

impl MatrixV

pub fn from_matrix(matrix: Matrix, offset: usize, len: usize) -> Self

Creates a view over rows [offset .. offset + len) of the matrix.

The matrix is moved into shared Arc storage for this view and any subsequent views derived from it.

pub fn from_arc_matrix(matrix: Arc<Matrix>, offset: usize, len: usize) -> Self

Creates a zero-copy view over matrix[offset .. offset+len) rows of an already-shared matrix. /// Creates a view over rows [offset .. offset + len) of a shared matrix.

pub fn from_self(&self, offset: usize, len: usize) -> Self

Creates a sub-window with offset relative to this view.

pub fn n_rows(&self) -> usize

Returns the number of rows in the window.

pub fn n_cols(&self) -> usize

Returns the number of columns in the backing matrix.

Windowing affects rows only, so every backing column remains present.

pub fn len(&self) -> usize

Returns the number of rows in the window.

pub fn is_empty(&self) -> bool

Returns true if the window has no rows or the backing matrix has no columns.

pub fn end(&self) -> usize

Returns the exclusive end row of the window in backing-matrix coordinates.

pub fn spans_backing(&self) -> bool

Returns true if the window covers every row of the backing matrix.

Full-span views can be materialised by cloning the backing matrix rather than constructing a new row window.

pub fn name(&self) -> Option<&str>

Returns the backing matrix name.

pub fn stride(&self) -> usize

Returns the backing matrix column stride in elements.

This is the BLAS leading dimension (lda).

pub fn col(&self, col: usize) -> &[f64]

Returns column col over the current row window.

The returned slice is contiguous. Panics if col is outside the backing matrix.

pub fn columns(&self) -> Vec<&[f64]>

Returns all column windows in column order.

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

Returns the value at (row, col).

row is relative to the current window.

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

Returns one window-relative row as an owned Vec<f64>.

pub fn as_tuple(&self) -> MatrixVT<'_>

Returns the view as (data, offset, length, stride).

data references the complete backing buffer. offset and length identify the current row window, and stride gives the physical spacing between columns.

pub fn m(&self) -> i32

Returns the window row count as i32 for BLAS and LAPACK calls.

pub fn n(&self) -> i32

Returns the column count as i32 for BLAS and LAPACK calls.

pub fn lda(&self) -> i32

Returns the BLAS leading dimension (lda).

Row windowing does not change the physical spacing between backing columns.

pub fn as_strided(&self) -> (&[f64], i32)

Returns the window as (data, lda) for BLAS and LAPACK.

data begins at the first row of the window. Element (i, j) is located at data[j * lda + i] for the m() × n() view.

pub fn as_mut_strided(&mut self) -> (&mut [f64], i32)

Returns mutable strided storage for BLAS and LAPACK routines.

Arc::make_mut provides copy-on-write behaviour when the backing matrix is shared. Mutations affect only the resulting backing allocation after any required copy.

pub fn to_matrix(&self) -> Matrix

Materialises the window as an owned Matrix.

Partial windows are copied into a new 64-byte-aligned column-major buffer with stride appropriate to the new row count. Full-span windows use the backing matrix’s Clone implementation.

pub fn gather_rows(&self, indices: &[usize]) -> Matrix

Gathers window-relative rows into a new owned Matrix.

Output rows follow the order of indices. Panics if any index is outside the current window.

Trait Implementations

impl ByteSize for MatrixV

Available on crate features matrix and views only.

fn est_bytes(&self) -> usize

Returns the estimated byte size of this object in memory.

fn logical_bytes(&self) -> usize

Returns the exact logical byte size of the data.

impl Clone for MatrixV

fn clone(&self) -> MatrixV

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Concatenate for MatrixV

fn concat(self, other: Self) -> Result<Self, MinarrowError>

Concatenates two row windows into one owned matrix.

Both windows must have the same number of columns. The result is returned as a full-span view over the concatenated matrix.

impl Debug for MatrixV

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

Formats the value using the given formatter.

impl Display for MatrixV

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

Formats the value using the given formatter.

impl From<Arc<Matrix>> for MatrixV

Converts a shared Arc<Matrix> to a full-span MatrixV.

fn from(matrix: Arc<Matrix>) -> Self

Converts to this type from the input type.

impl From<Matrix> for MatrixV

Converts an owned Matrix to a full-span MatrixV.

fn from(matrix: Matrix) -> Self

Converts to this type from the input type.

impl From<MatrixV> for Value

Available on crate features matrix and views only.

fn from(v: MatrixV) -> Self

Converts to this type from the input type.

impl From<MatrixV> for Matrix

Materialises a MatrixV as an owned Matrix.

fn from(view: MatrixV) -> Self

Converts to this type from the input type.

impl PartialEq for MatrixV

Equality is based on shape and values rather than backing storage.

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl RowSelection for MatrixV

Available on crate feature select only.

Row selection over an existing matrix view.

Contiguous selections return a sub-window over the same backing matrix. Non-contiguous selections gather the requested rows into a new owned matrix and return a full-span view over it.

type View = MatrixV

The view type returned by selection operations

fn r<S: DataSelector>(&self, selection: S) -> MatrixV

Select rows by index or range

fn get_row_count(&self) -> usize

Get the count for data resolution

fn row(&self, idx: usize) -> Self::View

Select a single row by index

impl Shape for MatrixV

fn shape(&self) -> ShapeDim

Returns arbitrary Shape dimension for any data shape

fn shape_1d(&self) -> usize

Returns the first dimension shape

fn shape_2d(&self) -> (usize, usize)

Returns the first and second dimension shapes

fn shape_3d(&self) -> (usize, usize, usize)

Returns the first, second and third dimension shapes

fn shape_4d(&self) -> (usize, usize, usize, usize)

Returns the first, second, third and fourth dimension shapes

impl TryFrom<Value> for MatrixV

Available on crate features matrix and views only.

fn try_from(v: Value) -> Result<Self, Self::Error>

Accepts any Value that resolves to a Matrix, viewed over its full row extent. An incoming MatrixView passes through unchanged. Other matrix-like types convert through Matrix::try_from first.

type Error = MinarrowError

The type returned in the event of a conversion error.