Struct StructuredStorage 

pub struct StructuredStorage<T> { /* private fields */ }

Structured tensor snapshot storage.

data and strides describe the payload tensor, while axis_classes describes how logical axes map onto payload axes. Logical flat-buffer semantics are column-major.

Implementations

impl<T> StructuredStorage<T>

pub fn new( data: Vec<T>, payload_dims: Vec<usize>, strides: Vec<isize>, axis_classes: Vec<usize>, ) -> Result<StructuredStorage<T>, Error>

Creates a structured payload snapshot from explicit payload metadata.

payload_dims and strides describe the compressed payload tensor, while axis_classes maps logical axes onto payload axes in canonical first-appearance order.

pub fn from_dense_col_major( data: Vec<T>, logical_dims: &[usize], ) -> StructuredStorage<T>

Creates a dense structured snapshot from column-major logical data.

pub fn from_diag_col_major( diag_data: Vec<T>, logical_rank: usize, ) -> StructuredStorage<T>

Creates a diagonal structured snapshot from column-major diagonal data.

pub fn data(&self) -> &[T]

Returns the owned payload buffer.

pub fn payload_dims(&self) -> &[usize]

Returns the payload tensor dimensions.

pub fn strides(&self) -> &[isize]

Returns the payload tensor strides.

pub fn axis_classes(&self) -> &[usize]

Returns the canonical logical-to-payload axis classes.

pub fn logical_dims(&self) -> Vec<usize>

Returns the logical dimensions derived from payload_dims and axis_classes.

pub fn logical_rank(&self) -> usize

Returns the logical rank.

pub fn is_dense(&self) -> bool

Returns true when the logical tensor is dense.

pub fn is_diag(&self) -> bool

Returns true when the logical tensor is diagonal.

pub fn len(&self) -> usize

Returns the payload buffer length.

pub fn is_empty(&self) -> bool

Returns true when the payload buffer is empty.

pub fn dense_col_major_view_if_contiguous(&self) -> Option<&[T]>

Returns a borrowed view when the logical tensor is dense and the payload is already stored contiguously in column-major order.

impl<T> StructuredStorage<T>

where T: Clone,

pub fn payload_col_major_vec(&self) -> Vec<T>

Materializes the payload tensor as a contiguous column-major buffer.

pub fn permute_logical_axes(&self, perm: &[usize]) -> StructuredStorage<T>

Returns a copy of the storage with logical axes permuted.

impl<T> StructuredStorage<T>

where T: Copy,

pub fn map_copy<U>(&self, f: impl FnMut(T) -> U) -> StructuredStorage<U>

Maps payload elements while preserving payload metadata and axis classes.

impl<T> StructuredStorage<T>

where T: Copy + Default,

pub fn logical_dense_col_major_vec(&self) -> Vec<T>

Materializes the logical tensor as a contiguous column-major dense buffer.

Repeated entries in axis_classes encode equality constraints between logical axes. Logical indices that violate those constraints are structural zeros in the dense materialization.

Trait Implementations

impl<T> Clone for StructuredStorage<T>

where T: Clone,

fn clone(&self) -> StructuredStorage<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Debug for StructuredStorage<T>

where T: Debug,

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

Formats the value using the given formatter.

impl<T> PartialEq for StructuredStorage<T>

where T: PartialEq,

fn eq(&self, other: &StructuredStorage<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T> StructuralPartialEq for StructuredStorage<T>