macro_traffic_sim_core 0.1.0

Core library for macroscopic traffic simulation using the classical 4-step demand model.
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137

//! # Default Values by Link Type
//!
//! Default lanes, speed, and capacity values for each link type,
//! ported from Go GMNS codebase.

use super::types::LinkType;

/// Default parameters for a given link type.
#[derive(Debug, Clone, Copy)]
pub struct LinkDefaults {
    /// Number of lanes.
    pub lanes: i32,
    /// Free-flow speed in km/h.
    pub free_speed: f64,
    /// Capacity in vehicles per hour per lane.
    pub capacity: i32,
    /// Whether the link is one-way by default.
    pub one_way: bool,
}

/// Returns default parameters for a given link type.
///
/// # Arguments
/// * `link_type` - The link type to get defaults for.
///
/// # Returns
/// A `LinkDefaults` instance with appropriate values.
///
/// # Example
/// ```
/// use macro_traffic_sim_core::gmns::defaults::get_link_defaults;
/// use macro_traffic_sim_core::gmns::types::LinkType;
///
/// let defaults = get_link_defaults(LinkType::Motorway);
/// assert_eq!(defaults.lanes, 4);
/// assert_eq!(defaults.capacity, 2300);
/// ```
pub fn get_link_defaults(link_type: LinkType) -> LinkDefaults {
    match link_type {
        LinkType::Motorway => LinkDefaults {
            lanes: 4,
            free_speed: 120.0,
            capacity: 2300,
            one_way: false,
        },
        LinkType::Trunk => LinkDefaults {
            lanes: 3,
            free_speed: 100.0,
            capacity: 2200,
            one_way: false,
        },
        LinkType::Primary => LinkDefaults {
            lanes: 3,
            free_speed: 80.0,
            capacity: 1800,
            one_way: false,
        },
        LinkType::Secondary => LinkDefaults {
            lanes: 2,
            free_speed: 60.0,
            capacity: 1600,
            one_way: false,
        },
        LinkType::Tertiary => LinkDefaults {
            lanes: 2,
            free_speed: 40.0,
            capacity: 1200,
            one_way: false,
        },
        LinkType::Residential => LinkDefaults {
            lanes: 1,
            free_speed: 30.0,
            capacity: 1000,
            one_way: false,
        },
        LinkType::LivingStreet => LinkDefaults {
            lanes: 1,
            free_speed: 15.0,
            capacity: 800,
            one_way: false,
        },
        LinkType::Service => LinkDefaults {
            lanes: 1,
            free_speed: 30.0,
            capacity: 800,
            one_way: false,
        },
        LinkType::Cycleway => LinkDefaults {
            lanes: 1,
            free_speed: 5.0,
            capacity: 800,
            one_way: true,
        },
        LinkType::Footway => LinkDefaults {
            lanes: 1,
            free_speed: 5.0,
            capacity: 800,
            one_way: true,
        },
        LinkType::Track => LinkDefaults {
            lanes: 1,
            free_speed: 30.0,
            capacity: 800,
            one_way: true,
        },
        LinkType::Unclassified => LinkDefaults {
            lanes: 1,
            free_speed: 30.0,
            capacity: 800,
            one_way: false,
        },
        LinkType::Connector => LinkDefaults {
            lanes: 2,
            free_speed: 120.0,
            capacity: 9999,
            one_way: false,
        },
        LinkType::Railway => LinkDefaults {
            lanes: 1,
            free_speed: 50.0,
            capacity: 1000,
            one_way: true,
        },
        LinkType::Aeroway => LinkDefaults {
            lanes: 1,
            free_speed: 50.0,
            capacity: 1000,
            one_way: true,
        },
        LinkType::Undefined => LinkDefaults {
            lanes: 1,
            free_speed: 30.0,
            capacity: 800,
            one_way: false,
        },
    }
}