Struct SimContext 

pub struct SimContext { /* private fields */ }

Central simulation context.

Holds the master seed, seed tree, logical clock, and event log for a single simulation run. Pass a reference to SimContext into every subsystem that needs deterministic randomness or event logging.

Implementations

impl SimContext

pub fn new(seed: VortexSeed) -> Self

Create a new simulation context from a master seed.

pub fn from_u64(seed: u64) -> Self

Create from a simple u64 seed.

pub fn seed(&self) -> VortexSeed

Get the master seed.

pub fn seed_tree(&self) -> &SeedTree

Get the seed tree for deriving subsystem-specific RNGs.

pub fn rng_for(&self, domain: &str) -> DetRng

Create a DetRng for a specific subsystem domain.

pub fn logical_time_us(&self) -> u64

Get the current logical time in microseconds.

pub fn advance_time_us(&mut self, delta_us: u64)

Advance logical time by the given microseconds.

pub fn set_time_us(&mut self, time_us: u64)

Set logical time to an absolute value.

pub fn log_event( &mut self, subsystem: Subsystem, description: impl Into<String>, ) -> SeqNo

Record an event in the event log.

pub fn log_event_with_payload( &mut self, subsystem: Subsystem, description: impl Into<String>, payload: Vec<u8>, ) -> SeqNo

Record an event with a payload.

pub fn event_log(&self) -> &SimEventLog

Get a reference to the event log.

pub fn into_event_log(self) -> SimEventLog

Take ownership of the event log (consumes the context).

Trait Implementations

impl Debug for SimContext

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

Formats the value using the given formatter.