Enum DenseStorage 

#[non_exhaustive]
pub enum DenseStorage {
    Auto,
    Compact,
    Square,
}

Which storage form the dense engine reduces from.

A crate::DistanceMatrix is built compact: the condensed lower triangle, n(n-1)/2 entries. The full form holds both triangles row-major, n * n entries, so that the cofacet diameter fold reads a contiguous row per simplex vertex where the compact form reads a strided column. The full form costs n(n+1)/2 entries more.

The choice is per run and comes after the routing decision, so a run the router sends to the sparse engine never builds the full form. Auto selects it from the compact matrix size, a frozen budget on the added bytes, the edge count at the resolved threshold, and how many distances the fold reads. Compact forbids the conversion, which bounds what a run spends on the matrix. Square forces it and skips the budget.

The conversion runs once and the full form lives only as long as the run. The caller keeps its compact matrix, so a run in the full form holds n * n + n(n-1)/2 entries: one and a half times the full form, three times the compact one.

The diagram is identical under all three, bit for bit.

A sparse input holds no distance matrix, so this setting does not reach crate::rips_persistence_sparse.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Auto

Convert to the full form when the frozen rule selects it, and keep the compact form otherwise.

Compact

Always reduce from the compact form. No run adds the second triangle.

Square

Always reduce from the full form. This is an explicit request, so the Auto budget on the added bytes does not apply.

Trait Implementations

impl Clone for DenseStorage

fn clone(&self) -> DenseStorage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DenseStorage

impl Debug for DenseStorage

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

Formats the value using the given formatter.

impl Default for DenseStorage

fn default() -> DenseStorage

Returns the “default value” for a type.

impl Eq for DenseStorage

impl PartialEq for DenseStorage

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DenseStorage