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.

average_tuples(l)[source]
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

max_tuples(l)[source]
run_adaptation_calculation(file_id, data_path, output_path, duration_max=10, discount_rate=12, growth_rate=6, read_from_file=False)[source]
sum_tuples(l)[source]

vtra.adaptation.run_options_national module

Assess national adaptation options

vtra.adaptation.run_options_provincial module

Assess provincial adaptation options