Struct DestinationDispatch 

pub struct DestinationDispatch { /* private fields */ }

Hall-call destination dispatch (DCS).

API shape

Uses DispatchStrategy::pre_dispatch to write sticky AssignedCar extensions and rebuild each car’s committed stop queue during a &mut World phase. DispatchStrategy::rank then routes each car to its own queue front and returns None for every other stop, so the group-wide Hungarian assignment trivially pairs each car with the stop it has already committed to.

Implementations

impl DestinationDispatch

pub const fn new() -> Self

Create a new DestinationDispatch with defaults (immediate sticky, no commitment window).

pub const fn with_stop_penalty(self, penalty: f64) -> Self

Override the fresh-stop penalty (ticks per new stop added to a car’s committed route when it picks this rider up).

pub const fn with_commitment_window_ticks(self, window: u64) -> Self

Enable deferred commitment: riders’ sticky assignments are re-evaluated each pass until the currently-assigned car is within window ticks of the rider’s origin. At that point the commitment latches and later ticks leave the assignment alone.

Trait Implementations

impl Default for DestinationDispatch

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DestinationDispatch

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl DispatchStrategy for DestinationDispatch

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

Optional hook called once per group before the assignment pass.

fn rank(&mut 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, serialized: &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 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 notify_removed(&mut self, _elevator: EntityId)

Notify the strategy that an elevator has been removed.

impl Serialize for DestinationDispatch

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

where __S: Serializer,

Serialize this value into the given Serde serializer.