Struct Shape 

pub struct Shape {
    pub dims: Vec<usize>,
    pub strides: Vec<usize>,
}

Represents the dimensional layout and physical memory strides of a tensor.

By separating dimensions from strides, ETensor can perform zero-copy view manipulations (like transposing or slicing) without moving physical data.

Fields

dims: Vec<usize>

The mathematical dimensions of the tensor (e.g., [Batch, Channels, Height, Width]).

strides: Vec<usize>

The number of physical memory elements to skip to reach the next element in a given dimension.

Implementations

impl Shape

pub fn new(dims: Vec<usize>) -> Self

Creates a new, contiguous shape layout.

Automatically calculates the default row-major (C-contiguous) strides required to map multi-dimensional coordinates to a flat 1D memory buffer.

pub fn transpose(&self) -> Self

Transposes the last two dimensions in O(1) time.

This returns a new Shape representation with swapped dimensions and strides, explicitly avoiding any duplication of the underlying physical buffer.

pub fn rank(&self) -> usize

Returns the total number of dimensions (rank) of the tensor.

pub fn num_elements(&self) -> usize

Returns the total number of mathematical elements contained in the shape.

pub fn is_contiguous(&self) -> bool

Verifies if the underlying physical memory layout perfectly matches the mathematical layout.

This is crucial for backend hardware execution, as many optimized CUDA or CPU BLAS kernels require contiguous memory arrays to function correctly.

Trait Implementations

impl Clone for Shape

fn clone(&self) -> Shape

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Shape

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

Formats the value using the given formatter.

impl PartialEq for Shape

fn eq(&self, other: &Shape) -> 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 Eq for Shape

impl StructuralPartialEq for Shape