uxsim-rs — Macroscopic City-Wide Traffic Flow & Kinematic Wave Simulator in Rust

[dependencies]
uxsim-rs = "0.1"
glam = "0.29"

use glam::Vec2;
use uxsim_rs::prelude::*;
use uxsim_rs::{Link, RoadNetwork, TrafficSimulator};
use uxsim_rs::flow_model::{FlowModel, NewellTriangular};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut network = RoadNetwork::new();

    // 1. Add intersection nodes
    network.add_node(1, Vec2::new(0.0, 0.0))?;
    network.add_node(2, Vec2::new(500.0, 0.0))?;
    network.add_node(3, Vec2::new(1000.0, 0.0))?;

    // 2. Add road links (length: 500m, 2 lanes, urban Newell model)
    let flow_model = FlowModel::NewellTriangular(NewellTriangular::standard_urban());
    network.add_link(Link::new(12, 1, 2, 500.0, 2, flow_model))?;
    network.add_link(Link::new(23, 2, 3, 500.0, 2, flow_model))?;

    // 3. Initialize simulator with 1.0s timestep
    let mut sim = TrafficSimulator::new(network, 1.0);

    // 4. Inject trips (A* dynamic auto-routing)
    sim.add_trip(1001, 1, 3, 0.0)?;

    // 5. Step simulation
    for _ in 0..60 {
        sim.step();
    }

    println!("Simulation step completed successfully!");
    Ok(())
}

Bevy RenderBubble Handoff Loop

use glam::Vec2;
use uxsim_rs::handoff::RenderBubble;

fn sync_traffic_bubble(sim: &mut TrafficSimulator, player_pos: Vec2) {
    let bubble = RenderBubble::new(player_pos, 150.0, 25.0);

    // 1. Query macroscopic vehicles in bubble
    let entering = sim.query_vehicles_in_bubble(&bubble);
    for veh_id in entering {
        if let Ok(handoff) = sim.handoff_to_micro(veh_id) {
            // Spawn high-fidelity Bevy 3D entity
            spawn_bevy_micro_car(
                handoff.world_position,
                handoff.forward_direction,
                handoff.speed
            );
        }
    }
}