Struct AgentSheaf 

pub struct AgentSheaf {
    pub agents: Vec<AgentBelief>,
    pub sheaf: CellularSheaf,
}

Wraps a group of agents as a cellular sheaf.

Each agent becomes a node, edges are built from a connectivity graph, and restriction maps default to identity (can be customized).

Fields

agents: Vec<AgentBelief>

The agents and their beliefs.

sheaf: CellularSheaf

The underlying cellular sheaf.

Implementations

impl AgentSheaf

pub fn complete(agents: Vec<AgentBelief>) -> Result<Self, SheafError>

Build an agent sheaf where all agents share the same stalk dimension, connected as a complete graph with identity restriction maps.

pub fn path(agents: Vec<AgentBelief>) -> Result<Self, SheafError>

Build an agent sheaf with a path connectivity.

pub fn with_edges( agents: Vec<AgentBelief>, edges: &[(usize, usize)], ) -> Result<Self, SheafError>

Build an agent sheaf with custom edges and identity restriction maps.

pub fn flat_beliefs(&self) -> Vec<f64>

Flatten all agent beliefs into a single vector.

pub fn laplacian(&self) -> Result<SheafLaplacian, SheafError>

Compute the sheaf Laplacian.

pub fn coherence( &self, max_iter: usize, tol: f64, ) -> Result<CoherenceMeasure, SheafError>

Measure coherence of current beliefs.

pub fn global_section(&self, tol: f64) -> Result<GlobalSection, SheafError>

Check if current beliefs form a global section.

pub fn len(&self) -> usize

Number of agents.

pub fn is_empty(&self) -> bool

True if there are no agents.

Trait Implementations

impl Clone for AgentSheaf

fn clone(&self) -> AgentSheaf

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentSheaf

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentSheaf

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentSheaf

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.