Struct Realization 

pub struct Realization {
    pub couplings: Vec<f32>,
    pub spins: Vec<i8>,
    pub temperatures: Vec<f32>,
    pub system_ids: Vec<usize>,
    pub rngs: Vec<Xoshiro256StarStar>,
    pub pair_rngs: Vec<Xoshiro256StarStar>,
    pub energies: Vec<f32>,
}

Mutable state for one disorder realization.

Holds the coupling array (fixed after construction), spin configurations for every replica at every temperature, and bookkeeping for parallel tempering.

With n_replicas replicas and n_temps temperatures there are n_systems = n_replicas * n_temps independent spin configurations. Spins are stored in a single flat Vec of length n_systems * n_spins, where system i occupies spins[i*n_spins .. (i+1)*n_spins].

Fields

couplings: Vec<f32>

Forward couplings, length n_spins * n_neighbors.

spins: Vec<i8>

All spin configurations, length n_systems * n_spins (+1/−1).

temperatures: Vec<f32>

Temperature assigned to each system slot, length n_systems.

system_ids: Vec<usize>

Parallel-tempering permutation: system_ids[slot] is the system index currently occupying temperature slot slot.

rngs: Vec<Xoshiro256StarStar>

One PRNG per system.

pair_rngs: Vec<Xoshiro256StarStar>

One PRNG per overlap-update pair slot, length n_temps * (n_replicas / 2).

energies: Vec<f32>

Cached total energy per system (E / N), length n_systems.

Implementations

impl Realization

pub fn new( lattice: &Lattice, couplings: Vec<f32>, temps: &[f32], n_replicas: usize, base_seed: u64, ) -> Self

Initialize a realization with random ±1 spins.

Seeds replica RNGs deterministically as base_seed, base_seed+1, ….

pub fn reset( &mut self, lattice: &Lattice, n_replicas: usize, n_temps: usize, base_seed: u64, )

Re-randomize all spins and reset the tempering permutation.