Updated (02-12-2023)

This collection of functions is designed to build, optimize, and update a network graph representing an urban drainage system.

The graph is built from OpenStreetMap data and raster datasets representing various geographic and physical features. The network topology is then optimized using graph metrics such as betweenness centrality or maximum flow. Finally, the physical parameters of the network, such as pipe diameter, are updated based on historical rainfall data provided by the user.

The steps can be summarized as follows:

• Build the network topology: Use the function setup_urban_sewer_network_topology_from_osm to build a graph representing the urban drainage network. Clean up the lines and compose them into a graph.
• Setup network bedlevel: The function setup_urban_sewer_network_bedlevel_from_dem adds bedlevel information to the network based on a Digital Elevation Model.
• setup_network_topology_optimization 2‍⃣ 3‍⃣ 4‍⃣ 5‍⃣ #43 Optimize the network topology: The function setup_network_topology_optimization uses graph metrics like betweenness centrality or maximum flow to optimize the network by removing unnecessary links. Joint development with network optimization xldeltares/hybridurb#36
• setup_network_dimentions_from_rainfallstats #44 Update pipe dimensions: The function setup_network_dimentions_from_rainfallstats is used to update the physical parameters, particularly the dimensions of the pipes, based on user-provided historical rainfall data. Two steps, the first is to get the T2 volume that is designed for the system storage, the second is to distribute that volume to the network edges, by specifying pipe dimensions.
• setup_network_parameters_from_rasters #42 Setup network physical parameters: The function setup_network_parameters_from_rasters is used to add physical parameters like upstream and downstream levels, upstream area, water demand, population, and building footprint to the nodes of the graph. connected to the function setup_graph_from_rasterdataset. Question: how to add areal information to nodes?

Note that all functions that works with the graph uses function in graph_utils.

Attachment - Flow chart: