Struct Wolff 

pub struct Wolff { /* private fields */ }

Wolff single-cluster sampler.

Precomputes a per-site neighbour table from the geometry so the flood-fill can enumerate neighbours in O(degree) without re-deriving lattice indices.

Implementations

impl Wolff

pub fn new(cfg: WolffConfig) -> Self

Build a sampler from a validated configuration.

pub fn square( rows: usize, cols: usize, coupling: f64, periodic: bool, ) -> SeqResult<Self>

Convenience constructor for a square lattice.

pub fn from_graph(adjacency: Vec<Vec<usize>>, coupling: f64) -> SeqResult<Self>

Convenience constructor for a general graph.

pub fn n_sites(&self) -> usize

Number of sites in the lattice / graph.

pub fn last_cluster_size(&self) -> usize

Size of the cluster flipped on the most recent Wolff::step.

pub fn bond_probability(&self, beta: f64) -> f64

Bond / addition probability p = 1 − exp(−2 β J). See super::swendsen_wang::SwendsenWang::bond_probability for the clamping rationale.

pub fn step( &mut self, spins: &mut [i8], beta: f64, rng: &mut LcgRng, ) -> SeqResult<()>

Perform one Wolff single-cluster update in place.

Seeds at a uniformly random site, grows the aligned cluster by stack flood-fill (each aligned neighbour joins with probability p = 1 − exp(−2 β J)), then flips the whole cluster.

Errors

SeqError::ShapeMismatch on a site-count mismatch, SeqError::InvalidParameter for non-finite beta or non-±1 spins.

pub fn magnetization(&self, spins: &[i8]) -> SeqResult<f64>

Mean magnetisation (1/N) Σ s_i ∈ [−1, +1].

Errors

SeqError::ShapeMismatch on a site-count mismatch.

pub fn energy(&self, spins: &[i8]) -> SeqResult<f64>

Total Ising energy E = −J Σ_(i,j) s_i s_j over the geometry’s edges (no external field). Each undirected edge is counted once.

Errors

SeqError::ShapeMismatch on a site-count mismatch.

Trait Implementations

impl Clone for Wolff

fn clone(&self) -> Wolff

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Wolff

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

Formats the value using the given formatter.