elevator-core 5.10.0

Engine-agnostic elevator simulation library with pluggable dispatch strategies
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

//! Energy system: compute per-tick energy consumption and regeneration.

use crate::components::ElevatorPhase;
use crate::energy::compute_tick_energy;
use crate::entity::EntityId;
use crate::events::{Event, EventBus};
use crate::world::World;

use super::PhaseContext;

/// Iterate elevators with an [`EnergyProfile`](crate::energy::EnergyProfile),
/// compute tick energy, update [`EnergyMetrics`](crate::energy::EnergyMetrics),
/// and emit [`Event::EnergyConsumed`] events.
pub fn run(
    world: &mut World,
    events: &mut EventBus,
    ctx: &PhaseContext,
    elevator_ids: &[EntityId],
) {
    for &eid in elevator_ids {
        if world.is_disabled(eid) {
            continue;
        }

        // Skip elevators without an energy profile.
        let Some(profile) = world.energy_profile(eid).cloned() else {
            continue;
        };

        let is_moving = world.elevator(eid).is_some_and(|c| c.phase.is_moving());
        let current_load = world.elevator(eid).map_or(0.0, |c| c.current_load);
        let velocity = world.velocity(eid).map_or(0.0, |v| v.value);

        let (consumed, regenerated) =
            compute_tick_energy(&profile, is_moving, current_load, velocity);

        // Auto-initialize metrics if a profile exists but metrics weren't set.
        if world.energy_metrics(eid).is_none() {
            world.set_energy_metrics(eid, crate::energy::EnergyMetrics::default());
        }
        if let Some(metrics) = world.energy_metrics_mut(eid) {
            metrics.record(consumed, regenerated);
        }

        if consumed > 0.0 || regenerated > 0.0 {
            events.emit(Event::EnergyConsumed {
                elevator: eid,
                consumed: consumed.into(),
                regenerated: regenerated.into(),
                tick: ctx.tick,
            });
        }
    }
}