Struct HypergraphSubstrate 

pub struct HypergraphSubstrate { /* private fields */ }

Hypergraph substrate for higher-order relations

Provides a substrate for storing and querying hypergraphs, supporting:

• Hyperedges spanning multiple entities
• Topological data analysis (persistent homology, Betti numbers)
• Sheaf-theoretic consistency checks

Implementations

impl HypergraphSubstrate

pub fn new(config: HypergraphConfig) -> Self

Create a new hypergraph substrate

pub fn add_entity(&self, id: EntityId, metadata: Value)

Add an entity to the hypergraph

pub fn contains_entity(&self, id: &EntityId) -> bool

Check if entity exists

pub fn create_hyperedge( &mut self, entities: &[EntityId], relation: &Relation, ) -> Result<HyperedgeId, Error>

Create hyperedge spanning multiple entities

Arguments

• entities - Slice of entity IDs to connect
• relation - Relation describing the connection

Returns

The ID of the created hyperedge

Errors

Returns Error::EntityNotFound if any entity doesn’t exist

pub fn hyperedges_for_entity(&self, entity: &EntityId) -> Vec<HyperedgeId>

Query hyperedges containing a specific entity

pub fn get_hyperedge(&self, id: &HyperedgeId) -> Option<Hyperedge>

Get hyperedge by ID

pub fn persistent_homology( &self, dimension: usize, epsilon_range: (f32, f32), ) -> PersistenceDiagram

Topological query: find persistent features

Computes persistent homology features in the specified dimension over the given epsilon range.

pub fn betti_numbers(&self, max_dim: usize) -> Vec<usize>

Query Betti numbers (topological invariants)

Returns the Betti numbers up to max_dim, where:

• β₀ = number of connected components
• β₁ = number of 1-dimensional holes (loops)
• β₂ = number of 2-dimensional holes (voids)
• etc.

pub fn check_sheaf_consistency( &self, sections: &[SectionId], ) -> SheafConsistencyResult

Sheaf consistency: check local-to-global coherence

Checks if local sections are consistent on their overlaps, following the sheaf axioms.

pub fn query(&self, query: &TopologicalQuery) -> Result<HyperedgeResult, Error>

Execute a topological query

pub fn stats(&self) -> HypergraphStats

Get statistics about the hypergraph