Struct SourcePhase 

pub struct SourcePhase<E, M: Model<E>> { /* private fields */ }

Manages the source execution phase in the simulation.

This structure holds the queue of sources executable in the current micro-step, and oversees source firing, scheduling, and discarding processes.

Implementations

impl<E, M: Model<E>> SourcePhase<E, M>

pub fn get_context(&mut self) -> &mut SourceContext<E, M>

Returns a mutable reference to the source context used in the current phase.

pub fn get_source_view(&self, ready_entry: &SourceReadyEntry) -> SourceView

Generates a view from the specified source entry.

pub fn complete_source_phase( self, model: &M, ) -> MicroStepHandler<SourceContext<E, M>>

Terminates the source phase, returns the source_handler to the context, and transitions to the next micro-step handler.

Invokes the after_source_phase hook to update the simulation state.

pub fn take_one(&mut self) -> Option<SourceReadyEntry>

Pops one source from the front of the queue.

pub fn take_one_if<F>(&mut self, predicate: F) -> Option<SourceReadyEntry>

where F: FnOnce(&SourceReadyEntry) -> bool,

Searches for and pops the first source in the queue that satisfies the given predicate.

pub fn take_front_if<F>(&mut self, predicate: F) -> Option<SourceReadyEntry>

where F: FnOnce(&SourceReadyEntry) -> bool,

Pops a source from the front of the queue only if it satisfies the given predicate.

pub fn take_all(&mut self) -> VecDeque<SourceReadyEntry>

Takes all sources currently in the queue.

pub fn take_all_if<F>(&mut self, predicate: F) -> VecDeque<SourceReadyEntry>

where F: FnMut(&SourceReadyEntry) -> bool,

Extracts and returns all sources from the queue that satisfy the given predicate.

Sources that do not satisfy the predicate remain in the queue.

pub fn fire_and_schedule(&mut self, model: &M, entry: SourceReadyEntry)

Fires the source and schedules it if a next firing time exists.

Invokes the before_source and after_source hooks surrounding the fire process.

pub fn discard(&mut self, model: &M, entry: SourceReadyEntry)

Discards the specified source.

Invokes the discard_source hook during the discard process.