vtra.adaptation package¶
Submodules¶
vtra.adaptation.adaptation_options module¶
Estimate costs and benefits, either under fixed parameters or under a sensitivity analysis, varying the cost components.
-
calc_costs
(x, param_values, mnt_dis_cost, mnt_nat_cost, cst_dis_cost, cst_nat_cost, brdg_cost, pavement, mnt_main_cost, cst_main_cost, discount_rates, discount_growth_rates, rehab_costs, min_main_dr, max_main_dr, duration_max=10, min_exp=True, national=False, min_loss=True)[source]¶ Estimate the total cost and benefits for a road segment. This function is used within a pandas apply
Parameters: - x – a row from the road segment dataframe that we are considering
- param_values – numpy array with a set of parameter combinations
- mnt_dis_cost – adaptation costs for a district road in the mountains
- mnt_nat_cost – adaptation costs for a national road in the mountains
- cst_dis_cost – adaptation costs for a district road on flat terrain
- cst_nat_cost – adaptation costs for a national road on flat terrain
- pavement – set of paving combinations. This corresponds with the cost table and the param_values
- mnt_main_cost – maintenance costs for roads in the mountains
- cst_main_cost – maintenance costs for roads on flat terrain
- discount_rates – discount rates to be used for the costs
- discount_growth_rates – discount rates to be used for the losses
- rehab_costs – rehabilitation costs after a disaster
- min_main_dr – discount rates for 4-year periodic maintenance
- max_main_dr – discount rates for 8-year periodic maintenance
- min_exp (bool, optional) – Specify whether we want to use the minimum or maximum exposure length. The default value is set to True
- national (bool, optional) – Specify whether we are looking at national roads. The default value is set to False
- min_loss (bool, optional) – Specify whether we want to use the minimum or maximum economic losses. The default value is set to True
Returns: - uncer_output (list) – outcomes for the initial adaptation costs of this road segment
- tot_uncer_output (list) – outcomes for the total adaptation costs of this road segment
- rel_share (list) – relative share of each factor in the initial adaptation cost of this road segment
- tot_rel_share (list) – relative share of each factor in the total adaptation cost of this road segment
- bc_ratio (list) – benefit cost ratios for this road segment
-
calculate_discounting_arrays
(discount_rate=12, growth_rate=6)[source]¶ Set discount rates for yearly and period maintenance costs
Parameters: - discount_rate – yearly discount rate
- growth_rate – yearly growth rate
Returns: - discount_rate_norm – discount rates to be used for the costs
- discount_rate_growth – discount rates to be used for the losses
- min_main_dr – discount rates for 4-year periodic maintenance
- max_main_dr – discount rates for 8-year periodic maintenance
vtra.adaptation.run_options_national module¶
Assess national adaptation options
vtra.adaptation.run_options_provincial module¶
Assess provincial adaptation options