From 0bf693c585b66fb5e9e0faf020ecf3c6e63570c6 Mon Sep 17 00:00:00 2001 From: virio-andreyana Date: Fri, 16 Jun 2023 01:31:59 +0200 Subject: [PATCH 01/18] general update of .rst files --- config/config.default.yaml | 145 ++++++++++------------ doc/configtables/co2_budget.csv | 2 + doc/configtables/countries.csv | 2 + doc/configtables/foresight.csv | 2 + doc/configtables/toplevel.csv | 6 +- doc/configuration.rst | 207 +++++++++++++++++++++++--------- doc/costs.rst | 2 +- doc/foresight.rst | 11 +- doc/preparation.rst | 2 +- doc/tutorial.rst | 14 +-- doc/wildcards.rst | 17 +++ 11 files changed, 253 insertions(+), 157 deletions(-) create mode 100644 doc/configtables/co2_budget.csv create mode 100644 doc/configtables/countries.csv create mode 100644 doc/configtables/foresight.csv diff --git a/config/config.default.yaml b/config/config.default.yaml index 78c1385c7..dc04a9258 100644 --- a/config/config.default.yaml +++ b/config/config.default.yaml @@ -2,6 +2,7 @@ # # SPDX-License-Identifier: CC0-1.0 +# docs in version: 0.8.0 tutorial: false @@ -9,63 +10,51 @@ logging: level: INFO format: '%(levelname)s:%(name)s:%(message)s' -run: - name: "" # use this to keep track of runs with different settings - disable_progressbar: false # set to true to disable the progressbar - shared_resources: false # set to true to share the default resources across runs - shared_cutouts: true # set to true to share the default cutout(s) across runs +# docs in +run: + name: "" + disable_progressbar: false + shared_resources: false + shared_cutouts: true -foresight: overnight # options are overnight, myopic, perfect (perfect is not yet implemented) -# if you use myopic or perfect foresight, set the investment years in "planning_horizons" below +# docs in +foresight: overnight -scenario: +# docs in +# Wildcard docs in +scenario: simpl: - '' - ll: # allowed transmission line volume expansion, can be any float >= 1.0 with a prefix v|c (today) or "copt" - - v1.0 + ll: - v1.5 - clusters: # number of nodes in Europe, any integer between 37 (1 node per country-zone) and several hundred + clusters: - 37 - 128 - 256 - 512 - 1024 - opts: # only relevant for PyPSA-Eur + opts: - '' - sector_opts: # this is where the main scenario settings are + sector_opts: - Co2L0-3H-T-H-B-I-A-solar+p3-dist1 - # to really understand the options here, look in scripts/prepare_sector_network.py - # Co2Lx specifies the CO2 target in x% of the 1990 values; default will give default (5%); - # Co2L0p25 will give 25% CO2 emissions; Co2Lm0p05 will give 5% negative emissions - # xH is the temporal resolution; 3H is 3-hourly, i.e. one snapshot every 3 hours - # single letters are sectors: T for land transport, H for building heating, - # B for biomass supply, I for industry, shipping and aviation, - # A for agriculture, forestry and fishing - # solar+c0.5 reduces the capital cost of solar to 50\% of reference value - # solar+p3 multiplies the available installable potential by factor 3 - # seq400 sets the potential of CO2 sequestration to 400 Mt CO2 per year - # dist{n} includes distribution grids with investment cost of n times cost in data/costs.csv - # for myopic/perfect foresight cb states the carbon budget in GtCO2 (cumulative - # emissions throughout the transition path in the timeframe determined by the - # planning_horizons), be:beta decay; ex:exponential decay - # cb40ex0 distributes a carbon budget of 40 GtCO2 following an exponential - # decay with initial growth rate 0 - planning_horizons: # investment years for myopic and perfect; for overnight, year of cost assumptions can be different and is defined under 'costs' - - 2050 - # for example, set to + planning_horizons: # - 2020 # - 2030 # - 2040 - # - 2050 - # for myopic foresight + - 2050 -countries: ['AL', 'AT', 'BA', 'BE', 'BG', 'CH', 'CZ', 'DE', 'DK', 'EE', 'ES', 'FI', 'FR', 'GB', 'GR', 'HR', 'HU', 'IE', 'IT', 'LT', 'LU', 'LV', 'ME', 'MK', 'NL', 'NO', 'PL', 'PT', 'RO', 'RS', 'SE', 'SI', 'SK'] +# docs in +countries: ['AL', 'AT', 'BA', 'BE', 'BG', 'CH', 'CZ', 'DE', 'DK', 'EE', 'ES', + 'FI', 'FR', 'GB', 'GR', 'HR', 'HU', 'IE', 'IT', 'LT', 'LU', 'LV', + 'ME', 'MK', 'NL', 'NO', 'PL', 'PT', 'RO', 'RS', 'SE', 'SI', 'SK'] +# docs in snapshots: start: "2013-01-01" end: "2014-01-01" - inclusive: 'left' # include start, not end + inclusive: 'left' +# docs in enable: prepare_links_p_nom: false retrieve_databundle: true @@ -77,9 +66,7 @@ enable: retrieve_natura_raster: true custom_busmap: false -# CO2 budget as a fraction of 1990 emissions -# this is over-ridden if CO2Lx is set in sector_opts -# this is also over-ridden if cb is set in sector_opts +# docs in co2_budget: 2020: 0.701 2025: 0.524 @@ -89,18 +76,19 @@ co2_budget: 2045: 0.032 2050: 0.000 +# docs in electricity: voltages: [220., 300., 380.] - gaslimit: false # global gas usage limit of X MWh_th - co2limit: 7.75e+7 # 0.05 * 3.1e9*0.5 + gaslimit: false + co2limit: 7.75e+7 co2base: 1.487e+9 agg_p_nom_limits: data/agg_p_nom_minmax.csv - operational_reserve: # like https://genxproject.github.io/GenX/dev/core/#Reserves + operational_reserve: activate: false - epsilon_load: 0.02 # share of total load - epsilon_vres: 0.02 # share of total renewable supply - contingency: 4000 # fixed capacity in MW + epsilon_load: 0.02 + epsilon_vres: 0.02 + contingency: 4000 max_hours: battery: 6 @@ -112,7 +100,6 @@ electricity: Store: [battery, H2] Link: [] # H2 pipeline - # use pandas query strings here, e.g. Country not in ['Germany'] powerplants_filter: (DateOut >= 2022 or DateOut != DateOut) # use pandas query strings here, e.g. Country in ['Germany'] custom_powerplants: false @@ -136,7 +123,7 @@ electricity: Onshore: [onwind] PV: [solar] - +# docs in atlite: default_cutout: europe-2013-era5 nprocesses: 4 @@ -163,20 +150,16 @@ atlite: sarah_dir: features: [influx, temperature] - +# docs in renewable: onwind: cutout: europe-2013-era5 resource: method: wind turbine: Vestas_V112_3MW - capacity_per_sqkm: 3 # ScholzPhd Tab 4.3.1: 10MW/km^2 and assuming 30% fraction of the already restricted - # area is available for installation of wind generators due to competing land use and likely public - # acceptance issues. + capacity_per_sqkm: 3 # correction_factor: 0.93 corine: - # Scholz, Y. (2012). Renewable energy based electricity supply at low costs - # development of the REMix model and application for Europe. ( p.42 / p.28) grid_codes: [12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 31, 32] distance: 1000 distance_grid_codes: [1, 2, 3, 4, 5, 6] @@ -189,13 +172,8 @@ renewable: resource: method: wind turbine: NREL_ReferenceTurbine_5MW_offshore - capacity_per_sqkm: 2 # ScholzPhd Tab 4.3.1: 10MW/km^2 and assuming 20% fraction of the already restricted - # area is available for installation of wind generators due to competing land use and likely public - # acceptance issues. + capacity_per_sqkm: 2 correction_factor: 0.8855 - # proxy for wake losses - # from 10.1016/j.energy.2018.08.153 - # until done more rigorously in #153 corine: [44, 255] natura: true ship_threshold: 400 @@ -209,13 +187,8 @@ renewable: resource: method: wind turbine: NREL_ReferenceTurbine_5MW_offshore - capacity_per_sqkm: 2 # ScholzPhd Tab 4.3.1: 10MW/km^2 and assuming 20% fraction of the already restricted - # area is available for installation of wind generators due to competing land use and likely public - # acceptance issues. + capacity_per_sqkm: 2 correction_factor: 0.8855 - # proxy for wake losses - # from 10.1016/j.energy.2018.08.153 - # until done more rigorously in #153 corine: [44, 255] natura: true ship_threshold: 400 @@ -232,14 +205,7 @@ renewable: orientation: slope: 35. azimuth: 180. - capacity_per_sqkm: 1.7 # ScholzPhd Tab 4.3.1: 170 MW/km^2 and assuming 1% of the area can be used for solar PV panels - # Correction factor determined by comparing uncorrected area-weighted full-load hours to those - # published in Supplementary Data to - # Pietzcker, Robert Carl, et al. "Using the sun to decarbonize the power - # sector -- The economic potential of photovoltaics and concentrating solar - # power." Applied Energy 135 (2014): 704-720. - # This correction factor of 0.854337 may be in order if using reanalysis data. - # for discussion refer to https://github.com/PyPSA/pypsa-eur/pull/304 + capacity_per_sqkm: 1.7 # correction_factor: 0.854337 corine: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 26, 31, 32] natura: true @@ -253,10 +219,12 @@ renewable: hydro_max_hours: "energy_capacity_totals_by_country" # one of energy_capacity_totals_by_country, estimate_by_large_installations or a float clip_min_inflow: 1.0 +# docs in conventional: nuclear: p_max_pu: "data/nuclear_p_max_pu.csv" # float of file name +# docs in lines: types: 220.: "Al/St 240/40 2-bundle 220.0" @@ -267,24 +235,28 @@ lines: length_factor: 1.25 under_construction: 'zero' # 'zero': set capacity to zero, 'remove': remove, 'keep': with full capacity +# docs in links: p_max_pu: 1.0 p_nom_max: .inf include_tyndp: true under_construction: 'zero' # 'zero': set capacity to zero, 'remove': remove, 'keep': with full capacity +# docs in transformers: x: 0.1 s_nom: 2000. type: '' +# docs in load: - power_statistics: true # only for files from <2019; set false in order to get ENTSOE transparency data - interpolate_limit: 3 # data gaps up until this size are interpolated linearly - time_shift_for_large_gaps: 1w # data gaps up until this size are copied by copying from + power_statistics: true + interpolate_limit: 3 + time_shift_for_large_gaps: 1w manual_adjustments: true # false scaling_factor: 1.0 +# TODO: PyPSA-Eur merge issue in prepare_sector_network.py # regulate what components with which carriers are kept from PyPSA-Eur; # some technologies are removed because they are implemented differently # (e.g. battery or H2 storage) or have different year-dependent costs @@ -305,12 +277,14 @@ pypsa_eur: - hydro Store: [] +# docs in energy: energy_totals_year: 2011 base_emissions_year: 1990 eurostat_report_year: 2016 emissions: CO2 # "CO2" or "All greenhouse gases - (CO2 equivalent)" +# docs in biomass: year: 2030 scenario: ENS_Med @@ -336,13 +310,14 @@ biomass: - Manure solid, liquid - Sludge - +# docs in solar_thermal: clearsky_model: simple # should be "simple" or "enhanced"? orientation: slope: 45. azimuth: 180. +# docs under construction in # only relevant for foresight = myopic or perfect existing_capacities: grouping_years_power: [1980, 1985, 1990, 1995, 2000, 2005, 2010, 2015, 2020, 2025, 2030] @@ -354,7 +329,7 @@ existing_capacities: - oil - uranium - +# docs under construction in sector: district_heating: potential: 0.6 # maximum fraction of urban demand which can be supplied by district heating @@ -515,6 +490,7 @@ sector: biomass_to_liquid: false biosng: false +# docs under construction in industry: St_primary_fraction: # fraction of steel produced via primary route versus secondary route (scrap+EAF); today fraction is 0.6 2020: 0.6 @@ -568,6 +544,7 @@ industry: # DECHEMA (2017): https://dechema.de/dechema_media/Downloads/Positionspapiere/Technology_study_Low_carbon_energy_and_feedstock_for_the_European_chemical_industry-p-20002750.pdf # Material Economics (2019): https://materialeconomics.com/latest-updates/industrial-transformation-2050 +# docs in costs: year: 2030 version: v0.5.0 @@ -594,14 +571,15 @@ costs: fuel cell: 0. battery: 0. battery inverter: 0. - emission_prices: # in currency per tonne emission, only used with the option Ep + emission_prices: co2: 0. +# docs in clustering: simplify_network: - to_substations: false # network is simplified to nodes with positive or negative power injection (i.e. substations or offwind connections) + to_substations: false algorithm: kmeans # choose from: [hac, kmeans] - feature: solar+onwind-time # only for hac. choose from: [solar+onwind-time, solar+onwind-cap, solar-time, solar-cap, solar+offwind-cap] etc. + feature: solar+onwind-time exclude_carriers: [] remove_stubs: true remove_stubs_across_borders: true @@ -611,7 +589,7 @@ clustering: exclude_carriers: [] aggregation_strategies: generators: - p_nom_max: sum # use "min" for more conservative assumptions + p_nom_max: sum p_nom_min: sum p_min_pu: mean marginal_cost: mean @@ -620,6 +598,7 @@ clustering: ramp_limit_down: max efficiency: mean +# docs in solving: #tmpdir: "path/to/tmp" options: @@ -693,7 +672,7 @@ solving: mem: 30000 #memory in MB; 20 GB enough for 50+B+I+H2; 100 GB for 181+B+I+H2 - +# docs in plotting: map: boundaries: [-11, 30, 34, 71] diff --git a/doc/configtables/co2_budget.csv b/doc/configtables/co2_budget.csv new file mode 100644 index 000000000..21b42f056 --- /dev/null +++ b/doc/configtables/co2_budget.csv @@ -0,0 +1,2 @@ +,Unit,Values,Description +co2_budget,--,Dictionary with planning horizons as keys.,CO2 budget as a fraction of 1990 emissions. Overwritten if ``CO2Lx`` or ``cb`` are set in ``{sector_opts}`` wildcard"doc/configtables/othertoplevel.csv diff --git a/doc/configtables/countries.csv b/doc/configtables/countries.csv new file mode 100644 index 000000000..63dd85b36 --- /dev/null +++ b/doc/configtables/countries.csv @@ -0,0 +1,2 @@ + ,Unit,Values,Description +countries,--,"Subset of {'AL', 'AT', 'BA', 'BE', 'BG', 'CH', 'CZ', 'DE', 'DK', 'EE', 'ES', 'FI', 'FR', 'GB', 'GR', 'HR', 'HU', 'IE', 'IT', 'LT', 'LU', 'LV', 'ME', 'MK', 'NL', 'NO', 'PL', 'PT', 'RO', 'RS', 'SE', 'SI', 'SK'}","European countries defined by their `Two-letter country codes (ISO 3166-1) `_ which should be included in the energy system model." \ No newline at end of file diff --git a/doc/configtables/foresight.csv b/doc/configtables/foresight.csv new file mode 100644 index 000000000..07f930f2e --- /dev/null +++ b/doc/configtables/foresight.csv @@ -0,0 +1,2 @@ +,Unit,Values,Description +foresight,string,"{overnight, myopic, perfect}","See :ref:`Foresight Options` for detail explanations." \ No newline at end of file diff --git a/doc/configtables/toplevel.csv b/doc/configtables/toplevel.csv index 8a4b443c2..9496e1651 100644 --- a/doc/configtables/toplevel.csv +++ b/doc/configtables/toplevel.csv @@ -3,8 +3,4 @@ version,--,0.x.x,"Version of PyPSA-Eur. Descriptive only." tutorial,bool,"{true, false}","Switch to retrieve the tutorial data set instead of the full data set." logging,,, -- level,--,"Any of {'INFO', 'WARNING', 'ERROR'}","Restrict console outputs to all infos, warning or errors only" --- format,--,"","Custom format for log messages. See `LogRecord `_ attributes." -foresight,string,"{overnight, myopic, perfect}","Defaults to overnight scenarios." -countries,--,"Subset of {'AL', 'AT', 'BA', 'BE', 'BG', 'CH', 'CZ', 'DE', 'DK', 'EE', 'ES', 'FI', 'FR', 'GB', 'GR', 'HR', 'HU', 'IE', 'IT', 'LT', 'LU', 'LV', 'ME', 'MK', 'NL', 'NO', 'PL', 'PT', 'RO', 'RS', 'SE', 'SI', 'SK'}","European countries defined by their `Two-letter country codes (ISO 3166-1) `_ which should be included in the energy system model." -focus_weights,--,"Keys should be two-digit country codes (e.g. DE) and values should range between 0 and 1","Ratio of total clusters for particular countries. the remaining weight is distributed according to mean load. An example: ``focus_weights: 'DE': 0.6 'FR': 0.2``." -co2_budget,--,"Dictionary with planning horizons as keys.","CO2 budget as a fraction of 1990 emissions. Overwritten if ``CO2Lx`` or ``cb`` are set in ``{sector_opts}`` wildcard" +-- format,--,"","Custom format for log messages. See `LogRecord `_ attributes." \ No newline at end of file diff --git a/doc/configuration.rst b/doc/configuration.rst index ee61c018d..89b6f42f4 100644 --- a/doc/configuration.rst +++ b/doc/configuration.rst @@ -18,7 +18,8 @@ Top-level configuration .. literalinclude:: ../config/config.default.yaml :language: yaml - :lines: 5-11,18-19,62,80-90 + :start-at: version: + :end-before: # docs .. csv-table:: @@ -26,7 +27,7 @@ Top-level configuration :widths: 25,7,22,30 :file: configtables/toplevel.csv -.. _scenario: +.. _run_cf: ``run`` ======= @@ -40,13 +41,34 @@ The ``run`` section is used for running and storing scenarios with different con .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: run: - :end-before: foresight: + :end-before: # docs .. csv-table:: :header-rows: 1 :widths: 25,7,22,30 :file: configtables/run.csv +.. _foresight_cf: + +``foresight`` +============= + +.. literalinclude:: ../config/config.default.yaml + :language: yaml + :start-at: foresight: + :end-at: foresight: + +.. csv-table:: + :header-rows: 1 + :widths: 25,7,22,30 + :file: configtables/foresight.csv + +.. note:: + if you use myopic or perfect foresight, The investment years in + :ref:`planning_horizons` in scenario has to be set. + +.. _scenario: + ``scenario`` ============ @@ -79,13 +101,28 @@ An exemplary dependency graph (starting from the simplification rules) then look .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: scenario: - :end-before: countries: + :end-before: # docs .. csv-table:: :header-rows: 1 :widths: 25,7,22,30 :file: configtables/scenario.csv +.. _countries: + +``countries`` +============= + +.. literalinclude:: ../config/config.default.yaml + :language: yaml + :start-at: countries: + :end-before: # docs + +.. csv-table:: + :header-rows: 1 + :widths: 25,7,22,30 + :file: configtables/countries.csv + .. _snapshots_cf: ``snapshots`` @@ -96,7 +133,7 @@ Specifies the temporal range to build an energy system model for as arguments to .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: snapshots: - :end-before: enable: + :end-before: # docs .. csv-table:: :header-rows: 1 @@ -113,13 +150,32 @@ Switches for some rules and optional features. .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: enable: - :end-before: co2_budget: + :end-before: # docs .. csv-table:: :header-rows: 1 :widths: 25,7,22,30 :file: configtables/enable.csv +.. _CO2_budget_cf: + +``co2 budget`` +============== + +.. literalinclude:: ../config/config.default.yaml + :language: yaml + :start-at: co2_budget: + :end-before: # docs + +.. csv-table:: + :header-rows: 1 + :widths: 25,7,22,30 + :file: configtables/co2_budget.csv + +.. note:: + this parameter is over-ridden if ``CO2Lx`` or ``cb`` is set in + sector_opts. + .. _electricity_cf: ``electricity`` @@ -128,7 +184,7 @@ Switches for some rules and optional features. .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: electricity: - :end-before: atlite: + :end-before: # docs .. csv-table:: :header-rows: 1 @@ -145,7 +201,7 @@ Define and specify the ``atlite.Cutout`` used for calculating renewable potentia .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: atlite: - :end-before: renewable: + :end-before: # docs .. csv-table:: :header-rows: 1 @@ -170,6 +226,15 @@ Define and specify the ``atlite.Cutout`` used for calculating renewable potentia :widths: 25,7,22,30 :file: configtables/onwind.csv +.. note:: + Notes on ``capacity_per_sqkm``. ScholzPhd Tab 4.3.1: 10MW/km^2 and assuming 30% fraction of the already restricted + area is available for installation of wind generators due to competing land use and likely public + acceptance issues. + +.. note:: + The default choice for corine ``grid_codes`` was based on Scholz, Y. (2012). Renewable energy based electricity supply at low costs + development of the REMix model and application for Europe. ( p.42 / p.28) + ``offwind-ac`` -------------- @@ -183,6 +248,16 @@ Define and specify the ``atlite.Cutout`` used for calculating renewable potentia :widths: 25,7,22,30 :file: configtables/offwind-ac.csv +.. note:: + Notes on ``capacity_per_sqkm``. ScholzPhd Tab 4.3.1: 10MW/km^2 and assuming 20% fraction of the already restricted + area is available for installation of wind generators due to competing land use and likely public + acceptance issues. + +.. note:: + Notes on ``correction_factor``. Correction due to proxy for wake losses + from 10.1016/j.energy.2018.08.153 + until done more rigorously in #153 + ``offwind-dc`` --------------- @@ -196,6 +271,10 @@ Define and specify the ``atlite.Cutout`` used for calculating renewable potentia :widths: 25,7,22,30 :file: configtables/offwind-dc.csv +.. note:: + both ``offwind-ac`` and ``offwind-dc`` have the same assumption on + ``capacity_per_sqkm`` and ``correction_factor``. + ``solar`` --------------- @@ -209,13 +288,22 @@ Define and specify the ``atlite.Cutout`` used for calculating renewable potentia :widths: 25,7,22,30 :file: configtables/solar.csv +.. note:: + Notes on ``capacity_per_sqkm``. ScholzPhd Tab 4.3.1: 170 MW/km^2 and assuming 1% of the area can be used for solar PV panels. + Correction factor determined by comparing uncorrected area-weighted full-load hours to those + published in Supplementary Data to Pietzcker, Robert Carl, et al. "Using the sun to decarbonize the power + sector -- The economic potential of photovoltaics and concentrating solar + power." Applied Energy 135 (2014): 704-720. + This correction factor of 0.854337 may be in order if using reanalysis data. + for discussion refer to this + ``hydro`` --------------- .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: hydro: - :end-before: conventional: + :end-before: # docs .. csv-table:: :header-rows: 1 @@ -237,7 +325,7 @@ overwrite the existing values. .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: conventional: - :end-before: lines: + :end-before: # docs .. csv-table:: :header-rows: 1 @@ -250,7 +338,7 @@ overwrite the existing values. .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: lines: - :end-before: links: + :end-before: # docs .. csv-table:: :header-rows: 1 @@ -265,7 +353,7 @@ overwrite the existing values. .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: links: - :end-before: transformers: + :end-before: # docs .. csv-table:: :header-rows: 1 @@ -280,7 +368,7 @@ overwrite the existing values. .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: transformers: - :end-before: load: + :end-before: # docs .. csv-table:: :header-rows: 1 @@ -295,45 +383,13 @@ overwrite the existing values. .. literalinclude:: ../config/config.default.yaml :language: yaml :start-after: type: - :end-at: scaling_factor: + :end-before: # docs .. csv-table:: :header-rows: 1 :widths: 25,7,22,30 :file: configtables/load.csv -.. _costs_cf: - -``costs`` -============= - -.. literalinclude:: ../config/config.default.yaml - :language: yaml - :start-at: costs: - :end-before: clustering: - -.. csv-table:: - :header-rows: 1 - :widths: 25,7,22,30 - :file: configtables/costs.csv - - -.. _clustering_cf: - -``clustering`` -============== - -.. literalinclude:: ../config/config.default.yaml - :language: yaml - :start-at: clustering: - :end-before: solving: - -.. csv-table:: - :header-rows: 1 - :widths: 25,7,22,30 - :file: configtables/clustering.csv - - .. _energy_cf: ``energy`` @@ -348,7 +404,7 @@ overwrite the existing values. .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: energy: - :end-before: biomass: + :end-before: # docs .. _biomass_cf: @@ -365,7 +421,7 @@ overwrite the existing values. .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: biomass: - :end-before: solar_thermal: + :end-before: # docs .. _solar_thermal_cf: @@ -381,7 +437,7 @@ overwrite the existing values. .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: solar_thermal: - :end-before: existing_capacities: + :end-before: # docs .. _existing_capacities_cf: @@ -397,7 +453,7 @@ overwrite the existing values. .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: existing_capacities: - :end-before: sector: + :end-before: # docs .. _sector_cf: @@ -413,7 +469,7 @@ overwrite the existing values. .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: sector: - :end-before: industry: + :end-before: # docs .. _industry_cf: @@ -429,22 +485,59 @@ overwrite the existing values. .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: industry: - :end-before: costs: + :end-before: # docs -.. _solving_cf: +.. _costs_cf: -``solving`` +``costs`` ============= .. literalinclude:: ../config/config.default.yaml :language: yaml - :start-at: solving: - :end-before: plotting: + :start-at: costs: + :end-before: # docs .. csv-table:: :header-rows: 1 :widths: 25,7,22,30 - :file: configtables/solving.csv + :file: configtables/costs.csv + +.. note:: + ``rooftop_share:`` are based on the potentials, assuming + (0.1 kW/m2 and 10 m2/person) + +.. _clustering_cf: + +``clustering`` +============== + +.. literalinclude:: ../config/config.default.yaml + :language: yaml + :start-at: clustering: + :end-before: # docs + +.. csv-table:: + :header-rows: 1 + :widths: 25,7,22,30 + :file: configtables/clustering.csv + +.. note:: + ``feature:`` in ``simplify_network:`` + are only relevant if ``hac`` were chosen in ``algorithm``. + +.. tip:: + use ``min`` in ``p_nom_max:`` for more ` + conservative assumptions. + +.. _solving_cf: + +``solving`` +============= + +.. literalinclude:: ../config/config.default.yaml + :language: yaml + :start-at: solving: + :end-before: # docs .. csv-table:: :header-rows: 1 diff --git a/doc/costs.rst b/doc/costs.rst index 21938ced5..5ddbb3603 100644 --- a/doc/costs.rst +++ b/doc/costs.rst @@ -12,7 +12,7 @@ The database of cost assumptions is retrieved from the repository saved to a file ``data/costs_{year}.csv``. The ``config/config.yaml`` provides options to choose a reference year and use a specific version of the repository. -.. literalinclude:: ../config.default.yaml +.. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: costs: :end-at: version: diff --git a/doc/foresight.rst b/doc/foresight.rst index 9b8210602..c1be34436 100644 --- a/doc/foresight.rst +++ b/doc/foresight.rst @@ -87,8 +87,12 @@ evolve with the myopic approach: vehicle-to-grid services. - The annual biomass potential (default year and scenario for which potential is - taken is 2030, defined `here - `_) + taken is 2030, as defined in config) + +.. literalinclude:: ../config/test/config.myopic.yaml + :language: yaml + :start-at: biomass: + :end-at: year: Configuration @@ -108,7 +112,7 @@ optimized. For a myopic optimization, this is equivalent to the investment year. To set the investment years which are sequentially simulated for the myopic investment planning, select for example: -.. literalinclude:: ../test/config.myopic.yaml +.. literalinclude:: ../config/test/config.myopic.yaml :language: yaml :start-at: planning_horizons: :end-before: countries: @@ -203,6 +207,7 @@ The myopic code solves the network for the time steps included in network comprises additional generator, storage, and link capacities with p_nom_extendable=True. The non-solved network is saved in ``results/run_name/networks/prenetworks-brownfield``. + The base year is the first element in ``planning_horizons``. Step 1 is implemented with the rule add_baseyear for the base year and with the rule add_brownfield for the remaining planning_horizons. diff --git a/doc/preparation.rst b/doc/preparation.rst index b5a120620..5cdc80316 100644 --- a/doc/preparation.rst +++ b/doc/preparation.rst @@ -89,7 +89,7 @@ Rule ``build_powerplants`` .. _electricity_demand: Rule ``build_electricity_demand`` -============================= +================================== .. automodule:: build_electricity_demand diff --git a/doc/tutorial.rst b/doc/tutorial.rst index 1b87cefe5..518c58a30 100644 --- a/doc/tutorial.rst +++ b/doc/tutorial.rst @@ -43,21 +43,21 @@ How to configure runs? The model can be adapted to only include selected countries (e.g. Belgium) instead of all European countries to limit the spatial scope. -.. literalinclude:: ../test/config.electricity.yaml +.. literalinclude:: ../config/test/config.electricity.yaml :language: yaml :start-at: countries: :end-before: snapshots: Likewise, the example's temporal scope can be restricted (e.g. to a single week). -.. literalinclude:: ../test/config.electricity.yaml +.. literalinclude:: ../config/test/config.electricity.yaml :language: yaml :start-at: snapshots: :end-before: electricity: It is also possible to allow less or more carbon-dioxide emissions. Here, we limit the emissions of Belgium to 100 Mt per year. -.. literalinclude:: ../test/config.electricity.yaml +.. literalinclude:: ../config/test/config.electricity.yaml :language: yaml :start-at: electricity: :end-before: extendable_carriers: @@ -65,7 +65,7 @@ It is also possible to allow less or more carbon-dioxide emissions. Here, we lim PyPSA-Eur also includes a database of existing conventional powerplants. We can select which types of existing powerplants we like to be extendable: -.. literalinclude:: ../test/config.electricity.yaml +.. literalinclude:: ../config/test/config.electricity.yaml :language: yaml :start-at: extendable_carriers: :end-before: renewable_carriers: @@ -74,7 +74,7 @@ To accurately model the temporal and spatial availability of renewables such as wind and solar energy, we rely on historical weather data. It is advisable to adapt the required range of coordinates to the selection of countries. -.. literalinclude:: ../test/config.electricity.yaml +.. literalinclude:: ../config/test/config.electricity.yaml :language: yaml :start-at: atlite: :end-before: renewable: @@ -83,7 +83,7 @@ We can also decide which weather data source should be used to calculate potentials and capacity factor time-series for each carrier. For example, we may want to use the ERA-5 dataset for solar and not the default SARAH-2 dataset. -.. literalinclude:: ../test/config.electricity.yaml +.. literalinclude:: ../config/test/config.electricity.yaml :language: yaml :start-at: solar: :end-at: cutout: @@ -91,7 +91,7 @@ want to use the ERA-5 dataset for solar and not the default SARAH-2 dataset. Finally, it is possible to pick a solver. For instance, this tutorial uses the open-source solver GLPK. -.. literalinclude:: ../test/config.electricity.yaml +.. literalinclude:: ../config/test/config.electricity.yaml :language: yaml :start-at: solver: :end-before: plotting: diff --git a/doc/wildcards.rst b/doc/wildcards.rst index 30c58929d..75eec1922 100644 --- a/doc/wildcards.rst +++ b/doc/wildcards.rst @@ -117,6 +117,23 @@ The ``{sector_opts}`` wildcard .. warning:: More comprehensive documentation for this wildcard will be added soon. + To really understand the options here, look in scripts/prepare_sector_network.py + + # Co2Lx specifies the CO2 target in x% of the 1990 values; default will give default (5%); + # Co2L0p25 will give 25% CO2 emissions; Co2Lm0p05 will give 5% negative emissions + # xH is the temporal resolution; 3H is 3-hourly, i.e. one snapshot every 3 hours + # single letters are sectors: T for land transport, H for building heating, + # B for biomass supply, I for industry, shipping and aviation, + # A for agriculture, forestry and fishing + # solar+c0.5 reduces the capital cost of solar to 50\% of reference value + # solar+p3 multiplies the available installable potential by factor 3 + # seq400 sets the potential of CO2 sequestration to 400 Mt CO2 per year + # dist{n} includes distribution grids with investment cost of n times cost in data/costs.csv + # for myopic/perfect foresight cb states the carbon budget in GtCO2 (cumulative + # emissions throughout the transition path in the timeframe determined by the + # planning_horizons), be:beta decay; ex:exponential decay + # cb40ex0 distributes a carbon budget of 40 GtCO2 following an exponential + # decay with initial growth rate 0 The ``{sector_opts}`` wildcard is only used for sector-coupling studies. From 678792009a7f85c4032add17bf8242e4d3f2f914 Mon Sep 17 00:00:00 2001 From: virio-andreyana Date: Thu, 22 Jun 2023 10:23:54 +0200 Subject: [PATCH 02/18] preparing sector config data --- doc/configtables/sector-opts.csv | 2 +- doc/configtables/sector.csv | 26 ++++++++++++++++++++++++++ 2 files changed, 27 insertions(+), 1 deletion(-) create mode 100644 doc/configtables/sector.csv diff --git a/doc/configtables/sector-opts.csv b/doc/configtables/sector-opts.csv index 5a6b68527..ea39c3b0d 100644 --- a/doc/configtables/sector-opts.csv +++ b/doc/configtables/sector-opts.csv @@ -1,5 +1,5 @@ Trigger, Description, Definition, Status -``nH``, i.e. ``2H``-``6H``, Resample the time-resolution by averaging over every ``n`` snapshots, ``prepare_network``: `average_every_nhours() `_ and its `caller `__), In active use +``nH``, i.e. ``2H``-``6H``, "Resample the time-resolution by averaging over every ``n`` snapshots, ``prepare_network``: `average_every_nhours() `_ and its `caller `__)", In active use ``Co2L``, Add an overall absolute carbon-dioxide emissions limit configured in ``electricity: co2limit``. If a float is appended an overall emission limit relative to the emission level given in ``electricity: co2base`` is added (e.g. ``Co2L0.05`` limits emissisions to 5% of what is given in ``electricity: co2base``), ``prepare_network``: `add_co2limit() `_ and its `caller `__, In active use ``carrier+{c|p|m}factor``,"Alter the capital cost (``c``), installable potential (``p``) or marginal costs (``m``) of a carrier by a factor. Example: ``solar+c0.5`` reduces the capital cost of solar to 50\% of original values.", ``prepare_network``, In active use ``T``,Add land transport sector,,In active use diff --git a/doc/configtables/sector.csv b/doc/configtables/sector.csv new file mode 100644 index 000000000..d553b7d9c --- /dev/null +++ b/doc/configtables/sector.csv @@ -0,0 +1,26 @@ +,Unit,Values,Description +district_heating,,,`prepare_sector_network.py `_ +-- potential,,float,maximum fraction of urban demand which can be supplied by district heating increase of today's district heating demand to potential maximum district heating share +-- progress,,Dictionary with planning horizons as keys.,Progress = 0 means today's district heating share. Progress = 1 means maximum fraction of urban demand is supplied by district heating +-- district_heating_loss,,float, +cluster_heat_buses,,bool,cluster residential and service heat buses in `prepare_sector_network.py `_ to one to save memory. +bev_dsm_restriction_value,,float,Adding a stage of charge (SOC) limit for battery electric vehicles (BEV) to manage its own energy demand (DSM). Located in `build_transport_demand.py `_. +bev_dsm_restriction_time,,float,Time at which SOC of BEV has to be dsm_restriction_value +transport_heating_deadband_upper,,, +transport_heating_deadband_lower,,, +ICE_lower_degree_factor,,, +ICE_upper_degree_factor,,, +EV_lower_degree_factor,,, +EV_upper_degree_factor,,, +bev_dsm,,, +bev_availability,,, +bev_energy,,, +bev_charge_efficiency,,, +bev_plug_to_wheel_efficiency,,, +bev_charge_rate,,, +bev_avail_max,,, +bev_avail_mean,,, +v2g,,, +land_transport_fuel_cell_share,,, +land_transport_electric_share,,, +land_transport_ice_share,,, From d943e3bb6847b27e8ec8231b56337627e7064913 Mon Sep 17 00:00:00 2001 From: virio-andreyana Date: Tue, 27 Jun 2023 23:16:15 +0200 Subject: [PATCH 03/18] add sector and industry table. In progress --- doc/configtables/industry.csv | 28 +++++++ doc/configtables/sector.csv | 133 +++++++++++++++++++++++++++------- doc/configuration.rst | 10 +++ 3 files changed, 146 insertions(+), 25 deletions(-) create mode 100644 doc/configtables/industry.csv diff --git a/doc/configtables/industry.csv b/doc/configtables/industry.csv new file mode 100644 index 000000000..6d5034982 --- /dev/null +++ b/doc/configtables/industry.csv @@ -0,0 +1,28 @@ +,Unit,Values,Description +St_primary_fraction,--,Dictionary with planning horizons as keys.,The fraction of steel produced via primary route versus secondary route (scrap+EAF). Current fraction is 0.6 +DRI_fraction,--,Dictionary with planning horizons as keys.,The fraction of the primary route converted to DRI + EAF +H2_DRI,--,float,The hydrogen consumption in Direct Reduced Iron (DRI) Mwh_H2 LHV/ton_Steel from 51kgH2/tSt in Vogl et al (2018) doi:10.1016/j.jclepro.2018.08.279 +elec_DRI,--,float,The electricity consumed in Direct Reduced Iron (DRI) shaft. MWh/tSt HYBRIT brochure https://ssabwebsitecdn.azureedge.net/-/media/hybrit/files/hybrit_brochure.pdf +Al_primary_fraction,--,Dictionary with planning horizons as keys.,The fraction of aluminium produced via the primary route versus scrap. Current fraction is 0.4 +MWh_NH3_per_tNH3,LHV,float,The energy amount per ton of ammonia. +MWh_CH4_per_tNH3_SMR,--,float,The energy amount of methane needed to produce a ton of ammonia using steam methane reforming (SMR). Value derived from 2012's demand from https://ec.europa.eu/docsroom/documents/4165/attachments/1/translations/en/renditions/pdf +MWh_elec_per_tNH3_SMR,--,float,"The energy amount of electricity needed to produce a ton of ammonia using steam methane reforming (SMR). same source, assuming 94-6% split methane-elec of total energy demand 11.5 MWh/tNH3" +MWh_H2_per_tNH3_electrolysis,--,float,"The energy amount of hydrogen needed to produce a ton of ammonia using Haber–Bosch process. From https://doi.org/10.1016/j.joule.2018.04.017, around 0.197 tH2/tHN3 (>3/17 since some H2 lost and used for energy)" +MWh_elec_per_tNH3_electrolysis,--,float,The energy amount of electricity needed to produce a ton of ammonia using Haber–Bosch process. From https://doi.org/10.1016/j.joule.2018.04.017 Table 13 (air separation and HB) +MWh_NH3_per_MWh_H2_cracker,--,float,The energy amount of amonia needed to produce an energy amount hydrogen using ammonia cracker. https://github.com/euronion/trace/blob/44a5ff8401762edbef80eff9cfe5a47c8d3c8be4/data/efficiencies.csv +NH3_process_emissions,MtCO2/a,float,The emission of ammonia production from steam methane reforming (SMR) +petrochemical_process_emissions,MtCO2/a,float,The emission of petrochemical production +HVC_primary_fraction,--,float,The fraction of today's high value chemicals (HVC) produced via primary route +HVC_mechanical_recycling_fraction,--,float,The fraction of today's high value chemicals (HVC) produced using mechanical recycling +HVC_chemical_recycling_fraction,--,float,The fraction of today's high value chemicals (HVC) produced using chemical recycling +HVC_production_today,MtHVC/a,float,The amount of high value chemicals (HVC) produced +MWh_elec_per_tHVC_mechanical_recycling,--,float,The energy amount of electricity needed to produce a ton of high value chemical (HVC) using mechanical recycling +MWh_elec_per_tHVC_chemical_recycling,--,float,The energy amount of electricity needed to produce a ton of high value chemical (HVC) using chemical recycling +chlorine_production_today,MtCl/a,float,The amount of chlorine produced +MWh_elec_per_tCl,--,float,The energy amount of electricity needed to produce a ton of chlorine +MWh_H2_per_tCl,--,float,The energy amount of hydrogen needed to produce a ton of chlorine +methanol_production_today,MtMeOH/a,float,The amount of methanol produced +MWh_elec_per_tMeOH,--,float,The energy amount of electricity needed to produce a ton of methanol +MWh_CH4_per_tMeOH,--,float,The energy amount of methane needed to produce a ton of methanol +hotmaps_locate_missing,--,true or false,Locate industrial sites without valid locations based on city and countries. +reference_year,--,year, diff --git a/doc/configtables/sector.csv b/doc/configtables/sector.csv index d553b7d9c..27a698096 100644 --- a/doc/configtables/sector.csv +++ b/doc/configtables/sector.csv @@ -1,26 +1,109 @@ ,Unit,Values,Description -district_heating,,,`prepare_sector_network.py `_ --- potential,,float,maximum fraction of urban demand which can be supplied by district heating increase of today's district heating demand to potential maximum district heating share --- progress,,Dictionary with planning horizons as keys.,Progress = 0 means today's district heating share. Progress = 1 means maximum fraction of urban demand is supplied by district heating --- district_heating_loss,,float, -cluster_heat_buses,,bool,cluster residential and service heat buses in `prepare_sector_network.py `_ to one to save memory. -bev_dsm_restriction_value,,float,Adding a stage of charge (SOC) limit for battery electric vehicles (BEV) to manage its own energy demand (DSM). Located in `build_transport_demand.py `_. -bev_dsm_restriction_time,,float,Time at which SOC of BEV has to be dsm_restriction_value -transport_heating_deadband_upper,,, -transport_heating_deadband_lower,,, -ICE_lower_degree_factor,,, -ICE_upper_degree_factor,,, -EV_lower_degree_factor,,, -EV_upper_degree_factor,,, -bev_dsm,,, -bev_availability,,, -bev_energy,,, -bev_charge_efficiency,,, -bev_plug_to_wheel_efficiency,,, -bev_charge_rate,,, -bev_avail_max,,, -bev_avail_mean,,, -v2g,,, -land_transport_fuel_cell_share,,, -land_transport_electric_share,,, -land_transport_ice_share,,, +district_heating,--,,`prepare_sector_network.py `_ +-- potential,--,float,maximum fraction of urban demand which can be supplied by district heating increase of today's district heating demand to potential maximum district heating share +-- progress,--,Dictionary with planning horizons as keys.,Progress = 0 means today's district heating share. Progress = 1 means maximum fraction of urban demand is supplied by district heating +-- district_heating_loss,--,float, +cluster_heat_buses,--,true or false,cluster residential and service heat buses in `prepare_sector_network.py `_ to one to save memory. +bev_dsm_restriction_value,--,float,Adding a stage of charge (SOC) limit for battery electric vehicles (BEV) to manage its own energy demand (DSM). Located in `build_transport_demand.py `_. +bev_dsm_restriction_time,--,float,Time at which SOC of BEV has to be dsm_restriction_value +transport_heating_deadband_upper,°C,float,"The minimum temperature in the vehicle. At lower temperatures, the energy required for heating in the vehicle increases." +transport_heating_deadband_lower,°C,float,"The maximum temperature in the vehicle. At higher temperatures, the energy required for cooling in the vehicle increases." +ICE_lower_degree_factor,--,float,Percentage increase in energy demand in internal combustion engine (ICE) for each degree difference between the cold environment and the minimum temperature. +ICE_upper_degree_factor,--,float,Percentage increase in energy demand in internal combustion engine (ICE) for each degree difference between the hot environment and the maximum temperature. +EV_lower_degree_factor,--,float,Percentage increase in energy demand in electric vehicles (EV) for each degree difference between the cold environment and the minimum temperature. +EV_upper_degree_factor,--,float,Percentage increase in energy demand in electric vehicles (EV) for each degree difference between the hot environment and the maximum temperature. +bev_dsm,--,true or false,Add the option for battery electric vehicles (BEV) to manage its own energy demand (DSM) +bev_availability,--,float,The percentage for battery electric vehicles (BEV) that are able to do demand side management (DSM) +bev_energy,--,float,The average size of battery electric vehicles (BEV) in MWh +bev_charge_efficiency,--,float,Battery electric vehicles (BEV) charge and discharge efficiency +bev_plug_to_wheel_efficiency,km/kWh,float,The distance battery electric vehicles (BEV) can travel in km per kWh of energy charge in battery. Base value comes from Tesla Model S https://www.fueleconomy.gov/feg/ +bev_charge_rate,MWh,float,The power consumption for one electric vehicle (EV) in MWh. Value derived from 3-phase charger with 11 kW. +bev_avail_max,--,float,The maximum percentage plugged-in availability for passenger electric vehicles. +bev_avail_mean,--,float,The average percentage plugged-in availability for passenger electric vehicles. +v2g,--,true or false,Allows feed-in to grid from EV battery +land_transport_fuel_cell_share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses fuel cells in a given year +land_transport_electric_share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses electric vehicles (EV) in a given year +land_transport_ice_share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses internal combustion engines (ICE) in a given year +transport_fuel_cell_efficiency,--,float,The H2 conversion efficiencies of fuel cells in transport +transport_internal_combustion_efficiency,--,float,The oil conversion efficiencies of internal combustion engine (ICE) in transport +agriculture_machinery_electric_share,--,float,The percentage for agricultural machinery that uses electricity +agriculture_machinery_oil_share,--,float,The percentage for agricultural machinery that uses oil +agriculture_machinery_fuel_efficiency,--,float,The efficiency of electric-powered machinery in the conversion of electricity to meet agricultural needs. +agriculture_machinery_electric_efficiency,--,float,The efficiency of oil-powered machinery in the conversion of oil to meet agricultural needs. +MWh_MeOH_per_MWh_H2,LHV,float,The energy amount of the produced methanol per energy amount of hydrogen. source: DECHEMA (2017): Low carbon energy and feedstock for the European chemical industry page 64. +MWh_MeOH_per_tCO2,LHV,float,The energy amount of the produced methanol per ton of CO2 +MWh_MeOH_per_MWh_e,LHV,float,The energy amount of the produced methanol per energy amount of electricity +shipping_hydrogen_liquefaction,--,true or false,Consider whether to include liquefaction costs for shipping H2 demand. +shipping_hydrogen_share,--,Dictionary with planning horizons as keys.,The share of ships powered by hydrogen in a given year +shipping_methanol_share,--,Dictionary with planning horizons as keys.,The share of ships powered by methanol in a given year +shipping_oil_share,--,Dictionary with planning horizons as keys.,The share of ships powered by oil in a given year +shipping_methanol_efficiency,--,float,The efficiency of methanol-powered ships in the conversion of methanol to meet shipping needs. +shipping_oil_efficiency,--,float,The efficiency of oil-powered ships in the conversion of oil to meet shipping needs. +aviation_demand_factor,--,float,The proportion of demand for aviation compared to today's +HVC_demand_factor,--,float,The proportion of demand for high-value chemicals compared to today's +time_dep_hp_cop,--,true or false, +heat_pump_sink_T,°C,float, +reduce_space_heat_exogenously,--,true or false, +reduce_space_heat_exogenously_factor,--,Dictionary with planning horizons as keys., +retrofitting,,, +-- retro_endogen,--,true or false,Add retrofitting as an endogenous system which co-optimise space heat savings. +-- cost_factor,,,Weight costs for building renovation +-- interest_rate,,,The interest rate for investment in building components +-- annualise_cost,--,true or false,Annualise the investment costs of retrofitting +-- tax_weighting,--,true or false,Weight the costs of retrofitting depending on taxes in countries +-- construction_index,--,true or false,Weight the costs of retrofitting depending on labour/material costs per country +tes,--,true or false,Add option for storing thermal energy in large water pits associated with district heating systems and individual thermal energy storage (TES) +tes_tau,,, +-- decentral,,, +-- central,,, +boilers,--,true or false,Add option for transforming electricity into heat using resistive heater +oil_boilers,--,true or false,Add option for transforming oil into heat using boilers +biomass_boiler,--,true or false,Add option for transforming biomass into heat using boilers +chp,--,true or false,Add option for using Combined Heat and Power (CHP) +micro_chp,--,true or false,Add option for using Combined Heat and Power (CHP) for decentral areas. +solar_thermal,--,true or false,Add option for using solar to generate heat. +solar_cf_correction,,, +marginal_cost_storage,,, +methanation,--,true or false,Add option for transforming hydrogen and CO2 into methane using methanation. +helmeth,--,true or false,Add option for transforming power into gas using HELMETH (Integrated High-Temperature ELectrolysis and METHanation for Effective Power to Gas Conversion) +coal_cc,--,true or false,Add option for coal CHPs with carbon capture +dac,--,true or false,Add option for Direct Air Capture (DAC) +co2_vent,--,true or false,Add option for vent out CO2 from storages to the atmosphere. +allam_cycle,--,true or false,Add option to include `Allam cycle gas power plants `_ +hydrogen_fuel_cell,--,true or false,Add option to include hydrogen fuel cell for re-electrification. Assuming OCGT technology costs +hydrogen_turbine,--,true or false,Add option to include hydrogen turbine for re-electrification. Assuming OCGT technology costs +SMR,--,true or false,Add option for transforming natural gas into hydrogen and CO2 using Steam Methane Reforming (SMR) +regional_co2_sequestration_potential,,, +-- enable,--,true or false,Add option for regionally-resolved geological carbon dioxide sequestration potentials based on `CO2StoP `_. +-- attribute,,, +-- include_onshore,,true or false,Add options for including onshore sequestration potentials +-- min_size,,float,Any sites with lower potential than this value will be excluded +-- max_size,,float,The maximum sequestration potential for any one site. +-- years_of_storage,,float,The years until potential exhausted at optimised annual rate +co2_sequestration_potential,MtCO2/a,float,The potential of sequestering CO2 in Europe per year +co2_sequestration_cost,EUR/tCO2,float,The cost of sequestering a ton of CO2 +co2_spatial,--,true or false,"„Add option to spatially resolve carrier representing stored carbon dioxide. This allows for more detailed modelling of CCUTS, e.g. regarding the capturing of industrial process emissions, usage as feedstock for electrofuels, transport of carbon dioxide, and geological sequestration sites.“" +co2network,--,true or false,Add option for planning a new carbon dioxide network +cc_fraction,,,The default fraction of CO2 captured with post-combustion capture +hydrogen_underground_storage,--,true or false,Add options for storing hydrogen underground. Storage potential depends regionally. +hydrogen_underground_storage_locations,,"„onshore, nearshore or offshore“","„The location where hydrogen underground storage can be located. Onshore, nearshore, offshore means it must be located more than 50 km away from the sea, within 50 km of the sea, or within the sea itself respectively.“" +ammonia,--,"„true, false or regional“","Add ammonia as a carrrier. It can be either true (copperplated NH3) or ""regional"" (regionalised NH3 without network)" +min_part_load_fischer_tropsch,,, +min_part_load_methanolisation,,, +use_fischer_tropsch_waste_heat,--,true or false,Add option for using waste heat of Fischer Tropsch in district heating networks +use_fuel_cell_waste_heat,--,true or false,Add option for using waste heat of fuel cells in district heating networks +use_electrolysis_waste_heat,--,true or false,Add option for using waste heat of electrolysis in district heating networks +electricity_distribution_grid,--,true or false,Add a electricity distribution grid +electricity_distribution_grid_cost_factor,,,Multiplies the investment cost of the electricity distribution grid in data/costs.csv +electricity_grid_connection,--,true or false,Add the cost of electricity grid connection for onshore wind and solar +H2_network,--,true or false,Add option for new hydrogen pipelines +gas_network,--,true or false,"Add natural gas infrastructure, incl. LNG terminals, production and entry-points" +H2_retrofit,--,true or false,Add option for retrofiting existing pipelines to transport hydrogen +H2_retrofit_capacity_per_CH4,,, +gas_distribution_grid,--,true or false,Add a gas distribution grid +gas_distribution_grid_cost_factor,,,Multiplies the investment cost of the gas distribution grid in data/costs.csv +biomass_spatial,--,true or false,Add option for resolving biomass demand regionally +biomass_transport,--,true or false,Add option for transporting solid biomass between nodes +conventional_generation,,,Add a more detailed description of conventional carriers. Any power generation requires the consumption of fuel from nodes representing that fuel. +biomass_to_liquid,--,true or false,Add option for transforming solid biomass into liquid fuel with the same properties as oil +biosng,--,true or false,Add option for transforming solid biomass into synthesis gas with the same properties as natural gas diff --git a/doc/configuration.rst b/doc/configuration.rst index 89b6f42f4..a1e0379ea 100644 --- a/doc/configuration.rst +++ b/doc/configuration.rst @@ -471,6 +471,11 @@ overwrite the existing values. :start-at: sector: :end-before: # docs +.. csv-table:: + :header-rows: 1 + :widths: 25,7,22,30 + :file: configtables/sector.csv + .. _industry_cf: ``industry`` @@ -487,6 +492,11 @@ overwrite the existing values. :start-at: industry: :end-before: # docs +.. csv-table:: + :header-rows: 1 + :widths: 25,7,22,30 + :file: configtables/industry.csv + .. _costs_cf: ``costs`` From febd2933742874924e316cb3e40b4c47b5ed5211 Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Wed, 28 Jun 2023 08:05:16 +0000 Subject: [PATCH 04/18] [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --- config/config.default.yaml | 36 ++++++++++++++++------------------ doc/configtables/countries.csv | 2 +- doc/configtables/foresight.csv | 2 +- doc/configtables/sector.csv | 2 +- doc/configtables/toplevel.csv | 2 +- doc/configuration.rst | 16 +++++++-------- 6 files changed, 29 insertions(+), 31 deletions(-) diff --git a/config/config.default.yaml b/config/config.default.yaml index dc04a9258..a54309ef6 100644 --- a/config/config.default.yaml +++ b/config/config.default.yaml @@ -2,7 +2,7 @@ # # SPDX-License-Identifier: CC0-1.0 -# docs in +# docs in version: 0.8.0 tutorial: false @@ -10,22 +10,22 @@ logging: level: INFO format: '%(levelname)s:%(name)s:%(message)s' -# docs in -run: +# docs in +run: name: "" disable_progressbar: false shared_resources: false shared_cutouts: true -# docs in +# docs in foresight: overnight -# docs in -# Wildcard docs in -scenario: +# docs in +# Wildcard docs in +scenario: simpl: - '' - ll: + ll: - v1.5 clusters: - 37 @@ -33,7 +33,7 @@ scenario: - 256 - 512 - 1024 - opts: + opts: - '' sector_opts: - Co2L0-3H-T-H-B-I-A-solar+p3-dist1 @@ -43,18 +43,16 @@ scenario: # - 2040 - 2050 -# docs in -countries: ['AL', 'AT', 'BA', 'BE', 'BG', 'CH', 'CZ', 'DE', 'DK', 'EE', 'ES', - 'FI', 'FR', 'GB', 'GR', 'HR', 'HU', 'IE', 'IT', 'LT', 'LU', 'LV', - 'ME', 'MK', 'NL', 'NO', 'PL', 'PT', 'RO', 'RS', 'SE', 'SI', 'SK'] +# docs in +countries: ['AL', 'AT', 'BA', 'BE', 'BG', 'CH', 'CZ', 'DE', 'DK', 'EE', 'ES', 'FI', 'FR', 'GB', 'GR', 'HR', 'HU', 'IE', 'IT', 'LT', 'LU', 'LV', 'ME', 'MK', 'NL', 'NO', 'PL', 'PT', 'RO', 'RS', 'SE', 'SI', 'SK'] -# docs in +# docs in snapshots: start: "2013-01-01" end: "2014-01-01" inclusive: 'left' -# docs in +# docs in enable: prepare_links_p_nom: false retrieve_databundle: true @@ -66,7 +64,7 @@ enable: retrieve_natura_raster: true custom_busmap: false -# docs in +# docs in co2_budget: 2020: 0.701 2025: 0.524 @@ -76,7 +74,7 @@ co2_budget: 2045: 0.032 2050: 0.000 -# docs in +# docs in electricity: voltages: [220., 300., 380.] gaslimit: false @@ -157,7 +155,7 @@ renewable: resource: method: wind turbine: Vestas_V112_3MW - capacity_per_sqkm: 3 + capacity_per_sqkm: 3 # correction_factor: 0.93 corine: grid_codes: [12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 31, 32] @@ -172,7 +170,7 @@ renewable: resource: method: wind turbine: NREL_ReferenceTurbine_5MW_offshore - capacity_per_sqkm: 2 + capacity_per_sqkm: 2 correction_factor: 0.8855 corine: [44, 255] natura: true diff --git a/doc/configtables/countries.csv b/doc/configtables/countries.csv index 63dd85b36..6a386416c 100644 --- a/doc/configtables/countries.csv +++ b/doc/configtables/countries.csv @@ -1,2 +1,2 @@ ,Unit,Values,Description -countries,--,"Subset of {'AL', 'AT', 'BA', 'BE', 'BG', 'CH', 'CZ', 'DE', 'DK', 'EE', 'ES', 'FI', 'FR', 'GB', 'GR', 'HR', 'HU', 'IE', 'IT', 'LT', 'LU', 'LV', 'ME', 'MK', 'NL', 'NO', 'PL', 'PT', 'RO', 'RS', 'SE', 'SI', 'SK'}","European countries defined by their `Two-letter country codes (ISO 3166-1) `_ which should be included in the energy system model." \ No newline at end of file +countries,--,"Subset of {'AL', 'AT', 'BA', 'BE', 'BG', 'CH', 'CZ', 'DE', 'DK', 'EE', 'ES', 'FI', 'FR', 'GB', 'GR', 'HR', 'HU', 'IE', 'IT', 'LT', 'LU', 'LV', 'ME', 'MK', 'NL', 'NO', 'PL', 'PT', 'RO', 'RS', 'SE', 'SI', 'SK'}","European countries defined by their `Two-letter country codes (ISO 3166-1) `_ which should be included in the energy system model." diff --git a/doc/configtables/foresight.csv b/doc/configtables/foresight.csv index 07f930f2e..a19ec1393 100644 --- a/doc/configtables/foresight.csv +++ b/doc/configtables/foresight.csv @@ -1,2 +1,2 @@ ,Unit,Values,Description -foresight,string,"{overnight, myopic, perfect}","See :ref:`Foresight Options` for detail explanations." \ No newline at end of file +foresight,string,"{overnight, myopic, perfect}","See :ref:`Foresight Options` for detail explanations." diff --git a/doc/configtables/sector.csv b/doc/configtables/sector.csv index 27a698096..6a6fcd0d9 100644 --- a/doc/configtables/sector.csv +++ b/doc/configtables/sector.csv @@ -4,7 +4,7 @@ district_heating,--,,`prepare_sector_network.py `_ to one to save memory. -bev_dsm_restriction_value,--,float,Adding a stage of charge (SOC) limit for battery electric vehicles (BEV) to manage its own energy demand (DSM). Located in `build_transport_demand.py `_. +bev_dsm_restriction_value,--,float,Adding a stage of charge (SOC) limit for battery electric vehicles (BEV) to manage its own energy demand (DSM). Located in `build_transport_demand.py `_. bev_dsm_restriction_time,--,float,Time at which SOC of BEV has to be dsm_restriction_value transport_heating_deadband_upper,°C,float,"The minimum temperature in the vehicle. At lower temperatures, the energy required for heating in the vehicle increases." transport_heating_deadband_lower,°C,float,"The maximum temperature in the vehicle. At higher temperatures, the energy required for cooling in the vehicle increases." diff --git a/doc/configtables/toplevel.csv b/doc/configtables/toplevel.csv index 9496e1651..dcf0f29a3 100644 --- a/doc/configtables/toplevel.csv +++ b/doc/configtables/toplevel.csv @@ -3,4 +3,4 @@ version,--,0.x.x,"Version of PyPSA-Eur. Descriptive only." tutorial,bool,"{true, false}","Switch to retrieve the tutorial data set instead of the full data set." logging,,, -- level,--,"Any of {'INFO', 'WARNING', 'ERROR'}","Restrict console outputs to all infos, warning or errors only" --- format,--,"","Custom format for log messages. See `LogRecord `_ attributes." \ No newline at end of file +-- format,--,"","Custom format for log messages. See `LogRecord `_ attributes." diff --git a/doc/configuration.rst b/doc/configuration.rst index a1e0379ea..a5de44531 100644 --- a/doc/configuration.rst +++ b/doc/configuration.rst @@ -64,7 +64,7 @@ The ``run`` section is used for running and storing scenarios with different con :file: configtables/foresight.csv .. note:: - if you use myopic or perfect foresight, The investment years in + if you use myopic or perfect foresight, The investment years in :ref:`planning_horizons` in scenario has to be set. .. _scenario: @@ -173,7 +173,7 @@ Switches for some rules and optional features. :file: configtables/co2_budget.csv .. note:: - this parameter is over-ridden if ``CO2Lx`` or ``cb`` is set in + this parameter is over-ridden if ``CO2Lx`` or ``cb`` is set in sector_opts. .. _electricity_cf: @@ -272,7 +272,7 @@ Define and specify the ``atlite.Cutout`` used for calculating renewable potentia :file: configtables/offwind-dc.csv .. note:: - both ``offwind-ac`` and ``offwind-dc`` have the same assumption on + both ``offwind-ac`` and ``offwind-dc`` have the same assumption on ``capacity_per_sqkm`` and ``correction_factor``. ``solar`` @@ -512,8 +512,8 @@ overwrite the existing values. :widths: 25,7,22,30 :file: configtables/costs.csv -.. note:: - ``rooftop_share:`` are based on the potentials, assuming +.. note:: + ``rooftop_share:`` are based on the potentials, assuming (0.1 kW/m2 and 10 m2/person) .. _clustering_cf: @@ -531,11 +531,11 @@ overwrite the existing values. :widths: 25,7,22,30 :file: configtables/clustering.csv -.. note:: - ``feature:`` in ``simplify_network:`` +.. note:: + ``feature:`` in ``simplify_network:`` are only relevant if ``hac`` were chosen in ``algorithm``. -.. tip:: +.. tip:: use ``min`` in ``p_nom_max:`` for more ` conservative assumptions. From 9138901e5d35467331a1956dde856fff6c3e1d49 Mon Sep 17 00:00:00 2001 From: virio-andreyana Date: Mon, 3 Jul 2023 03:37:41 +0200 Subject: [PATCH 05/18] add table for biomass, energy, existing capacities, solar thermal, plotting (need suggestion) --- doc/configtables/biomass.csv | 7 ++ doc/configtables/energy.csv | 5 ++ doc/configtables/existing_capacities.csv | 5 ++ doc/configtables/plotting.csv | 29 +++++--- doc/configtables/sector.csv | 92 ++++++++++++------------ doc/configtables/solar-thermal.csv | 5 ++ doc/configuration.rst | 56 ++++++++++----- 7 files changed, 127 insertions(+), 72 deletions(-) create mode 100644 doc/configtables/biomass.csv create mode 100644 doc/configtables/energy.csv create mode 100644 doc/configtables/existing_capacities.csv create mode 100644 doc/configtables/solar-thermal.csv diff --git a/doc/configtables/biomass.csv b/doc/configtables/biomass.csv new file mode 100644 index 000000000..f5b4841f2 --- /dev/null +++ b/doc/configtables/biomass.csv @@ -0,0 +1,7 @@ +,Unit,Values,Description +year ,--,"{2010, 2020, 2030, 2040, 2050}",Year for which to retrieve biomass potential according to the assumptions of the `JRC ENSPRESO `_ . +scenario ,--,"{""ENS_Low"", ""ENS_Med"", ""ENS_High""}",Scenario for which to retrieve biomass potential. The scenario definition can be seen in `ENSPRESO_BIOMASS `_ +classes ,,, +-- solid biomass,--,Array of biomass comodity,The comodity that are included as solid biomass +-- not included,--,Array of biomass comodity,The comodity that are not included as a biomass potential +-- biogas,--,Array of biomass comodity,The comodity that are included as biogas diff --git a/doc/configtables/energy.csv b/doc/configtables/energy.csv new file mode 100644 index 000000000..640a9bc39 --- /dev/null +++ b/doc/configtables/energy.csv @@ -0,0 +1,5 @@ +,Unit,Values,Description +energy_totals_year ,--,"{1990,1995,2000,2005,2010,2011,…} ",The year for the sector energy use. The year must be avaliable in the Eurostat report +base_emissions_year ,--,YYYY; e.g. ‚1990‘ ,'The base year for the sector emissions. See `European Environment Agency (EEA) `_ downloaded 201228 (modified by EEA last on 201221)‘ +eurostat_report_year ,--,"{2016,2017,2018}","'The year in which the Eurostat report year are extracted. 2016 includes Bosnia and Herzegovina, 2017 does not‘" +emissions ,--,"{CO2, All greenhouse gases - (CO2 equivalent)}",Specify which sectoral emissions are taken into account. Data derived from EEA. diff --git a/doc/configtables/existing_capacities.csv b/doc/configtables/existing_capacities.csv new file mode 100644 index 000000000..6b53d5f12 --- /dev/null +++ b/doc/configtables/existing_capacities.csv @@ -0,0 +1,5 @@ +,Unit,Values,Description +grouping_years_power ,--,An array of years,Intervals to group existing capacities for power +grouping_years_heat ,--,An array of years below 2020,Intervals to group existing capacities for heat +threshold_capacity ,MW,float,Capacities generators and links of below threshold are removed during add_existing_capacities +conventional_carriers ,--,"Any subset of {uranium, coal, lignite, oil} ",List of conventional power plants to include in the sectoral network diff --git a/doc/configtables/plotting.csv b/doc/configtables/plotting.csv index bea345cae..82bf7af61 100644 --- a/doc/configtables/plotting.csv +++ b/doc/configtables/plotting.csv @@ -1,10 +1,19 @@ -,Unit,Values,Description -map,,, --- boundaries,°,"[x1,x2,y1,y2]","Boundaries of the map plots in degrees latitude (y) and longitude (x)" -costs_max,bn Euro,float,"Upper y-axis limit in cost bar plots." -costs_threshold,bn Euro,float,"Threshold below which technologies will not be shown in cost bar plots." -energy_max,TWh,float,"Upper y-axis limit in energy bar plots." -energy_min,TWh,float,"Lower y-axis limit in energy bar plots." -energy_threshold,TWh,float,"Threshold below which technologies will not be shown in energy bar plots." -tech_colors,--,"carrier -> HEX colour code","Mapping from network ``carrier`` to a colour (`HEX colour code `_)." -nice_names,--,"str -> str","Mapping from network ``carrier`` to a more readable name." +,Unit,Values,Description +map,,, +-- boundaries,°,"[x1,x2,y1,y2]",Boundaries of the map plots in degrees latitude (y) and longitude (x) +costs_max,bn Euro,float,Upper y-axis limit in cost bar plots. +costs_threshold,bn Euro,float,Threshold below which technologies will not be shown in cost bar plots. +energy_max,TWh,float,Upper y-axis limit in energy bar plots. +energy_min,TWh,float,Lower y-axis limit in energy bar plots. +energy_threshold,TWh,float,Threshold below which technologies will not be shown in energy bar plots. +tech_colors,--,carrier -> HEX colour code,Mapping from network ``carrier`` to a colour (`HEX colour code `_). +vre_techs ,--,subset of carriers,Value not in use +renewable_storage_techs ,--,subset of carriers,Value not in use +conv_techs ,--,subset of carriers,Value in use with unworthy significance. Used as the definition of conventional carrier in solve_network +storage_techs ,--,subset of carriers,Value not in use +load_carriers ,--,subset of carriers,Value not in use +AC_carriers ,--,subset of carriers,Value not in use +link_carriers ,--,subset of carriers,Value not in use +heat_links ,--,subset of carriers,Value not in use +heat_generators ,--,subset of carriers,Value not in use +nice_names,--,str -> str,Mapping from network ``carrier`` to a more readable name. diff --git a/doc/configtables/sector.csv b/doc/configtables/sector.csv index 6a6fcd0d9..7a6f3c140 100644 --- a/doc/configtables/sector.csv +++ b/doc/configtables/sector.csv @@ -3,7 +3,7 @@ district_heating,--,,`prepare_sector_network.py `_ to one to save memory. +cluster_heat_buses,--,"{true, false}",cluster residential and service heat buses in `prepare_sector_network.py `_ to one to save memory. bev_dsm_restriction_value,--,float,Adding a stage of charge (SOC) limit for battery electric vehicles (BEV) to manage its own energy demand (DSM). Located in `build_transport_demand.py `_. bev_dsm_restriction_time,--,float,Time at which SOC of BEV has to be dsm_restriction_value transport_heating_deadband_upper,°C,float,"The minimum temperature in the vehicle. At lower temperatures, the energy required for heating in the vehicle increases." @@ -12,7 +12,7 @@ ICE_lower_degree_factor,--,float,Percentage increase in energy demand in interna ICE_upper_degree_factor,--,float,Percentage increase in energy demand in internal combustion engine (ICE) for each degree difference between the hot environment and the maximum temperature. EV_lower_degree_factor,--,float,Percentage increase in energy demand in electric vehicles (EV) for each degree difference between the cold environment and the minimum temperature. EV_upper_degree_factor,--,float,Percentage increase in energy demand in electric vehicles (EV) for each degree difference between the hot environment and the maximum temperature. -bev_dsm,--,true or false,Add the option for battery electric vehicles (BEV) to manage its own energy demand (DSM) +bev_dsm,--,"{true, false}",Add the option for battery electric vehicles (BEV) to manage its own energy demand (DSM) bev_availability,--,float,The percentage for battery electric vehicles (BEV) that are able to do demand side management (DSM) bev_energy,--,float,The average size of battery electric vehicles (BEV) in MWh bev_charge_efficiency,--,float,Battery electric vehicles (BEV) charge and discharge efficiency @@ -20,7 +20,7 @@ bev_plug_to_wheel_efficiency,km/kWh,float,The distance battery electric vehicles bev_charge_rate,MWh,float,The power consumption for one electric vehicle (EV) in MWh. Value derived from 3-phase charger with 11 kW. bev_avail_max,--,float,The maximum percentage plugged-in availability for passenger electric vehicles. bev_avail_mean,--,float,The average percentage plugged-in availability for passenger electric vehicles. -v2g,--,true or false,Allows feed-in to grid from EV battery +v2g,--,"{true, false}",Allows feed-in to grid from EV battery land_transport_fuel_cell_share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses fuel cells in a given year land_transport_electric_share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses electric vehicles (EV) in a given year land_transport_ice_share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses internal combustion engines (ICE) in a given year @@ -33,7 +33,7 @@ agriculture_machinery_electric_efficiency,--,float,The efficiency of oil-powered MWh_MeOH_per_MWh_H2,LHV,float,The energy amount of the produced methanol per energy amount of hydrogen. source: DECHEMA (2017): Low carbon energy and feedstock for the European chemical industry page 64. MWh_MeOH_per_tCO2,LHV,float,The energy amount of the produced methanol per ton of CO2 MWh_MeOH_per_MWh_e,LHV,float,The energy amount of the produced methanol per energy amount of electricity -shipping_hydrogen_liquefaction,--,true or false,Consider whether to include liquefaction costs for shipping H2 demand. +shipping_hydrogen_liquefaction,--,"{true, false}",Consider whether to include liquefaction costs for shipping H2 demand. shipping_hydrogen_share,--,Dictionary with planning horizons as keys.,The share of ships powered by hydrogen in a given year shipping_methanol_share,--,Dictionary with planning horizons as keys.,The share of ships powered by methanol in a given year shipping_oil_share,--,Dictionary with planning horizons as keys.,The share of ships powered by oil in a given year @@ -41,69 +41,69 @@ shipping_methanol_efficiency,--,float,The efficiency of methanol-powered ships i shipping_oil_efficiency,--,float,The efficiency of oil-powered ships in the conversion of oil to meet shipping needs. aviation_demand_factor,--,float,The proportion of demand for aviation compared to today's HVC_demand_factor,--,float,The proportion of demand for high-value chemicals compared to today's -time_dep_hp_cop,--,true or false, +time_dep_hp_cop,--,"{true, false}", heat_pump_sink_T,°C,float, -reduce_space_heat_exogenously,--,true or false, +reduce_space_heat_exogenously,--,"{true, false}", reduce_space_heat_exogenously_factor,--,Dictionary with planning horizons as keys., retrofitting,,, --- retro_endogen,--,true or false,Add retrofitting as an endogenous system which co-optimise space heat savings. +-- retro_endogen,--,"{true, false}",Add retrofitting as an endogenous system which co-optimise space heat savings. -- cost_factor,,,Weight costs for building renovation -- interest_rate,,,The interest rate for investment in building components --- annualise_cost,--,true or false,Annualise the investment costs of retrofitting --- tax_weighting,--,true or false,Weight the costs of retrofitting depending on taxes in countries --- construction_index,--,true or false,Weight the costs of retrofitting depending on labour/material costs per country -tes,--,true or false,Add option for storing thermal energy in large water pits associated with district heating systems and individual thermal energy storage (TES) +-- annualise_cost,--,"{true, false}",Annualise the investment costs of retrofitting +-- tax_weighting,--,"{true, false}",Weight the costs of retrofitting depending on taxes in countries +-- construction_index,--,"{true, false}",Weight the costs of retrofitting depending on labour/material costs per country +tes,--,"{true, false}",Add option for storing thermal energy in large water pits associated with district heating systems and individual thermal energy storage (TES) tes_tau,,, -- decentral,,, -- central,,, -boilers,--,true or false,Add option for transforming electricity into heat using resistive heater -oil_boilers,--,true or false,Add option for transforming oil into heat using boilers -biomass_boiler,--,true or false,Add option for transforming biomass into heat using boilers -chp,--,true or false,Add option for using Combined Heat and Power (CHP) -micro_chp,--,true or false,Add option for using Combined Heat and Power (CHP) for decentral areas. -solar_thermal,--,true or false,Add option for using solar to generate heat. +boilers,--,"{true, false}",Add option for transforming electricity into heat using resistive heater +oil_boilers,--,"{true, false}",Add option for transforming oil into heat using boilers +biomass_boiler,--,"{true, false}",Add option for transforming biomass into heat using boilers +chp,--,"{true, false}",Add option for using Combined Heat and Power (CHP) +micro_chp,--,"{true, false}",Add option for using Combined Heat and Power (CHP) for decentral areas. +solar_thermal,--,"{true, false}",Add option for using solar to generate heat. solar_cf_correction,,, marginal_cost_storage,,, -methanation,--,true or false,Add option for transforming hydrogen and CO2 into methane using methanation. -helmeth,--,true or false,Add option for transforming power into gas using HELMETH (Integrated High-Temperature ELectrolysis and METHanation for Effective Power to Gas Conversion) -coal_cc,--,true or false,Add option for coal CHPs with carbon capture -dac,--,true or false,Add option for Direct Air Capture (DAC) -co2_vent,--,true or false,Add option for vent out CO2 from storages to the atmosphere. -allam_cycle,--,true or false,Add option to include `Allam cycle gas power plants `_ -hydrogen_fuel_cell,--,true or false,Add option to include hydrogen fuel cell for re-electrification. Assuming OCGT technology costs -hydrogen_turbine,--,true or false,Add option to include hydrogen turbine for re-electrification. Assuming OCGT technology costs -SMR,--,true or false,Add option for transforming natural gas into hydrogen and CO2 using Steam Methane Reforming (SMR) +methanation,--,"{true, false}",Add option for transforming hydrogen and CO2 into methane using methanation. +helmeth,--,"{true, false}",Add option for transforming power into gas using HELMETH (Integrated High-Temperature ELectrolysis and METHanation for Effective Power to Gas Conversion) +coal_cc,--,"{true, false}",Add option for coal CHPs with carbon capture +dac,--,"{true, false}",Add option for Direct Air Capture (DAC) +co2_vent,--,"{true, false}",Add option for vent out CO2 from storages to the atmosphere. +allam_cycle,--,"{true, false}",Add option to include `Allam cycle gas power plants `_ +hydrogen_fuel_cell,--,"{true, false}",Add option to include hydrogen fuel cell for re-electrification. Assuming OCGT technology costs +hydrogen_turbine,--,"{true, false}",Add option to include hydrogen turbine for re-electrification. Assuming OCGT technology costs +SMR,--,"{true, false}",Add option for transforming natural gas into hydrogen and CO2 using Steam Methane Reforming (SMR) regional_co2_sequestration_potential,,, --- enable,--,true or false,Add option for regionally-resolved geological carbon dioxide sequestration potentials based on `CO2StoP `_. +-- enable,--,"{true, false}",Add option for regionally-resolved geological carbon dioxide sequestration potentials based on `CO2StoP `_. -- attribute,,, --- include_onshore,,true or false,Add options for including onshore sequestration potentials +-- include_onshore,,"{true, false}",Add options for including onshore sequestration potentials -- min_size,,float,Any sites with lower potential than this value will be excluded -- max_size,,float,The maximum sequestration potential for any one site. -- years_of_storage,,float,The years until potential exhausted at optimised annual rate co2_sequestration_potential,MtCO2/a,float,The potential of sequestering CO2 in Europe per year co2_sequestration_cost,EUR/tCO2,float,The cost of sequestering a ton of CO2 -co2_spatial,--,true or false,"„Add option to spatially resolve carrier representing stored carbon dioxide. This allows for more detailed modelling of CCUTS, e.g. regarding the capturing of industrial process emissions, usage as feedstock for electrofuels, transport of carbon dioxide, and geological sequestration sites.“" -co2network,--,true or false,Add option for planning a new carbon dioxide network +co2_spatial,--,"{true, false}","„Add option to spatially resolve carrier representing stored carbon dioxide. This allows for more detailed modelling of CCUTS, e.g. regarding the capturing of industrial process emissions, usage as feedstock for electrofuels, transport of carbon dioxide, and geological sequestration sites.“" +co2network,--,"{true, false}",Add option for planning a new carbon dioxide network cc_fraction,,,The default fraction of CO2 captured with post-combustion capture -hydrogen_underground_storage,--,true or false,Add options for storing hydrogen underground. Storage potential depends regionally. -hydrogen_underground_storage_locations,,"„onshore, nearshore or offshore“","„The location where hydrogen underground storage can be located. Onshore, nearshore, offshore means it must be located more than 50 km away from the sea, within 50 km of the sea, or within the sea itself respectively.“" -ammonia,--,"„true, false or regional“","Add ammonia as a carrrier. It can be either true (copperplated NH3) or ""regional"" (regionalised NH3 without network)" +hydrogen_underground_storage,--,"{true, false}",Add options for storing hydrogen underground. Storage potential depends regionally. +hydrogen_underground_storage_locations,,"{onshore, nearshore, offshore}","„The location where hydrogen underground storage can be located. Onshore, nearshore, offshore means it must be located more than 50 km away from the sea, within 50 km of the sea, or within the sea itself respectively.“" +ammonia,--,"{true, false, regional}","Add ammonia as a carrrier. It can be either true (copperplated NH3) or ""regional"" (regionalised NH3 without network)" min_part_load_fischer_tropsch,,, min_part_load_methanolisation,,, -use_fischer_tropsch_waste_heat,--,true or false,Add option for using waste heat of Fischer Tropsch in district heating networks -use_fuel_cell_waste_heat,--,true or false,Add option for using waste heat of fuel cells in district heating networks -use_electrolysis_waste_heat,--,true or false,Add option for using waste heat of electrolysis in district heating networks -electricity_distribution_grid,--,true or false,Add a electricity distribution grid +use_fischer_tropsch_waste_heat,--,"{true, false}",Add option for using waste heat of Fischer Tropsch in district heating networks +use_fuel_cell_waste_heat,--,"{true, false}",Add option for using waste heat of fuel cells in district heating networks +use_electrolysis_waste_heat,--,"{true, false}",Add option for using waste heat of electrolysis in district heating networks +electricity_distribution_grid,--,"{true, false}",Add a electricity distribution grid electricity_distribution_grid_cost_factor,,,Multiplies the investment cost of the electricity distribution grid in data/costs.csv -electricity_grid_connection,--,true or false,Add the cost of electricity grid connection for onshore wind and solar -H2_network,--,true or false,Add option for new hydrogen pipelines -gas_network,--,true or false,"Add natural gas infrastructure, incl. LNG terminals, production and entry-points" -H2_retrofit,--,true or false,Add option for retrofiting existing pipelines to transport hydrogen +electricity_grid_connection,--,"{true, false}",Add the cost of electricity grid connection for onshore wind and solar +H2_network,--,"{true, false}",Add option for new hydrogen pipelines +gas_network,--,"{true, false}","Add natural gas infrastructure, incl. LNG terminals, production and entry-points" +H2_retrofit,--,"{true, false}",Add option for retrofiting existing pipelines to transport hydrogen H2_retrofit_capacity_per_CH4,,, -gas_distribution_grid,--,true or false,Add a gas distribution grid +gas_distribution_grid,--,"{true, false}",Add a gas distribution grid gas_distribution_grid_cost_factor,,,Multiplies the investment cost of the gas distribution grid in data/costs.csv -biomass_spatial,--,true or false,Add option for resolving biomass demand regionally -biomass_transport,--,true or false,Add option for transporting solid biomass between nodes +biomass_spatial,--,"{true, false}",Add option for resolving biomass demand regionally +biomass_transport,--,"{true, false}",Add option for transporting solid biomass between nodes conventional_generation,,,Add a more detailed description of conventional carriers. Any power generation requires the consumption of fuel from nodes representing that fuel. -biomass_to_liquid,--,true or false,Add option for transforming solid biomass into liquid fuel with the same properties as oil -biosng,--,true or false,Add option for transforming solid biomass into synthesis gas with the same properties as natural gas +biomass_to_liquid,--,"{true, false}",Add option for transforming solid biomass into liquid fuel with the same properties as oil +biosng,--,"{true, false}",Add option for transforming solid biomass into synthesis gas with the same properties as natural gas diff --git a/doc/configtables/solar-thermal.csv b/doc/configtables/solar-thermal.csv new file mode 100644 index 000000000..2daf99aea --- /dev/null +++ b/doc/configtables/solar-thermal.csv @@ -0,0 +1,5 @@ +,Unit,Values,Description +clearsky_model ,--,"{‘simple’, ‘enhanced’}",Type of clearsky model for diffuse irradiation +orientation ,--,"{units of degrees, ‘latitude_optimal’}",Panel orientation with slope and azimuth +-- azimuth,float,units of degrees,The angle between the north and the sun with panels on the local horizon +-- slope,float,units of degrees,The angle between the ground and the panels diff --git a/doc/configuration.rst b/doc/configuration.rst index a5de44531..cd926b6a2 100644 --- a/doc/configuration.rst +++ b/doc/configuration.rst @@ -398,14 +398,15 @@ overwrite the existing values. .. note:: Only used for sector-coupling studies. -.. warning:: - More comprehensive documentation for this segment will be released soon. - .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: energy: :end-before: # docs +.. csv-table:: + :header-rows: 1 + :widths: 25,7,22,30 + :file: configtables/energy.csv .. _biomass_cf: @@ -415,14 +416,36 @@ overwrite the existing values. .. note:: Only used for sector-coupling studies. -.. warning:: - More comprehensive documentation for this segment will be released soon. - .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: biomass: :end-before: # docs +.. csv-table:: + :header-rows: 1 + :widths: 25,7,22,30 + :file: configtables/biomass.csv + +The list of available biomass is given by the category in `ENSPRESO_BIOMASS `_, namely: + +- Agricultural waste +- Manure solid, liquid +- Residues from landscape care +- Bioethanol barley, wheat, grain maize, oats, other cereals and rye +- Sugar from sugar beet +- Miscanthus, switchgrass, RCG +- Willow +- Poplar +- Sunflower, soya seed +- Rape seed +- Fuelwood residues +- FuelwoodRW +- C&P_RW +- Secondary Forestry residues - woodchips +- Sawdust +- Municipal waste +- Sludge + .. _solar_thermal_cf: ``solar_thermal`` @@ -431,30 +454,34 @@ overwrite the existing values. .. note:: Only used for sector-coupling studies. -.. warning:: - More comprehensive documentation for this segment will be released soon. - .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: solar_thermal: :end-before: # docs +.. csv-table:: + :header-rows: 1 + :widths: 25,7,22,30 + :file: configtables/solar-thermal.csv + .. _existing_capacities_cf: ``existing_capacities`` ======================= .. note:: - Only used for sector-coupling studies. - -.. warning:: - More comprehensive documentation for this segment will be released soon. + Only used for sector-coupling studies. The value for grouping years are only used in myopic scenarios. .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: existing_capacities: :end-before: # docs +.. csv-table:: + :header-rows: 1 + :widths: 25,7,22,30 + :file: configtables/existing_capacities.csv + .. _sector_cf: ``sector`` @@ -463,9 +490,6 @@ overwrite the existing values. .. note:: Only used for sector-coupling studies. -.. warning:: - More comprehensive documentation for this segment will be released soon. - .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: sector: From ac264282dab1fd2d5d930f8aa591564f91c1af18 Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Mon, 3 Jul 2023 01:38:02 +0000 Subject: [PATCH 06/18] [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --- doc/configtables/solar-thermal.csv | 4 ++-- doc/configuration.rst | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/configtables/solar-thermal.csv b/doc/configtables/solar-thermal.csv index 2daf99aea..7cc8dfc70 100644 --- a/doc/configtables/solar-thermal.csv +++ b/doc/configtables/solar-thermal.csv @@ -1,5 +1,5 @@ ,Unit,Values,Description -clearsky_model ,--,"{‘simple’, ‘enhanced’}",Type of clearsky model for diffuse irradiation -orientation ,--,"{units of degrees, ‘latitude_optimal’}",Panel orientation with slope and azimuth +clearsky_model ,--,"{‘simple’, ‘enhanced’}",Type of clearsky model for diffuse irradiation +orientation ,--,"{units of degrees, ‘latitude_optimal’}",Panel orientation with slope and azimuth -- azimuth,float,units of degrees,The angle between the north and the sun with panels on the local horizon -- slope,float,units of degrees,The angle between the ground and the panels diff --git a/doc/configuration.rst b/doc/configuration.rst index cd926b6a2..66af161ef 100644 --- a/doc/configuration.rst +++ b/doc/configuration.rst @@ -436,7 +436,7 @@ The list of available biomass is given by the category in `ENSPRESO_BIOMASS Date: Wed, 5 Jul 2023 01:51:50 +0200 Subject: [PATCH 07/18] finalized config documentation --- config/config.default.yaml | 236 +++++++++++++--------------- doc/configtables/.~lock.sector.csv# | 1 + doc/configtables/electricity.csv | 58 +++---- doc/configtables/industry.csv | 40 ++--- doc/configtables/sector.csv | 69 ++++---- doc/configuration.rst | 8 +- 6 files changed, 197 insertions(+), 215 deletions(-) create mode 100644 doc/configtables/.~lock.sector.csv# diff --git a/config/config.default.yaml b/config/config.default.yaml index 8a1948aa3..f3b69e4a8 100644 --- a/config/config.default.yaml +++ b/config/config.default.yaml @@ -2,7 +2,7 @@ # # SPDX-License-Identifier: CC0-1.0 -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#top-level-configuration version: 0.8.0 tutorial: false @@ -10,18 +10,18 @@ logging: level: INFO format: '%(levelname)s:%(name)s:%(message)s' -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#run run: name: "" disable_progressbar: false shared_resources: false shared_cutouts: true -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#foresight foresight: overnight -# docs in -# Wildcard docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#scenario +# Wildcard docs in https://pypsa-eur.readthedocs.io/en/latest/wildcards.html scenario: simpl: - '' @@ -43,16 +43,16 @@ scenario: # - 2040 - 2050 -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#countries countries: ['AL', 'AT', 'BA', 'BE', 'BG', 'CH', 'CZ', 'DE', 'DK', 'EE', 'ES', 'FI', 'FR', 'GB', 'GR', 'HR', 'HU', 'IE', 'IT', 'LT', 'LU', 'LV', 'ME', 'MK', 'NL', 'NO', 'PL', 'PT', 'RO', 'RS', 'SE', 'SI', 'SK'] -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#snapshots snapshots: start: "2013-01-01" end: "2014-01-01" inclusive: 'left' -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#enable enable: prepare_links_p_nom: false retrieve_databundle: true @@ -64,7 +64,7 @@ enable: retrieve_natura_raster: true custom_busmap: false -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#co2-budget co2_budget: 2020: 0.701 2025: 0.524 @@ -74,7 +74,7 @@ co2_budget: 2045: 0.032 2050: 0.000 -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#electricity electricity: voltages: [220., 300., 380.] gaslimit: false @@ -99,7 +99,6 @@ electricity: Link: [] # H2 pipeline powerplants_filter: (DateOut >= 2022 or DateOut != DateOut) - # use pandas query strings here, e.g. Country in ['Germany'] custom_powerplants: false conventional_carriers: [nuclear, oil, OCGT, CCGT, coal, lignite, geothermal, biomass] @@ -107,25 +106,19 @@ electricity: estimate_renewable_capacities: enable: true - # Add capacities from OPSD data from_opsd: true - # Renewable capacities are based on existing capacities reported by IRENA year: 2020 - # Artificially limit maximum capacities to factor * (IRENA capacities), - # i.e. 110% of 's capacities => expansion_limit: 1.1 - # false: Use estimated renewable potentials determine by the workflow expansion_limit: false technology_mapping: - # Wind is the Fueltype in powerplantmatching, onwind, offwind-{ac,dc} the carrier in PyPSA-Eur Offshore: [offwind-ac, offwind-dc] Onshore: [onwind] PV: [solar] -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#atlite atlite: default_cutout: europe-2013-era5 nprocesses: 4 - show_progress: false # false saves time + show_progress: false cutouts: # use 'base' to determine geographical bounds and time span from config # base: @@ -148,7 +141,7 @@ atlite: sarah_dir: features: [influx, temperature] -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#renewable renewable: onwind: cutout: europe-2013-era5 @@ -217,12 +210,12 @@ renewable: hydro_max_hours: "energy_capacity_totals_by_country" # one of energy_capacity_totals_by_country, estimate_by_large_installations or a float clip_min_inflow: 1.0 -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#conventional conventional: nuclear: p_max_pu: "data/nuclear_p_max_pu.csv" # float of file name -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#lines lines: types: 220.: "Al/St 240/40 2-bundle 220.0" @@ -233,20 +226,20 @@ lines: length_factor: 1.25 under_construction: 'zero' # 'zero': set capacity to zero, 'remove': remove, 'keep': with full capacity -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#links links: p_max_pu: 1.0 p_nom_max: .inf include_tyndp: true under_construction: 'zero' # 'zero': set capacity to zero, 'remove': remove, 'keep': with full capacity -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#transformers transformers: x: 0.1 s_nom: 2000. type: '' -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#load load: power_statistics: true interpolate_limit: 3 @@ -254,6 +247,7 @@ load: manual_adjustments: true # false scaling_factor: 1.0 +# docs # TODO: PyPSA-Eur merge issue in prepare_sector_network.py # regulate what components with which carriers are kept from PyPSA-Eur; # some technologies are removed because they are implemented differently @@ -275,14 +269,14 @@ pypsa_eur: - hydro Store: [] -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#energy energy: energy_totals_year: 2011 base_emissions_year: 1990 eurostat_report_year: 2016 - emissions: CO2 # "CO2" or "All greenhouse gases - (CO2 equivalent)" + emissions: CO2 -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#biomass biomass: year: 2030 scenario: ENS_Med @@ -308,15 +302,14 @@ biomass: - Manure solid, liquid - Sludge -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#solar-thermal solar_thermal: clearsky_model: simple # should be "simple" or "enhanced"? orientation: slope: 45. azimuth: 180. -# docs under construction in -# only relevant for foresight = myopic or perfect +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#existing-capacities existing_capacities: grouping_years_power: [1980, 1985, 1990, 1995, 2000, 2005, 2010, 2015, 2020, 2025, 2030] grouping_years_heat: [1980, 1985, 1990, 1995, 2000, 2005, 2010, 2015, 2019] # these should not extend 2020 @@ -327,37 +320,34 @@ existing_capacities: - oil - uranium -# docs under construction in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#sector sector: district_heating: - potential: 0.6 # maximum fraction of urban demand which can be supplied by district heating - # increase of today's district heating demand to potential maximum district heating share - # progress = 0 means today's district heating share, progress = 1 means maximum fraction of urban demand is supplied by district heating + potential: 0.6 progress: 2020: 0.0 2030: 0.3 2040: 0.6 2050: 1.0 district_heating_loss: 0.15 - cluster_heat_buses: false # cluster residential and service heat buses to one to save memory - bev_dsm_restriction_value: 0.75 #Set to 0 for no restriction on BEV DSM - bev_dsm_restriction_time: 7 #Time at which SOC of BEV has to be dsm_restriction_value + cluster_heat_buses: false + bev_dsm_restriction_value: 0.75 + bev_dsm_restriction_time: 7 transport_heating_deadband_upper: 20. transport_heating_deadband_lower: 15. - ICE_lower_degree_factor: 0.375 #in per cent increase in fuel consumption per degree above deadband + ICE_lower_degree_factor: 0.375 ICE_upper_degree_factor: 1.6 EV_lower_degree_factor: 0.98 EV_upper_degree_factor: 0.63 - bev_dsm: true #turns on EV battery - bev_availability: 0.5 #How many cars do smart charging - bev_energy: 0.05 #average battery size in MWh - bev_charge_efficiency: 0.9 #BEV (dis-)charging efficiency - bev_plug_to_wheel_efficiency: 0.2 #kWh/km from EPA https://www.fueleconomy.gov/feg/ for Tesla Model S - bev_charge_rate: 0.011 #3-phase charger with 11 kW + bev_dsm: true + bev_availability: 0.5 + bev_energy: 0.05 + bev_charge_efficiency: 0.9 + bev_plug_to_wheel_efficiency: 0.2 + bev_charge_rate: 0.011 bev_avail_max: 0.95 bev_avail_mean: 0.8 - v2g: true #allows feed-in to grid from EV battery - #what is not EV or FCEV is oil-fuelled ICE + v2g: true land_transport_fuel_cell_share: 2020: 0 2030: 0.05 @@ -377,12 +367,12 @@ sector: transport_internal_combustion_efficiency: 0.3 agriculture_machinery_electric_share: 0 agriculture_machinery_oil_share: 1 - agriculture_machinery_fuel_efficiency: 0.7 # fuel oil per use - agriculture_machinery_electric_efficiency: 0.3 # electricity per use - MWh_MeOH_per_MWh_H2: 0.8787 # in LHV, source: DECHEMA (2017): Low carbon energy and feedstock for the European chemical industry , pg. 64. - MWh_MeOH_per_tCO2: 4.0321 # in LHV, source: DECHEMA (2017): Low carbon energy and feedstock for the European chemical industry , pg. 64. - MWh_MeOH_per_MWh_e: 3.6907 # in LHV, source: DECHEMA (2017): Low carbon energy and feedstock for the European chemical industry , pg. 64. - shipping_hydrogen_liquefaction: false # whether to consider liquefaction costs for shipping H2 demands + agriculture_machinery_fuel_efficiency: 0.7 + agriculture_machinery_electric_efficiency: 0.3 + MWh_MeOH_per_MWh_H2: 0.8787 + MWh_MeOH_per_tCO2: 4.0321 + MWh_MeOH_per_MWh_e: 3.6907 + shipping_hydrogen_liquefaction: false shipping_hydrogen_share: 2020: 0 2030: 0 @@ -398,18 +388,14 @@ sector: 2030: 0.7 2040: 0.3 2050: 0 - shipping_methanol_efficiency: 0.46 # 10-15% higher https://www.iea-amf.org/app/webroot/files/file/Annex%20Reports/AMF_Annex_56.pdf, https://users.ugent.be/~lsileghe/documents/extended_abstract.pdf - shipping_oil_efficiency: 0.40 #For conversion of fuel oil to propulsion in 2011 - aviation_demand_factor: 1. # relative aviation demand compared to today - HVC_demand_factor: 1. # relative HVC demand compared to today - time_dep_hp_cop: true #time dependent heat pump coefficient of performance - heat_pump_sink_T: 55. # Celsius, based on DTU / large area radiators; used in build_cop_profiles.py - # conservatively high to cover hot water and space heating in poorly-insulated buildings - reduce_space_heat_exogenously: true # reduces space heat demand by a given factor (applied before losses in DH) - # this can represent e.g. building renovation, building demolition, or if - # the factor is negative: increasing floor area, increased thermal comfort, population growth - reduce_space_heat_exogenously_factor: # per unit reduction in space heat demand - # the default factors are determined by the LTS scenario from http://tool.european-calculator.eu/app/buildings/building-types-area/?levers=1ddd4444421213bdbbbddd44444ffffff11f411111221111211l212221 + shipping_methanol_efficiency: 0.46 + shipping_oil_efficiency: 0.40 + aviation_demand_factor: 1. + HVC_demand_factor: 1. + time_dep_hp_cop: true + heat_pump_sink_T: 55. + reduce_space_heat_exogenously: true + reduce_space_heat_exogenously_factor: 2020: 0.10 # this results in a space heat demand reduction of 10% 2025: 0.09 # first heat demand increases compared to 2020 because of larger floor area per capita 2030: 0.09 @@ -417,15 +403,15 @@ sector: 2040: 0.16 2045: 0.21 2050: 0.29 - retrofitting: # co-optimises building renovation to reduce space heat demand - retro_endogen: false # co-optimise space heat savings - cost_factor: 1.0 # weight costs for building renovation - interest_rate: 0.04 # for investment in building components - annualise_cost: true # annualise the investment costs - tax_weighting: false # weight costs depending on taxes in countries - construction_index: true # weight costs depending on labour/material costs per country + retrofitting: + retro_endogen: false + cost_factor: 1.0 + interest_rate: 0.04 + annualise_cost: true + tax_weighting: false + construction_index: true tes: true - tes_tau: # 180 day time constant for centralised, 3 day for decentralised + tes_tau: decentral: 3 central: 180 boilers: true @@ -446,51 +432,48 @@ sector: hydrogen_turbine: false SMR: true regional_co2_sequestration_potential: - enable: false # enable regionally resolved geological co2 storage potential + enable: false attribute: 'conservative estimate Mt' - include_onshore: false # include onshore sequestration potentials - min_size: 3 # Gt, sites with lower potential will be excluded - max_size: 25 # Gt, max sequestration potential for any one site, TODO research suitable value - years_of_storage: 25 # years until potential exhausted at optimised annual rate - co2_sequestration_potential: 200 #MtCO2/a sequestration potential for Europe - co2_sequestration_cost: 10 #EUR/tCO2 for sequestration of CO2 + include_onshore: false + min_size: 3 + max_size: 25 + years_of_storage: 25 + co2_sequestration_potential: 200 + co2_sequestration_cost: 10 co2_spatial: false co2network: false - cc_fraction: 0.9 # default fraction of CO2 captured with post-combustion capture + cc_fraction: 0.9 hydrogen_underground_storage: true hydrogen_underground_storage_locations: # - onshore # more than 50 km from sea - nearshore # within 50 km of sea # - offshore - ammonia: false # can be false (no NH3 carrier), true (copperplated NH3), "regional" (regionalised NH3 without network) - min_part_load_fischer_tropsch: 0.9 # p_min_pu - min_part_load_methanolisation: 0.5 # p_min_pu + ammonia: false + min_part_load_fischer_tropsch: 0.9 + min_part_load_methanolisation: 0.5 use_fischer_tropsch_waste_heat: true use_fuel_cell_waste_heat: true use_electrolysis_waste_heat: false electricity_distribution_grid: true - electricity_distribution_grid_cost_factor: 1.0 #multiplies cost in data/costs.csv - electricity_grid_connection: true # only applies to onshore wind and utility PV + electricity_distribution_grid_cost_factor: 1.0 + electricity_grid_connection: true H2_network: true gas_network: false - H2_retrofit: false # if set to True existing gas pipes can be retrofitted to H2 pipes - # according to hydrogen backbone strategy (April, 2020) p.15 - # https://gasforclimate2050.eu/wp-content/uploads/2020/07/2020_European-Hydrogen-Backbone_Report.pdf - # 60% of original natural gas capacity could be used in cost-optimal case as H2 capacity - H2_retrofit_capacity_per_CH4: 0.6 # ratio for H2 capacity per original CH4 capacity of retrofitted pipelines - gas_network_connectivity_upgrade: 1 # https://networkx.org/documentation/stable/reference/algorithms/generated/networkx.algorithms.connectivity.edge_augmentation.k_edge_augmentation.html#networkx.algorithms.connectivity.edge_augmentation.k_edge_augmentation + H2_retrofit: false + H2_retrofit_capacity_per_CH4: 0.6 + gas_network_connectivity_upgrade: 1 gas_distribution_grid: true - gas_distribution_grid_cost_factor: 1.0 #multiplies cost in data/costs.csv - biomass_spatial: false # regionally resolve biomass (e.g. potentials) - biomass_transport: false # allow transport of solid biomass between nodes - conventional_generation: # generator : carrier + gas_distribution_grid_cost_factor: 1.0 + biomass_spatial: false + biomass_transport: false + conventional_generation: OCGT: gas biomass_to_liquid: false biosng: false -# docs under construction in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#industry industry: - St_primary_fraction: # fraction of steel produced via primary route versus secondary route (scrap+EAF); today fraction is 0.6 + St_primary_fraction: 2020: 0.6 2025: 0.55 2030: 0.5 @@ -498,7 +481,7 @@ industry: 2040: 0.4 2045: 0.35 2050: 0.3 - DRI_fraction: # fraction of the primary route converted to DRI + EAF + DRI_fraction: 2020: 0 2025: 0 2030: 0.05 @@ -506,9 +489,9 @@ industry: 2040: 0.4 2045: 0.7 2050: 1 - H2_DRI: 1.7 #H2 consumption in Direct Reduced Iron (DRI), MWh_H2,LHV/ton_Steel from 51kgH2/tSt in Vogl et al (2018) doi:10.1016/j.jclepro.2018.08.279 - elec_DRI: 0.322 #electricity consumption in Direct Reduced Iron (DRI) shaft, MWh/tSt HYBRIT brochure https://ssabwebsitecdn.azureedge.net/-/media/hybrit/files/hybrit_brochure.pdf - Al_primary_fraction: # fraction of aluminium produced via the primary route versus scrap; today fraction is 0.4 + H2_DRI: 1.7 + elec_DRI: 0.322 + Al_primary_fraction: 2020: 0.4 2025: 0.375 2030: 0.35 @@ -516,33 +499,30 @@ industry: 2040: 0.3 2045: 0.25 2050: 0.2 - MWh_NH3_per_tNH3: 5.166 # LHV - MWh_CH4_per_tNH3_SMR: 10.8 # 2012's demand from https://ec.europa.eu/docsroom/documents/4165/attachments/1/translations/en/renditions/pdf - MWh_elec_per_tNH3_SMR: 0.7 # same source, assuming 94-6% split methane-elec of total energy demand 11.5 MWh/tNH3 - MWh_H2_per_tNH3_electrolysis: 6.5 # from https://doi.org/10.1016/j.joule.2018.04.017, around 0.197 tH2/tHN3 (>3/17 since some H2 lost and used for energy) - MWh_elec_per_tNH3_electrolysis: 1.17 # from https://doi.org/10.1016/j.joule.2018.04.017 Table 13 (air separation and HB) + MWh_NH3_per_tNH3: 5.166 + MWh_CH4_per_tNH3_SMR: 10.8 + MWh_elec_per_tNH3_SMR: 0.7 + MWh_H2_per_tNH3_electrolysis: 6.5 + MWh_elec_per_tNH3_electrolysis: 1.17 MWh_NH3_per_MWh_H2_cracker: 1.46 # https://github.com/euronion/trace/blob/44a5ff8401762edbef80eff9cfe5a47c8d3c8be4/data/efficiencies.csv - NH3_process_emissions: 24.5 # in MtCO2/a from SMR for H2 production for NH3 from UNFCCC for 2015 for EU28 - petrochemical_process_emissions: 25.5 # in MtCO2/a for petrochemical and other from UNFCCC for 2015 for EU28 - HVC_primary_fraction: 1. # fraction of today's HVC produced via primary route - HVC_mechanical_recycling_fraction: 0. # fraction of today's HVC produced via mechanical recycling - HVC_chemical_recycling_fraction: 0. # fraction of today's HVC produced via chemical recycling - HVC_production_today: 52. # MtHVC/a from DECHEMA (2017), Figure 16, page 107; includes ethylene, propylene and BTX - MWh_elec_per_tHVC_mechanical_recycling: 0.547 # from SI of https://doi.org/10.1016/j.resconrec.2020.105010, Table S5, for HDPE, PP, PS, PET. LDPE would be 0.756. - MWh_elec_per_tHVC_chemical_recycling: 6.9 # Material Economics (2019), page 125; based on pyrolysis and electric steam cracking - chlorine_production_today: 9.58 # MtCl/a from DECHEMA (2017), Table 7, page 43 - MWh_elec_per_tCl: 3.6 # DECHEMA (2017), Table 6, page 43 - MWh_H2_per_tCl: -0.9372 # DECHEMA (2017), page 43; negative since hydrogen produced in chloralkali process - methanol_production_today: 1.5 # MtMeOH/a from DECHEMA (2017), page 62 - MWh_elec_per_tMeOH: 0.167 # DECHEMA (2017), Table 14, page 65 - MWh_CH4_per_tMeOH: 10.25 # DECHEMA (2017), Table 14, page 65 + NH3_process_emissions: 24.5 + petrochemical_process_emissions: 25.5 + HVC_primary_fraction: 1. + HVC_mechanical_recycling_fraction: 0. + HVC_chemical_recycling_fraction: 0. + HVC_production_today: 52. + MWh_elec_per_tHVC_mechanical_recycling: 0.547 + MWh_elec_per_tHVC_chemical_recycling: 6.9 + chlorine_production_today: 9.58 + MWh_elec_per_tCl: 3.6 + MWh_H2_per_tCl: -0.9372 + methanol_production_today: 1.5 + MWh_elec_per_tMeOH: 0.167 + MWh_CH4_per_tMeOH: 10.25 hotmaps_locate_missing: false reference_year: 2015 - # references: - # DECHEMA (2017): https://dechema.de/dechema_media/Downloads/Positionspapiere/Technology_study_Low_carbon_energy_and_feedstock_for_the_European_chemical_industry-p-20002750.pdf - # Material Economics (2019): https://materialeconomics.com/latest-updates/industrial-transformation-2050 -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#costs costs: year: 2030 version: v0.5.0 @@ -572,7 +552,7 @@ costs: emission_prices: co2: 0. -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#clustering clustering: simplify_network: to_substations: false @@ -596,7 +576,7 @@ clustering: ramp_limit_down: max efficiency: mean -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#solving solving: #tmpdir: "path/to/tmp" options: @@ -670,7 +650,7 @@ solving: mem: 30000 #memory in MB; 20 GB enough for 50+B+I+H2; 100 GB for 181+B+I+H2 -# docs in +# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#plotting plotting: map: boundaries: [-11, 30, 34, 71] diff --git a/doc/configtables/.~lock.sector.csv# b/doc/configtables/.~lock.sector.csv# new file mode 100644 index 000000000..b614fb4e0 --- /dev/null +++ b/doc/configtables/.~lock.sector.csv# @@ -0,0 +1 @@ +,DESKTOP-2RNCH2B/kunde,,05.07.2023 01:09,file:///C:/Users/kunde/AppData/Roaming/LibreOffice/4; \ No newline at end of file diff --git a/doc/configtables/electricity.csv b/doc/configtables/electricity.csv index 9cf23ebf7..02dcbdde3 100644 --- a/doc/configtables/electricity.csv +++ b/doc/configtables/electricity.csv @@ -1,29 +1,29 @@ -,Unit,Values,Description -voltages,kV,"Any subset of {220., 300., 380.}",Voltage levels to consider -gaslimit,MWhth,"float or false",Global gas usage limit -co2limit,:math:`t_{CO_2-eq}/a`,float,Cap on total annual system carbon dioxide emissions -co2base,:math:`t_{CO_2-eq}/a`,float,Reference value of total annual system carbon dioxide emissions if relative emission reduction target is specified in ``{opts}`` wildcard. -agg_p_nom_limits,file,path,Reference to ``.csv`` file specifying per carrier generator nominal capacity constraints for individual countries if ``'CCL'`` is in ``{opts}`` wildcard. Defaults to ``data/agg_p_nom_minmax.csv``. -operational_reserve,,,"Settings for reserve requirements following like `GenX `_" --- activate,bool,"true or false","Whether to take operational reserve requirements into account during optimisation" --- epsilon_load,--,float,share of total load --- epsilon_vres,--,float,share of total renewable supply --- contingency,MW,float,fixed reserve capacity -max_hours,,, --- battery,h,float,Maximum state of charge capacity of the battery in terms of hours at full output capacity ``p_nom``. Cf. `PyPSA documentation `_. --- H2,h,float,Maximum state of charge capacity of the hydrogen storage in terms of hours at full output capacity ``p_nom``. Cf. `PyPSA documentation `_. -extendable_carriers,,, --- Generator,--,"Any extendable carrier","Defines existing or non-existing conventional and renewable power plants to be extendable during the optimization. Conventional generators can only be built/expanded where already existent today. If a listed conventional carrier is not included in the ``conventional_carriers`` list, the lower limit of the capacity expansion is set to 0." --- StorageUnit,--,"Any subset of {'battery','H2'}",Adds extendable storage units (battery and/or hydrogen) at every node/bus after clustering without capacity limits and with zero initial capacity. --- Store,--,"Any subset of {'battery','H2'}",Adds extendable storage units (battery and/or hydrogen) at every node/bus after clustering without capacity limits and with zero initial capacity. --- Link,--,Any subset of {'H2 pipeline'},Adds extendable links (H2 pipelines only) at every connection where there are lines or HVDC links without capacity limits and with zero initial capacity. Hydrogen pipelines require hydrogen storage to be modelled as ``Store``. -powerplants_filter,--,"use `pandas.query `_ strings here, e.g. Country not in ['Germany']",Filter query for the default powerplant database. -custom_powerplants,--,"use `pandas.query `_ strings here, e.g. Country in ['Germany']",Filter query for the custom powerplant database. -conventional_carriers,--,"Any subset of {nuclear, oil, OCGT, CCGT, coal, lignite, geothermal, biomass}","List of conventional power plants to include in the model from ``resources/powerplants.csv``. If an included carrier is also listed in `extendable_carriers`, the capacity is taken as a lower bound." -renewable_carriers,--,"Any subset of {solar, onwind, offwind-ac, offwind-dc, hydro}",List of renewable generators to include in the model. -estimate_renewable_capacities,,, --- enable,,bool,"Activate routine to estimate renewable capacities" --- from_opsd,--,bool,"Add capacities from OPSD data" --- year,--,bool,"Renewable capacities are based on existing capacities reported by IRENA for the specified year" --- expansion_limit,--,float or false,"Artificially limit maximum capacities to factor * (IRENA capacities), i.e. 110% of 's capacities => expansion_limit: 1.1 false: Use estimated renewable potentials determine by the workflow" --- technology_mapping,,,"Mapping between powerplantmatching and PyPSA-Eur technology names" +,Unit,Values,Description +voltages,kV,"Any subset of {220., 300., 380.}",Voltage levels to consider +gaslimit,MWhth,float or false,Global gas usage limit +co2limit,:math:`t_{CO_2-eq}/a`,float,Cap on total annual system carbon dioxide emissions +co2base,:math:`t_{CO_2-eq}/a`,float,Reference value of total annual system carbon dioxide emissions if relative emission reduction target is specified in ``{opts}`` wildcard. +agg_p_nom_limits,file,path,Reference to ``.csv`` file specifying per carrier generator nominal capacity constraints for individual countries if ``'CCL'`` is in ``{opts}`` wildcard. Defaults to ``data/agg_p_nom_minmax.csv``. +operational_reserve,,,Settings for reserve requirements following like `GenX `_ +-- activate,bool,true or false,Whether to take operational reserve requirements into account during optimisation +-- epsilon_load,--,float,share of total load +-- epsilon_vres,--,float,share of total renewable supply +-- contingency,MW,float,fixed reserve capacity +max_hours,,, +-- battery,h,float,Maximum state of charge capacity of the battery in terms of hours at full output capacity ``p_nom``. Cf. `PyPSA documentation `_. +-- H2,h,float,Maximum state of charge capacity of the hydrogen storage in terms of hours at full output capacity ``p_nom``. Cf. `PyPSA documentation `_. +extendable_carriers,,, +-- Generator,--,Any extendable carrier,"Defines existing or non-existing conventional and renewable power plants to be extendable during the optimization. Conventional generators can only be built/expanded where already existent today. If a listed conventional carrier is not included in the ``conventional_carriers`` list, the lower limit of the capacity expansion is set to 0." +-- StorageUnit,--,"Any subset of {'battery','H2'}",Adds extendable storage units (battery and/or hydrogen) at every node/bus after clustering without capacity limits and with zero initial capacity. +-- Store,--,"Any subset of {'battery','H2'}",Adds extendable storage units (battery and/or hydrogen) at every node/bus after clustering without capacity limits and with zero initial capacity. +-- Link,--,Any subset of {'H2 pipeline'},Adds extendable links (H2 pipelines only) at every connection where there are lines or HVDC links without capacity limits and with zero initial capacity. Hydrogen pipelines require hydrogen storage to be modelled as ``Store``. +powerplants_filter,--,"use `pandas.query `_ strings here, e.g. Country not in ['Germany']",Filter query for the default powerplant database. +custom_powerplants,--,"use `pandas.query `_ strings here, e.g. Country in ['Germany']",Filter query for the custom powerplant database. +conventional_carriers,--,"Any subset of {nuclear, oil, OCGT, CCGT, coal, lignite, geothermal, biomass}","List of conventional power plants to include in the model from ``resources/powerplants.csv``. If an included carrier is also listed in `extendable_carriers`, the capacity is taken as a lower bound." +renewable_carriers,--,"Any subset of {solar, onwind, offwind-ac, offwind-dc, hydro}",List of renewable generators to include in the model. +estimate_renewable_capacities,,, +-- enable,,bool,Activate routine to estimate renewable capacities +-- from_opsd,--,bool,Add capacities from OPSD data +-- year,--,bool,Renewable capacities are based on existing capacities reported by IRENA for the specified year +-- expansion_limit,--,float or false,"Artificially limit maximum IRENA capacities to a factor. For example, an ``expansion_limit: 1.1`` means 110% of capacities . If false are chosen, the estimated renewable potentials determine by the workflow are used." +-- technology_mapping,,,Mapping between powerplantmatching and PyPSA-Eur technology names diff --git a/doc/configtables/industry.csv b/doc/configtables/industry.csv index 6d5034982..248ed4b54 100644 --- a/doc/configtables/industry.csv +++ b/doc/configtables/industry.csv @@ -1,28 +1,28 @@ ,Unit,Values,Description St_primary_fraction,--,Dictionary with planning horizons as keys.,The fraction of steel produced via primary route versus secondary route (scrap+EAF). Current fraction is 0.6 DRI_fraction,--,Dictionary with planning horizons as keys.,The fraction of the primary route converted to DRI + EAF -H2_DRI,--,float,The hydrogen consumption in Direct Reduced Iron (DRI) Mwh_H2 LHV/ton_Steel from 51kgH2/tSt in Vogl et al (2018) doi:10.1016/j.jclepro.2018.08.279 -elec_DRI,--,float,The electricity consumed in Direct Reduced Iron (DRI) shaft. MWh/tSt HYBRIT brochure https://ssabwebsitecdn.azureedge.net/-/media/hybrit/files/hybrit_brochure.pdf -Al_primary_fraction,--,Dictionary with planning horizons as keys.,The fraction of aluminium produced via the primary route versus scrap. Current fraction is 0.4 +H2_DRI,--,float,The hydrogen consumption in Direct Reduced Iron (DRI) Mwh_H2 LHV/ton_Steel from 51kgH2/tSt in `Vogl et al (2018) `_ +elec_DRI,MWh/tSt,float,The electricity consumed in Direct Reduced Iron (DRI) shaft. From `HYBRIT brochure `_ +Al_primary_fraction,--,Dictionary with planning horizons as keys.,The fraction of aluminium produced via the primary route versus scrap. Current fraction is 0.4 MWh_NH3_per_tNH3,LHV,float,The energy amount per ton of ammonia. -MWh_CH4_per_tNH3_SMR,--,float,The energy amount of methane needed to produce a ton of ammonia using steam methane reforming (SMR). Value derived from 2012's demand from https://ec.europa.eu/docsroom/documents/4165/attachments/1/translations/en/renditions/pdf +MWh_CH4_per_tNH3_SMR,--,float,The energy amount of methane needed to produce a ton of ammonia using steam methane reforming (SMR). Value derived from 2012's demand from `Center for European Policy Studies (2008) `_ MWh_elec_per_tNH3_SMR,--,float,"The energy amount of electricity needed to produce a ton of ammonia using steam methane reforming (SMR). same source, assuming 94-6% split methane-elec of total energy demand 11.5 MWh/tNH3" -MWh_H2_per_tNH3_electrolysis,--,float,"The energy amount of hydrogen needed to produce a ton of ammonia using Haber–Bosch process. From https://doi.org/10.1016/j.joule.2018.04.017, around 0.197 tH2/tHN3 (>3/17 since some H2 lost and used for energy)" -MWh_elec_per_tNH3_electrolysis,--,float,The energy amount of electricity needed to produce a ton of ammonia using Haber–Bosch process. From https://doi.org/10.1016/j.joule.2018.04.017 Table 13 (air separation and HB) -MWh_NH3_per_MWh_H2_cracker,--,float,The energy amount of amonia needed to produce an energy amount hydrogen using ammonia cracker. https://github.com/euronion/trace/blob/44a5ff8401762edbef80eff9cfe5a47c8d3c8be4/data/efficiencies.csv -NH3_process_emissions,MtCO2/a,float,The emission of ammonia production from steam methane reforming (SMR) -petrochemical_process_emissions,MtCO2/a,float,The emission of petrochemical production +MWh_H2_per_tNH3_electrolysis,--,float,"The energy amount of hydrogen needed to produce a ton of ammonia using Haber–Bosch process. From `Wang et al (2018) `_, Base value assumed around 0.197 tH2/tHN3 (>3/17 since some H2 lost and used for energy)" +MWh_elec_per_tNH3_electrolysis,--,float,"The energy amount of electricity needed to produce a ton of ammonia using Haber–Bosch process. From `Wang et al (2018) `_, Table 13 (air separation and HB)" +MWh_NH3_per_MWh_H2_cracker,--,float,The energy amount of amonia needed to produce an energy amount hydrogen using ammonia cracker +NH3_process_emissions,MtCO2/a,float,The emission of ammonia production from steam methane reforming (SMR). From UNFCCC for 2015 for EU28 +petrochemical_process_emissions,MtCO2/a,float,The emission of petrochemical production. From UNFCCC for 2015 for EU28 HVC_primary_fraction,--,float,The fraction of today's high value chemicals (HVC) produced via primary route HVC_mechanical_recycling_fraction,--,float,The fraction of today's high value chemicals (HVC) produced using mechanical recycling HVC_chemical_recycling_fraction,--,float,The fraction of today's high value chemicals (HVC) produced using chemical recycling -HVC_production_today,MtHVC/a,float,The amount of high value chemicals (HVC) produced -MWh_elec_per_tHVC_mechanical_recycling,--,float,The energy amount of electricity needed to produce a ton of high value chemical (HVC) using mechanical recycling -MWh_elec_per_tHVC_chemical_recycling,--,float,The energy amount of electricity needed to produce a ton of high value chemical (HVC) using chemical recycling -chlorine_production_today,MtCl/a,float,The amount of chlorine produced -MWh_elec_per_tCl,--,float,The energy amount of electricity needed to produce a ton of chlorine -MWh_H2_per_tCl,--,float,The energy amount of hydrogen needed to produce a ton of chlorine -methanol_production_today,MtMeOH/a,float,The amount of methanol produced -MWh_elec_per_tMeOH,--,float,The energy amount of electricity needed to produce a ton of methanol -MWh_CH4_per_tMeOH,--,float,The energy amount of methane needed to produce a ton of methanol -hotmaps_locate_missing,--,true or false,Locate industrial sites without valid locations based on city and countries. -reference_year,--,year, +HVC_production_today,MtHVC/a,float,"The amount of high value chemicals (HVC) produced. This includes ethylene, propylene and BTX. From `DECHEMA (2017) `_, Figure 16, page 107" +MWh_elec_per_tHVC_mechanical_recycling,MWh/tHVC,float,"The energy amount of electricity needed to produce a ton of high value chemical (HVC) using mechanical recycling. From SI of `Meys et al (2020) `_, Table S5, for HDPE, PP, PS, PET. LDPE would be 0.756." +MWh_elec_per_tHVC_chemical_recycling,MWh/tHVC,float,"The energy amount of electricity needed to produce a ton of high value chemical (HVC) using chemical recycling. Value are based on pyrolysis and electric steam cracking. From `Material Economics (2019) `_, page 125" +chlorine_production_today,MtCl/a,float,"The amount of chlorine produced. From `DECHEMA (2017) `_, Table 7, page 43" +MWh_elec_per_tCl,MWh/tCl,float,"The energy amount of electricity needed to produce a ton of chlorine. From `DECHEMA (2017) `_, Table 6 page 43" +MWh_H2_per_tCl,MWhH2/tCl,float,"The energy amount of hydrogen needed to produce a ton of chlorine. The value is negative since hydrogen produced in chloralkali process. From `DECHEMA (2017) `_, page 43" +methanol_production_today,MtMeOH/a,float,"The amount of methanol produced. From `DECHEMA (2017) `_, page 62" +MWh_elec_per_tMeOH,MWh/tMeOH,float,"The energy amount of electricity needed to produce a ton of methanol. From `DECHEMA (2017) `_, Table 14, page 65" +MWh_CH4_per_tMeOH,MWhCH4/tMeOH,float,"The energy amount of methane needed to produce a ton of methanol. From `DECHEMA (2017) `_, Table 14, page 65" +hotmaps_locate_missing,--,"{true,false}",Locate industrial sites without valid locations based on city and countries. +reference_year,year,YYYY,The year used as the baseline for industrial energy demand and production. Data extracted from `JRC-IDEES 2015 `_ diff --git a/doc/configtables/sector.csv b/doc/configtables/sector.csv index 7a6f3c140..cb6c8115b 100644 --- a/doc/configtables/sector.csv +++ b/doc/configtables/sector.csv @@ -2,9 +2,9 @@ district_heating,--,,`prepare_sector_network.py `_ -- potential,--,float,maximum fraction of urban demand which can be supplied by district heating increase of today's district heating demand to potential maximum district heating share -- progress,--,Dictionary with planning horizons as keys.,Progress = 0 means today's district heating share. Progress = 1 means maximum fraction of urban demand is supplied by district heating --- district_heating_loss,--,float, +-- district_heating_loss,--,float,Percentage increase in district heat demand in urban central due to heat losses cluster_heat_buses,--,"{true, false}",cluster residential and service heat buses in `prepare_sector_network.py `_ to one to save memory. -bev_dsm_restriction_value,--,float,Adding a stage of charge (SOC) limit for battery electric vehicles (BEV) to manage its own energy demand (DSM). Located in `build_transport_demand.py `_. +bev_dsm_restriction_value,--,float,Adding a stage of charge (SOC) limit for battery electric vehicles (BEV) to manage its own energy demand (DSM). Located in `build_transport_demand.py `_. Set to 0 for no restriction on BEV DSM bev_dsm_restriction_time,--,float,Time at which SOC of BEV has to be dsm_restriction_value transport_heating_deadband_upper,°C,float,"The minimum temperature in the vehicle. At lower temperatures, the energy required for heating in the vehicle increases." transport_heating_deadband_lower,°C,float,"The maximum temperature in the vehicle. At higher temperatures, the energy required for cooling in the vehicle increases." @@ -16,54 +16,54 @@ bev_dsm,--,"{true, false}",Add the option for battery electric vehicles (BEV) to bev_availability,--,float,The percentage for battery electric vehicles (BEV) that are able to do demand side management (DSM) bev_energy,--,float,The average size of battery electric vehicles (BEV) in MWh bev_charge_efficiency,--,float,Battery electric vehicles (BEV) charge and discharge efficiency -bev_plug_to_wheel_efficiency,km/kWh,float,The distance battery electric vehicles (BEV) can travel in km per kWh of energy charge in battery. Base value comes from Tesla Model S https://www.fueleconomy.gov/feg/ +bev_plug_to_wheel_efficiency,km/kWh,float,The distance battery electric vehicles (BEV) can travel in km per kWh of energy charge in battery. Base value comes from `Tesla Model S `_ bev_charge_rate,MWh,float,The power consumption for one electric vehicle (EV) in MWh. Value derived from 3-phase charger with 11 kW. bev_avail_max,--,float,The maximum percentage plugged-in availability for passenger electric vehicles. bev_avail_mean,--,float,The average percentage plugged-in availability for passenger electric vehicles. v2g,--,"{true, false}",Allows feed-in to grid from EV battery land_transport_fuel_cell_share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses fuel cells in a given year land_transport_electric_share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses electric vehicles (EV) in a given year -land_transport_ice_share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses internal combustion engines (ICE) in a given year +land_transport_ice_share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses internal combustion engines (ICE) in a given year. What is not EV or FCEV is oil-fuelled ICE. transport_fuel_cell_efficiency,--,float,The H2 conversion efficiencies of fuel cells in transport transport_internal_combustion_efficiency,--,float,The oil conversion efficiencies of internal combustion engine (ICE) in transport agriculture_machinery_electric_share,--,float,The percentage for agricultural machinery that uses electricity agriculture_machinery_oil_share,--,float,The percentage for agricultural machinery that uses oil agriculture_machinery_fuel_efficiency,--,float,The efficiency of electric-powered machinery in the conversion of electricity to meet agricultural needs. agriculture_machinery_electric_efficiency,--,float,The efficiency of oil-powered machinery in the conversion of oil to meet agricultural needs. -MWh_MeOH_per_MWh_H2,LHV,float,The energy amount of the produced methanol per energy amount of hydrogen. source: DECHEMA (2017): Low carbon energy and feedstock for the European chemical industry page 64. -MWh_MeOH_per_tCO2,LHV,float,The energy amount of the produced methanol per ton of CO2 -MWh_MeOH_per_MWh_e,LHV,float,The energy amount of the produced methanol per energy amount of electricity +MWh_MeOH_per_MWh_H2,LHV,float,"The energy amount of the produced methanol per energy amount of hydrogen. From `DECHEMA (2017) `_, page 64." +MWh_MeOH_per_tCO2,LHV,float,"The energy amount of the produced methanol per ton of CO2. From `DECHEMA (2017) `_, page 64." +MWh_MeOH_per_MWh_e,LHV,float,"The energy amount of the produced methanol per energy amount of electricity. From `DECHEMA (2017) `_, page 64." shipping_hydrogen_liquefaction,--,"{true, false}",Consider whether to include liquefaction costs for shipping H2 demand. shipping_hydrogen_share,--,Dictionary with planning horizons as keys.,The share of ships powered by hydrogen in a given year shipping_methanol_share,--,Dictionary with planning horizons as keys.,The share of ships powered by methanol in a given year shipping_oil_share,--,Dictionary with planning horizons as keys.,The share of ships powered by oil in a given year -shipping_methanol_efficiency,--,float,The efficiency of methanol-powered ships in the conversion of methanol to meet shipping needs. -shipping_oil_efficiency,--,float,The efficiency of oil-powered ships in the conversion of oil to meet shipping needs. +shipping_methanol_efficiency,--,float,"The efficiency of methanol-powered ships in the conversion of methanol to meet shipping needs (propulsion). The efficiency increase from oil can be 10-15% higher according to the `IEA `_," +shipping_oil_efficiency,--,float,The efficiency of oil-powered ships in the conversion of oil to meet shipping needs (propulsion). Base value derived from 2011 aviation_demand_factor,--,float,The proportion of demand for aviation compared to today's HVC_demand_factor,--,float,The proportion of demand for high-value chemicals compared to today's -time_dep_hp_cop,--,"{true, false}", -heat_pump_sink_T,°C,float, -reduce_space_heat_exogenously,--,"{true, false}", -reduce_space_heat_exogenously_factor,--,Dictionary with planning horizons as keys., +time_dep_hp_cop,--,"{true, false}",Consider the time dependent coefficient of performance (COP) of the heat pump +heat_pump_sink_T,°C,float,The temperature heat sink used in heat pumps based on DTU / large area radiators. The value is conservatively high to cover hot water and space heating in poorly-insulated buildings +reduce_space_heat_exogenously,--,"{true, false}",Influence on space heating demand by a certain factor (applied before losses in district heating). +reduce_space_heat_exogenously_factor,--,Dictionary with planning horizons as keys.,"A positive factor can mean renovation or demolition of a building. If the factor is negative, it can mean an increase in floor area, increased thermal comfort, population growth. The default factors are determined by the `Eurocalc Homes and buildings decarbonization scenario `_" retrofitting,,, -- retro_endogen,--,"{true, false}",Add retrofitting as an endogenous system which co-optimise space heat savings. --- cost_factor,,,Weight costs for building renovation --- interest_rate,,,The interest rate for investment in building components +-- cost_factor,--,float,Weight costs for building renovation +-- interest_rate,--,float,The interest rate for investment in building components -- annualise_cost,--,"{true, false}",Annualise the investment costs of retrofitting -- tax_weighting,--,"{true, false}",Weight the costs of retrofitting depending on taxes in countries -- construction_index,--,"{true, false}",Weight the costs of retrofitting depending on labour/material costs per country tes,--,"{true, false}",Add option for storing thermal energy in large water pits associated with district heating systems and individual thermal energy storage (TES) -tes_tau,,, --- decentral,,, --- central,,, +tes_tau,,,The time constant used to calculate the decay of thermal energy in thermal energy storage (TES): 1- :math:`e^{-1/24τ}`. +-- decentral,days,float,The time constant in decentralized thermal energy storage (TES) +-- central,days,float,The time constant in centralized thermal energy storage (TES) boilers,--,"{true, false}",Add option for transforming electricity into heat using resistive heater oil_boilers,--,"{true, false}",Add option for transforming oil into heat using boilers biomass_boiler,--,"{true, false}",Add option for transforming biomass into heat using boilers chp,--,"{true, false}",Add option for using Combined Heat and Power (CHP) micro_chp,--,"{true, false}",Add option for using Combined Heat and Power (CHP) for decentral areas. -solar_thermal,--,"{true, false}",Add option for using solar to generate heat. -solar_cf_correction,,, -marginal_cost_storage,,, +solar_thermal,--,"{true, false}",Add option for using solar thermal to generate heat. +solar_cf_correction,--,float,The correction factor for the value provided by the solar thermal profile calculations +marginal_cost_storage,currency/MWh ,float,The marginal cost of discharging batteries in distributed grids methanation,--,"{true, false}",Add option for transforming hydrogen and CO2 into methane using methanation. helmeth,--,"{true, false}",Add option for transforming power into gas using HELMETH (Integrated High-Temperature ELectrolysis and METHanation for Effective Power to Gas Conversion) coal_cc,--,"{true, false}",Add option for coal CHPs with carbon capture @@ -75,21 +75,21 @@ hydrogen_turbine,--,"{true, false}",Add option to include hydrogen turbine for r SMR,--,"{true, false}",Add option for transforming natural gas into hydrogen and CO2 using Steam Methane Reforming (SMR) regional_co2_sequestration_potential,,, -- enable,--,"{true, false}",Add option for regionally-resolved geological carbon dioxide sequestration potentials based on `CO2StoP `_. --- attribute,,, --- include_onshore,,"{true, false}",Add options for including onshore sequestration potentials --- min_size,,float,Any sites with lower potential than this value will be excluded --- max_size,,float,The maximum sequestration potential for any one site. --- years_of_storage,,float,The years until potential exhausted at optimised annual rate +-- attribute,--,string,Name of the attribute for the sequestration potential +-- include_onshore,--,"{true, false}",Add options for including onshore sequestration potentials +-- min_size,Gt ,float,Any sites with lower potential than this value will be excluded +-- max_size,Gt ,float,The maximum sequestration potential for any one site. +-- years_of_storage,years,float,The years until potential exhausted at optimised annual rate co2_sequestration_potential,MtCO2/a,float,The potential of sequestering CO2 in Europe per year -co2_sequestration_cost,EUR/tCO2,float,The cost of sequestering a ton of CO2 +co2_sequestration_cost,currency/tCO2,float,The cost of sequestering a ton of CO2 co2_spatial,--,"{true, false}","„Add option to spatially resolve carrier representing stored carbon dioxide. This allows for more detailed modelling of CCUTS, e.g. regarding the capturing of industrial process emissions, usage as feedstock for electrofuels, transport of carbon dioxide, and geological sequestration sites.“" co2network,--,"{true, false}",Add option for planning a new carbon dioxide network -cc_fraction,,,The default fraction of CO2 captured with post-combustion capture +cc_fraction,--,float,The default fraction of CO2 captured with post-combustion capture hydrogen_underground_storage,--,"{true, false}",Add options for storing hydrogen underground. Storage potential depends regionally. hydrogen_underground_storage_locations,,"{onshore, nearshore, offshore}","„The location where hydrogen underground storage can be located. Onshore, nearshore, offshore means it must be located more than 50 km away from the sea, within 50 km of the sea, or within the sea itself respectively.“" -ammonia,--,"{true, false, regional}","Add ammonia as a carrrier. It can be either true (copperplated NH3) or ""regional"" (regionalised NH3 without network)" -min_part_load_fischer_tropsch,,, -min_part_load_methanolisation,,, +ammonia,--,"{true, false, regional}","Add ammonia as a carrrier. It can be either true (copperplated NH3), false (no NH3 carrier) or ""regional"" (regionalised NH3 without network)" +min_part_load_fischer_tropsch,per unit of p_nom ,float,The minimum unit dispatch (p_min_pu) for the Fischer-Tropsch process +min_part_load_methanolisation,per unit of p_nom ,float,The minimum unit dispatch (p_min_pu) for the methanolisation process use_fischer_tropsch_waste_heat,--,"{true, false}",Add option for using waste heat of Fischer Tropsch in district heating networks use_fuel_cell_waste_heat,--,"{true, false}",Add option for using waste heat of fuel cells in district heating networks use_electrolysis_waste_heat,--,"{true, false}",Add option for using waste heat of electrolysis in district heating networks @@ -97,9 +97,10 @@ electricity_distribution_grid,--,"{true, false}",Add a electricity distribution electricity_distribution_grid_cost_factor,,,Multiplies the investment cost of the electricity distribution grid in data/costs.csv electricity_grid_connection,--,"{true, false}",Add the cost of electricity grid connection for onshore wind and solar H2_network,--,"{true, false}",Add option for new hydrogen pipelines -gas_network,--,"{true, false}","Add natural gas infrastructure, incl. LNG terminals, production and entry-points" -H2_retrofit,--,"{true, false}",Add option for retrofiting existing pipelines to transport hydrogen -H2_retrofit_capacity_per_CH4,,, +gas_network,--,"{true, false}","Add existing natural gas infrastructure, incl. LNG terminals, production and entry-points. The existing gas network is added with a lossless transport model. A length-weighted `k-edge augmentation algorithm `_ can be run to add new candidate gas pipelines such that all regions of the model can be connected to the gas network. When activated, all the gas demands are regionally disaggregated as well." +H2_retrofit,--,"{true, false}","Add option for retrofiting existing pipelines to transport hydrogen. The reasoning is in accordance with the `hydrogen backbone strategy (April, 2020) p.15 `_. 60% of original natural gas capacity could be used in cost-optimal case as H2 capacity." +H2_retrofit_capacity_per_CH4,--,float,The ratio for H2 capacity per original CH4 capacity of retrofitted pipelines +gas_network_connectivity_upgrade ,--,float,The number of desired edge connectivity (k) in the length-weighted `k-edge augmentation algorithm `_ used for the gas network gas_distribution_grid,--,"{true, false}",Add a gas distribution grid gas_distribution_grid_cost_factor,,,Multiplies the investment cost of the gas distribution grid in data/costs.csv biomass_spatial,--,"{true, false}",Add option for resolving biomass demand regionally diff --git a/doc/configuration.rst b/doc/configuration.rst index cd926b6a2..1aa6e76d4 100644 --- a/doc/configuration.rst +++ b/doc/configuration.rst @@ -191,6 +191,9 @@ Switches for some rules and optional features. :widths: 25,7,22,30 :file: configtables/electricity.csv +.. note:: + Wind is the Fueltype in powerplantmatching, onwind, offwind-{ac,dc} the carrier in PyPSA-Eur + .. _atlite_cf: ``atlite`` @@ -470,7 +473,7 @@ The list of available biomass is given by the category in `ENSPRESO_BIOMASS Date: Tue, 4 Jul 2023 23:58:05 +0000 Subject: [PATCH 08/18] [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --- config/config.default.yaml | 10 +++++----- doc/configtables/.~lock.sector.csv# | 2 +- doc/configtables/sector.csv | 4 ++-- 3 files changed, 8 insertions(+), 8 deletions(-) diff --git a/config/config.default.yaml b/config/config.default.yaml index f3b69e4a8..6e5fba778 100644 --- a/config/config.default.yaml +++ b/config/config.default.yaml @@ -323,7 +323,7 @@ existing_capacities: # docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#sector sector: district_heating: - potential: 0.6 + potential: 0.6 progress: 2020: 0.0 2030: 0.3 @@ -434,7 +434,7 @@ sector: regional_co2_sequestration_potential: enable: false attribute: 'conservative estimate Mt' - include_onshore: false + include_onshore: false min_size: 3 max_size: 25 years_of_storage: 25 @@ -455,12 +455,12 @@ sector: use_fuel_cell_waste_heat: true use_electrolysis_waste_heat: false electricity_distribution_grid: true - electricity_distribution_grid_cost_factor: 1.0 + electricity_distribution_grid_cost_factor: 1.0 electricity_grid_connection: true H2_network: true gas_network: false H2_retrofit: false - H2_retrofit_capacity_per_CH4: 0.6 + H2_retrofit_capacity_per_CH4: 0.6 gas_network_connectivity_upgrade: 1 gas_distribution_grid: true gas_distribution_grid_cost_factor: 1.0 @@ -489,7 +489,7 @@ industry: 2040: 0.4 2045: 0.7 2050: 1 - H2_DRI: 1.7 + H2_DRI: 1.7 elec_DRI: 0.322 Al_primary_fraction: 2020: 0.4 diff --git a/doc/configtables/.~lock.sector.csv# b/doc/configtables/.~lock.sector.csv# index b614fb4e0..24f46f24a 100644 --- a/doc/configtables/.~lock.sector.csv# +++ b/doc/configtables/.~lock.sector.csv# @@ -1 +1 @@ -,DESKTOP-2RNCH2B/kunde,,05.07.2023 01:09,file:///C:/Users/kunde/AppData/Roaming/LibreOffice/4; \ No newline at end of file +,DESKTOP-2RNCH2B/kunde,,05.07.2023 01:09,file:///C:/Users/kunde/AppData/Roaming/LibreOffice/4; diff --git a/doc/configtables/sector.csv b/doc/configtables/sector.csv index cb6c8115b..298052739 100644 --- a/doc/configtables/sector.csv +++ b/doc/configtables/sector.csv @@ -43,7 +43,7 @@ aviation_demand_factor,--,float,The proportion of demand for aviation compared t HVC_demand_factor,--,float,The proportion of demand for high-value chemicals compared to today's time_dep_hp_cop,--,"{true, false}",Consider the time dependent coefficient of performance (COP) of the heat pump heat_pump_sink_T,°C,float,The temperature heat sink used in heat pumps based on DTU / large area radiators. The value is conservatively high to cover hot water and space heating in poorly-insulated buildings -reduce_space_heat_exogenously,--,"{true, false}",Influence on space heating demand by a certain factor (applied before losses in district heating). +reduce_space_heat_exogenously,--,"{true, false}",Influence on space heating demand by a certain factor (applied before losses in district heating). reduce_space_heat_exogenously_factor,--,Dictionary with planning horizons as keys.,"A positive factor can mean renovation or demolition of a building. If the factor is negative, it can mean an increase in floor area, increased thermal comfort, population growth. The default factors are determined by the `Eurocalc Homes and buildings decarbonization scenario `_" retrofitting,,, -- retro_endogen,--,"{true, false}",Add retrofitting as an endogenous system which co-optimise space heat savings. @@ -99,7 +99,7 @@ electricity_grid_connection,--,"{true, false}",Add the cost of electricity grid H2_network,--,"{true, false}",Add option for new hydrogen pipelines gas_network,--,"{true, false}","Add existing natural gas infrastructure, incl. LNG terminals, production and entry-points. The existing gas network is added with a lossless transport model. A length-weighted `k-edge augmentation algorithm `_ can be run to add new candidate gas pipelines such that all regions of the model can be connected to the gas network. When activated, all the gas demands are regionally disaggregated as well." H2_retrofit,--,"{true, false}","Add option for retrofiting existing pipelines to transport hydrogen. The reasoning is in accordance with the `hydrogen backbone strategy (April, 2020) p.15 `_. 60% of original natural gas capacity could be used in cost-optimal case as H2 capacity." -H2_retrofit_capacity_per_CH4,--,float,The ratio for H2 capacity per original CH4 capacity of retrofitted pipelines +H2_retrofit_capacity_per_CH4,--,float,The ratio for H2 capacity per original CH4 capacity of retrofitted pipelines gas_network_connectivity_upgrade ,--,float,The number of desired edge connectivity (k) in the length-weighted `k-edge augmentation algorithm `_ used for the gas network gas_distribution_grid,--,"{true, false}",Add a gas distribution grid gas_distribution_grid_cost_factor,,,Multiplies the investment cost of the gas distribution grid in data/costs.csv From 9c6e5e0ed055b4ab0196ce26552df6ae9920a3c2 Mon Sep 17 00:00:00 2001 From: Fabian Date: Wed, 5 Jul 2023 11:34:07 +0200 Subject: [PATCH 09/18] config: remove unneeded plotting entries --- config/config.default.yaml | 42 ----------------------------------- doc/configtables/plotting.csv | 9 -------- scripts/solve_network.py | 9 ++++---- 3 files changed, 5 insertions(+), 55 deletions(-) diff --git a/config/config.default.yaml b/config/config.default.yaml index 6e5fba778..574776186 100644 --- a/config/config.default.yaml +++ b/config/config.default.yaml @@ -665,48 +665,6 @@ plotting: energy_max: 20000 energy_min: -20000 energy_threshold: 50. - vre_techs: - - onwind - - offwind-ac - - offwind-dc - - solar - - ror - renewable_storage_techs: - - PHS - - hydro - conv_techs: - - OCGT - - CCGT - - Nuclear - - Coal - storage_techs: - - hydro+PHS - - battery - - H2 - load_carriers: - - AC load - AC_carriers: - - AC line - - AC transformer - link_carriers: - - DC line - - Converter AC-DC - heat_links: - - heat pump - - resistive heater - - CHP heat - - CHP electric - - gas boiler - - central heat pump - - central resistive heater - - central CHP heat - - central CHP electric - - central gas boiler - heat_generators: - - gas boiler - - central gas boiler - - solar thermal collector - - central solar thermal collector nice_names: OCGT: "Open-Cycle Gas" diff --git a/doc/configtables/plotting.csv b/doc/configtables/plotting.csv index 82bf7af61..ed5d9c9fe 100644 --- a/doc/configtables/plotting.csv +++ b/doc/configtables/plotting.csv @@ -7,13 +7,4 @@ energy_max,TWh,float,Upper y-axis limit in energy bar plots. energy_min,TWh,float,Lower y-axis limit in energy bar plots. energy_threshold,TWh,float,Threshold below which technologies will not be shown in energy bar plots. tech_colors,--,carrier -> HEX colour code,Mapping from network ``carrier`` to a colour (`HEX colour code `_). -vre_techs ,--,subset of carriers,Value not in use -renewable_storage_techs ,--,subset of carriers,Value not in use -conv_techs ,--,subset of carriers,Value in use with unworthy significance. Used as the definition of conventional carrier in solve_network -storage_techs ,--,subset of carriers,Value not in use -load_carriers ,--,subset of carriers,Value not in use -AC_carriers ,--,subset of carriers,Value not in use -link_carriers ,--,subset of carriers,Value not in use -heat_links ,--,subset of carriers,Value not in use -heat_generators ,--,subset of carriers,Value not in use nice_names,--,str -> str,Mapping from network ``carrier`` to a more readable name. diff --git a/scripts/solve_network.py b/scripts/solve_network.py index 58f4db721..37dea1622 100644 --- a/scripts/solve_network.py +++ b/scripts/solve_network.py @@ -378,13 +378,14 @@ def add_SAFE_constraints(n, config): peakdemand = n.loads_t.p_set.sum(axis=1).max() margin = 1.0 + config["electricity"]["SAFE_reservemargin"] reserve_margin = peakdemand * margin - # TODO: do not take this from the plotting config! - conv_techs = config["plotting"]["conv_techs"] - ext_gens_i = n.generators.query("carrier in @conv_techs & p_nom_extendable").index + conventional_carriers = config["electricity"]["conventional_carriers"] + ext_gens_i = n.generators.query( + "carrier in @conventional_carriers & p_nom_extendable" + ).index p_nom = n.model["Generator-p_nom"].loc[ext_gens_i] lhs = p_nom.sum() exist_conv_caps = n.generators.query( - "~p_nom_extendable & carrier in @conv_techs" + "~p_nom_extendable & carrier in @conventional_carriers" ).p_nom.sum() rhs = reserve_margin - exist_conv_caps n.model.add_constraints(lhs >= rhs, name="safe_mintotalcap") From d73452903190e9c422f85229656939470e37008b Mon Sep 17 00:00:00 2001 From: virio-andreyana <114650479+virio-andreyana@users.noreply.github.com> Date: Wed, 12 Jul 2023 12:42:31 +0200 Subject: [PATCH 10/18] Apply Fabian Neumann suggestions from code review Co-authored-by: Fabian Neumann --- doc/configtables/electricity.csv | 12 ++++--- doc/configtables/energy.csv | 9 +++-- doc/configtables/existing_capacities.csv | 5 +-- doc/configtables/industry.csv | 13 ++++--- doc/configtables/sector.csv | 46 ++++++++++++++---------- doc/configtables/solar-thermal.csv | 3 +- 6 files changed, 55 insertions(+), 33 deletions(-) diff --git a/doc/configtables/electricity.csv b/doc/configtables/electricity.csv index 02dcbdde3..828c34df7 100644 --- a/doc/configtables/electricity.csv +++ b/doc/configtables/electricity.csv @@ -4,7 +4,8 @@ gaslimit,MWhth,float or false,Global gas usage limit co2limit,:math:`t_{CO_2-eq}/a`,float,Cap on total annual system carbon dioxide emissions co2base,:math:`t_{CO_2-eq}/a`,float,Reference value of total annual system carbon dioxide emissions if relative emission reduction target is specified in ``{opts}`` wildcard. agg_p_nom_limits,file,path,Reference to ``.csv`` file specifying per carrier generator nominal capacity constraints for individual countries if ``'CCL'`` is in ``{opts}`` wildcard. Defaults to ``data/agg_p_nom_minmax.csv``. -operational_reserve,,,Settings for reserve requirements following like `GenX `_ +operational_reserve,,,Settings for reserve requirements following `GenX `_ + -- activate,bool,true or false,Whether to take operational reserve requirements into account during optimisation -- epsilon_load,--,float,share of total load -- epsilon_vres,--,float,share of total renewable supply @@ -17,9 +18,12 @@ extendable_carriers,,, -- StorageUnit,--,"Any subset of {'battery','H2'}",Adds extendable storage units (battery and/or hydrogen) at every node/bus after clustering without capacity limits and with zero initial capacity. -- Store,--,"Any subset of {'battery','H2'}",Adds extendable storage units (battery and/or hydrogen) at every node/bus after clustering without capacity limits and with zero initial capacity. -- Link,--,Any subset of {'H2 pipeline'},Adds extendable links (H2 pipelines only) at every connection where there are lines or HVDC links without capacity limits and with zero initial capacity. Hydrogen pipelines require hydrogen storage to be modelled as ``Store``. -powerplants_filter,--,"use `pandas.query `_ strings here, e.g. Country not in ['Germany']",Filter query for the default powerplant database. -custom_powerplants,--,"use `pandas.query `_ strings here, e.g. Country in ['Germany']",Filter query for the custom powerplant database. -conventional_carriers,--,"Any subset of {nuclear, oil, OCGT, CCGT, coal, lignite, geothermal, biomass}","List of conventional power plants to include in the model from ``resources/powerplants.csv``. If an included carrier is also listed in `extendable_carriers`, the capacity is taken as a lower bound." +powerplants_filter,--,"use `pandas.query `_ strings here, e.g. ``Country not in ['Germany']``",Filter query for the default powerplant database. + +custom_powerplants,--,"use `pandas.query `_ strings here, e.g. ``Country in ['Germany']``",Filter query for the custom powerplant database. + +conventional_carriers,--,"Any subset of {nuclear, oil, OCGT, CCGT, coal, lignite, geothermal, biomass}","List of conventional power plants to include in the model from ``resources/powerplants.csv``. If an included carrier is also listed in ``extendable_carriers``, the capacity is taken as a lower bound." + renewable_carriers,--,"Any subset of {solar, onwind, offwind-ac, offwind-dc, hydro}",List of renewable generators to include in the model. estimate_renewable_capacities,,, -- enable,,bool,Activate routine to estimate renewable capacities diff --git a/doc/configtables/energy.csv b/doc/configtables/energy.csv index 640a9bc39..ff5e48cd3 100644 --- a/doc/configtables/energy.csv +++ b/doc/configtables/energy.csv @@ -1,5 +1,8 @@ ,Unit,Values,Description energy_totals_year ,--,"{1990,1995,2000,2005,2010,2011,…} ",The year for the sector energy use. The year must be avaliable in the Eurostat report -base_emissions_year ,--,YYYY; e.g. ‚1990‘ ,'The base year for the sector emissions. See `European Environment Agency (EEA) `_ downloaded 201228 (modified by EEA last on 201221)‘ -eurostat_report_year ,--,"{2016,2017,2018}","'The year in which the Eurostat report year are extracted. 2016 includes Bosnia and Herzegovina, 2017 does not‘" -emissions ,--,"{CO2, All greenhouse gases - (CO2 equivalent)}",Specify which sectoral emissions are taken into account. Data derived from EEA. +base_emissions_year ,--,"YYYY; e.g. 1990","The base year for the sector emissions. See `European Environment Agency (EEA) `_." + +eurostat_report_year ,--,"{2016,2017,2018}","The publication year of the Eurostat report. 2016 includes Bosnia and Herzegovina, 2017 does not" + +emissions ,--,"{CO2, All greenhouse gases - (CO2 equivalent)}","Specify which sectoral emissions are taken into account. Data derived from EEA. Currently only CO2 is implemented." + diff --git a/doc/configtables/existing_capacities.csv b/doc/configtables/existing_capacities.csv index 6b53d5f12..875191931 100644 --- a/doc/configtables/existing_capacities.csv +++ b/doc/configtables/existing_capacities.csv @@ -1,5 +1,6 @@ ,Unit,Values,Description -grouping_years_power ,--,An array of years,Intervals to group existing capacities for power -grouping_years_heat ,--,An array of years below 2020,Intervals to group existing capacities for heat +grouping_years_power ,--,A list of years,Intervals to group existing capacities for power +grouping_years_heat ,--,A list of years below 2020,Intervals to group existing capacities for heat + threshold_capacity ,MW,float,Capacities generators and links of below threshold are removed during add_existing_capacities conventional_carriers ,--,"Any subset of {uranium, coal, lignite, oil} ",List of conventional power plants to include in the sectoral network diff --git a/doc/configtables/industry.csv b/doc/configtables/industry.csv index 248ed4b54..358da5c84 100644 --- a/doc/configtables/industry.csv +++ b/doc/configtables/industry.csv @@ -1,6 +1,7 @@ ,Unit,Values,Description St_primary_fraction,--,Dictionary with planning horizons as keys.,The fraction of steel produced via primary route versus secondary route (scrap+EAF). Current fraction is 0.6 -DRI_fraction,--,Dictionary with planning horizons as keys.,The fraction of the primary route converted to DRI + EAF +DRI_fraction,--,Dictionary with planning horizons as keys.,The fraction of the primary route DRI + EAF + H2_DRI,--,float,The hydrogen consumption in Direct Reduced Iron (DRI) Mwh_H2 LHV/ton_Steel from 51kgH2/tSt in `Vogl et al (2018) `_ elec_DRI,MWh/tSt,float,The electricity consumed in Direct Reduced Iron (DRI) shaft. From `HYBRIT brochure `_ Al_primary_fraction,--,Dictionary with planning horizons as keys.,The fraction of aluminium produced via the primary route versus scrap. Current fraction is 0.4 @@ -12,12 +13,14 @@ MWh_elec_per_tNH3_electrolysis,--,float,"The energy amount of electricity needed MWh_NH3_per_MWh_H2_cracker,--,float,The energy amount of amonia needed to produce an energy amount hydrogen using ammonia cracker NH3_process_emissions,MtCO2/a,float,The emission of ammonia production from steam methane reforming (SMR). From UNFCCC for 2015 for EU28 petrochemical_process_emissions,MtCO2/a,float,The emission of petrochemical production. From UNFCCC for 2015 for EU28 -HVC_primary_fraction,--,float,The fraction of today's high value chemicals (HVC) produced via primary route -HVC_mechanical_recycling_fraction,--,float,The fraction of today's high value chemicals (HVC) produced using mechanical recycling -HVC_chemical_recycling_fraction,--,float,The fraction of today's high value chemicals (HVC) produced using chemical recycling +HVC_primary_fraction,--,float,The fraction of high value chemicals (HVC) produced via primary route +HVC_mechanical_recycling_fraction,--,float,The fraction of high value chemicals (HVC) produced using mechanical recycling +HVC_chemical_recycling_fraction,--,float,The fraction of high value chemicals (HVC) produced using chemical recycling + HVC_production_today,MtHVC/a,float,"The amount of high value chemicals (HVC) produced. This includes ethylene, propylene and BTX. From `DECHEMA (2017) `_, Figure 16, page 107" MWh_elec_per_tHVC_mechanical_recycling,MWh/tHVC,float,"The energy amount of electricity needed to produce a ton of high value chemical (HVC) using mechanical recycling. From SI of `Meys et al (2020) `_, Table S5, for HDPE, PP, PS, PET. LDPE would be 0.756." -MWh_elec_per_tHVC_chemical_recycling,MWh/tHVC,float,"The energy amount of electricity needed to produce a ton of high value chemical (HVC) using chemical recycling. Value are based on pyrolysis and electric steam cracking. From `Material Economics (2019) `_, page 125" +MWh_elec_per_tHVC_chemical_recycling,MWh/tHVC,float,"The energy amount of electricity needed to produce a ton of high value chemical (HVC) using chemical recycling. The default value is based on pyrolysis and electric steam cracking. From `Material Economics (2019) `_, page 125" + chlorine_production_today,MtCl/a,float,"The amount of chlorine produced. From `DECHEMA (2017) `_, Table 7, page 43" MWh_elec_per_tCl,MWh/tCl,float,"The energy amount of electricity needed to produce a ton of chlorine. From `DECHEMA (2017) `_, Table 6 page 43" MWh_H2_per_tCl,MWhH2/tCl,float,"The energy amount of hydrogen needed to produce a ton of chlorine. The value is negative since hydrogen produced in chloralkali process. From `DECHEMA (2017) `_, page 43" diff --git a/doc/configtables/sector.csv b/doc/configtables/sector.csv index 298052739..7f7efed4d 100644 --- a/doc/configtables/sector.csv +++ b/doc/configtables/sector.csv @@ -1,10 +1,11 @@ ,Unit,Values,Description district_heating,--,,`prepare_sector_network.py `_ --- potential,--,float,maximum fraction of urban demand which can be supplied by district heating increase of today's district heating demand to potential maximum district heating share --- progress,--,Dictionary with planning horizons as keys.,Progress = 0 means today's district heating share. Progress = 1 means maximum fraction of urban demand is supplied by district heating +-- potential,--,float,maximum fraction of urban demand which can be supplied by district heating +-- progress,--,Dictionary with planning horizons as keys., Increase of today's district heating demand to potential maximum district heating share. Progress = 0 means today's district heating share. Progress = 1 means maximum fraction of urban demand is supplied by district heating -- district_heating_loss,--,float,Percentage increase in district heat demand in urban central due to heat losses -cluster_heat_buses,--,"{true, false}",cluster residential and service heat buses in `prepare_sector_network.py `_ to one to save memory. -bev_dsm_restriction_value,--,float,Adding a stage of charge (SOC) limit for battery electric vehicles (BEV) to manage its own energy demand (DSM). Located in `build_transport_demand.py `_. Set to 0 for no restriction on BEV DSM +cluster_heat_buses,--,"{true, false}",Cluster residential and service heat buses in `prepare_sector_network.py `_ to one to save memory. + +bev_dsm_restriction_value,--,float,Adds a lower state of charge (SOC) limit for battery electric vehicles (BEV) to manage its own energy demand (DSM). Located in `build_transport_demand.py `_. Set to 0 for no restriction on BEV DSM bev_dsm_restriction_time,--,float,Time at which SOC of BEV has to be dsm_restriction_value transport_heating_deadband_upper,°C,float,"The minimum temperature in the vehicle. At lower temperatures, the energy required for heating in the vehicle increases." transport_heating_deadband_lower,°C,float,"The maximum temperature in the vehicle. At higher temperatures, the energy required for cooling in the vehicle increases." @@ -12,7 +13,8 @@ ICE_lower_degree_factor,--,float,Percentage increase in energy demand in interna ICE_upper_degree_factor,--,float,Percentage increase in energy demand in internal combustion engine (ICE) for each degree difference between the hot environment and the maximum temperature. EV_lower_degree_factor,--,float,Percentage increase in energy demand in electric vehicles (EV) for each degree difference between the cold environment and the minimum temperature. EV_upper_degree_factor,--,float,Percentage increase in energy demand in electric vehicles (EV) for each degree difference between the hot environment and the maximum temperature. -bev_dsm,--,"{true, false}",Add the option for battery electric vehicles (BEV) to manage its own energy demand (DSM) +bev_dsm,--,"{true, false}",Add the option for battery electric vehicles (BEV) to participate in demand-side management (DSM) + bev_availability,--,float,The percentage for battery electric vehicles (BEV) that are able to do demand side management (DSM) bev_energy,--,float,The average size of battery electric vehicles (BEV) in MWh bev_charge_efficiency,--,float,Battery electric vehicles (BEV) charge and discharge efficiency @@ -33,14 +35,17 @@ agriculture_machinery_electric_efficiency,--,float,The efficiency of oil-powered MWh_MeOH_per_MWh_H2,LHV,float,"The energy amount of the produced methanol per energy amount of hydrogen. From `DECHEMA (2017) `_, page 64." MWh_MeOH_per_tCO2,LHV,float,"The energy amount of the produced methanol per ton of CO2. From `DECHEMA (2017) `_, page 64." MWh_MeOH_per_MWh_e,LHV,float,"The energy amount of the produced methanol per energy amount of electricity. From `DECHEMA (2017) `_, page 64." -shipping_hydrogen_liquefaction,--,"{true, false}",Consider whether to include liquefaction costs for shipping H2 demand. +shipping_hydrogen_liquefaction,--,"{true, false}",Whether to include liquefaction costs for hydrogen demand in shipping. + shipping_hydrogen_share,--,Dictionary with planning horizons as keys.,The share of ships powered by hydrogen in a given year shipping_methanol_share,--,Dictionary with planning horizons as keys.,The share of ships powered by methanol in a given year shipping_oil_share,--,Dictionary with planning horizons as keys.,The share of ships powered by oil in a given year -shipping_methanol_efficiency,--,float,"The efficiency of methanol-powered ships in the conversion of methanol to meet shipping needs (propulsion). The efficiency increase from oil can be 10-15% higher according to the `IEA `_," +shipping_methanol_efficiency,--,float,"The efficiency of methanol-powered ships in the conversion of methanol to meet shipping needs (propulsion). The efficiency increase from oil can be 10-15% higher according to the `IEA `_" + shipping_oil_efficiency,--,float,The efficiency of oil-powered ships in the conversion of oil to meet shipping needs (propulsion). Base value derived from 2011 -aviation_demand_factor,--,float,The proportion of demand for aviation compared to today's -HVC_demand_factor,--,float,The proportion of demand for high-value chemicals compared to today's +aviation_demand_factor,--,float,The proportion of demand for aviation compared to today's consumption +HVC_demand_factor,--,float,The proportion of demand for high-value chemicals compared to today's consumption + time_dep_hp_cop,--,"{true, false}",Consider the time dependent coefficient of performance (COP) of the heat pump heat_pump_sink_T,°C,float,The temperature heat sink used in heat pumps based on DTU / large area radiators. The value is conservatively high to cover hot water and space heating in poorly-insulated buildings reduce_space_heat_exogenously,--,"{true, false}",Influence on space heating demand by a certain factor (applied before losses in district heating). @@ -82,27 +87,32 @@ regional_co2_sequestration_potential,,, -- years_of_storage,years,float,The years until potential exhausted at optimised annual rate co2_sequestration_potential,MtCO2/a,float,The potential of sequestering CO2 in Europe per year co2_sequestration_cost,currency/tCO2,float,The cost of sequestering a ton of CO2 -co2_spatial,--,"{true, false}","„Add option to spatially resolve carrier representing stored carbon dioxide. This allows for more detailed modelling of CCUTS, e.g. regarding the capturing of industrial process emissions, usage as feedstock for electrofuels, transport of carbon dioxide, and geological sequestration sites.“" -co2network,--,"{true, false}",Add option for planning a new carbon dioxide network +co2_spatial,--,"{true, false}","Add option to spatially resolve carrier representing stored carbon dioxide. This allows for more detailed modelling of CCUTS, e.g. regarding the capturing of industrial process emissions, usage as feedstock for electrofuels, transport of carbon dioxide, and geological sequestration sites." + +co2network,--,"{true, false}",Add option for planning a new carbon dioxide transmission network + cc_fraction,--,float,The default fraction of CO2 captured with post-combustion capture hydrogen_underground_storage,--,"{true, false}",Add options for storing hydrogen underground. Storage potential depends regionally. -hydrogen_underground_storage_locations,,"{onshore, nearshore, offshore}","„The location where hydrogen underground storage can be located. Onshore, nearshore, offshore means it must be located more than 50 km away from the sea, within 50 km of the sea, or within the sea itself respectively.“" +hydrogen_underground_storage_locations,,"{onshore, nearshore, offshore}","The location where hydrogen underground storage can be located. Onshore, nearshore, offshore means it must be located more than 50 km away from the sea, within 50 km of the sea, or within the sea itself respectively." + ammonia,--,"{true, false, regional}","Add ammonia as a carrrier. It can be either true (copperplated NH3), false (no NH3 carrier) or ""regional"" (regionalised NH3 without network)" -min_part_load_fischer_tropsch,per unit of p_nom ,float,The minimum unit dispatch (p_min_pu) for the Fischer-Tropsch process -min_part_load_methanolisation,per unit of p_nom ,float,The minimum unit dispatch (p_min_pu) for the methanolisation process +min_part_load_fischer_tropsch,per unit of p_nom ,float,The minimum unit dispatch (``p_min_pu``) for the Fischer-Tropsch process +min_part_load_methanolisation,per unit of p_nom ,float,The minimum unit dispatch (``p_min_pu``) for the methanolisation process + use_fischer_tropsch_waste_heat,--,"{true, false}",Add option for using waste heat of Fischer Tropsch in district heating networks use_fuel_cell_waste_heat,--,"{true, false}",Add option for using waste heat of fuel cells in district heating networks use_electrolysis_waste_heat,--,"{true, false}",Add option for using waste heat of electrolysis in district heating networks -electricity_distribution_grid,--,"{true, false}",Add a electricity distribution grid +electricity_distribution_grid,--,"{true, false}",Add a simplified representation of the exchange capacity between transmission and distribution grid level through a link. electricity_distribution_grid_cost_factor,,,Multiplies the investment cost of the electricity distribution grid in data/costs.csv electricity_grid_connection,--,"{true, false}",Add the cost of electricity grid connection for onshore wind and solar H2_network,--,"{true, false}",Add option for new hydrogen pipelines gas_network,--,"{true, false}","Add existing natural gas infrastructure, incl. LNG terminals, production and entry-points. The existing gas network is added with a lossless transport model. A length-weighted `k-edge augmentation algorithm `_ can be run to add new candidate gas pipelines such that all regions of the model can be connected to the gas network. When activated, all the gas demands are regionally disaggregated as well." -H2_retrofit,--,"{true, false}","Add option for retrofiting existing pipelines to transport hydrogen. The reasoning is in accordance with the `hydrogen backbone strategy (April, 2020) p.15 `_. 60% of original natural gas capacity could be used in cost-optimal case as H2 capacity." -H2_retrofit_capacity_per_CH4,--,float,The ratio for H2 capacity per original CH4 capacity of retrofitted pipelines +H2_retrofit,--,"{true, false}","Add option for retrofiting existing pipelines to transport hydrogen. " +H2_retrofit_capacity_per_CH4,--,float,"The ratio for H2 capacity per original CH4 capacity of retrofitted pipelines. The `European Hydrogen Backbone (April, 2020) p.15 `_ 60% of original natural gas capacity could be used in cost-optimal case as H2 capacity." gas_network_connectivity_upgrade ,--,float,The number of desired edge connectivity (k) in the length-weighted `k-edge augmentation algorithm `_ used for the gas network gas_distribution_grid,--,"{true, false}",Add a gas distribution grid -gas_distribution_grid_cost_factor,,,Multiplies the investment cost of the gas distribution grid in data/costs.csv +gas_distribution_grid_cost_factor,,,Multiplier for the investment cost of the gas distribution grid + biomass_spatial,--,"{true, false}",Add option for resolving biomass demand regionally biomass_transport,--,"{true, false}",Add option for transporting solid biomass between nodes conventional_generation,,,Add a more detailed description of conventional carriers. Any power generation requires the consumption of fuel from nodes representing that fuel. diff --git a/doc/configtables/solar-thermal.csv b/doc/configtables/solar-thermal.csv index 7cc8dfc70..4575ae0d4 100644 --- a/doc/configtables/solar-thermal.csv +++ b/doc/configtables/solar-thermal.csv @@ -1,5 +1,6 @@ ,Unit,Values,Description clearsky_model ,--,"{‘simple’, ‘enhanced’}",Type of clearsky model for diffuse irradiation orientation ,--,"{units of degrees, ‘latitude_optimal’}",Panel orientation with slope and azimuth --- azimuth,float,units of degrees,The angle between the north and the sun with panels on the local horizon +-- azimuth,float,units of degrees,The angle between the North and the sun with panels on the local horizon + -- slope,float,units of degrees,The angle between the ground and the panels From 4ecc7ae43904b392059fcc60ce56b38ef6f3b78a Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Wed, 12 Jul 2023 10:42:46 +0000 Subject: [PATCH 11/18] [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --- doc/configtables/energy.csv | 1 - 1 file changed, 1 deletion(-) diff --git a/doc/configtables/energy.csv b/doc/configtables/energy.csv index ff5e48cd3..8718d75ed 100644 --- a/doc/configtables/energy.csv +++ b/doc/configtables/energy.csv @@ -5,4 +5,3 @@ base_emissions_year ,--,"YYYY; e.g. 1990","The base year for the sector emission eurostat_report_year ,--,"{2016,2017,2018}","The publication year of the Eurostat report. 2016 includes Bosnia and Herzegovina, 2017 does not" emissions ,--,"{CO2, All greenhouse gases - (CO2 equivalent)}","Specify which sectoral emissions are taken into account. Data derived from EEA. Currently only CO2 is implemented." - From 8c4299ee103bbfd8bf76ebe1e08938cb93fafae9 Mon Sep 17 00:00:00 2001 From: virio-andreyana <114650479+virio-andreyana@users.noreply.github.com> Date: Wed, 12 Jul 2023 12:42:54 +0200 Subject: [PATCH 12/18] Delete .~lock.sector.csv# --- doc/configtables/.~lock.sector.csv# | 1 - 1 file changed, 1 deletion(-) delete mode 100644 doc/configtables/.~lock.sector.csv# diff --git a/doc/configtables/.~lock.sector.csv# b/doc/configtables/.~lock.sector.csv# deleted file mode 100644 index 24f46f24a..000000000 --- a/doc/configtables/.~lock.sector.csv# +++ /dev/null @@ -1 +0,0 @@ -,DESKTOP-2RNCH2B/kunde,,05.07.2023 01:09,file:///C:/Users/kunde/AppData/Roaming/LibreOffice/4; From 3582c27e2ecf59bf6f30c8e006316abb34e895f3 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Thu, 13 Jul 2023 10:31:40 +0200 Subject: [PATCH 13/18] Update doc/configuration.rst --- doc/configuration.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/configuration.rst b/doc/configuration.rst index 7e911ef91..cb8127a9a 100644 --- a/doc/configuration.rst +++ b/doc/configuration.rst @@ -64,7 +64,7 @@ The ``run`` section is used for running and storing scenarios with different con :file: configtables/foresight.csv .. note:: - if you use myopic or perfect foresight, The investment years in + If you use myopic or perfect foresight, the planning horizon in :ref:`planning_horizons` in scenario has to be set. .. _scenario: From 56fd99a10ec060e5457ffb4d4cd4242f7a415300 Mon Sep 17 00:00:00 2001 From: virio-andreyana <114650479+virio-andreyana@users.noreply.github.com> Date: Thu, 13 Jul 2023 11:45:46 +0200 Subject: [PATCH 14/18] Apply three Fabian Neumann suggestions from code review Co-authored-by: Fabian Neumann --- doc/configtables/sector.csv | 8 +++++--- doc/configuration.rst | 2 +- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/doc/configtables/sector.csv b/doc/configtables/sector.csv index 7f7efed4d..d403e6768 100644 --- a/doc/configtables/sector.csv +++ b/doc/configtables/sector.csv @@ -7,8 +7,9 @@ cluster_heat_buses,--,"{true, false}",Cluster residential and service heat buses bev_dsm_restriction_value,--,float,Adds a lower state of charge (SOC) limit for battery electric vehicles (BEV) to manage its own energy demand (DSM). Located in `build_transport_demand.py `_. Set to 0 for no restriction on BEV DSM bev_dsm_restriction_time,--,float,Time at which SOC of BEV has to be dsm_restriction_value -transport_heating_deadband_upper,°C,float,"The minimum temperature in the vehicle. At lower temperatures, the energy required for heating in the vehicle increases." -transport_heating_deadband_lower,°C,float,"The maximum temperature in the vehicle. At higher temperatures, the energy required for cooling in the vehicle increases." +transport_heating_deadband_upper,°C,float,"The maximum temperature in the vehicle. At higher temperatures, the energy required for cooling in the vehicle increases." +transport_heating_deadband_lower,°C,float,"The minimum temperature in the vehicle. At lower temperatures, the energy required for heating in the vehicle increases." + ICE_lower_degree_factor,--,float,Percentage increase in energy demand in internal combustion engine (ICE) for each degree difference between the cold environment and the minimum temperature. ICE_upper_degree_factor,--,float,Percentage increase in energy demand in internal combustion engine (ICE) for each degree difference between the hot environment and the maximum temperature. EV_lower_degree_factor,--,float,Percentage increase in energy demand in electric vehicles (EV) for each degree difference between the cold environment and the minimum temperature. @@ -103,7 +104,8 @@ use_fischer_tropsch_waste_heat,--,"{true, false}",Add option for using waste hea use_fuel_cell_waste_heat,--,"{true, false}",Add option for using waste heat of fuel cells in district heating networks use_electrolysis_waste_heat,--,"{true, false}",Add option for using waste heat of electrolysis in district heating networks electricity_distribution_grid,--,"{true, false}",Add a simplified representation of the exchange capacity between transmission and distribution grid level through a link. -electricity_distribution_grid_cost_factor,,,Multiplies the investment cost of the electricity distribution grid in data/costs.csv +electricity_distribution_grid_cost_factor,,,Multiplies the investment cost of the electricity distribution grid + electricity_grid_connection,--,"{true, false}",Add the cost of electricity grid connection for onshore wind and solar H2_network,--,"{true, false}",Add option for new hydrogen pipelines gas_network,--,"{true, false}","Add existing natural gas infrastructure, incl. LNG terminals, production and entry-points. The existing gas network is added with a lossless transport model. A length-weighted `k-edge augmentation algorithm `_ can be run to add new candidate gas pipelines such that all regions of the model can be connected to the gas network. When activated, all the gas demands are regionally disaggregated as well." diff --git a/doc/configuration.rst b/doc/configuration.rst index cb8127a9a..f8d97c7b7 100644 --- a/doc/configuration.rst +++ b/doc/configuration.rst @@ -473,7 +473,7 @@ The list of available biomass is given by the category in `ENSPRESO_BIOMASS Date: Thu, 13 Jul 2023 12:52:18 +0200 Subject: [PATCH 15/18] add description on technology_mapping --- doc/configtables/electricity.csv | 17 ++++++++++------- doc/configuration.rst | 3 --- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/doc/configtables/electricity.csv b/doc/configtables/electricity.csv index 828c34df7..eb0874564 100644 --- a/doc/configtables/electricity.csv +++ b/doc/configtables/electricity.csv @@ -5,7 +5,7 @@ co2limit,:math:`t_{CO_2-eq}/a`,float,Cap on total annual system carbon dioxide e co2base,:math:`t_{CO_2-eq}/a`,float,Reference value of total annual system carbon dioxide emissions if relative emission reduction target is specified in ``{opts}`` wildcard. agg_p_nom_limits,file,path,Reference to ``.csv`` file specifying per carrier generator nominal capacity constraints for individual countries if ``'CCL'`` is in ``{opts}`` wildcard. Defaults to ``data/agg_p_nom_minmax.csv``. operational_reserve,,,Settings for reserve requirements following `GenX `_ - +,,, -- activate,bool,true or false,Whether to take operational reserve requirements into account during optimisation -- epsilon_load,--,float,share of total load -- epsilon_vres,--,float,share of total renewable supply @@ -19,15 +19,18 @@ extendable_carriers,,, -- Store,--,"Any subset of {'battery','H2'}",Adds extendable storage units (battery and/or hydrogen) at every node/bus after clustering without capacity limits and with zero initial capacity. -- Link,--,Any subset of {'H2 pipeline'},Adds extendable links (H2 pipelines only) at every connection where there are lines or HVDC links without capacity limits and with zero initial capacity. Hydrogen pipelines require hydrogen storage to be modelled as ``Store``. powerplants_filter,--,"use `pandas.query `_ strings here, e.g. ``Country not in ['Germany']``",Filter query for the default powerplant database. - +,,, custom_powerplants,--,"use `pandas.query `_ strings here, e.g. ``Country in ['Germany']``",Filter query for the custom powerplant database. - +,,, conventional_carriers,--,"Any subset of {nuclear, oil, OCGT, CCGT, coal, lignite, geothermal, biomass}","List of conventional power plants to include in the model from ``resources/powerplants.csv``. If an included carrier is also listed in ``extendable_carriers``, the capacity is taken as a lower bound." - +,,, renewable_carriers,--,"Any subset of {solar, onwind, offwind-ac, offwind-dc, hydro}",List of renewable generators to include in the model. estimate_renewable_capacities,,, -- enable,,bool,Activate routine to estimate renewable capacities --- from_opsd,--,bool,Add capacities from OPSD data --- year,--,bool,Renewable capacities are based on existing capacities reported by IRENA for the specified year +-- from_opsd,--,bool,Add renewable capacities from `OPSD database `_. The value is depreciated but still can be used. +-- year,--,bool,Renewable capacities are based on existing capacities reported by IRENA (IRENASTAT) for the specified year -- expansion_limit,--,float or false,"Artificially limit maximum IRENA capacities to a factor. For example, an ``expansion_limit: 1.1`` means 110% of capacities . If false are chosen, the estimated renewable potentials determine by the workflow are used." --- technology_mapping,,,Mapping between powerplantmatching and PyPSA-Eur technology names +-- technology_mapping,,,Mapping between PyPSA-Eur and powerplantmatching technology names +-- -- Offshore,--,"Any subset of {offwind-ac, offwind-dc}","List of PyPSA-Eur carriers that is considered as (IRENA, OPSD) onshore technology." +-- -- Offshore,--,{onwind},"List of PyPSA-Eur carriers that is considered as (IRENA, OPSD) offshore technology." +-- -- PV,--,{solar},"List of PyPSA-Eur carriers that is considered as (IRENA, OPSD) PV technology." diff --git a/doc/configuration.rst b/doc/configuration.rst index cb8127a9a..5e288a7f3 100644 --- a/doc/configuration.rst +++ b/doc/configuration.rst @@ -191,9 +191,6 @@ Switches for some rules and optional features. :widths: 25,7,22,30 :file: configtables/electricity.csv -.. note:: - Wind is the Fueltype in powerplantmatching, onwind, offwind-{ac,dc} the carrier in PyPSA-Eur - .. _atlite_cf: ``atlite`` From a03574ba14fa69d8199455925d8d46cfd3f91c3f Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Thu, 13 Jul 2023 10:55:56 +0000 Subject: [PATCH 16/18] [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --- doc/configtables/electricity.csv | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/configtables/electricity.csv b/doc/configtables/electricity.csv index eb0874564..4c04fee66 100644 --- a/doc/configtables/electricity.csv +++ b/doc/configtables/electricity.csv @@ -27,7 +27,7 @@ conventional_carriers,--,"Any subset of {nuclear, oil, OCGT, CCGT, coal, lignite renewable_carriers,--,"Any subset of {solar, onwind, offwind-ac, offwind-dc, hydro}",List of renewable generators to include in the model. estimate_renewable_capacities,,, -- enable,,bool,Activate routine to estimate renewable capacities --- from_opsd,--,bool,Add renewable capacities from `OPSD database `_. The value is depreciated but still can be used. +-- from_opsd,--,bool,Add renewable capacities from `OPSD database `_. The value is depreciated but still can be used. -- year,--,bool,Renewable capacities are based on existing capacities reported by IRENA (IRENASTAT) for the specified year -- expansion_limit,--,float or false,"Artificially limit maximum IRENA capacities to a factor. For example, an ``expansion_limit: 1.1`` means 110% of capacities . If false are chosen, the estimated renewable potentials determine by the workflow are used." -- technology_mapping,,,Mapping between PyPSA-Eur and powerplantmatching technology names From 23b154de36c7251fd1c443c46239548e58500d82 Mon Sep 17 00:00:00 2001 From: virio-andreyana Date: Fri, 14 Jul 2023 12:25:23 +0200 Subject: [PATCH 17/18] adjust config table spacing --- doc/configtables/industry.csv | 26 ++++----- doc/configtables/sector.csv | 106 +++++++++++++++++----------------- doc/configuration.rst | 60 +++++++++---------- doc/tutorial.rst | 16 ++--- doc/tutorial_sector.rst | 12 ++-- 5 files changed, 110 insertions(+), 110 deletions(-) diff --git a/doc/configtables/industry.csv b/doc/configtables/industry.csv index 358da5c84..fc1b3f0fa 100644 --- a/doc/configtables/industry.csv +++ b/doc/configtables/industry.csv @@ -1,30 +1,30 @@ ,Unit,Values,Description St_primary_fraction,--,Dictionary with planning horizons as keys.,The fraction of steel produced via primary route versus secondary route (scrap+EAF). Current fraction is 0.6 DRI_fraction,--,Dictionary with planning horizons as keys.,The fraction of the primary route DRI + EAF - +,,, H2_DRI,--,float,The hydrogen consumption in Direct Reduced Iron (DRI) Mwh_H2 LHV/ton_Steel from 51kgH2/tSt in `Vogl et al (2018) `_ elec_DRI,MWh/tSt,float,The electricity consumed in Direct Reduced Iron (DRI) shaft. From `HYBRIT brochure `_ Al_primary_fraction,--,Dictionary with planning horizons as keys.,The fraction of aluminium produced via the primary route versus scrap. Current fraction is 0.4 MWh_NH3_per_tNH3,LHV,float,The energy amount per ton of ammonia. MWh_CH4_per_tNH3_SMR,--,float,The energy amount of methane needed to produce a ton of ammonia using steam methane reforming (SMR). Value derived from 2012's demand from `Center for European Policy Studies (2008) `_ MWh_elec_per_tNH3_SMR,--,float,"The energy amount of electricity needed to produce a ton of ammonia using steam methane reforming (SMR). same source, assuming 94-6% split methane-elec of total energy demand 11.5 MWh/tNH3" -MWh_H2_per_tNH3_electrolysis,--,float,"The energy amount of hydrogen needed to produce a ton of ammonia using Haber–Bosch process. From `Wang et al (2018) `_, Base value assumed around 0.197 tH2/tHN3 (>3/17 since some H2 lost and used for energy)" -MWh_elec_per_tNH3_electrolysis,--,float,"The energy amount of electricity needed to produce a ton of ammonia using Haber–Bosch process. From `Wang et al (2018) `_, Table 13 (air separation and HB)" -MWh_NH3_per_MWh_H2_cracker,--,float,The energy amount of amonia needed to produce an energy amount hydrogen using ammonia cracker +Mwh_H2_per_tNH3 _electrolysis,--,float,"The energy amount of hydrogen needed to produce a ton of ammonia using Haber–Bosch process. From `Wang et al (2018) `_, Base value assumed around 0.197 tH2/tHN3 (>3/17 since some H2 lost and used for energy)" +Mwh_elec_per_tNH3 _electrolysis,--,float,"The energy amount of electricity needed to produce a ton of ammonia using Haber–Bosch process. From `Wang et al (2018) `_, Table 13 (air separation and HB)" +Mwh_NH3_per_MWh _H2_cracker,--,float,The energy amount of amonia needed to produce an energy amount hydrogen using ammonia cracker NH3_process_emissions,MtCO2/a,float,The emission of ammonia production from steam methane reforming (SMR). From UNFCCC for 2015 for EU28 -petrochemical_process_emissions,MtCO2/a,float,The emission of petrochemical production. From UNFCCC for 2015 for EU28 +petrochemical_process _emissions,MtCO2/a,float,The emission of petrochemical production. From UNFCCC for 2015 for EU28 HVC_primary_fraction,--,float,The fraction of high value chemicals (HVC) produced via primary route -HVC_mechanical_recycling_fraction,--,float,The fraction of high value chemicals (HVC) produced using mechanical recycling -HVC_chemical_recycling_fraction,--,float,The fraction of high value chemicals (HVC) produced using chemical recycling - +HVC_mechanical_recycling _fraction,--,float,The fraction of high value chemicals (HVC) produced using mechanical recycling +HVC_chemical_recycling _fraction,--,float,The fraction of high value chemicals (HVC) produced using chemical recycling +,,, HVC_production_today,MtHVC/a,float,"The amount of high value chemicals (HVC) produced. This includes ethylene, propylene and BTX. From `DECHEMA (2017) `_, Figure 16, page 107" -MWh_elec_per_tHVC_mechanical_recycling,MWh/tHVC,float,"The energy amount of electricity needed to produce a ton of high value chemical (HVC) using mechanical recycling. From SI of `Meys et al (2020) `_, Table S5, for HDPE, PP, PS, PET. LDPE would be 0.756." -MWh_elec_per_tHVC_chemical_recycling,MWh/tHVC,float,"The energy amount of electricity needed to produce a ton of high value chemical (HVC) using chemical recycling. The default value is based on pyrolysis and electric steam cracking. From `Material Economics (2019) `_, page 125" - -chlorine_production_today,MtCl/a,float,"The amount of chlorine produced. From `DECHEMA (2017) `_, Table 7, page 43" +Mwh_elec_per_tHVC _mechanical_recycling,MWh/tHVC,float,"The energy amount of electricity needed to produce a ton of high value chemical (HVC) using mechanical recycling. From SI of `Meys et al (2020) `_, Table S5, for HDPE, PP, PS, PET. LDPE would be 0.756." +Mwh_elec_per_tHVC _chemical_recycling,MWh/tHVC,float,"The energy amount of electricity needed to produce a ton of high value chemical (HVC) using chemical recycling. The default value is based on pyrolysis and electric steam cracking. From `Material Economics (2019) `_, page 125" +,,, +chlorine_production _today,MtCl/a,float,"The amount of chlorine produced. From `DECHEMA (2017) `_, Table 7, page 43" MWh_elec_per_tCl,MWh/tCl,float,"The energy amount of electricity needed to produce a ton of chlorine. From `DECHEMA (2017) `_, Table 6 page 43" MWh_H2_per_tCl,MWhH2/tCl,float,"The energy amount of hydrogen needed to produce a ton of chlorine. The value is negative since hydrogen produced in chloralkali process. From `DECHEMA (2017) `_, page 43" -methanol_production_today,MtMeOH/a,float,"The amount of methanol produced. From `DECHEMA (2017) `_, page 62" +methanol_production _today,MtMeOH/a,float,"The amount of methanol produced. From `DECHEMA (2017) `_, page 62" MWh_elec_per_tMeOH,MWh/tMeOH,float,"The energy amount of electricity needed to produce a ton of methanol. From `DECHEMA (2017) `_, Table 14, page 65" MWh_CH4_per_tMeOH,MWhCH4/tMeOH,float,"The energy amount of methane needed to produce a ton of methanol. From `DECHEMA (2017) `_, Table 14, page 65" hotmaps_locate_missing,--,"{true,false}",Locate industrial sites without valid locations based on city and countries. diff --git a/doc/configtables/sector.csv b/doc/configtables/sector.csv index d403e6768..36b7dd987 100644 --- a/doc/configtables/sector.csv +++ b/doc/configtables/sector.csv @@ -2,55 +2,55 @@ district_heating,--,,`prepare_sector_network.py `_ -- potential,--,float,maximum fraction of urban demand which can be supplied by district heating -- progress,--,Dictionary with planning horizons as keys., Increase of today's district heating demand to potential maximum district heating share. Progress = 0 means today's district heating share. Progress = 1 means maximum fraction of urban demand is supplied by district heating --- district_heating_loss,--,float,Percentage increase in district heat demand in urban central due to heat losses +-- district_heating_loss,--,float,Share increase in district heat demand in urban central due to heat losses cluster_heat_buses,--,"{true, false}",Cluster residential and service heat buses in `prepare_sector_network.py `_ to one to save memory. - -bev_dsm_restriction_value,--,float,Adds a lower state of charge (SOC) limit for battery electric vehicles (BEV) to manage its own energy demand (DSM). Located in `build_transport_demand.py `_. Set to 0 for no restriction on BEV DSM -bev_dsm_restriction_time,--,float,Time at which SOC of BEV has to be dsm_restriction_value -transport_heating_deadband_upper,°C,float,"The maximum temperature in the vehicle. At higher temperatures, the energy required for cooling in the vehicle increases." -transport_heating_deadband_lower,°C,float,"The minimum temperature in the vehicle. At lower temperatures, the energy required for heating in the vehicle increases." - -ICE_lower_degree_factor,--,float,Percentage increase in energy demand in internal combustion engine (ICE) for each degree difference between the cold environment and the minimum temperature. -ICE_upper_degree_factor,--,float,Percentage increase in energy demand in internal combustion engine (ICE) for each degree difference between the hot environment and the maximum temperature. -EV_lower_degree_factor,--,float,Percentage increase in energy demand in electric vehicles (EV) for each degree difference between the cold environment and the minimum temperature. -EV_upper_degree_factor,--,float,Percentage increase in energy demand in electric vehicles (EV) for each degree difference between the hot environment and the maximum temperature. +,,, +bev_dsm_restriction _value,--,float,Adds a lower state of charge (SOC) limit for battery electric vehicles (BEV) to manage its own energy demand (DSM). Located in `build_transport_demand.py `_. Set to 0 for no restriction on BEV DSM +bev_dsm_restriction _time,--,float,Time at which SOC of BEV has to be dsm_restriction_value +transport_heating _deadband_upper,°C,float,"The maximum temperature in the vehicle. At higher temperatures, the energy required for cooling in the vehicle increases." +transport_heating _deadband_lower,°C,float,"The minimum temperature in the vehicle. At lower temperatures, the energy required for heating in the vehicle increases." +,,, +ICE_lower_degree_factor,--,float,Share increase in energy demand in internal combustion engine (ICE) for each degree difference between the cold environment and the minimum temperature. +ICE_upper_degree_factor,--,float,Share increase in energy demand in internal combustion engine (ICE) for each degree difference between the hot environment and the maximum temperature. +EV_lower_degree_factor,--,float,Share increase in energy demand in electric vehicles (EV) for each degree difference between the cold environment and the minimum temperature. +EV_upper_degree_factor,--,float,Share increase in energy demand in electric vehicles (EV) for each degree difference between the hot environment and the maximum temperature. bev_dsm,--,"{true, false}",Add the option for battery electric vehicles (BEV) to participate in demand-side management (DSM) - -bev_availability,--,float,The percentage for battery electric vehicles (BEV) that are able to do demand side management (DSM) +,,, +bev_availability,--,float,The share for battery electric vehicles (BEV) that are able to do demand side management (DSM) bev_energy,--,float,The average size of battery electric vehicles (BEV) in MWh bev_charge_efficiency,--,float,Battery electric vehicles (BEV) charge and discharge efficiency -bev_plug_to_wheel_efficiency,km/kWh,float,The distance battery electric vehicles (BEV) can travel in km per kWh of energy charge in battery. Base value comes from `Tesla Model S `_ +bev_plug_to_wheel _efficiency,km/kWh,float,The distance battery electric vehicles (BEV) can travel in km per kWh of energy charge in battery. Base value comes from `Tesla Model S `_ bev_charge_rate,MWh,float,The power consumption for one electric vehicle (EV) in MWh. Value derived from 3-phase charger with 11 kW. -bev_avail_max,--,float,The maximum percentage plugged-in availability for passenger electric vehicles. -bev_avail_mean,--,float,The average percentage plugged-in availability for passenger electric vehicles. +bev_avail_max,--,float,The maximum share plugged-in availability for passenger electric vehicles. +bev_avail_mean,--,float,The average share plugged-in availability for passenger electric vehicles. v2g,--,"{true, false}",Allows feed-in to grid from EV battery -land_transport_fuel_cell_share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses fuel cells in a given year -land_transport_electric_share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses electric vehicles (EV) in a given year -land_transport_ice_share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses internal combustion engines (ICE) in a given year. What is not EV or FCEV is oil-fuelled ICE. -transport_fuel_cell_efficiency,--,float,The H2 conversion efficiencies of fuel cells in transport -transport_internal_combustion_efficiency,--,float,The oil conversion efficiencies of internal combustion engine (ICE) in transport -agriculture_machinery_electric_share,--,float,The percentage for agricultural machinery that uses electricity -agriculture_machinery_oil_share,--,float,The percentage for agricultural machinery that uses oil -agriculture_machinery_fuel_efficiency,--,float,The efficiency of electric-powered machinery in the conversion of electricity to meet agricultural needs. -agriculture_machinery_electric_efficiency,--,float,The efficiency of oil-powered machinery in the conversion of oil to meet agricultural needs. -MWh_MeOH_per_MWh_H2,LHV,float,"The energy amount of the produced methanol per energy amount of hydrogen. From `DECHEMA (2017) `_, page 64." +land_transport_fuel_cell _share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses fuel cells in a given year +land_transport_electric _share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses electric vehicles (EV) in a given year +land_transport_ice _share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses internal combustion engines (ICE) in a given year. What is not EV or FCEV is oil-fuelled ICE. +transport_fuel_cell _efficiency,--,float,The H2 conversion efficiencies of fuel cells in transport +transport_internal _combustion_efficiency,--,float,The oil conversion efficiencies of internal combustion engine (ICE) in transport +agriculture_machinery _electric_share,--,float,The share for agricultural machinery that uses electricity +agriculture_machinery _oil_share,--,float,The share for agricultural machinery that uses oil +agriculture_machinery _fuel_efficiency,--,float,The efficiency of electric-powered machinery in the conversion of electricity to meet agricultural needs. +agriculture_machinery _electric_efficiency,--,float,The efficiency of oil-powered machinery in the conversion of oil to meet agricultural needs. +Mwh_MeOH_per_MWh_H2,LHV,float,"The energy amount of the produced methanol per energy amount of hydrogen. From `DECHEMA (2017) `_, page 64." MWh_MeOH_per_tCO2,LHV,float,"The energy amount of the produced methanol per ton of CO2. From `DECHEMA (2017) `_, page 64." MWh_MeOH_per_MWh_e,LHV,float,"The energy amount of the produced methanol per energy amount of electricity. From `DECHEMA (2017) `_, page 64." -shipping_hydrogen_liquefaction,--,"{true, false}",Whether to include liquefaction costs for hydrogen demand in shipping. - +shipping_hydrogen _liquefaction,--,"{true, false}",Whether to include liquefaction costs for hydrogen demand in shipping. +,,, shipping_hydrogen_share,--,Dictionary with planning horizons as keys.,The share of ships powered by hydrogen in a given year shipping_methanol_share,--,Dictionary with planning horizons as keys.,The share of ships powered by methanol in a given year shipping_oil_share,--,Dictionary with planning horizons as keys.,The share of ships powered by oil in a given year -shipping_methanol_efficiency,--,float,"The efficiency of methanol-powered ships in the conversion of methanol to meet shipping needs (propulsion). The efficiency increase from oil can be 10-15% higher according to the `IEA `_" - +shipping_methanol _efficiency,--,float,The efficiency of methanol-powered ships in the conversion of methanol to meet shipping needs (propulsion). The efficiency increase from oil can be 10-15% higher according to the `IEA `_ +,,, shipping_oil_efficiency,--,float,The efficiency of oil-powered ships in the conversion of oil to meet shipping needs (propulsion). Base value derived from 2011 aviation_demand_factor,--,float,The proportion of demand for aviation compared to today's consumption HVC_demand_factor,--,float,The proportion of demand for high-value chemicals compared to today's consumption - +,,, time_dep_hp_cop,--,"{true, false}",Consider the time dependent coefficient of performance (COP) of the heat pump heat_pump_sink_T,°C,float,The temperature heat sink used in heat pumps based on DTU / large area radiators. The value is conservatively high to cover hot water and space heating in poorly-insulated buildings -reduce_space_heat_exogenously,--,"{true, false}",Influence on space heating demand by a certain factor (applied before losses in district heating). -reduce_space_heat_exogenously_factor,--,Dictionary with planning horizons as keys.,"A positive factor can mean renovation or demolition of a building. If the factor is negative, it can mean an increase in floor area, increased thermal comfort, population growth. The default factors are determined by the `Eurocalc Homes and buildings decarbonization scenario `_" +reduce_space_heat _exogenously,--,"{true, false}",Influence on space heating demand by a certain factor (applied before losses in district heating). +reduce_space_heat _exogenously_factor,--,Dictionary with planning horizons as keys.,"A positive factor can mean renovation or demolition of a building. If the factor is negative, it can mean an increase in floor area, increased thermal comfort, population growth. The default factors are determined by the `Eurocalc Homes and buildings decarbonization scenario `_" retrofitting,,, -- retro_endogen,--,"{true, false}",Add retrofitting as an endogenous system which co-optimise space heat savings. -- cost_factor,--,float,Weight costs for building renovation @@ -79,7 +79,7 @@ allam_cycle,--,"{true, false}",Add option to include `Allam cycle gas power plan hydrogen_fuel_cell,--,"{true, false}",Add option to include hydrogen fuel cell for re-electrification. Assuming OCGT technology costs hydrogen_turbine,--,"{true, false}",Add option to include hydrogen turbine for re-electrification. Assuming OCGT technology costs SMR,--,"{true, false}",Add option for transforming natural gas into hydrogen and CO2 using Steam Methane Reforming (SMR) -regional_co2_sequestration_potential,,, +regional_co2 _sequestration_potential,,, -- enable,--,"{true, false}",Add option for regionally-resolved geological carbon dioxide sequestration potentials based on `CO2StoP `_. -- attribute,--,string,Name of the attribute for the sequestration potential -- include_onshore,--,"{true, false}",Add options for including onshore sequestration potentials @@ -89,32 +89,32 @@ regional_co2_sequestration_potential,,, co2_sequestration_potential,MtCO2/a,float,The potential of sequestering CO2 in Europe per year co2_sequestration_cost,currency/tCO2,float,The cost of sequestering a ton of CO2 co2_spatial,--,"{true, false}","Add option to spatially resolve carrier representing stored carbon dioxide. This allows for more detailed modelling of CCUTS, e.g. regarding the capturing of industrial process emissions, usage as feedstock for electrofuels, transport of carbon dioxide, and geological sequestration sites." - +,,, co2network,--,"{true, false}",Add option for planning a new carbon dioxide transmission network - +,,, cc_fraction,--,float,The default fraction of CO2 captured with post-combustion capture -hydrogen_underground_storage,--,"{true, false}",Add options for storing hydrogen underground. Storage potential depends regionally. -hydrogen_underground_storage_locations,,"{onshore, nearshore, offshore}","The location where hydrogen underground storage can be located. Onshore, nearshore, offshore means it must be located more than 50 km away from the sea, within 50 km of the sea, or within the sea itself respectively." - +hydrogen_underground _storage,--,"{true, false}",Add options for storing hydrogen underground. Storage potential depends regionally. +hydrogen_underground _storage_locations,,"{onshore, nearshore, offshore}","The location where hydrogen underground storage can be located. Onshore, nearshore, offshore means it must be located more than 50 km away from the sea, within 50 km of the sea, or within the sea itself respectively." +,,, ammonia,--,"{true, false, regional}","Add ammonia as a carrrier. It can be either true (copperplated NH3), false (no NH3 carrier) or ""regional"" (regionalised NH3 without network)" -min_part_load_fischer_tropsch,per unit of p_nom ,float,The minimum unit dispatch (``p_min_pu``) for the Fischer-Tropsch process -min_part_load_methanolisation,per unit of p_nom ,float,The minimum unit dispatch (``p_min_pu``) for the methanolisation process - -use_fischer_tropsch_waste_heat,--,"{true, false}",Add option for using waste heat of Fischer Tropsch in district heating networks +min_part_load_fischer _tropsch,per unit of p_nom ,float,The minimum unit dispatch (``p_min_pu``) for the Fischer-Tropsch process +min_part_load _methanolisation,per unit of p_nom ,float,The minimum unit dispatch (``p_min_pu``) for the methanolisation process +,,, +use_fischer_tropsch _waste_heat,--,"{true, false}",Add option for using waste heat of Fischer Tropsch in district heating networks use_fuel_cell_waste_heat,--,"{true, false}",Add option for using waste heat of fuel cells in district heating networks -use_electrolysis_waste_heat,--,"{true, false}",Add option for using waste heat of electrolysis in district heating networks -electricity_distribution_grid,--,"{true, false}",Add a simplified representation of the exchange capacity between transmission and distribution grid level through a link. -electricity_distribution_grid_cost_factor,,,Multiplies the investment cost of the electricity distribution grid - -electricity_grid_connection,--,"{true, false}",Add the cost of electricity grid connection for onshore wind and solar +use_electrolysis_waste _heat,--,"{true, false}",Add option for using waste heat of electrolysis in district heating networks +electricity_distribution _grid,--,"{true, false}",Add a simplified representation of the exchange capacity between transmission and distribution grid level through a link. +electricity_distribution _grid_cost_factor,,,Multiplies the investment cost of the electricity distribution grid +,,, +electricity_grid _connection,--,"{true, false}",Add the cost of electricity grid connection for onshore wind and solar H2_network,--,"{true, false}",Add option for new hydrogen pipelines gas_network,--,"{true, false}","Add existing natural gas infrastructure, incl. LNG terminals, production and entry-points. The existing gas network is added with a lossless transport model. A length-weighted `k-edge augmentation algorithm `_ can be run to add new candidate gas pipelines such that all regions of the model can be connected to the gas network. When activated, all the gas demands are regionally disaggregated as well." -H2_retrofit,--,"{true, false}","Add option for retrofiting existing pipelines to transport hydrogen. " -H2_retrofit_capacity_per_CH4,--,float,"The ratio for H2 capacity per original CH4 capacity of retrofitted pipelines. The `European Hydrogen Backbone (April, 2020) p.15 `_ 60% of original natural gas capacity could be used in cost-optimal case as H2 capacity." -gas_network_connectivity_upgrade ,--,float,The number of desired edge connectivity (k) in the length-weighted `k-edge augmentation algorithm `_ used for the gas network +H2_retrofit,--,"{true, false}",Add option for retrofiting existing pipelines to transport hydrogen. +H2_retrofit_capacity _per_CH4,--,float,"The ratio for H2 capacity per original CH4 capacity of retrofitted pipelines. The `European Hydrogen Backbone (April, 2020) p.15 `_ 60% of original natural gas capacity could be used in cost-optimal case as H2 capacity." +gas_network_connectivity _upgrade ,--,float,The number of desired edge connectivity (k) in the length-weighted `k-edge augmentation algorithm `_ used for the gas network gas_distribution_grid,--,"{true, false}",Add a gas distribution grid -gas_distribution_grid_cost_factor,,,Multiplier for the investment cost of the gas distribution grid - +gas_distribution_grid _cost_factor,,,Multiplier for the investment cost of the gas distribution grid +,,, biomass_spatial,--,"{true, false}",Add option for resolving biomass demand regionally biomass_transport,--,"{true, false}",Add option for transporting solid biomass between nodes conventional_generation,,,Add a more detailed description of conventional carriers. Any power generation requires the consumption of fuel from nodes representing that fuel. diff --git a/doc/configuration.rst b/doc/configuration.rst index 0b2669f65..8f15faa70 100644 --- a/doc/configuration.rst +++ b/doc/configuration.rst @@ -24,7 +24,7 @@ Top-level configuration .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/toplevel.csv .. _run_cf: @@ -45,7 +45,7 @@ The ``run`` section is used for running and storing scenarios with different con .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/run.csv .. _foresight_cf: @@ -60,7 +60,7 @@ The ``run`` section is used for running and storing scenarios with different con .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/foresight.csv .. note:: @@ -105,7 +105,7 @@ An exemplary dependency graph (starting from the simplification rules) then look .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/scenario.csv .. _countries: @@ -120,7 +120,7 @@ An exemplary dependency graph (starting from the simplification rules) then look .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/countries.csv .. _snapshots_cf: @@ -137,7 +137,7 @@ Specifies the temporal range to build an energy system model for as arguments to .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/snapshots.csv .. _enable_cf: @@ -154,7 +154,7 @@ Switches for some rules and optional features. .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/enable.csv .. _CO2_budget_cf: @@ -169,7 +169,7 @@ Switches for some rules and optional features. .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/co2_budget.csv .. note:: @@ -188,7 +188,7 @@ Switches for some rules and optional features. .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/electricity.csv .. _atlite_cf: @@ -205,7 +205,7 @@ Define and specify the ``atlite.Cutout`` used for calculating renewable potentia .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/atlite.csv .. _renewable_cf: @@ -223,7 +223,7 @@ Define and specify the ``atlite.Cutout`` used for calculating renewable potentia .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/onwind.csv .. note:: @@ -245,7 +245,7 @@ Define and specify the ``atlite.Cutout`` used for calculating renewable potentia .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/offwind-ac.csv .. note:: @@ -268,7 +268,7 @@ Define and specify the ``atlite.Cutout`` used for calculating renewable potentia .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/offwind-dc.csv .. note:: @@ -285,7 +285,7 @@ Define and specify the ``atlite.Cutout`` used for calculating renewable potentia .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/solar.csv .. note:: @@ -307,7 +307,7 @@ Define and specify the ``atlite.Cutout`` used for calculating renewable potentia .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/hydro.csv .. _lines_cf: @@ -329,7 +329,7 @@ overwrite the existing values. .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/conventional.csv ``lines`` @@ -342,7 +342,7 @@ overwrite the existing values. .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/lines.csv .. _links_cf: @@ -357,7 +357,7 @@ overwrite the existing values. .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/links.csv .. _transformers_cf: @@ -372,7 +372,7 @@ overwrite the existing values. .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/transformers.csv .. _load_cf: @@ -387,7 +387,7 @@ overwrite the existing values. .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/load.csv .. _energy_cf: @@ -405,7 +405,7 @@ overwrite the existing values. .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/energy.csv .. _biomass_cf: @@ -423,7 +423,7 @@ overwrite the existing values. .. csv-table:: :header-rows: 1 - :widths: 25,7,22,30 + :widths: 22,7,22,33 :file: configtables/biomass.csv The list of available biomass is given by the category in `ENSPRESO_BIOMASS `_, namely: @@ -461,7 +461,7 @@ The list of available biomass is given by the category in `ENSPRESO_BIOMASS Date: Fri, 14 Jul 2023 10:26:07 +0000 Subject: [PATCH 18/18] [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --- doc/configtables/sector.csv | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/configtables/sector.csv b/doc/configtables/sector.csv index 36b7dd987..d610c8626 100644 --- a/doc/configtables/sector.csv +++ b/doc/configtables/sector.csv @@ -109,7 +109,7 @@ electricity_distribution _grid_cost_factor,,,Multiplies the investment cost of t electricity_grid _connection,--,"{true, false}",Add the cost of electricity grid connection for onshore wind and solar H2_network,--,"{true, false}",Add option for new hydrogen pipelines gas_network,--,"{true, false}","Add existing natural gas infrastructure, incl. LNG terminals, production and entry-points. The existing gas network is added with a lossless transport model. A length-weighted `k-edge augmentation algorithm `_ can be run to add new candidate gas pipelines such that all regions of the model can be connected to the gas network. When activated, all the gas demands are regionally disaggregated as well." -H2_retrofit,--,"{true, false}",Add option for retrofiting existing pipelines to transport hydrogen. +H2_retrofit,--,"{true, false}",Add option for retrofiting existing pipelines to transport hydrogen. H2_retrofit_capacity _per_CH4,--,float,"The ratio for H2 capacity per original CH4 capacity of retrofitted pipelines. The `European Hydrogen Backbone (April, 2020) p.15 `_ 60% of original natural gas capacity could be used in cost-optimal case as H2 capacity." gas_network_connectivity _upgrade ,--,float,The number of desired edge connectivity (k) in the length-weighted `k-edge augmentation algorithm `_ used for the gas network gas_distribution_grid,--,"{true, false}",Add a gas distribution grid