elevator-core 6.0.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

//! "Player-as-elevator" demo — direct velocity control via
//! [`ServiceMode::Manual`](elevator_core::components::ServiceMode::Manual).
//!
//! The sim is placed into Manual mode; the "driver" commands ascent,
//! cruises, then triggers an emergency stop. Each tick we print the
//! current position and velocity so you can see the trapezoidal
//! acceleration/deceleration clamped to the elevator's kinematic caps.
//!
//! Run with:
//!
//! ```text
//! cargo run -p elevator-core --example manual_driver --release
//! ```
#![allow(clippy::unwrap_used, clippy::missing_docs_in_private_items)]

use elevator_core::prelude::*;

fn main() {
    let mut sim = SimulationBuilder::demo().build().unwrap();
    let elev = sim.world().iter_elevators().next().unwrap().0;

    sim.set_service_mode(elev, ServiceMode::Manual).unwrap();

    // Phase 1: command full ascent.
    sim.set_target_velocity(elev, 2.0).unwrap();

    println!("tick  phase        pos     vel");
    println!("----  -----------  ------  -----");

    for t in 0..180 {
        // Halfway through, slam the emergency brake.
        if t == 90 {
            sim.emergency_stop(elev).unwrap();
        }
        sim.step();

        let pos = sim.world().position(elev).unwrap().value();
        let vel = sim.velocity(elev).unwrap();
        let phase = if t < 90 { "ascending " } else { "e-stopping" };
        println!("{t:>4}  {phase}  {pos:>5.2}m  {vel:>5.2}");

        if t > 90 && vel.abs() < 1e-6 {
            println!("\nCar stopped at {pos:.2}m after {t} ticks.");
            break;
        }
    }
}