Struct RunCursor 

pub struct RunCursor { /* private fields */ }

One CPU run of a sweep, built and stepped a slice at a time.

A run steps from tick 0 to the plan’s total, unless its stop condition holds at a sample first. The actions due at tick 0 fire before the first step, and those due at a later tick after the step that reaches it.

Implementations

impl RunCursor

pub fn new( entry: &ModelEntry, measure: &Arc<MeasurePlan>, request: &RunRequest<'_>, timeout: Option<Duration>, ) -> Self

Builds the model of request with the request’s seed, and times the build.

A run ends with the slice in which its stepping and sampling pass timeout. A cursor whose build failed finishes on its first Self::advance, with the failure as its status. A GPU model is rejected.

pub fn tick(&self) -> u64

Tick the run has reached, 0 for a run whose build failed.

pub fn advance(&mut self, max_steps: u64) -> CursorState

Steps the run by at most max_steps steps, firing the actions and taking the samples due on the way.

A sample due at the tick the run has reached is taken even when max_steps is 0. A fault ends the run, and its outcome keeps the samples taken before it.

Panics

Panics when called again after it returned CursorState::Finished.

Trait Implementations

impl Debug for RunCursor

Prints the run, and leaves out the live simulation.

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

Formats the value using the given formatter.