Skip to content

Add growth seed parameter #680

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
tsmbland merged 10 commits into from
Mar 27, 2025
Merged

Add growth seed parameter #680

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
21c4bad
Apply fixed growth seed of 1
tsmbland Mar 17, 2025
ce4b239
New seed method, doc improvements
tsmbland Mar 18, 2025
80037c3
Formatting improvements
tsmbland Mar 18, 2025
8aa7548
More formatting improvements
tsmbland Mar 18, 2025
f9f1ad6
Proper equations
tsmbland Mar 18, 2025
0ab009a
Better method for equations
tsmbland Mar 18, 2025
cf8dd54
Another attempt at correct formatting
tsmbland Mar 18, 2025
b354a97
Added test
tsmbland Mar 19, 2025
1fb0641
Update results
tsmbland Mar 26, 2025
90e3217
Fix new-decision-metric model
tsmbland Mar 26, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 17 additions & 8 deletions docs/inputs/technodata.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -81,12 +81,13 @@ var_par, var_exp

ProductionRef is the production of a reference capacity (CapRef) for the cost estimate decided by the modeller before filling the input data files.

Growith constraints (optional)
Growth constraints (optional)
MaxCapacityAddition
represents the maximum addition of installed capacity per technology, per year in a period, per region.

MaxCapacityGrowth
represents the fraction growth per year based on the available stock in a year, per region and technology.
To allow growth to be initiated, a seed value must be specified (see GrowthSeed below).

TotalCapacityLimit
represents the total capacity limit per technology, region and year.
Expand All @@ -96,19 +97,27 @@ Growith constraints (optional)

resBoilerElectric, region1, 10, 0.2, 100

In this example, MaxCapacityAddition, MaxCapacityGrowth, and TotalCapacityLimit equal to 10 PJ, 0.2 (corresponding to 20 \%), and 100 PJ.
Assuming a 5-year time step, the *MaxCapacityAddition* introduces a constraint on the maximum capacity which can be added in the investment year:
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 * ((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*.
In this example, MaxCapacityAddition, MaxCapacityGrowth and TotalCapacityLimit equal to 10 PJ, 0.2 (corresponding to 20 \%), and 100 PJ.
Assuming a 5-year time step:

* *MaxCapacityAddition* restricts new capacity which can be installed over the investment period to 10 * 5 = 50 PJ.
* *MaxCapacityGrowth* restricts capacity growth to 20 \% per year (:math:`\approx` 149 \% over 5 years).
The investment limit will depend on the existing capacity and the decommissioning profile. Assuming that 7.7 PJ of resBoilerElectric is available in the current year, and that 4.9 PJ of
resBoilerElectric is already commissioned for the investment year, then the constraint applies as follows: 7.7 * (1 + 0.2)\ :sup:`5` - 4.9 = 14.3 PJ.
Also see the GrowthSeed parameter below.
* *TotalCapacityLimit* will restrict new addition to 100 - 4.9 = 95.1 PJ (so that total capacity in the investment year will not exceed 100 PJ).
* Overall, the most restrictive constraint will apply, which in this case is 14.3 PJ.

Growth constraints are applied for each single agent in a multi-agent simulation. When only one agent is present, the growth constraints
apply individually to the "New" and "Retrofit" agent, when present.

If any of the three parameters are not provided in the technodata file, that particular constraint is not applied.

GrowthSeed (optional, default = 1)
applies a lower-bound on the initial capacity value used in the MaxCapacityGrowth calculation, allowing growth to initiate when capacity is low/zero.

Taking the above example, if the GrowthSeed is set to 10 PJ (higher than the existing capacity of 7.7 PJ), the MaxCapacityGrowth constraint will be applied as follows:
10 x (1 + 0.2)\ :sup:`5` - 4.9 = 19.9 PJ.

TechnicalLife
represents the number of years that a technology operates before it is decommissioned.
Expand Down
86 changes: 44 additions & 42 deletions docs/tutorial-code/add-agent/1-single-objective/Results/MCACapacity.csv
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,115 +6,117 @@ A2,0.50000000000,R1,2020,R1,power,gasCCGT,newcapa,2020
A1,7.50000000000,R1,2020,R1,gas,gassupply1,newcapa,2020
A2,7.50000000000,R1,2020,R1,gas,gassupply1,newcapa,2020
A1,2.50000000000,R1,2020,R1,residential,gasboiler,newcapa,2025
A1,9.50000000000,R1,2025,R1,residential,heatpump,newcapa,2025
A1,1.90630000000,R1,2025,R1,residential,gasboiler,newcapa,2025
A1,7.59380000000,R1,2025,R1,residential,heatpump,newcapa,2025
A2,2.50000000000,R1,2020,R1,residential,gasboiler,newcapa,2025
A2,9.50000000000,R1,2025,R1,residential,gasboiler,newcapa,2025
A1,0.50000000000,R1,2020,R1,power,gasCCGT,newcapa,2025
A1,1.61110000000,R1,2025,R1,power,gasCCGT,newcapa,2025
A1,1.18750000000,R1,2025,R1,power,gasCCGT,newcapa,2025
A2,0.50000000000,R1,2020,R1,power,gasCCGT,newcapa,2025
A2,3.62500000000,R1,2025,R1,power,windturbine,newcapa,2025
A2,2.67190000000,R1,2025,R1,power,windturbine,newcapa,2025
A1,7.50000000000,R1,2020,R1,gas,gassupply1,newcapa,2025
A1,4.02470000000,R1,2025,R1,gas,gassupply1,newcapa,2025
A1,4.89950000000,R1,2025,R1,gas,gassupply1,newcapa,2025
A2,7.50000000000,R1,2020,R1,gas,gassupply1,newcapa,2025
A2,4.02470000000,R1,2025,R1,gas,gassupply1,newcapa,2025
A1,9.50000000000,R1,2025,R1,residential,heatpump,newcapa,2030
A2,4.89950000000,R1,2025,R1,gas,gassupply1,newcapa,2025
A1,1.90630000000,R1,2025,R1,residential,gasboiler,newcapa,2030
A1,7.59380000000,R1,2025,R1,residential,heatpump,newcapa,2030
A1,5.50000000000,R1,2030,R1,residential,heatpump,newcapa,2030
A2,9.50000000000,R1,2025,R1,residential,gasboiler,newcapa,2030
A2,5.50000000000,R1,2030,R1,residential,gasboiler,newcapa,2030
A1,1.61110000000,R1,2025,R1,power,gasCCGT,newcapa,2030
A1,1.18750000000,R1,2025,R1,power,gasCCGT,newcapa,2030
A1,3.87500000000,R1,2030,R1,power,windturbine,newcapa,2030
A2,3.62500000000,R1,2025,R1,power,windturbine,newcapa,2030
A2,2.67190000000,R1,2025,R1,power,windturbine,newcapa,2030
A2,3.87500000000,R1,2030,R1,power,windturbine,newcapa,2030
A1,3.75000000000,R1,2020,R1,gas,gassupply1,newcapa,2030
A1,4.02470000000,R1,2025,R1,gas,gassupply1,newcapa,2030
A1,4.89950000000,R1,2025,R1,gas,gassupply1,newcapa,2030
A1,3.23720000000,R1,2030,R1,gas,gassupply1,newcapa,2030
A2,3.75000000000,R1,2020,R1,gas,gassupply1,newcapa,2030
A2,4.02470000000,R1,2025,R1,gas,gassupply1,newcapa,2030
A2,4.89950000000,R1,2025,R1,gas,gassupply1,newcapa,2030
A2,3.23720000000,R1,2030,R1,gas,gassupply1,newcapa,2030
A1,5.50000000000,R1,2030,R1,residential,heatpump,newcapa,2035
A1,12.50000000000,R1,2035,R1,residential,heatpump,newcapa,2035
A2,5.50000000000,R1,2030,R1,residential,gasboiler,newcapa,2035
A2,12.50000000000,R1,2035,R1,residential,gasboiler,newcapa,2035
A1,1.61110000000,R1,2025,R1,power,gasCCGT,newcapa,2035
A1,1.18750000000,R1,2025,R1,power,gasCCGT,newcapa,2035
A1,3.87500000000,R1,2030,R1,power,windturbine,newcapa,2035
A1,1.50000000000,R1,2035,R1,power,windturbine,newcapa,2035
A2,3.62500000000,R1,2025,R1,power,windturbine,newcapa,2035
A1,2.45310000000,R1,2035,R1,power,windturbine,newcapa,2035
A2,2.67190000000,R1,2025,R1,power,windturbine,newcapa,2035
A2,3.87500000000,R1,2030,R1,power,windturbine,newcapa,2035
A2,1.50000000000,R1,2035,R1,power,windturbine,newcapa,2035
A1,4.02470000000,R1,2025,R1,gas,gassupply1,newcapa,2035
A2,2.45310000000,R1,2035,R1,power,windturbine,newcapa,2035
A1,4.89950000000,R1,2025,R1,gas,gassupply1,newcapa,2035
A1,3.23720000000,R1,2030,R1,gas,gassupply1,newcapa,2035
A1,5.68330000000,R1,2035,R1,gas,gassupply1,newcapa,2035
A2,4.02470000000,R1,2025,R1,gas,gassupply1,newcapa,2035
A1,4.45490000000,R1,2035,R1,gas,gassupply1,newcapa,2035
A2,4.89950000000,R1,2025,R1,gas,gassupply1,newcapa,2035
A2,3.23720000000,R1,2030,R1,gas,gassupply1,newcapa,2035
A2,5.68330000000,R1,2035,R1,gas,gassupply1,newcapa,2035
A2,4.45490000000,R1,2035,R1,gas,gassupply1,newcapa,2035
A1,12.50000000000,R1,2035,R1,residential,heatpump,newcapa,2040
A1,8.50000000000,R1,2040,R1,residential,heatpump,newcapa,2040
A2,12.50000000000,R1,2035,R1,residential,gasboiler,newcapa,2040
A2,8.50000000000,R1,2040,R1,residential,gasboiler,newcapa,2040
A1,1.61110000000,R1,2025,R1,power,gasCCGT,newcapa,2040
A1,1.18750000000,R1,2025,R1,power,gasCCGT,newcapa,2040
A1,3.87500000000,R1,2030,R1,power,windturbine,newcapa,2040
A1,1.50000000000,R1,2035,R1,power,windturbine,newcapa,2040
A1,2.45310000000,R1,2035,R1,power,windturbine,newcapa,2040
A1,1.50000000000,R1,2040,R1,power,windturbine,newcapa,2040
A2,3.62500000000,R1,2025,R1,power,windturbine,newcapa,2040
A2,2.67190000000,R1,2025,R1,power,windturbine,newcapa,2040
A2,3.87500000000,R1,2030,R1,power,windturbine,newcapa,2040
A2,1.50000000000,R1,2035,R1,power,windturbine,newcapa,2040
A2,2.45310000000,R1,2035,R1,power,windturbine,newcapa,2040
A2,1.50000000000,R1,2040,R1,power,windturbine,newcapa,2040
A1,4.02470000000,R1,2025,R1,gas,gassupply1,newcapa,2040
A1,4.89950000000,R1,2025,R1,gas,gassupply1,newcapa,2040
A1,3.23720000000,R1,2030,R1,gas,gassupply1,newcapa,2040
A1,5.68330000000,R1,2035,R1,gas,gassupply1,newcapa,2040
A1,4.45490000000,R1,2035,R1,gas,gassupply1,newcapa,2040
A1,1.93330000000,R1,2040,R1,gas,gassupply1,newcapa,2040
A2,4.02470000000,R1,2025,R1,gas,gassupply1,newcapa,2040
A2,4.89950000000,R1,2025,R1,gas,gassupply1,newcapa,2040
A2,3.23720000000,R1,2030,R1,gas,gassupply1,newcapa,2040
A2,5.68330000000,R1,2035,R1,gas,gassupply1,newcapa,2040
A2,4.45490000000,R1,2035,R1,gas,gassupply1,newcapa,2040
A2,1.93330000000,R1,2040,R1,gas,gassupply1,newcapa,2040
A1,8.50000000000,R1,2040,R1,residential,heatpump,newcapa,2045
A1,15.50000000000,R1,2045,R1,residential,heatpump,newcapa,2045
A2,8.50000000000,R1,2040,R1,residential,gasboiler,newcapa,2045
A2,15.50000000000,R1,2045,R1,residential,gasboiler,newcapa,2045
A1,1.61110000000,R1,2025,R1,power,gasCCGT,newcapa,2045
A1,1.18750000000,R1,2025,R1,power,gasCCGT,newcapa,2045
A1,3.87500000000,R1,2030,R1,power,windturbine,newcapa,2045
A1,1.50000000000,R1,2035,R1,power,windturbine,newcapa,2045
A1,2.45310000000,R1,2035,R1,power,windturbine,newcapa,2045
A1,1.50000000000,R1,2040,R1,power,windturbine,newcapa,2045
A1,1.50000000000,R1,2045,R1,power,windturbine,newcapa,2045
A2,3.62500000000,R1,2025,R1,power,windturbine,newcapa,2045
A2,2.67190000000,R1,2025,R1,power,windturbine,newcapa,2045
A2,3.87500000000,R1,2030,R1,power,windturbine,newcapa,2045
A2,1.50000000000,R1,2035,R1,power,windturbine,newcapa,2045
A2,2.45310000000,R1,2035,R1,power,windturbine,newcapa,2045
A2,1.50000000000,R1,2040,R1,power,windturbine,newcapa,2045
A2,1.50000000000,R1,2045,R1,power,windturbine,newcapa,2045
A1,4.02470000000,R1,2025,R1,gas,gassupply1,newcapa,2045
A1,4.89950000000,R1,2025,R1,gas,gassupply1,newcapa,2045
A1,3.23720000000,R1,2030,R1,gas,gassupply1,newcapa,2045
A1,5.68330000000,R1,2035,R1,gas,gassupply1,newcapa,2045
A1,4.45490000000,R1,2035,R1,gas,gassupply1,newcapa,2045
A1,1.93330000000,R1,2040,R1,gas,gassupply1,newcapa,2045
A1,1.93330000000,R1,2045,R1,gas,gassupply1,newcapa,2045
A2,4.02470000000,R1,2025,R1,gas,gassupply1,newcapa,2045
A2,4.89950000000,R1,2025,R1,gas,gassupply1,newcapa,2045
A2,3.23720000000,R1,2030,R1,gas,gassupply1,newcapa,2045
A2,5.68330000000,R1,2035,R1,gas,gassupply1,newcapa,2045
A2,4.45490000000,R1,2035,R1,gas,gassupply1,newcapa,2045
A2,1.93330000000,R1,2040,R1,gas,gassupply1,newcapa,2045
A2,1.93330000000,R1,2045,R1,gas,gassupply1,newcapa,2045
A1,15.50000000000,R1,2045,R1,residential,heatpump,newcapa,2050
A1,11.50000000000,R1,2050,R1,residential,heatpump,newcapa,2050
A2,15.50000000000,R1,2045,R1,residential,gasboiler,newcapa,2050
A2,11.50000000000,R1,2050,R1,residential,gasboiler,newcapa,2050
A1,1.61110000000,R1,2025,R1,power,gasCCGT,newcapa,2050
A1,1.18750000000,R1,2025,R1,power,gasCCGT,newcapa,2050
A1,3.87500000000,R1,2030,R1,power,windturbine,newcapa,2050
A1,1.50000000000,R1,2035,R1,power,windturbine,newcapa,2050
A1,2.45310000000,R1,2035,R1,power,windturbine,newcapa,2050
A1,1.50000000000,R1,2040,R1,power,windturbine,newcapa,2050
A1,1.50000000000,R1,2045,R1,power,windturbine,newcapa,2050
A1,1.50000000000,R1,2050,R1,power,windturbine,newcapa,2050
A2,3.87500000000,R1,2030,R1,power,windturbine,newcapa,2050
A2,1.50000000000,R1,2035,R1,power,windturbine,newcapa,2050
A2,2.45310000000,R1,2035,R1,power,windturbine,newcapa,2050
A2,1.50000000000,R1,2040,R1,power,windturbine,newcapa,2050
A2,1.50000000000,R1,2045,R1,power,windturbine,newcapa,2050
A2,3.31250000000,R1,2050,R1,power,windturbine,newcapa,2050
A1,4.02470000000,R1,2025,R1,gas,gassupply1,newcapa,2050
A2,2.83590000000,R1,2050,R1,power,windturbine,newcapa,2050
A1,4.89950000000,R1,2025,R1,gas,gassupply1,newcapa,2050
A1,3.23720000000,R1,2030,R1,gas,gassupply1,newcapa,2050
A1,5.68330000000,R1,2035,R1,gas,gassupply1,newcapa,2050
A1,4.45490000000,R1,2035,R1,gas,gassupply1,newcapa,2050
A1,1.93330000000,R1,2040,R1,gas,gassupply1,newcapa,2050
A1,1.93330000000,R1,2045,R1,gas,gassupply1,newcapa,2050
A1,1.93330000000,R1,2050,R1,gas,gassupply1,newcapa,2050
A2,4.02470000000,R1,2025,R1,gas,gassupply1,newcapa,2050
A2,4.89950000000,R1,2025,R1,gas,gassupply1,newcapa,2050
A2,3.23720000000,R1,2030,R1,gas,gassupply1,newcapa,2050
A2,5.68330000000,R1,2035,R1,gas,gassupply1,newcapa,2050
A2,4.45490000000,R1,2035,R1,gas,gassupply1,newcapa,2050
A2,1.93330000000,R1,2040,R1,gas,gassupply1,newcapa,2050
A2,1.93330000000,R1,2045,R1,gas,gassupply1,newcapa,2050
A2,1.93330000000,R1,2050,R1,gas,gassupply1,newcapa,2050
Loading