Tutorials#

Step-by-step worked examples for every RA2CE module. Find the question you’re trying to answer, pick the right analysis, and follow an executable notebook to results.

Note

First time here? Getting Started covers installation and the required folder structure. Come back once your environment is ready.

Foundation

Required for all analyses
OSM import .shp shapefile
Network step 01
Build your network
Import or download a graph representation of your transport network. All subsequent analyses depend on this foundation step.
User questions
  • How do I create a new (road) network?
  • How do I import a pre-defined shapefile network?
Network from OSM download → Network from shapefile →
2 m 0 m Flood depth (m) per segment
Hazard step 02
Overlay hazard data
Map flood, earthquake, or other hazard intensity onto each network link. Produces per-segment exposure attributes used in all downstream risk analyses.
User questions
  • How do I overlay hazard data onto my network?
  • How is the hazard intensity in my network?
  • How much water is expected at each (road) segment?
Hazard overlay tutorial →

Analysis modules

Choose one or combine
+22 min detour Origin Destination Closed link
Criticality analysis
Network redundancy & detour analysis
Identify which links, when disrupted, cause the greatest impact to network connectivity. Compute detour times and quantify the cost of losing any road segment.
User questions
  • How redundant is my network?
  • Are there alternative routes?
  • What is the detour time during a disaster?
Single link redundancy tutorial → Multi link redundancy tutorial →
🏥 A B C 12 min 34 min Isolated Reachable Detour No access
Accessibility analysis
Origin–destination reachability
Measure travel times from origin zones to critical destinations: hospitals, shelters, emergency services. Under normal and disrupted network conditions.
User questions
  • What is the shortest evacuation route in emergency conditions?
  • Are critical services reachable during a disaster?
  • Which districts are isolated from essential services in emergency conditions?
Defined OD pairs tutorial → Origins to closest destinations →
Water depth (m) 0 50% 75% 100% Reference curves Manual curves EAD € 2.4 M / yr
Damages analysis
Physical damage & EAD estimation
Apply intensity–damage functions to exposed road segments to estimate repair costs per event, then integrate across return periods to compute Expected Annual Damage.
User questions
  • What is the estimated physical (direct) damage to my infrastructure for an event?
  • What is the EAD (Expected Annual Damage) to my infrastructure?
  • How much should be saved/invested to cover future repair costs?
Reference damage curves tutorial → Manual damage curves tutorial → Expected Annual Damage (EAD) →
EAL € 890 K / yr 1:10 1:50 1:100 1:250 Return period Loss Travel time lost
Losses analysis
Economic losses & EAL estimation
Translate network disruption into indirect economic losses: value of lost travel time, freight delays and integrate across return periods to derive Expected Annual Loss.
User questions
  • What is the estimated economic (indirect) loss from a service disruption of the infrastructure due to an event?
  • What is the EAL (Expected Annual Loss) to my infrastructure?
Multi link redundancy losses →

What you'll get

Example outputs
Water depth
Damage curves
Depth–damage functions
Road segment
EAD per segment
Expected annual damage
OK Critical Detour
Network risk map
Criticality per link

Advanced modules

Build on analysis results
🛡️
Advanced
Adaptation
Resilience strategy evaluation
Compare infrastructure upgrades, nature-based solutions, and maintenance strategies by their impact on EAD and network connectivity under current and future hazard conditions. Identify the most cost-effective resilience measures.
⚖️
Advanced
Equity
Distributional risk analysis
Evaluate who is most exposed to infrastructure disruptions. Identify socially vulnerable populations with limited access to alternative routes or critical services, and quantify the equity implications of adaptation choices.
How does RA2CE work? — Modelling framework

The diagram below shows how all modules connect. Each box is clickable. Solid arrows are required inputs; dashed arrows are optional.

1 · Network 2 · Network Exposure (Hazard) 4 · Network Criticality (connectivity & detour) 3 · Damages ($) (physical repair cost) 5 · Losses ($ / pax) (indirect economic loss) 6 · Annual Expected Damages & Losses (EAD / EAL) 7 · Prioritisation / 8 · Adaptation Measures Accessibility (services reachable?) Equity (distributional impact) required input optional input Click any module to jump to its tutorial
icon:

map

🗺 Network — “Do I have a usable road network?”

  • How do I create a road network from OpenStreetMap?
  • How do I import a pre-defined shapefile network?
  • How do I clean and prepare my network for analysis?
Network

🌊 Hazard — “Where is my network exposed?”

  • What flood depth is expected at each road segment?
  • How do I overlay a hazard map onto my network?
  • Which links are inundated during a 1-in-100-year event?
Hazard
Edit on GitHub
Show Source