Struct CubicalComplex 

pub struct CubicalComplex {
    pub cells: Vec<(CubicalCell, f64)>,
    pub spatial_dim: usize,
}

A filtered cubical complex.

Filtration values are stored per cell and sorted in non-decreasing order.

Fields

cells: Vec<(CubicalCell, f64)>

Sorted list of (cell, filtration_value).

spatial_dim: usize

Spatial dimension of the complex (2 for images, 3 for volumes).

Implementations

impl CubicalComplex

pub fn from_image_2d(image: &[Vec<f64>]) -> Result<Self>

Build a 2D cubical complex from a 2D image (rows × cols).

Filtration value of each cell = max pixel value over all vertices of that cell (sup-level set filtration). Cells:

• 0-cells: rows+1 × cols+1 vertices
• 1-cells: horizontal and vertical edges between adjacent vertices
• 2-cells: rows × cols faces (pixel cells)

pub fn from_image_3d(image: &[Vec<Vec<f64>>]) -> Result<Self>

Build a 3D cubical complex from a 3D image (slices × rows × cols).

pub fn boundary(&self, cell: &CubicalCell) -> Vec<CubicalCell>

Compute the boundary faces of a cubical cell.

For a k-cell, the boundary consists of 2k faces obtained by decreasing or increasing each “active” (odd) coordinate by 1.

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

Compute persistence diagram via boundary matrix reduction.

Returns (birth, death, dimension) triples sorted by birth value.

pub fn cell_count(&self, dim: usize) -> usize

Count cells by dimension.

Trait Implementations

impl Clone for CubicalComplex

fn clone(&self) -> CubicalComplex

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CubicalComplex

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

Formats the value using the given formatter.