Struct Metrics 

#[non_exhaustive]
pub struct Metrics { /* private fields */ }

Aggregated simulation metrics, updated each tick from events.

Games query this via sim.metrics() for HUD display, scoring, or scenario evaluation.

Implementations

impl Metrics

pub fn new() -> Self

Create a new Metrics with default throughput window (3600 ticks).

pub const fn with_throughput_window(self, window_ticks: u64) -> Self

Set the throughput window size (builder pattern).

pub const fn avg_wait_time(&self) -> f64

Average wait time in ticks (spawn to board).

pub const fn avg_ride_time(&self) -> f64

Average ride time in ticks (board to exit).

pub const fn max_wait_time(&self) -> u64

Maximum wait time observed (ticks).

pub const fn throughput(&self) -> u64

Riders delivered in the current throughput window.

pub const fn total_delivered(&self) -> u64

Riders delivered total.

pub const fn total_abandoned(&self) -> u64

Riders who abandoned.

pub const fn total_spawned(&self) -> u64

Total riders spawned.

pub const fn abandonment_rate(&self) -> f64

Abandonment rate (0.0 - 1.0).

pub const fn total_distance(&self) -> f64

Total distance traveled by all elevators.

pub const fn utilization_by_group(&self) -> &HashMap<String, f64>

Per-group instantaneous elevator utilization (fraction of elevators moving).

pub const fn reposition_distance(&self) -> f64

Total distance traveled by elevators while repositioning.

pub const fn total_moves(&self) -> u64

Total rounded-floor transitions across all elevators (passing-floor crossings plus arrivals).

pub const fn total_settled(&self) -> u64

Total riders settled as residents.

pub const fn total_rerouted(&self) -> u64

Total riders rerouted from resident phase.

pub const fn throughput_window_ticks(&self) -> u64

Window size for throughput calculation (ticks).

pub const fn total_energy_consumed(&self) -> f64

Total energy consumed by all elevators (requires energy feature).

pub const fn total_energy_regenerated(&self) -> f64

Total energy regenerated by all elevators (requires energy feature).

pub const fn net_energy(&self) -> f64

Net energy: consumed minus regenerated (requires energy feature).

pub fn avg_utilization(&self) -> f64

Overall utilization: average across all groups.

Trait Implementations

impl Clone for Metrics

fn clone(&self) -> Metrics

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Metrics

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Metrics

fn default() -> Metrics

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Metrics

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Metrics

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Compact one-line summary for HUDs and logs.

let m = Metrics::new();
assert_eq!(format!("{m}"), "0 delivered, avg wait 0.0t, 0% util");

impl Serialize for Metrics

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

where __S: Serializer,

Serialize this value into the given Serde serializer.