Struct UnifiedTimeStepper 

pub struct UnifiedTimeStepper {
    pub domains: Vec<TimeDomainState>,
    pub global_dt: f64,
    pub global_time: f64,
    pub subcycle_ratios: Vec<usize>,
}

Coordinates adaptive time-stepping across multiple physics domains.

Each domain may have a different natural timestep; the stepper computes a global step size (the minimum, after safety factors) and determines how many sub-steps faster domains effectively need within that global window. Domains whose natural timestep is larger than the global one take a single step of size global_dt.

Fields

domains: Vec<TimeDomainState>

Per-domain states.

global_dt: f64

Current global timestep (minimum across domains, with safety).

global_time: f64

Accumulated simulation time.

subcycle_ratios: Vec<usize>

How many sub-steps each domain takes per global step.

Implementations

impl UnifiedTimeStepper

pub fn new(configs: Vec<TimeDomainConfig>) -> Self

Create a new stepper from per-domain configurations.

pub fn compute_global_dt(&mut self) -> f64

Compute and update the global timestep (minimum across domains).

Returns the new global_dt.

pub fn compute_subcycle_ratios(&mut self)

Recompute the subcycle ratios based on the current global_dt and each domain’s current_dt.

pub fn advance_global_time(&mut self)

Advance the global simulation time by one global_dt and increment each domain’s step counter by its subcycle ratio.

pub fn update_domain_dt(&mut self, domain_idx: usize, new_dt: f64) -> bool

Update a domain’s suggested timestep.

The new value is clamped to the domain’s [min_dt, max_dt] range.

Returns true if domain_idx was valid, false otherwise.

pub fn update_domain_error(&mut self, domain_idx: usize, error: f64) -> bool

Record an error estimate for a domain (used by Richardson / embedded-pair integrators).

Returns true if domain_idx was valid, false otherwise.

pub fn step_schedule(&self) -> Vec<StepSchedule>

Generate the step schedule describing how each domain should be advanced during the next global step.

Trait Implementations

impl Clone for UnifiedTimeStepper

fn clone(&self) -> UnifiedTimeStepper

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UnifiedTimeStepper

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

Formats the value using the given formatter.