Struct LoopyBp 

pub struct LoopyBp { /* private fields */ }

Loopy belief-propagation engine for a fixed grid topology.

The grid geometry (edge list and per-node incident-message bookkeeping) is built once in LoopyBp::new and reused across LoopyBp::infer calls.

Implementations

impl LoopyBp

pub fn new( height: usize, width: usize, n_states: usize, config: LoopyBpConfig, ) -> SeqResult<Self>

Build an inference engine for a height × width grid with n_states labels per node.

Errors

• SeqError::InvalidConfiguration if any dimension is 0 or config.max_iter == 0.
• SeqError::InvalidParameter if config.damping is outside (0, 1].

pub fn height(&self) -> usize

Grid height.

pub fn width(&self) -> usize

Grid width.

pub fn n_states(&self) -> usize

Number of labels per node.

pub fn infer(&self, unary: &[f64], pairwise: &[f64]) -> SeqResult<Vec<f64>>

Run sum-product BP and return the per-node marginals [H*W*n_states], normalised so each node’s distribution sums to 1.

Errors

SeqError::ShapeMismatch if unary or pairwise has the wrong length.

pub fn infer_detailed( &self, unary: &[f64], pairwise: &[f64], ) -> SeqResult<LoopyBpResult>

Run sum-product BP, returning marginals together with the sweep count and whether convergence was reached. See LoopyBp::infer for the error conditions.

Trait Implementations

impl Clone for LoopyBp

fn clone(&self) -> LoopyBp

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LoopyBp

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

Formats the value using the given formatter.