Struct PairGenerator 

pub struct PairGenerator { /* private fields */ }

Reusable buffers and immutable configuration for indexed random pairs.

Implementations

impl PairGenerator

pub fn new( shape: &[usize], method: PairingMethod, num_pairs: usize, rng: ResolvedRng, ) -> Result<Self, PairGenerationError>

Constructs an allocation-stable pair generator from explicit randomness.

pub fn refresh_at(&mut self, sweep: u64)

Replaces every cached pair for an explicit scientific sweep.

Repeating this call with the same sweep reproduces the same batch exactly. No mutable RNG cursor participates in the result. All three dense caches and kernel workspaces retain their storage across sweeps.

pub fn shape(&self) -> &[usize]

pub fn rank(&self) -> usize

pub fn num_pairs(&self) -> usize

pub fn method(&self) -> PairingMethod

pub fn resolved_rng(&self) -> ResolvedRng

pub fn generated_sweep(&self) -> Option<u64>

Returns the sweep represented by the current buffers, if generated.

pub fn sources(&self) -> &VectorList<isize>

pub fn displacements(&self) -> &VectorList<isize>

Raw displacements. Every row satisfies target = source + displacement.

pub fn targets(&self) -> &VectorList<isize>

Raw target coordinates for use with boundary-aware SquareLattice accessors.

Trait Implementations

impl Clone for PairGenerator

fn clone(&self) -> PairGenerator

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PairGenerator

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

Formats the value using the given formatter.