Replace depreciated functions in OSMnx

demos_and_examples/example_16en_import_from_OpenStreetMap.py

@@ -10,7 +10,7 @@
 )
 
 #Tokyo highway
-nodes, links = OSMImporter.import_osm_data(north=35.817, south=35.570, east=139.881, west=139.583, custom_filter='["highway"~"motorway"]')
+nodes, links = OSMImporter.import_osm_data(bbox=(35.817, 35.570, 139.881, 139.583), custom_filter='["highway"~"motorway"]')
 nodes, links = OSMImporter.osm_network_postprocessing(nodes, links, node_merge_threshold=0.005, node_merge_iteration=5, enforce_bidirectional=True)  # merge threshold distance: 0.005 degree ~= 500 m. `enforce_bidirectional` makes all links bidirectional, so that network is not fragmented (but the original network topology is not preserved rigorously).
 OSMImporter.osm_network_visualize(nodes, links, show_link_name=0)
 OSMImporter.osm_network_to_World(W, nodes, links, default_jam_density=0.2, coef_degree_to_meter=111000)

demos_and_examples/uxsim/OSMImporter/OSMImporter.py

@@ -26,7 +26,7 @@ class OSMImporter:
     OpenStreetMap importer using OSMnx.
     Work in progress. Import from OSM is experimental and may not work as expected. It is functional but may produce inappropriate networks for simulation, such as too many nodes, too many deadends, fragmented networks.
     """
-    def import_osm_data(north, south, east, west, custom_filter='["highway"~"trunk|primary"]', 
+    def import_osm_data(north=None, south=None, east=None, west=None, bbox=None, custom_filter='["highway"~"trunk|primary"]', 
                         default_number_of_lanes_mortorway=3, default_number_of_lanes_trunk=3, 
                         default_number_of_lanes_primary=2, default_number_of_lanes_secondary=2, 
                         default_number_of_lanes_residential=1, default_number_of_lanes_tertiary=1, 
@@ -42,6 +42,8 @@ def import_osm_data(north, south, east, west, custom_filter='["highway"~"trunk|p
         ----------
         north, south, east, west: float
             The latitudes and longitudes of the area to be imported.
+        bbox: list
+            The bounding box of the area to be imported. The order is [north, south, east, west]. This is prioritized than north, south, east, west arguments.
         custom_filter: str
             The filter to be used for importing the data. 
             The default is '["highway"~"trunk|primary"]', which means that only trunk and primary roads (usually correspond to major arterial roads) are imported.
@@ -68,7 +70,14 @@ def import_osm_data(north, south, east, west, custom_filter='["highway"~"trunk|p
             raise ImportError("Optional module 'osmnx' is not installed. Please install it by 'pip install osmnx' to use this function.")
 
         print("Start downloading OSM data. This may take some time.")
-        G = ox.graph.graph_from_bbox(north=north, south=south, east=east, west=west, network_type="drive", 
+        if bbox is not None:
+            try:
+                G = ox.graph.graph_from_bbox(bbox=bbox, network_type="drive", custom_filter=custom_filter)
+            except TypeError: #version issue?
+                warnings.warn("OSMnx version may be too old. Update is recommended.")
+                G = ox.graph.graph_from_bbox(north=bbox[0], south=bbox[1], east=bbox[2], west=bbox[3], network_type="drive", custom_filter=custom_filter)
+        else:
+            G = ox.graph.graph_from_bbox(north=north, south=south, east=east, west=west, network_type="drive", 
                                     custom_filter=custom_filter)
         print("Download completed")
         """

demos_and_examples/uxsim/uxsim.py

@@ -374,26 +374,32 @@ def __init__(s, W, name, start_node, end_node, length, free_flow_speed=20, jam_d
         Notes
         -----
         Traffic Flow Model:
+
         - The link model follows a multi-lane, single-pipe approach where FIFO is guaranteed per link and no lane changing occurs.
         - Fundamental diagram parameters such as free_flow_speed, jam_density (or jam_density_per_lane), and number_of_lanes determine the link's flow characteristics. Reaction time of drivers `REACTION_TIME` is a grobal parameter.
         - Real-time link status for external reference is maintained with attributes `speed`, `density`, `flow`, `num_vehicles`, and `num_vehicles_queue`.
 
         Traffic Flow Model Parameters:
+
         - Their definition is illustrated as https://toruseo.jp/UXsim/docs/_images/fundamental_diagram.png
         - If you are not familiar to the traffic flow theory, it is recommended that you adjust only `free_flow_speed` and `number_of_lanes` for the traffic flow model parameters, leaving the other parameters at their default values.
 
         Capacity and Bottlenecks:
+
         - The `capacity_out` and `capacity_in` parameters set the outflow and inflow capacities of the link. If not provided, the capacities are unlimited.
         - These capacities can represent bottlenecks at the beginning or end of the link.
 
         Connection to Node Model:
+
         - At the downstream end of a sending link, vehicles in all lanes have the right to be sent out, but FIFO order is maintained.
         - At the upstream end of a receiving link, all lanes can accept vehicles.
 
         Parameter Adjustments:
+
         - Some traffic flow model parameters like `free_flow_speed`, `jam_density`, `capacity_out`, `capacity_in`, and `merge_priority` can be altered during simulation to reflect changing conditions.
             
         Details on Multi-lane model:
+
         - Link model:
             - Multiple lanes with single-pipe model. FIFO is guaranteed per link. No lane changing.
             - Links have a `lanes` attribute representing the number of lanes. 
@@ -406,22 +412,23 @@ def __init__(s, W, name, start_node, end_node, length, free_flow_speed=20, jam_d
             - Receiving links:  
                 - All lanes at the upstream end of the link can accept vehicles.
 
-        Details on Fundamental diagram parameters (*: input, **: alternative input):
-        - *free_flow_speed (m/s)
-        - *jam_density (veh/m/LINK)  
-        - **jam_density_per_lane (veh/m/lane)
-        - *lanes, number_of_lane (lane) 
+        Details on Fundamental diagram parameters (+: input, ++: alternative input):
+
+        - free_flow_speed (m/s)+
+        - jam_density (veh/m/LINK)+
+        - jam_density_per_lane (veh/m/lane)++
+        - lanes, number_of_lane (lane)+
         - tau: y-intercept of link FD (s/veh*LINK)
-        - REACTION_TIME (s/veh*lane) 
+        - REACTION_TIME, World.reaction_time (s/veh*lane) 
         - w (m/s)
         - capacity (veh/s/LINK)
         - capacity_per_lane (veh/s/lane)
         - delta: minimum spacing (m/veh*LINK)
         - delta_per_lane: minimum spacing in lane (m/veh*lane) 
         - q_star: capacity (veh/s/LINK)
         - k_star: critical density (veh/s/LINK)
-        - *capacity_in, capacity_out: bottleneck capacity at beginning/end of link (veh/s/LINK)
-        - *Node.flow_capacity: node flow capacity (veh/s/LINK-LIKE) 
+        - capacity_in, capacity_out: bottleneck capacity at beginning/end of link (veh/s/LINK)+
+        - Node.flow_capacity: node flow capacity (veh/s/LINK-LIKE)+
         """
 
         s.W = W

tests/test_other_functions.py

@@ -72,8 +72,6 @@ def test_analyzer():
     assert True
 
 @pytest.mark.filterwarnings("ignore::UserWarning")
-@pytest.mark.filterwarnings("ignore::DeprecationWarning") #TODO: Current usage of OSMnx will be deprecated in the future. Need to update.
-@pytest.mark.filterwarnings("ignore:Iteration over multi-part geometries is deprecated")
 def test_osm_import():
     from uxsim.OSMImporter import OSMImporter
 
@@ -86,7 +84,7 @@ def test_osm_import():
     )
 
     #Tokyo highway
-    nodes, links = OSMImporter.import_osm_data(north=35.817, south=35.570, east=139.881, west=139.583, custom_filter='["highway"~"motorway"]')
+    nodes, links = OSMImporter.import_osm_data(bbox=(35.817, 35.570, 139.881, 139.583), custom_filter='["highway"~"motorway"]')
     nodes, links = OSMImporter.osm_network_postprocessing(nodes, links, node_merge_threshold=0.005, node_merge_iteration=5, enforce_bidirectional=True)  # merge threshold distance: 0.005 degree ~= 500 m. `enforce_bidirectional` makes all links bidirectional, so that network is not fragmented (but the original network topology is not preserved rigorously).
     OSMImporter.osm_network_visualize(nodes, links, show_link_name=0, show_mode=0, save_mode=0)
     OSMImporter.osm_network_to_World(W, nodes, links, default_jam_density=0.2, coef_degree_to_meter=111000)

uxsim/OSMImporter/OSMImporter.py

@@ -26,7 +26,7 @@ class OSMImporter:
     OpenStreetMap importer using OSMnx.
     Work in progress. Import from OSM is experimental and may not work as expected. It is functional but may produce inappropriate networks for simulation, such as too many nodes, too many deadends, fragmented networks.
     """
-    def import_osm_data(north, south, east, west, custom_filter='["highway"~"trunk|primary"]', 
+    def import_osm_data(north=None, south=None, east=None, west=None, bbox=None, custom_filter='["highway"~"trunk|primary"]', 
                         default_number_of_lanes_mortorway=3, default_number_of_lanes_trunk=3, 
                         default_number_of_lanes_primary=2, default_number_of_lanes_secondary=2, 
                         default_number_of_lanes_residential=1, default_number_of_lanes_tertiary=1, 
@@ -42,6 +42,8 @@ def import_osm_data(north, south, east, west, custom_filter='["highway"~"trunk|p
         ----------
         north, south, east, west: float
             The latitudes and longitudes of the area to be imported.
+        bbox: list
+            The bounding box of the area to be imported. The order is [north, south, east, west]. This is prioritized than north, south, east, west arguments.
         custom_filter: str
             The filter to be used for importing the data. 
             The default is '["highway"~"trunk|primary"]', which means that only trunk and primary roads (usually correspond to major arterial roads) are imported.
@@ -68,7 +70,14 @@ def import_osm_data(north, south, east, west, custom_filter='["highway"~"trunk|p
             raise ImportError("Optional module 'osmnx' is not installed. Please install it by 'pip install osmnx' to use this function.")
 
         print("Start downloading OSM data. This may take some time.")
-        G = ox.graph.graph_from_bbox(north=north, south=south, east=east, west=west, network_type="drive", 
+        if bbox is not None:
+            try:
+                G = ox.graph.graph_from_bbox(bbox=bbox, network_type="drive", custom_filter=custom_filter)
+            except TypeError: #version issue?
+                warnings.warn("OSMnx version may be too old. Update is recommended.")
+                G = ox.graph.graph_from_bbox(north=bbox[0], south=bbox[1], east=bbox[2], west=bbox[3], network_type="drive", custom_filter=custom_filter)
+        else:
+            G = ox.graph.graph_from_bbox(north=north, south=south, east=east, west=west, network_type="drive", 
                                     custom_filter=custom_filter)
         print("Download completed")
         """