|
18 | 18 | "cell_type": "markdown", |
19 | 19 | "metadata": {}, |
20 | 20 | "source": [ |
21 | | - "MUSE is made up of a number of different [input files](../inputs/index.rst). These, however, can be broadly split into two:\n", |
| 21 | + "MUSE is made up of a number of different [input files](../inputs/index.rst). These can be broadly split into two types:\n", |
22 | 22 | "\n", |
23 | 23 | "- [Simulation settings](../inputs/toml.rst)\n", |
24 | 24 | "\n", |
|
83 | 83 | "cell_type": "markdown", |
84 | 84 | "metadata": {}, |
85 | 85 | "source": [ |
86 | | - "Within the default folder there is the ```settings.toml``` file, `input` folder and `technodata` folder. To add a technology within the power sector, we must open the ```technodata``` folder followed by the ```power``` folder.\n", |
| 86 | + "Within the default folder you'll find a ```settings.toml``` file, `input` folder and `technodata` folder. To add a technology within the power sector, we must open the ```technodata``` folder followed by the ```power``` folder.\n", |
87 | 87 | "\n", |
88 | 88 | "At this point, we must note that we require consistency in input and output units. For example, if capacity is in PJ, the same basis would be needed for the output files `CommIn.csv` and `CommOut.csv`. In addition, across sectors a commodity needs to maintain the same unit. In these examples, we use the unit petajoule (PJ).\n", |
89 | 89 | "\n", |
90 | | - "Next, we will edit the ```CommIn.csv``` file, which specifies the commodities consumed by solar photovoltaics.\n", |
| 90 | + "We will first edit the ```CommIn.csv``` file, which specifies the commodities consumed by solar photovoltaics.\n", |
91 | 91 | "\n", |
92 | 92 | "The table below shows the original ```CommIn.csv``` version in normal text, and the added column and row in **bold**.\n", |
93 | 93 | "\n", |
|
108 | 108 | "- the input type is [fixed](../inputs/commodities_io.rst)\n", |
109 | 109 | "- solarPV consumes solar\n", |
110 | 110 | "\n", |
111 | | - "As the solar commodity has not been previously defined, we must define it by adding a column, which we will call solar. We fill out the entries in the solar column, ie. that neither `gasCCGT` nor `windturbine` consume solar.\n" |
| 111 | + "As the solar commodity has not been previously defined, we must define it by adding a column, which we will call `solar`. We fill out the entries in the solar column, ie. that neither `gasCCGT` nor `windturbine` consume `solar`.\n" |
112 | 112 | ] |
113 | 113 | }, |
114 | 114 | { |
|
133 | 133 | "cell_type": "markdown", |
134 | 134 | "metadata": {}, |
135 | 135 | "source": [ |
136 | | - "The next file to modify is the ```ExistingCapacity.csv``` file. This file details the existing capacity of each technology, per benchmark year. For this example, we will set the existing capacity to be 0. Please note, that the model interpolates between years linearly. \n", |
| 136 | + "The next file to modify is the `ExistingCapacity.csv` file. This file details the existing capacity of each technology, and a decommissioning profile across the time framework. For this example, we will set the existing capacity to be 0. Please note that the model interpolates linearly between years. \n", |
137 | 137 | "\n", |
138 | 138 | "|ProcessName|RegionName|Unit|2020|2025|2030|2035|2040|2045|2050|\n", |
139 | 139 | "|-|-|-|-|-|-|-|-|-|-|\n", |
|
146 | 146 | "cell_type": "markdown", |
147 | 147 | "metadata": {}, |
148 | 148 | "source": [ |
149 | | - "Finally, the ```Technodata.csv``` contains parametrisation data for the technology, such as the cost, growth constraints, lifetime of the power plant and fuel used. The technodata file is too long for it all to be displayed here, so we will truncate the full version." |
150 | | - ] |
151 | | - }, |
152 | | - { |
153 | | - "cell_type": "markdown", |
154 | | - "metadata": {}, |
155 | | - "source": [ |
156 | | - "Here, we will only define the parameters: ```ProcessName```, ```RegionName```, ```Time```, ```Level```,```cap_par```, ```Fuel```,```EndUse``` and ```Agent1```\n", |
| 149 | + "Finally, the `Technodata.csv` file contains parametrisation data for the technology, such as the cost, growth constraints, lifetime of the power plant and fuel used. \n", |
157 | 150 | "\n", |
158 | | - "We shall copy the existing parameters from the ```windturbine``` technology for the remaining parameters that can be seen in the ```Technodata.csv``` file for brevity. You can see the full file [here](https://github.com/EnergySystemsModellingLab/MUSE_OS/blob/main/docs/tutorial-code/1-add-new-technology/1-introduction/technodata/power/Technodata.csv).\n", |
| 151 | + "We will only display the some of the parameters, as the table is too large to display in full. The remaining parameters will be copied from the `windturbine` technology. You can see the full file [here](https://github.com/EnergySystemsModellingLab/MUSE_OS/blob/main/docs/tutorial-code/1-add-new-technology/1-introduction/technodata/power/Technodata.csv), and details about each parameter [here](../inputs/technodata.rst).\n", |
159 | 152 | "\n", |
160 | | - "Again, flat forward extension is used here. Therefore, as in this example we only provide data for the benchmark year 2020. 2025 and the following benchmark years will keep the same characteristics, e.g. costs, for each benchmark year of the simulation." |
161 | | - ] |
162 | | - }, |
163 | | - { |
164 | | - "cell_type": "markdown", |
165 | | - "metadata": {}, |
166 | | - "source": [ |
167 | 153 | "|ProcessName|RegionName|Time|Level|cap_par|cap_exp|…|Fuel|EndUse|Agent1|\n", |
168 | 154 | "|-|-|-|-|-|-|-|-|-|-|\n", |
169 | 155 | "|Unit|-|Year|-|MUS$2010/PJ_a|-|…|-|-|New|\n", |
170 | 156 | "|gasCCGT|R1|2020|fixed|23.78234399|1|…|gas|electricity|1|\n", |
171 | 157 | "|windturbine|R1|2020|fixed|36.30771182|1|…|wind|electricity|1|\n", |
172 | | - "|**solarPV**|**R1**|**2020**|**fixed**|**30**|**1**|...|**solar**|**electricity**|**1**" |
| 158 | + "|**solarPV**|**R1**|**2020**|**fixed**|**30**|**1**|...|**solar**|**electricity**|**1**|\n", |
| 159 | + "\n", |
| 160 | + "Again, flat forward extension is used. Therefore, as we only provide data for the benchmark year 2020, 2025 and the following benchmark years will keep the same characteristics." |
173 | 161 | ] |
174 | 162 | }, |
175 | 163 | { |
|
183 | 171 | "cell_type": "markdown", |
184 | 172 | "metadata": {}, |
185 | 173 | "source": [ |
186 | | - "Next, navigate to the ```input``` folder.\n", |
| 174 | + "Next, navigate to the `input` folder.\n", |
187 | 175 | "\n", |
188 | | - "We must now edit each of the files found here to add the new solar commodity. Due to space constraints we will not display all of the entries contained in the input files. The edited files can be viewed in full [here](https://github.com/EnergySystemsModellingLab/MUSE_OS/tree/main/docs/tutorial-code/1-add-new-technology/1-introduction)." |
| 176 | + "We must now edit each of the files found here to add the new `solar` commodity. Due to space constraints we will not display all of the entries contained in every input. You can be view the edited files in full [here](https://github.com/EnergySystemsModellingLab/MUSE_OS/tree/main/docs/tutorial-code/1-add-new-technology/1-introduction)." |
189 | 177 | ] |
190 | 178 | }, |
191 | 179 | { |
192 | 180 | "cell_type": "markdown", |
193 | 181 | "metadata": {}, |
194 | 182 | "source": [ |
195 | | - "The ```GlobalCommodities.csv``` file is the file which defines the commodities. Here we give the commodities a commodity type, CO2 emissions factor and heat rate. For this file, we will add the solar commodity, with zero CO2 emissions factor and a heat rate of 1.\n", |
| 183 | + "Commodities are defined in the `GlobalCommodities.csv` file. Here we give the commodities a commodity type, CO2 emissions factor and heat rate. For this file, we will add the `solar` commodity, with zero CO2 emissions factor and a heat rate of 1.\n", |
196 | 184 | "\n", |
197 | 185 | "|Commodity|CommodityType|CommodityName|CommodityEmissionFactor_CO2|HeatRate|Unit|\n", |
198 | 186 | "|-|-|-|-|-|-|\n", |
|
208 | 196 | "cell_type": "markdown", |
209 | 197 | "metadata": {}, |
210 | 198 | "source": [ |
211 | | - "The ```Projections.csv``` file details the initial market prices for the commodities. The market clearing algorithm will update these throughout the simulation, however, an initial estimate is required to start the simulation. As solar energy is free, we will indicate this by adding a final column.\n", |
| 199 | + "The `Projections.csv` file details the initial market prices for the commodities. The market clearing algorithm will update these throughout the simulation, however an initial estimate is required to start the simulation. As solar energy is free, we will indicate this by adding a final column.\n", |
212 | 200 | "\n", |
213 | 201 | "Please note that the unit row is not read by MUSE, but used as a reference for the user. The units should be consistent across all input files for MUSE; MUSE does not carry out any unit conversion.\n", |
214 | 202 | "\n", |
|
260 | 248 | "metadata": {}, |
261 | 249 | "source": [ |
262 | 250 | "Now we are able to run our simulation with the new solar power technology.\n", |
263 | | - "\n", |
264 | | - "To do this we run the same run command as previously in the command line:\n", |
| 251 | + "To do this, we run the following command in the command line:\n", |
265 | 252 | "\n", |
266 | 253 | "```bash\n", |
267 | 254 | "python -m muse settings.toml\n", |
|
289 | 276 | "cell_type": "markdown", |
290 | 277 | "metadata": {}, |
291 | 278 | "source": [ |
292 | | - "First, we will import the ```MCACapacity.csv``` file using pandas and print the first 5 lines with the ```head()``` command. (Make sure to change the file path to where the `MCACapacity.csv` is on your computer.)" |
| 279 | + "First, we will import the ```MCACapacity.csv``` file using pandas, and print the first 5 lines with the ```head()``` command. (Make sure to change the file path as appropriate.)" |
293 | 280 | ] |
294 | 281 | }, |
295 | 282 | { |
|
338 | 325 | "cell_type": "markdown", |
339 | 326 | "metadata": {}, |
340 | 327 | "source": [ |
341 | | - "We can now see that there is `solarPV` in the power sector, compared to the example [here](../running-muse-example.ipynb) where `solarPV` is absent! That's great and means it worked! \n", |
| 328 | + "We can now see that there is `solarPV` capacity in the power sector, compared to the example [here](../running-muse-example.ipynb) where `solarPV` is absent! That's great and means it worked! \n", |
342 | 329 | "\n", |
343 | 330 | "We can see that `solarPV` has a higher uptake than `gasCCGT`, and has entirely replaced `windturbine` in of the sector, which is likely due to the lower `cap_par` (capital cost) which makes it more favourable for investment. We can investigate this by changing the `cap_par` value for `solarPV`, which we will do in the next section." |
344 | 331 | ] |
|
356 | 343 | "source": [ |
357 | 344 | "Now, we will observe what happens if we increase the capital price of solar to be more expensive than wind in the year 2020, but then reduce the price of solar in 2040. By doing this, we should observe an initial investment in wind in the first few benchmark years of the simulation, followed by a transition to solar as we approach the year 2040.\n", |
358 | 345 | "\n", |
359 | | - "To achieve this we have to modify the `Technodata.csv`, `CommIn.csv` and `CommOut.csv` files in the `power` sector.\n", |
| 346 | + "To achieve this, we have to modify the `Technodata.csv`, `CommIn.csv` and `CommOut.csv` files in the `power` sector.\n", |
360 | 347 | "\n", |
361 | 348 | "First, we will amend the `Technodata.csv` file as follows:\n", |
362 | 349 | "\n", |
|
383 | 370 | "source": [ |
384 | 371 | "Next we will modify the `CommIn.csv` file.\n", |
385 | 372 | "\n", |
386 | | - "For this step, we have to provide the input commodities for each technology, in each of the years defined in the `Technodata.csv` file. So, for this example we are required to provide entries for the years 2020 and 2040 for each of the technologies. For now, we won't change the 2040 values compared to the 2020. Therefore, we just need to copy and paste each of the entries for each of the technologies, as shown below:\n", |
| 373 | + "For this step, we have to provide the input commodities for each technology, in each of the years defined in the `Technodata.csv` file. So, for this example, we are required to provide entries for the years 2020 and 2040 for each of the technologies. For now, we won't change the 2040 values compared to the 2020. Therefore, we just need to copy and paste each of the entries for each of the technologies, as shown below:\n", |
387 | 374 | "\n", |
388 | 375 | "|ProcessName|RegionName|Time|Level|electricity|gas|heat|CO2f|wind|solar|\n", |
389 | 376 | "|-|-|-|-|-|-|-|-|-|-|\n", |
|
397 | 384 | "\n", |
398 | 385 | "We must do the same for the `CommOut.csv` file. For the sake of brevity we won't show you this, but the link to the file can be found [here](https://github.com/EnergySystemsModellingLab/MUSE_OS/blob/main/docs/tutorial-code/1-add-new-technology/2-scenario/technodata/power/CommOut.csv).\n", |
399 | 386 | "\n", |
400 | | - "We will now rerun the simulation, using the same command as previously and visualise the new results." |
401 | | - ] |
402 | | - }, |
403 | | - { |
404 | | - "cell_type": "markdown", |
405 | | - "metadata": {}, |
406 | | - "source": [ |
407 | | - "We must import the new ```MCACapacity.csv``` file again, and then visualise the results." |
| 387 | + "We will now rerun the simulation, using the same command as previously, import the new `MCACapacity.csv` file again, and visualise the results:" |
408 | 388 | ] |
409 | 389 | }, |
410 | 390 | { |
|
440 | 420 | "source": [ |
441 | 421 | "From the results, we can see that `windturbine` now outcompetes `solarPV` in the year 2025. However, between the years 2025 and 2050, as the capital cost of `solarPV` decreases, the share of `solarPV` begins to increase.\n", |
442 | 422 | "\n", |
443 | | - "For the full example with the completed input files see [here](https://github.com/EnergySystemsModellingLab/MUSE_OS/tree/main/docs/tutorial-code/1-add-new-technology/2-scenario)" |
| 423 | + "For the full example with the completed input files see [here](https://github.com/EnergySystemsModellingLab/MUSE_OS/tree/main/docs/tutorial-code/1-add-new-technology/2-scenario)." |
444 | 424 | ] |
| 425 | + }, |
| 426 | + { |
| 427 | + "cell_type": "markdown", |
| 428 | + "metadata": {}, |
| 429 | + "source": [] |
445 | 430 | } |
446 | 431 | ], |
447 | 432 | "metadata": { |
|
0 commit comments