Analysis and Results¶
Important
- This section describes the steps Analysis and Results steps of the Argentina Transport Risk Analysis (ATRA)
- To implement the ATRA without any changes in existing codes, all data described here should be created and stored exactly as indicated below
Mapping Flows onto Networks¶
- Purpose:
- Map the national-scale OD node level matrix values to network paths
- For all transport modes at national scale
- Estimate 2 values - A MIN and a MAX value of flows between each selected OD node pair
- Based on MIN-MAX generalised costs estimates
- Execution:
- Load data as described in Topological network requirements and OD matrices requirements
- For road, rail, port OD matrices run
atra.analysis.flow_mapping
- Result:
- Store OD flow paths in csv outputs in
/results/flow_mapping_paths/
- Store total OD flows on edges in csv files in
/results/flow_mapping_combined/
- Optional - Store OD flows on edges in shapefiles in
/results/flow_mapping_shapefiles/
- csv files in
/results/flow_mapping_paths/
contain attributes: origin_id
- String node ID of Origindestination_id
- String node ID of Destinationorigin_province
- String name of Province of Origin node IDdestination_province
- String name of Province of Destination node IDmin_edge_path
- List of string of edge IDs for paths with minimum generalised cost flowsmax_edge_path
- List of string of edge IDs for paths with maximum generalised cost flowsmin_distance
- Float values of estimated distance for paths with minimum generalised cost flowsmax_distance
- Float values of estimated distance for paths with maximum generalised cost flowsmin_time
- Float values of estimated time for paths with minimum generalised cost flowsmax_time
- Float values of estimated time for paths with maximum generalised cost flowsmin_gcost
- Float values of estimated generalised cost for paths with minimum generalised cost flowsmax_gcost
- Float values of estimated generalised cost for paths with maximum generalised cost flowsmin_total_tons
- Float values of estimated daily minimum total tonnages for all industries bettween OD pairmax_total_tons
- Float values of estimated daily maximum total tonnages for all industries bettween OD pairindustry_columns
- All daily tonnages of industry columns given in the OD matrix data for specific sectors
- csv files in
- csv files in
/results/flow_mapping_combined/
contain attributes: edge_id
- String edge IDmin_total_tons
- Float values of estimated daily minimum total tonnages on edgemax_total_tons
- Float values of estimated daily maximum total tonnages on edgecommodity/industry_columns
- All total daily tonnages of commodity/industry columns on edge
- csv files in
- Store OD flow paths in csv outputs in
Hazard Exposure¶
- Purpose:
- Intersect hazards and network line and point geometries with hazatd polygons
- Write final results to Shapefiles
- Collect network-hazard intersection attributes
- Combine with boundary Polygons to collect network-hazard-boundary intersection attributes
- Write final results to an Excel sheet
- Execution:
- Result:
- Store shapefile outputs in the directory
/results/networks_hazards_intersection_shapefiles/
- All hazard-edge intersection shapefiles with attributes:
edge_id
- String name of intersecting edge IDlength
- Float length of intersection of edge LineString and hazard Polygongeometry
- LineString geometry of intersection of edge LineString and hazard Polygon
- All hazard-node intersection shapefile with attributes:
node_id
- String name of intersecting node IDgeometry
- Point geometry of intersecting node ID
- Store summarised results in csv files in path
/results/hazard_scenarios/
- csv files of network-hazard-boundary intersection with attributes:
edge_id
/node_id
- String name of intersecting edge ID or node IDlength
- Float length of intersection of edge LineString and hazard Polygon: Only for edgesprovince_id
- String/Integer ID of Provinceprovince_name
- String name of Provincedepartment_id
- String/Integer ID of Departmentdepartment_name
- String name of Departmenthazard_type
- String name of hazard typemodel
- String name of hazard modelyear
- String name of hazard yearclimate_scenario
- String name of hazard scenarioprobability
- Float/String value of hazard probabilitymin_depth
- Integer value of minimum value of flood depth of exposuremax_depth
- Integer value of maximum value of flood depth of exposure
- Store shapefile outputs in the directory
Combine hazard scenarios for risk weights¶
- Purpose
- Combine failure scenarios across probability levels into single value per hazard type, scenario, network edges
- The risk weights are the sum of probability*exposure for each hazard type intersecting network edges
- Execution
- Load results from Hazard exposure and Topological network requirements
- Run
atra.analysis.collect_network_hazard_scenarios_national
- Result
Combined scenarios in
results/network_stats/{mode}_hazard_intersections_risk_weights.csv
edge_id/bridge_id
- string, name of failed edgehazard_type
- string, name of hazardmodel
- string, name of hazard model (if any)climate_scenario
- string, name of climate scenario (if any)year
- integer, year of hazard dataedge_length
- float, length of edgemin/max_height
- float, hazard height (if any)min/max_exposure_percent
- float, percentage of edge exposed to hazardmin/max_duration_wt
- float, duration weightmin/max_exposure_length
- float, length of edge exposed to hazardrisk_wt
- float, risk weightdam_wt
- float, damage weight
Network Failure Analysis¶
- Purpose:
- Failure analysis of edges in invidiual networks
- To estimate flow isolations and rerouting effects on same network
- Failure analysis of edges in networks with multi-modal options
- To estimate flow isolations and rerouting effects with multi-modal options
- Execution:
- Load network and flow excel data as described in Topological network requirements, Mapping Flows onto Networks, and failure scenarios from Hazard exposure
- For all networks failure analysis run
atra.analysis.failure_estimation
- For networks failure analysis with multi-modal options run
atra.analysis.multi_modal_failure_estimation
- Result:
- Store csv outputs in the directory
/results/failure_results/
- Optional - Store shapefile outputs in
/results/failure_shapefiles/
- All failure scenarios results in
/results/failure_results/all_fail_scenarios/
edge_id
- String name or list of failed edgesorigin_id
- String node ID of Origin of disrupted OD flowdestination_id
- String node ID of Destination of disrupted OD floworigin_province
- String name of Province of Origin node ID of disrupted OD flowdestination_province
- String name of Province of Destination node ID of disrupted OD flowno_access
- Boolean 1 (no reroutng) or 0 (rerouting)min/max_distance
- Float value of estimated distance of OD journey before disruptionmin/max_time
- Float value of estimated time of OD journey before disruptionmin/max_gcost
- Float value of estimated travel cost of OD journey before disruptionnew_cost
- Float value of estimated cost of OD journey after disruptionnew_distance
- Float value of estimated distance of OD journey after disruptionnew_path
- List of string edge IDs of estimated new route of OD journey after disruptionnew_time
- Float value of estimated time of OD journey after disruptiondist_diff
- Float value of Post disruption minus per-disruption distancetime_diff
- Float value Post disruption minus per-disruption timeemin/max_tr_loss
- Float value of estimated change in rerouting costindustry_columns
- Float values of all daily tonnages of industry columns along disrupted OD pairsmin/max_total_tons
- Float values of total daily tonnages along disrupted OD pairs
- All failure scenarios results in
- Isolated OD scenarios - OD flows with no rerouting options in
/results/failure_results/isolated_od_scenarios/
edge_id
- String name or list of failed edgesorigin_province
- String name of Province of Origin node ID of disrupted OD flowdestination_province
- String name of Province of Destination node ID of disrupted OD flowindustry_columns
- Float values of all daily tonnages of industry columns along disrupted OD pairsmin/max_total_tons
- Float values of total daily tonnages along disrupted OD pairs
- Isolated OD scenarios - OD flows with no rerouting options in
- Rerouting scenarios - OD flows with rerouting options in
/results/failure_results/rerouting_scenarios/
edge_id
- String name or list of failed edgeso_region
- String name of Province of Origin node ID of disrupted OD flowd_region
- String name of Province of Destination node ID of disrupted OD flowmin/max_tr_loss
- Float value of change in rerouting costmin/max_total_tons
- Float values of total daily tonnages along disrupted OD pairs
- Rerouting scenarios - OD flows with rerouting options in
- Min-max combined scenarios - Combined min-max results along each edge in
/results/failure_results/minmax_combined_scenarios/
edge_id
- String name or list of failed edgesno_access
- Boolean 1 (no reroutng) or 0 (rerouting)min/max_tr_loss
- Float values of change in rerouting costmin/max_total_tons
- Float values of total daily tonnages affected by disrupted edge
- Min-max combined scenarios - Combined min-max results along each edge in
- Shapefile min-max combined scenarios
edge_id
- String name or list of failed edgesno_access
- Boolean 1 (no reroutng) or 0 (rerouting)min/max_tr_loss
- Float values of change in rerouting costmin/max_total_tons
- Float values of total daily tonnages affted by disrupted edgegeometry
- LineString geomtry of edges
- Store csv outputs in the directory
Macroeconomic loss Analysis¶
- Purpose:
- Macroeconomic losses analysis due to edge failures in networks
- To estimate economic impacts of flow isolations/disruptions
- To understand the wider economic impacts of these disruptions
- Execution:
- Load data described in Macroeconomic Data and OD matrices requirements
- To create the multiregional input-output table for Argentina, run
atra.mrio.run_mrio
- To perform the loss analysis, run
atra.mria.run_mria
- Result:
- Store the new multiregional input-output table in
/data/economic_IO_tables/output_data/
- files
IO_ARGENTINA.xlsx
contain: - Sheetname
T
with the full multiregional table - Sheetname
labels_T
with the column and row labels of matrixT
- Sheetname
FD
with the final demand columns of the new table - Sheetname
labels_FD
with the column labels of matrixFD
- Sheetname
ExpROW
with the export to the Rest of the World columns of the new table - Sheetname
labels_ExpROW
with the column labels of matrixExpROW
- Sheetname
VA
with the value added rows of the new table - Sheetname
labels_VA
with the row labels of matrixVA
- Sheetname
- files
- Store the new multiregional input-output table in
- Store csv files in
/results/economic_failure_losses/summarized/
- All summarized files have the following attributes:
edge_id
- String edge IDstotal_losses
- Value of the total economic losses due to the disruption of the corresponding edge ID
- Store csv files in
/results/economic_failure_losses/od_region_losses/
- All od_losses file have the following attributes:
edge_id
- String edge IDsregion
- String name of the regiondir_losses
- Value of the direct losses due to the diruption of the corresponding edge ID in the corresponding regiontotal_losses
- Value of the total losses due to the diruption of the corresponding edge ID in the corresponding regionind_losses
- Value of the indirect losses due to the diruption of the corresponding edge ID in the corresponding region
Combining Network Failure and Macroeconomic loss Results¶
- Purpose:
- Combine macroeconomic loss estimates with rerouting losses
- Execution:
- Load data described in Failure Analysis and Macroeconomic loss analysis
- Run
atra.analysis.economic_failure_combine_national
- Result:
- Store csv files in
/results/failure_results/minmax_combined_scenarios/
- Files with names
single_edge_failures_minmax_national_{mode}_{x}_percent_disrupt.csv
orsingle_edge_failures_minmax_national_{mode}_{x}_percent_disrupt_multi_modal.csv
orsingle_edge_failures_minmax_national_{mode}_{x}_percent_modal_shift.csv
contain edge_id
- String name or list of failed edgesno_access
- Boolean 1 (no reroutng) or 0 (rerouting)min/max_tr_loss
- Float values of change in rerouting costmin/max_total_tons
- Float values of total daily tonnages affected by disrupted edgemin/max_econ_loss
- Float values of total daily macroeconomic lossesmin/max_econ_impact
- Float values of sum of transport loss and macroeconomic loss
- Files with names
- Store csv files in
Estimating the bridge flows and failure losses¶
- Purpose:
- Estimate the flows and failure losses on the national-roads bridges
- This done after all road failure analysis is performed because bridges results are estimated through the road failures
- Execution:
- Result:
- Creates outputs for bridges similar to the ones explained in Mapping Flows onto Networks
- Creates outputs for bridges similar to the ones explained in Combining Network Failure and Macroeconomic loss Results
Adaptation¶
- Purpose:
- Generate adaption scenarios/strategies and examine their costs, benefits, net present values and benefit-cost ratios
- For roads and bridges, based on different types of hazards, road assets and climate-change conditions
- Execution:
- Load data described in Topological network requirements, Combining Network Failure and Macroeconomic loss Results, and Adaptation Options
- Common functions are in
atra.adaptation_options
- Run
atra.analysis.adaptation_analysis
- Result:
- Store results as excel sheets in
/results/adaptation_results/
- All adaptation results have the following attributes:
edge_id
/bridge_id
- string, edge or bridges IDshazard_type
- string, names of hazard typesmodel
- string, names of hazard modelsclimate_scenario
- string, names of climate scenariosyear
- integer, values of year of hazard climate modelswidth
- float, edge widthsedge_length
- float, edge lengthsmin/max_depth
- float, heights of hazard exposure - if floodingmin/max_exposure_percent
- float, percent of edge length exposed to hazardmin/max_duration_wt
- float, duration of disruption of edgemin/max_exposure_length
- float, edge length exposed to hazardrisk_wt
- float, weight given to estimating expected annual lossesdam_wt
- float, weight given to estimating expected annual damage costsmin/max_econ_impact
- float, minimum/maximum economic impactmin/max_benefit
- float, minimum/maximum benefitmin/max_ini_adap_cost
- float, minimum/maximum initial adaptation costmin/max_tot_adap_cost
- float, minimum/maximum total adaptation costmin/max_bc_ratio
- float, minimum/maximum benefit cost ratiomin/max_bc_diff
- float, minimum/maximum benefit cost difference- Attributes specific to the roads or bridges
- Store results as excel sheets in
Processing outputs and plots¶
- Purpose:
- Several scripts are written to generate statistics and plots to process results
- These codes are very specific to the kinds of data and outputs produced from the analysis
- See the scripts with
atra.stats
andatra.plot