tonyear.calculate_tonyears

tonyear.calculate_tonyears#

tonyear.calculate_tonyears(method: str, baseline: ndarray, time_horizon: int, delay: int, discount_rate: float) dict[source]#

This function calculates the benefit of a delayed emission according one of two ton-year accounting methods.

Parameters:
methodstr

The ton-year accounting method (Moura Costa: ‘mc’, Lashof: ‘lashof’, Climate Action Reserve: ‘car’, or Quebec: ‘qc’)

baselinenp.ndarray

Array modeling the residence of an emission in the atmosphere over time, i.e. a decay curve / impulse response function

time_horizonint

Specifies the period over which the impact of an emission is considered (years)

delayint

Specifies the emission delay for which a ton-year benefit will be calculated (years)

discount_ratefloat

Specifies the discount rate to apply time preference to both costs and benefits over the time horizon. Extreme caution should be used when applying discounting within ton-year accounting. See documentation for more details.

Returns:
method_dictdict

Return dict with the following keys:

  • parameters : key parameters used for the calculation

  • baseline : array modeling baseline emission curve, discounted if applicable

  • scenario : array modeling the scenario curve, discounted if applicable

  • baseline_atm_cost : the cost of of a baseline emission

  • benefit : the benefit of delaying an emission, calculated according to specified accounting method

  • num_for_equivalence : the ratio between the baseline cost and the benefit