Switch MaxCapacityGrowth to compound growth (#565)

* Tidy max_capacity_expansion constraint

* Remove another unnecessary statement

* Change to compound growth

* Update documentation and test

* Update results files

* Change growth parameter and update results again

* Fix test

* Fix doctest

* Update src/muse/constraints.py

Co-authored-by: Diego Alonso Álvarez <6095790+dalonsoa@users.noreply.github.com>

---------

Co-authored-by: Diego Alonso Álvarez <6095790+dalonsoa@users.noreply.github.com>

Author: tsmbland

docs/inputs/technodata.rst

@@ -86,7 +86,7 @@ Growith constraints
       represents the maximum addition of installed capacity per technology, per year in a period, per region.
 
    MaxCapacityGrowth
-      represents the percentage growth per year based on the available stock in a year, per region and technology.
+      represents the fraction growth per year based on the available stock in a year, per region and technology.
 
    TotalCapacityLimit
       represents the total capacity limit per technology, region and year.
@@ -101,7 +101,7 @@ Growith constraints
    it constrains the new capacity which can be installed in a modelled period as being equal to *10 * 5 = 50 PJ*.
    The *MaxCapacityGrowth* applies a constraint on the capacity which can be installed in a modelled period, which depends on the
    decommissioning profile. Assuming that 7.7 PJ of resBoilerElectric is available in the year when the decision is made (investment year), and that 4.9 PJ of
-   resBoilerElectric is available in the year at which capacities invested in, will be online, then the constraint applies as follows *7.7 * (0.2 * 5 + 1) - 4.9 = 10.5 PJ*.
+   resBoilerElectric is available in the year at which capacities invested in, will be online, then the constraint applies as follows *7.7 * ((1 + 0.2) ** 5) - 4.9 = 14.3 PJ*.
    The *TotalCapacityLimit* applies a constraint on the maximum capacity of a technology in the investment year; it depends on the decommissioning profile and equals *100 - 4.9 = 95.1 PJ*.
 
    Growth constraints are applied for each single agent in a multi-agent simulation. When only one agent is present, the growth constraints

docs/tutorial-code/add-agent/1-single-objective/technodata/gas/Technodata.csv

@@ -1,3 +1,3 @@
 ProcessName,RegionName,Time,cap_par,cap_exp,fix_par,fix_exp,var_par,var_exp,MaxCapacityAddition,MaxCapacityGrowth,TotalCapacityLimit,TechnicalLife,UtilizationFactor,ScalingSize,efficiency,InterestRate,Type,Fuel,EndUse,Agent1,Agent2
 Unit,-,Year,MUS$2010/PJ_a,-,MUS$2010/PJ,-,MUS$2010/PJ,-,PJ,%,PJ,Years,-,PJ,%,-,-,-,-,New,New
-gassupply1,R1,2020,0,1,0,1,2.55,1,10,1,100,35,0.9,0.00000189,86,0.1,energy,gas,gas,0.5,0.5
+gassupply1,R1,2020,0,1,0,1,2.55,1,10,0.5,100,35,0.9,0.00000189,86,0.1,energy,gas,gas,0.5,0.5

docs/tutorial-code/add-agent/1-single-objective/technodata/power/Technodata.csv

@@ -1,4 +1,4 @@
 ProcessName,RegionName,Time,cap_par,cap_exp,fix_par,fix_exp,var_par,var_exp,MaxCapacityAddition,MaxCapacityGrowth,TotalCapacityLimit,TechnicalLife,UtilizationFactor,ScalingSize,efficiency,InterestRate,Type,Fuel,EndUse,Agent1,Agent2
 Unit,-,Year,MUS$2010/PJ_a,-,MUS$2010/PJ,-,MUS$2010/PJ,-,PJ,%,PJ,Years,-,PJ,%,-,-,-,-,New,New
-gasCCGT,R1,2020,23.78234399,1,0,1,0,1,10,1,100,35,0.9,0.00000189,86,0.1,energy,gas,electricity,0.5,0.5
-windturbine,R1,2020,36.30771182,1,0,1,0,1,10,1,100,25,0.4,0.00000189,86,0.1,energy,wind,electricity,0.5,0.5
+gasCCGT,R1,2020,23.78234399,1,0,1,0,1,10,0.5,100,35,0.9,0.00000189,86,0.1,energy,gas,electricity,0.5,0.5
+windturbine,R1,2020,36.30771182,1,0,1,0,1,10,0.5,100,25,0.4,0.00000189,86,0.1,energy,wind,electricity,0.5,0.5

docs/tutorial-code/add-agent/1-single-objective/technodata/residential/Technodata.csv

@@ -1,4 +1,4 @@
 ProcessName,RegionName,Time,cap_par,cap_exp,fix_par,fix_exp,var_par,var_exp,MaxCapacityAddition,MaxCapacityGrowth,TotalCapacityLimit,TechnicalLife,UtilizationFactor,ScalingSize,efficiency,InterestRate,Type,Fuel,EndUse,Agent1,Agent2
 Unit,-,Year,MUS$2010/PJ_a,-,MUS$2010/PJ,-,MUS$2010/PJ,-,PJ,%,PJ,Years,-,PJ,%,-,-,-,-,New,New
-gasboiler,R1,2020,3.8,1,0,1,0,1,10,1,100,10,1,0.00000189,86,0.1,energy,gas,heat,0.5,0.5
-heatpump,R1,2020,8.866667,1,0,1,0,1,10,1,100,10,1,0.00000189,86,0.1,energy,electricity,heat,0.5,0.5
+gasboiler,R1,2020,3.8,1,0,1,0,1,10,0.5,100,10,1,0.00000189,86,0.1,energy,gas,heat,0.5,0.5
+heatpump,R1,2020,8.866667,1,0,1,0,1,10,0.5,100,10,1,0.00000189,86,0.1,energy,electricity,heat,0.5,0.5

docs/tutorial-code/add-agent/2-multiple-objective/technodata/gas/Technodata.csv

@@ -1,3 +1,3 @@
 ProcessName,RegionName,Time,cap_par,cap_exp,fix_par,fix_exp,var_par,var_exp,MaxCapacityAddition,MaxCapacityGrowth,TotalCapacityLimit,TechnicalLife,UtilizationFactor,ScalingSize,efficiency,InterestRate,Type,Fuel,EndUse,Agent1,Agent2
 Unit,-,Year,MUS$2010/PJ_a,-,MUS$2010/PJ,-,MUS$2010/PJ,-,PJ,%,PJ,Years,-,PJ,%,-,-,-,-,New,New
-gassupply1,R1,2020,0,1,0,1,2.55,1,10,1,100,35,0.9,0.00000189,86,0.1,energy,gas,gas,0.5,0.5
+gassupply1,R1,2020,0,1,0,1,2.55,1,10,0.5,100,35,0.9,0.00000189,86,0.1,energy,gas,gas,0.5,0.5

docs/tutorial-code/add-agent/2-multiple-objective/technodata/power/Technodata.csv

@@ -1,4 +1,4 @@
 ProcessName,RegionName,Time,cap_par,cap_exp,fix_par,fix_exp,var_par,var_exp,MaxCapacityAddition,MaxCapacityGrowth,TotalCapacityLimit,TechnicalLife,UtilizationFactor,ScalingSize,efficiency,InterestRate,Type,Fuel,EndUse,Agent1,Agent2
 Unit,-,Year,MUS$2010/PJ_a,-,MUS$2010/PJ,-,MUS$2010/PJ,-,PJ,%,PJ,Years,-,PJ,%,-,-,-,-,New,New
-gasCCGT,R1,2020,23.78234399,1,0,1,0,1,10,1,100,35,0.9,0.00000189,86,0.1,energy,gas,electricity,0.5,0.5
-windturbine,R1,2020,36.30771182,1,0,1,0,1,10,1,100,25,0.4,0.00000189,86,0.1,energy,wind,electricity,0.5,0.5
+gasCCGT,R1,2020,23.78234399,1,0,1,0,1,10,0.5,100,35,0.9,0.00000189,86,0.1,energy,gas,electricity,0.5,0.5
+windturbine,R1,2020,36.30771182,1,0,1,0,1,10,0.5,100,25,0.4,0.00000189,86,0.1,energy,wind,electricity,0.5,0.5

docs/tutorial-code/add-agent/2-multiple-objective/technodata/residential/Technodata.csv

@@ -1,4 +1,4 @@
 ProcessName,RegionName,Time,cap_par,cap_exp,fix_par,fix_exp,var_par,var_exp,MaxCapacityAddition,MaxCapacityGrowth,TotalCapacityLimit,TechnicalLife,UtilizationFactor,ScalingSize,efficiency,InterestRate,Type,Fuel,EndUse,Agent1,Agent2
 Unit,-,Year,MUS$2010/PJ_a,-,MUS$2010/PJ,-,MUS$2010/PJ,-,PJ,%,PJ,Years,-,PJ,%,-,-,-,-,New,New
-gasboiler,R1,2020,3.8,1,0,1,0,1,10,1,100,10,1,0.00000189,86,0.1,energy,gas,heat,0.5,0.5
-heatpump,R1,2020,8.866667,1,0,1,0,1,10,1,100,10,1,0.00000189,86,0.1,energy,electricity,heat,0.5,0.5
+gasboiler,R1,2020,3.8,1,0,1,0,1,10,0.5,100,10,1,0.00000189,86,0.1,energy,gas,heat,0.5,0.5
+heatpump,R1,2020,8.866667,1,0,1,0,1,10,0.5,100,10,1,0.00000189,86,0.1,energy,electricity,heat,0.5,0.5

docs/tutorial-code/add-correlation-demand/1-correlation/technodata/gas/Technodata.csv

@@ -1,3 +1,3 @@
 ProcessName,RegionName,Time,cap_par,cap_exp,fix_par,fix_exp,var_par,var_exp,MaxCapacityAddition,MaxCapacityGrowth,TotalCapacityLimit,TechnicalLife,UtilizationFactor,ScalingSize,efficiency,InterestRate,Type,Fuel,EndUse,Agent1
 Unit,-,Year,MUS$2010/PJ_a,-,MUS$2010/PJ,-,MUS$2010/PJ,-,PJ,%,PJ,Years,-,PJ,%,-,-,-,-,New
-gassupply1,R1,2020,0,1,0,1,2.55,1,10,1,100,35,0.9,0.00000189,86,0.1,energy,gas,gas,1
+gassupply1,R1,2020,0,1,0,1,2.55,1,10,0.5,100,35,0.9,0.00000189,86,0.1,energy,gas,gas,1

docs/tutorial-code/add-correlation-demand/1-correlation/technodata/power/Technodata.csv

@@ -1,4 +1,4 @@
 ProcessName,RegionName,Time,cap_par,cap_exp,fix_par,fix_exp,var_par,var_exp,MaxCapacityAddition,MaxCapacityGrowth,TotalCapacityLimit,TechnicalLife,UtilizationFactor,ScalingSize,efficiency,InterestRate,Type,Fuel,EndUse,Agent1
 Unit,-,Year,MUS$2010/PJ_a,-,MUS$2010/PJ,-,MUS$2010/PJ,-,PJ,%,PJ,Years,-,PJ,%,-,-,-,-,New
-gasCCGT,R1,2020,23.78234399,1,0,1,0,1,10,1,100,35,0.9,0.00000189,86,0.1,energy,gas,electricity,1
-windturbine,R1,2020,36.30771182,1,0,1,0,1,10,1,100,25,0.4,0.00000189,86,0.1,energy,wind,electricity,1
+gasCCGT,R1,2020,23.78234399,1,0,1,0,1,10,0.5,100,35,0.9,0.00000189,86,0.1,energy,gas,electricity,1
+windturbine,R1,2020,36.30771182,1,0,1,0,1,10,0.5,100,25,0.4,0.00000189,86,0.1,energy,wind,electricity,1

docs/tutorial-code/add-correlation-demand/1-correlation/technodata/residential/Technodata.csv

@@ -1,4 +1,4 @@
 ProcessName,RegionName,Time,cap_par,cap_exp,fix_par,fix_exp,var_par,var_exp,MaxCapacityAddition,MaxCapacityGrowth,TotalCapacityLimit,TechnicalLife,UtilizationFactor,ScalingSize,efficiency,InterestRate,Type,Fuel,EndUse,Agent1
 Unit,-,Year,MUS$2010/PJ_a,-,MUS$2010/PJ,-,MUS$2010/PJ,-,PJ,%,PJ,Years,-,PJ,%,-,-,-,-,New
-gasboiler,R1,2020,3.8,1,0,1,0,1,10,1,100,10,1,0.00000189,86,0.1,energy,gas,heat,1
-heatpump,R1,2020,8.866667,1,0,1,0,1,10,1,100,10,1,0.00000189,86,0.1,energy,electricity,heat,1
+gasboiler,R1,2020,3.8,1,0,1,0,1,10,0.5,100,10,1,0.00000189,86,0.1,energy,gas,heat,1
+heatpump,R1,2020,8.866667,1,0,1,0,1,10,0.5,100,10,1,0.00000189,86,0.1,energy,electricity,heat,1