Struct RefineParams 

pub struct RefineParams {
    pub num_gibbs: usize,
    pub num_greedy: usize,
    pub feature_weighting: FeatureWeighting,
    pub seed: u64,
    pub gibbs_stagnation: f64,
    pub profile_source: ProfileSource,
    pub parallel: bool,
}

Parameters controlling the refinement pass.

Fields

num_gibbs: usize

Gibbs sweeps per level (0 disables Gibbs; greedy still runs).

num_greedy: usize

Greedy sweeps per level (early-exits on zero moves).

feature_weighting: FeatureWeighting

Per-feature weighting scheme (only meaningful for Raw profile source).

seed: u64

Seed for Gibbs RNG.

gibbs_stagnation: f64

Gibbs stagnation threshold (fraction of entities moving per sweep). Breaks early when three consecutive sweeps are below this bound. 0.0 disables early exit.

profile_source: ProfileSource

Feature source. Defaults to Raw.

parallel: bool

Jacobi-style parallel sweeps (default true).

When true, every entity proposes its move against a frozen pre-sweep snapshot of the sufficient stats (rayon par_iter); proposals are then applied sequentially with the move guard. Per-entity RNG seeds are derived from (sweep_seed, entity_idx), so the result is deterministic given seed and independent of thread count (per rand release — SmallRng’s stream is not guaranteed stable across rand versions).

When false, runs the classic Gauss–Seidel loop: each entity scores against the live stats (updated by every accepted move so far in the sweep), single-threaded.

Jacobi is biased — within a sweep, entities can’t see each other’s moves — but converges fine for the multilevel DC-Poisson use case and is roughly P× faster on large pb-sample counts.

Trait Implementations

impl Clone for RefineParams

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RefineParams

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

Formats the value using the given formatter.

impl Default for RefineParams

fn default() -> Self

Returns the “default value” for a type.