Struct SimulationTime 

pub struct SimulationTime { /* private fields */ }

The temporal coordinate associated with one SystemState.

iteration is always present and provides deterministic ordering, chunk boundaries, and checkpoint identity. physical_time optionally records a finite domain time such as seconds or model time. Time-axis units belong to stream metadata so they are not repeated in every state.

Implementations

impl SimulationTime

pub const fn from_iteration(iteration: u64) -> Self

Creates an iteration-only time point.

pub fn from_iteration_and_physical_time( iteration: u64, physical_time: f64, ) -> Option<Self>

Creates a time point with a finite physical coordinate.

Returns None for NaN or either infinity. Negative finite values are accepted because some scientific coordinate systems use an origin after the beginning of a simulation or observation.

pub const fn iteration(self) -> u64

Returns the deterministic iteration coordinate.

pub const fn physical_time(self) -> Option<f64>

Returns the optional physical coordinate.

pub fn checked_advance( self, physical_time_increment: Option<f64>, ) -> Result<Self, StateError>

Computes the next scientific time without mutating a state.

None advances only the iteration and preserves the optional physical coordinate. Some(delta) also advances an existing physical coordinate. All overflow and finiteness checks are identical to SystemState::advance_simulation_time.

Trait Implementations

impl Clone for SimulationTime

fn clone(&self) -> SimulationTime

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SimulationTime

impl Debug for SimulationTime

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

Formats the value using the given formatter.

impl PartialEq for SimulationTime

fn eq(&self, other: &SimulationTime) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for SimulationTime