Struct VariationalMessagePassing 

pub struct VariationalMessagePassing { /* private fields */ }

The VMP coordinate-ascent engine.

The engine itself is a thin state machine that holds the VmpConfig and drives the per-variable update rules defined by each VmpFactor variant.

Implementations

impl VariationalMessagePassing

pub fn new(config: VmpConfig) -> Result<Self>

Build an engine from a validated configuration.

pub fn with_graph(graph: &FactorGraph, config: VmpConfig) -> Result<Self>

Construct an engine from an already-existing FactorGraph (structure only) plus the VMP annotations. The graph is consulted to validate that every factor references variables that the user also registered with the factor-graph API, which is useful when VMP is layered on top of the generic PGM pipeline.

pub fn run(&mut self) -> Result<VmpResult>

Run the coordinate-ascent loop.

pub fn compute_elbo(&self) -> Result<f64>

Evidence Lower Bound L(q) = E_q[log p(x, z)] − E_q[log q(z)].

For the three conjugate relationships shipped in v0.2.0 the ELBO decomposes as Σ E_q[log p(factor)] − Σ KL(q(v) || prior(v)) because each prior cancels with the log p(z) term.

pub fn states(&self) -> &HashMap<String, VariationalState>

Read-only access to the current states.