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.

pub const fn with_candidate_limit(self, limit: Option<usize>) -> Self

Set the per-car candidate limit for the assignment cost matrix. None disables pruning entirely; defaults to Some(50). See DispatchStrategy::candidate_limit for the rationale.

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(&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 candidate_limit(&self) -> Option<usize>

Maximum candidate stops the assignment phase considers per car.

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.