Struct AttractorSampler 

pub struct AttractorSampler {
    pub attractor: AttractorType,
    pub state: Vec3,
    pub dt: f32,
    pub time: f32,
    pub scale: f32,
    pub center: Vec3,
    pub substeps: usize,
}

Stateful sampler that integrates an attractor over time. Maintains the current state and advances it on each call to next().

Fields

attractor: AttractorType

Which system is integrated.

state: Vec3

Current state in the attractor’s own coordinates (before scale and centre).

dt: f32

Integration time step per sub-step.

time: f32

Simulated time integrated so far.

scale: f32

Scale applied to output positions (use normalization_scale() for unit cube).

center: Vec3

Center offset applied after scaling.

substeps: usize

How many integration steps per next() call (sub-steps for stability).

Implementations

impl AttractorSampler

pub fn new(attractor: AttractorType) -> Self

A sampler starting on the attractor (after 5,000 warm-up steps) with its recommended time step and unit-cube scale.

pub fn next(&mut self) -> Vec3

Advance by substeps integration steps and return the normalised position.

pub fn sample_trajectory(&mut self, n: usize) -> Vec<Vec3>

Sample n points from the attractor trajectory.

pub fn reset(&mut self)

Reset to a fresh warmed initial condition.

pub fn set_attractor(&mut self, attractor: AttractorType)

Set the attractor type, resetting the state.

pub fn raw_state(&self) -> Vec3

Current raw (un-normalised) state.

pub fn position(&self) -> Vec3

Current normalised position.

pub fn velocity(&self) -> Vec3

Instantaneous velocity vector in normalised space.

Trait Implementations

impl Clone for AttractorSampler

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 AttractorSampler

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

Formats the value using the given formatter.