Struct LoopScheduleDispatch 

pub struct LoopScheduleDispatch { /* private fields */ }

Dispatch strategy that holds Loop cars to a uniform dwell at every stop, with hold-recovery to keep the timetable stable under load.

See the module-level documentation for the full contract. The tunable fields are exposed through accessors so hosts can inspect the schedule in-flight (HUDs, debuggers). The struct itself is immutable after construction — replace the active strategy via Simulation::set_dispatch with a freshly-built instance to retune live, or rely on restore_config on the snapshot path.

Implementations

impl LoopScheduleDispatch

pub fn new( dwell_ticks: u32, target_headway_ticks: u32, hold_cap_ticks: u32, ) -> Self

Construct a LoopScheduleDispatch with explicit tunables.

All three integer parameters are clamped to a minimum of 1: a zero dwell would collapse the door cycle into a no-op, a zero headway would never trigger recovery, and a zero hold cap would disable recovery entirely (use a small but positive value to keep recovery active without unbounded waits).

pub const fn dwell_ticks(&self) -> u32

Dwell at each stop, in ticks. See Self::new for the invariants this guarantees.

pub const fn target_headway_ticks(&self) -> u32

Desired tick gap between consecutive arrivals at the same stop.

pub const fn hold_cap_ticks(&self) -> u32

Maximum extra dwell hold-recovery will apply per stop.

Trait Implementations

impl Clone for LoopScheduleDispatch

fn clone(&self) -> LoopScheduleDispatch

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LoopScheduleDispatch

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

Formats the value using the given formatter.

impl Default for LoopScheduleDispatch

fn default() -> Self

Sensible defaults for a 60-tick-per-second sim: a 30-tick (half-second) dwell, a 300-tick (5-second) headway target, and a 120-tick (2-second) hold cap. Hosts should call Self::new with values matched to their line geometry rather than relying on these.

impl<'de> Deserialize<'de> for LoopScheduleDispatch

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl DispatchStrategy for LoopScheduleDispatch

fn pre_dispatch( &mut self, group: &ElevatorGroup, _manifest: &DispatchManifest, world: &mut World, )

Optional hook called once per group before the assignment pass.

fn rank(&self, _ctx: &RankContext<'_>) -> Option<f64>

Score the cost of sending car to stop. Lower is better.

fn builtin_id(&self) -> Option<BuiltinStrategy>

If this strategy is a known built-in variant, return it so Simulation::new can stamp the correct BuiltinStrategy into the group’s snapshot identity.

fn snapshot_config(&self) -> Option<String>

Serialize this strategy’s tunable configuration to a string that restore_config can apply to a freshly-instantiated instance.

fn restore_config(&mut self, config: &str) -> Result<(), String>

Restore tunable configuration from a string previously produced by snapshot_config on the same strategy variant. Called by crate::snapshot::WorldSnapshot::restore immediately after BuiltinStrategy::instantiate builds the default instance, so the restore writes over the defaults.

fn notify_removed(&mut self, elevator: EntityId)

Notify the strategy that an elevator has been removed.

fn prepare_car( &mut self, _car: EntityId, _car_position: f64, _group: &ElevatorGroup, _manifest: &DispatchManifest, _world: &World, )

Optional hook called once per candidate car, before any rank calls for that car in the current pass.

fn fallback( &mut self, _car: EntityId, _car_position: f64, _group: &ElevatorGroup, _manifest: &DispatchManifest, _world: &World, ) -> DispatchDecision

Decide what an idle car should do when no stop was assigned to it.

fn candidate_limit(&self) -> Option<usize>

Maximum candidate stops the assignment phase considers per car.

impl Serialize for LoopScheduleDispatch

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.