Merge branch 'dev' into feature/stratified_therm_storage

CHANGELOG.md

@@ -24,6 +24,9 @@ Here is a template for new release sections
 ### Added
 - Updated release protocol with info on credentials for test.pypi.org (step 9) and added "Fixed" to unreleased section of changelog.md in release protocol (#695)
 - Added information about the API to the docs (#701)
+- Added CO2 emission factors in the section model_assumption.rst (#697)
+- Added energyBusses.csv in RTD (#678)
+- Add and link `rewableAsset` as parameter in RTD, specifically `MVS_parameters.rst` and `MVS_parameters_list.csv` (#710)
 
 ### Changed 
 - Benchmark test for investment model (`Test_Economic_KPI.test_benchmark_Economic_KPI_C2_E2`): Expand test to LCOE as well as all all other system-wide economic parameters, transpose `test_data_economic_expected_values.csv`, change `test_data_economic_expected_values.xls` (#613)
@@ -40,6 +43,7 @@ Here is a template for new release sections
 - Use current version number as defined in `version.py` for RTD (#693)
 - Added storage to the table in autoreport listing the energy system components (#686)
 - Add assertion `sum(attributed_costs)==cost_total` (for single-vector system) (#613)
+- Benchmark test for renewable share (`TestTechnicalKPI.test_renewable_factor_and_renewable_share_of_local_generation()`) (#613)
 
 ## [0.5.3] - 2020-12-08
 

docs/MVS_parameters.rst

@@ -98,6 +98,7 @@ The file `energyProduction.csv` defines the assets that serve as energy sources,
 * :ref:`outflowdirec-label`
 * :ref:`filename-label`
 * :ref:`energyvector-label`
+* :ref:`renewableasset-label`
 * :ref:`typeoemof-label`
 
 energyProviders.csv

docs/Model_Assumptions.rst

@@ -342,6 +342,92 @@ For example, the `degree of sector coupling` will reach its maximum, when the sy
 
 In the MVS, there is no distinction between energy carriers and energy vector. For `Electricity` of the `Electricity` vector this may be self-explanatory. However, the energy carriers of the `Heat` vector can have different technical characteristics: A fluid on different temperature levels. As the MVS measures the energy content of a flow in kWh(thermal) however, this distinction is only relevant for the end user to be aware of, as two assets that have different energy carriers as an output should not be connected to one and the same bus if a detailed analysis is expected. An example of this would be, that a system where the output of the diesel boiler as well as the output of a solar thermal panel are connected to the same bus, eventhough they can not both supply the same kind of heat demands (radiator vs. floor heating).  This, however, is something that the end-user has to be aware of themselves, eg. by defining self-explanatory labels.
 
+Emission factors
+----------------------------
+In order to optimise the energy system with minimum emissions, it is important to calculate emission per unit of fuel consumption.
+
+Following emission factors for energy carriers are defined:
+
+These values are based on direct emissions during stationary consumption of the mentioned fuels.
+
+.. _table_emissions_energyCarriers:
+
+.. list-table:: Emission factors: Kg of CO2 equivalent per unit of fuel consumption
+   :widths: 50 25 25 25
+   :header-rows: 1
+
+   * - Energy carrier
+     - Unit
+     - Value
+     - Source
+   * - Diesel
+     - kgCO2eq/litre
+     - 2.7
+     - [`4  <https://www.eib.org/attachments/strategies/eib_project_carbon_footprint_methodologies_en.pdf>`__] Page No. 26
+   * - Gasoline
+     - kgCO2eq/litre
+     - 2.3
+     - [`4  <https://www.eib.org/attachments/strategies/eib_project_carbon_footprint_methodologies_en.pdf>`__] Page No. 26
+   * - Kerosene
+     - kgCO2eq/litre
+     - 2.5
+     - [`4  <https://www.eib.org/attachments/strategies/eib_project_carbon_footprint_methodologies_en.pdf>`__] Page No. 26
+   * - Natural gas
+     - kgCO2eq/m3
+     - 1.9
+     - [`4  <https://www.eib.org/attachments/strategies/eib_project_carbon_footprint_methodologies_en.pdf>`__] Page No. 26
+   * - LPG
+     - kgCO2eq/litre
+     - 1.6
+     - [`4  <https://www.eib.org/attachments/strategies/eib_project_carbon_footprint_methodologies_en.pdf>`__] Page No. 26
+   * - Biodiesel
+     - kgCO2eq/litre
+     - 0.000125
+     - [`5  <https://www.mfe.govt.nz/sites/default/files/media/Climate%20Change/2019-emission-factors-summary.pdf>`__] Page No. 6
+   * - Bioethanol
+     - kgCO2eq/litre
+     - 0.0000807
+     - [`5  <https://www.mfe.govt.nz/sites/default/files/media/Climate%20Change/2019-emission-factors-summary.pdf>`__] Page No. 6
+   * - Biogas
+     - kgCO2eq/m3
+     - 0.12
+     - [`6 <https://www.winnipeg.ca/finance/findata/matmgt/documents/2012/682-2012/682-2012_Appendix_H-WSTP_South_End_Plant_Process_Selection_Report/Appendix%207.pdf>`__] Page No. 1
+
+Following CO2 emissions for Germany and the four pilot sites (Norway, Spain, Romania, India) are defined:
+
+.. _table_CO2_emissions_countries:
+
+.. list-table:: CO2 Emission factors: grams of CO2 equivalent per kWh of electricity consumption
+   :widths: 50 25 25 25
+   :header-rows: 1
+
+   * - Country
+     - Unit
+     - Value
+     - Source
+   * - Germany
+     - gCO2eq/kWh
+     - 338
+     - [`7 <https://www.eea.europa.eu/data-and-maps/indicators/overview-of-the-electricity-production-3/assessment>`__] Fig. 2
+   * - Norway
+     - gCO2eq/kWh
+     - 19
+     - [`7 <https://www.eea.europa.eu/data-and-maps/indicators/overview-of-the-electricity-production-3/assessment>`__] Fig. 2
+   * - Spain
+     - gCO2eq/kWh
+     - 207
+     - [`7 <https://www.eea.europa.eu/data-and-maps/indicators/overview-of-the-electricity-production-3/assessment>`__] Fig. 2
+   * - Romania
+     - gCO2eq/kWh
+     - 293
+     - [`7 <https://www.eea.europa.eu/data-and-maps/indicators/overview-of-the-electricity-production-3/assessment>`__] Fig. 2
+   * - India
+     - gCO2eq/kWh
+     - 708
+     - [`8 <https://www.climate-transparency.org/wp-content/uploads/2019/11/B2G_2019_India.pdf>`__] Page No. 7
+
+The values mentioned in the table above account for emissions during the complete life cycle. This includes emissions during energy production, energy conversion, energy storage and energy transmission.
+
 Limitations
 -----------
 

docs/simulating_with_the_mvs.rst

@@ -36,6 +36,7 @@ that works just like above described "mvs_config.json".
 For that, each of the following files have to be present in the folder "csv_elements":
 
 - `economic_data.csv <https://github.com/rl-institut/multi-vector-simulator/blob/dev/input_template/csv_elements/economic_data.csv>`__ - Major economic parameters of the project
+- `energyBusses.csv  <https://github.com/rl-institut/multi-vector-simulator/blob/dev/input_template/csv_elements/energyBusses.csv>`__ - Energy busses of the energy system to be simulated
 - `energyConsumption.csv  <https://github.com/rl-institut/multi-vector-simulator/blob/dev/input_template/csv_elements/energyConsumption.csv>`__ - Energy demands and paths to their time series as csv
 - `energyConversion.csv <https://github.com/rl-institut/multi-vector-simulator/blob/dev/input_template/csv_elements/energyConversion.csv>`__ - Conversion/transformer objects, eg. transformers, generators, heat pumps
 - `energyProduction.csv <https://github.com/rl-institut/multi-vector-simulator/blob/dev/input_template/csv_elements/energyProduction.csv>`__ - Act as energy "sources", ie. PV or wind plants, with paths to their generation time series as csv

src/multi_vector_simulator/utils/constants_output.py

@@ -12,6 +12,7 @@
     COST_OPERATIONAL_TOTAL,
     COST_INVESTMENT,
     COST_UPFRONT,
+    COST_REPLACEMENT,
     COST_DISPATCH,
     COST_OM,
     ANNUITY_TOTAL,
@@ -37,6 +38,7 @@
     COST_OPERATIONAL_TOTAL,
     COST_INVESTMENT,
     COST_UPFRONT,
+    COST_REPLACEMENT,
     COST_DISPATCH,
     COST_OM,
     ANNUITY_TOTAL,

tests/benchmark_test_inputs/AB_grid_PV/csv_elements/energyProviders.csv

@@ -9,4 +9,4 @@ peak_demand_pricing,currency/kW,0
 peak_demand_pricing_period,"times per year (1,2,3,4,6,12)",1
 type_oemof,str,source
 energyVector,str,Electricity
-renewable_share,factor,0.1
+renewable_share,factor,0

tests/benchmark_test_inputs/Economic_KPI_C2_E2/test_data_economic_expected_values.csv

@@ -1,27 +1,6 @@
-,diesel_generator,pv_plant_01,storage capacity,input power,output power
-group,energyConversion,energyProduction,energyStorage,energyStorage,energyStorage
-age_installed,0.0,0.0,0.0,0.0,0.0
-development_costs,0.0,2.0,0.0,0.0,0.0
-specific_costs,100.0,500.0,500.0,200.0,300.0
-installedCap,1.0,1.0,1.0,1.0,1.0
-specific_costs_om,5.0,5.0,5.0,0.0,0.0
-dispatch_price,0.0,0.01,0.0,0.0,0.0
-lifetime,30.0,20.0,10.0,10.0,10.0
-lifetime_specific_cost_om,49.090737037246505,49.090737037246505,49.090737037246505,0.0,0.0
-lifetime_price_dispatch,0.0,0.09818147407449301,0.0,0.0,0.0
-lifetime_specific_cost,92.84839308653143,500.0,731.596744042342,292.638697616937,438.958046425405
-annuity_of_specific_investment_costs_and_specific_annual_om,14.4568139215434,55.926104411575295,79.5147443485377,29.8058977394151,44.7088466091226
-simulation_annuity,14.4568139215434,55.926104411575295,79.5147443485377,29.8058977394151,44.7088466091226
-Specific_replacement_costs_of_installed_capacity,-7.15160691346856,0.0,231.59674404234198,92.6386976169368,138.958046425405
-Specific_replacement_costs_of_optimized_capacity,-7.15160691346856,0.0,231.59674404234198,92.6386976169368,138.958046425405
-optimizedAddCap,0.0,0.0,0.0,0.0,0.0
-annuity_om,5.0000000000000036,16.637940000000054,5.0000000000000036,0.0,0.0
-annuity_total,4.271593039228317,16.841644417646357,28.58863993696238,9.435455974784949,14.153183962177405
-costs_total,41.93913012377794,165.35374747629743,280.6874810795885,92.6386976169368,138.958046425405
-costs_om_total,49.090737037246505,163.35374747629743,49.090737037246505,0.0,0.0
-costs_cost_om,49.090737037246505,49.090737037246505,49.090737037246505,0.0,0.0
-costs_dispatch,0.0,114.26301043905092,0.0,0.0,0.0
-costs_investment_over_lifetime,-7.15160691346856,2.0,231.59674404234198,92.6386976169368,138.958046425405
-costs_upfront_in_year_zero,0.0,2.0,0.0,0.0,0.0
-Replacement_costs_during_project_lifetime,-7.15160691346856,0.0,231.59674404234198,92.6386976169368,138.958046425405
-levelized_cost_of_energy_of_asset,0.00048762477616761605,0.014471327758732474,0.016317716858994358,0,0
+,group,age_installed,development_costs,specific_costs,installedCap,specific_costs_om,dispatch_price,lifetime,lifetime_specific_cost_om,lifetime_price_dispatch,lifetime_specific_cost,annuity_of_specific_investment_costs_and_specific_annual_om,simulation_annuity,Specific_replacement_costs_of_installed_capacity,Specific_replacement_costs_of_optimized_capacity,optimizedAddCap,annuity_om,annuity_total,costs_total,costs_om_total,costs_cost_om,costs_dispatch,costs_investment_over_lifetime,costs_upfront_in_year_zero,Replacement_costs_during_project_lifetime,levelized_cost_of_energy_of_asset
+diesel_generator,energyConversion,0,0,100,1,5,0.0,30,49.090737037246505,0.0,92.84839308653143,14.4568139215434,14.4568139215434,-7.15160691346856,-7.15160691346856,0,5.000000000000004,4.271593039228317,41.939130123777936,49.090737037246505,49.090737037246505,0.0,-7.15160691346856,0,-7.15160691346856,0.0004876247761676161
+pv_plant_01,energyProduction,0,2,500,1,5,0.01,20,49.090737037246505,0.098181474074493,500.0,55.926104411575295,55.926104411575295,0.0,0.0,0,16.637940000000054,16.841644417646357,165.35374747629743,163.35374747629743,49.090737037246505,114.26301043905092,2.0,2,0.0,0.014471327758732475
+storage capacity,energyStorage,0,0,500,1,5,0.0,10,49.090737037246505,0.0,731.596744042342,79.5147443485377,79.5147443485377,231.59674404234198,231.59674404234198,0,5.000000000000004,28.58863993696238,280.6874810795885,49.090737037246505,49.090737037246505,0.0,231.59674404234198,0,231.59674404234198,0.016317716858994358
+input power,energyStorage,0,0,200,1,0,0.0,10,0.0,0.0,292.638697616937,29.8058977394151,29.8058977394151,92.6386976169368,92.6386976169368,0,0.0,9.435455974784947,92.6386976169368,0.0,0.0,0.0,92.6386976169368,0,92.6386976169368,0.0
+output power,energyStorage,0,0,300,1,0,0.0,10,0.0,0.0,438.958046425405,44.7088466091226,44.7088466091226,138.958046425405,138.958046425405,0,0.0,14.153183962177405,138.958046425405,0.0,0.0,0.0,138.958046425405,0,138.958046425405,0.0