finalized config documentation

2023-07-05 01:51:50 +02:00 · 2023-07-05 01:51:50 +02:00 · 55add4c785
commit 55add4c785
parent 9138901e5d
6 changed files with 197 additions and 215 deletions
--- 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
+# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#scenario
-# Wildcard docs in
+# 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 <years>'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
+# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration.html#existing-capacities
 # only relevant for foresight = myopic or perfect
 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
+    potential: 0.6 
     # 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
    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
+  cluster_heat_buses: false
-  bev_dsm_restriction_value: 0.75  #Set to 0 for no restriction on BEV DSM
+  bev_dsm_restriction_value: 0.75
-  bev_dsm_restriction_time: 7  #Time at which SOC of BEV has to be dsm_restriction_value
+  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_dsm: true
-  bev_availability: 0.5  #How many cars do smart charging
+  bev_availability: 0.5
-  bev_energy: 0.05  #average battery size in MWh
+  bev_energy: 0.05
-  bev_charge_efficiency: 0.9  #BEV (dis-)charging efficiency
+  bev_charge_efficiency: 0.9
-  bev_plug_to_wheel_efficiency: 0.2 #kWh/km from EPA https://www.fueleconomy.gov/feg/ for Tesla Model S
+  bev_plug_to_wheel_efficiency: 0.2
-  bev_charge_rate: 0.011 #3-phase charger with 11 kW
+  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
+  v2g: true
  #what is not EV or FCEV is oil-fuelled ICE
  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_fuel_efficiency: 0.7
-  agriculture_machinery_electric_efficiency: 0.3 # electricity per use
+  agriculture_machinery_electric_efficiency: 0.3
-  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_MWh_H2: 0.8787
-  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_tCO2: 4.0321
-  MWh_MeOH_per_MWh_e: 3.6907 # in LHV, source: DECHEMA (2017): Low carbon energy and feedstock for the European chemical industry , pg. 64.
+  MWh_MeOH_per_MWh_e: 3.6907
-  shipping_hydrogen_liquefaction: false # whether to consider liquefaction costs for shipping H2 demands
+  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_methanol_efficiency: 0.46
-  shipping_oil_efficiency: 0.40 #For conversion of fuel oil to propulsion in 2011
+  shipping_oil_efficiency: 0.40
-  aviation_demand_factor: 1. # relative aviation demand compared to today
+  aviation_demand_factor: 1.
-  HVC_demand_factor: 1. # relative HVC demand compared to today
+  HVC_demand_factor: 1.
-  time_dep_hp_cop: true #time dependent heat pump coefficient of performance
+  time_dep_hp_cop: true
-  heat_pump_sink_T: 55. # Celsius, based on DTU / large area radiators; used in build_cop_profiles.py
+  heat_pump_sink_T: 55.
-   # conservatively high to cover hot water and space heating in poorly-insulated buildings
+  reduce_space_heat_exogenously: true
-  reduce_space_heat_exogenously: true  # reduces space heat demand by a given factor (applied before losses in DH)
+  reduce_space_heat_exogenously_factor:
  # 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
    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
+  retrofitting:
-    retro_endogen: false  # co-optimise space heat savings
+    retro_endogen: false
-    cost_factor: 1.0   # weight costs for building renovation
+    cost_factor: 1.0
-    interest_rate: 0.04  # for investment in building components
+    interest_rate: 0.04
-    annualise_cost: true  # annualise the investment costs
+    annualise_cost: true
-    tax_weighting: false   # weight costs depending on taxes in countries
+    tax_weighting: false
-    construction_index: true   # weight costs depending on labour/material costs per country
+    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
+    include_onshore: false 
-    min_size: 3 # Gt, sites with lower potential will be excluded
+    min_size: 3
-    max_size: 25 # Gt, max sequestration potential for any one site, TODO research suitable value
+    max_size: 25
-    years_of_storage: 25 # years until potential exhausted at optimised annual rate
+    years_of_storage: 25
-  co2_sequestration_potential: 200  #MtCO2/a sequestration potential for Europe
+  co2_sequestration_potential: 200
-  co2_sequestration_cost: 10   #EUR/tCO2 for sequestration of CO2
+  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)
+  ammonia: false
-  min_part_load_fischer_tropsch: 0.9 # p_min_pu
+  min_part_load_fischer_tropsch: 0.9
-  min_part_load_methanolisation: 0.5 # p_min_pu
+  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_distribution_grid_cost_factor: 1.0 
-  electricity_grid_connection: true  # only applies to onshore wind and utility PV
+  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
+  H2_retrofit: false
-  # according to hydrogen backbone strategy (April, 2020) p.15
+  H2_retrofit_capacity_per_CH4: 0.6 
-  # https://gasforclimate2050.eu/wp-content/uploads/2020/07/2020_European-Hydrogen-Backbone_Report.pdf
+  gas_network_connectivity_upgrade: 1
  # 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
  gas_distribution_grid: true
-  gas_distribution_grid_cost_factor: 1.0  #multiplies cost in data/costs.csv
+  gas_distribution_grid_cost_factor: 1.0
-  biomass_spatial: false  # regionally resolve biomass (e.g. potentials)
+  biomass_spatial: false
-  biomass_transport: false  # allow transport of solid biomass between nodes
+  biomass_transport: false
-  conventional_generation: # generator : carrier
+  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
+  H2_DRI: 1.7 
-  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
+  elec_DRI: 0.322
-  Al_primary_fraction:  # fraction of aluminium produced via the primary route versus scrap; today fraction is 0.4
+  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_NH3_per_tNH3: 5.166
-  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_CH4_per_tNH3_SMR: 10.8
-  MWh_elec_per_tNH3_SMR: 0.7 # same source, assuming 94-6% split methane-elec of total energy demand 11.5 MWh/tNH3
+  MWh_elec_per_tNH3_SMR: 0.7
-  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_H2_per_tNH3_electrolysis: 6.5
-  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_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
+  NH3_process_emissions: 24.5
-  petrochemical_process_emissions: 25.5 # in MtCO2/a for petrochemical and other from UNFCCC for 2015 for EU28
+  petrochemical_process_emissions: 25.5
-  HVC_primary_fraction: 1. # fraction of today's HVC produced via primary route
+  HVC_primary_fraction: 1.
-  HVC_mechanical_recycling_fraction: 0. # fraction of today's HVC produced via mechanical recycling
+  HVC_mechanical_recycling_fraction: 0.
-  HVC_chemical_recycling_fraction: 0. # fraction of today's HVC produced via chemical recycling
+  HVC_chemical_recycling_fraction: 0.
-  HVC_production_today: 52. # MtHVC/a from DECHEMA (2017), Figure 16, page 107; includes ethylene, propylene and BTX
+  HVC_production_today: 52.
-  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_mechanical_recycling: 0.547
-  MWh_elec_per_tHVC_chemical_recycling: 6.9 # Material Economics (2019), page 125; based on pyrolysis and electric steam cracking
+  MWh_elec_per_tHVC_chemical_recycling: 6.9
-  chlorine_production_today: 9.58 # MtCl/a from DECHEMA (2017), Table 7, page 43
+  chlorine_production_today: 9.58
-  MWh_elec_per_tCl: 3.6 # DECHEMA (2017), Table 6, page 43
+  MWh_elec_per_tCl: 3.6
-  MWh_H2_per_tCl: -0.9372  # DECHEMA (2017), page 43; negative since hydrogen produced in chloralkali process
+  MWh_H2_per_tCl: -0.9372
-  methanol_production_today: 1.5 # MtMeOH/a from DECHEMA (2017), page 62
+  methanol_production_today: 1.5
-  MWh_elec_per_tMeOH: 0.167 # DECHEMA (2017), Table 14, page 65
+  MWh_elec_per_tMeOH: 0.167
-  MWh_CH4_per_tMeOH: 10.25 # DECHEMA (2017), Table 14, page 65
+  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]
--- a/doc/configtables/.~lock.sector.csv#
+++ 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;
--- a/doc/configtables/electricity.csv
+++ b/doc/configtables/electricity.csv
@ -1,29 +1,29 @@
-,Unit,Values,Description
+,Unit,Values,Description
-voltages,kV,"Any subset of {220., 300., 380.}",Voltage levels to consider
+voltages,kV,"Any subset of {220., 300., 380.}",Voltage levels to consider
-gaslimit,MWhth,"float or false",Global gas usage limit
+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
+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.
+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``.
+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 <https://genxproject.github.io/GenX/dev/core/#Reserves>`_"
+operational_reserve,,,Settings for reserve requirements following like `GenX <https://genxproject.github.io/GenX/dev/core/#Reserves>`_
-- activate,bool,"true or false","Whether to take operational reserve requirements into account during optimisation"
+-- activate,bool,true or false,Whether to take operational reserve requirements into account during optimisation
-- epsilon_load,--,float,share of total load
+-- epsilon_load,--,float,share of total load
-- epsilon_vres,--,float,share of total renewable supply
+-- epsilon_vres,--,float,share of total renewable supply
-- contingency,MW,float,fixed reserve capacity
+-- contingency,MW,float,fixed reserve capacity
-max_hours,,,
+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 <https://pypsa.readthedocs.io/en/latest/components.html#storage-unit>`_.
+-- battery,h,float,Maximum state of charge capacity of the battery in terms of hours at full output capacity ``p_nom``. Cf. `PyPSA documentation <https://pypsa.readthedocs.io/en/latest/components.html#storage-unit>`_.
-- 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 <https://pypsa.readthedocs.io/en/latest/components.html#storage-unit>`_.
+-- 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 <https://pypsa.readthedocs.io/en/latest/components.html#storage-unit>`_.
-extendable_carriers,,,
+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."
+-- 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.
+-- 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.
+-- 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``.
+-- 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 <https://pandas.pydata.org/pandas-docs/stable/reference/api/pandas.DataFrame.query.html>`_ strings here, e.g. Country not in ['Germany']",Filter query for the default powerplant database.
+powerplants_filter,--,"use `pandas.query <https://pandas.pydata.org/pandas-docs/stable/reference/api/pandas.DataFrame.query.html>`_ strings here, e.g. Country not in ['Germany']",Filter query for the default powerplant database.
-custom_powerplants,--,"use `pandas.query <https://pandas.pydata.org/pandas-docs/stable/reference/api/pandas.DataFrame.query.html>`_ strings here, e.g. Country in ['Germany']",Filter query for the custom powerplant database.
+custom_powerplants,--,"use `pandas.query <https://pandas.pydata.org/pandas-docs/stable/reference/api/pandas.DataFrame.query.html>`_ 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."
+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.
+renewable_carriers,--,"Any subset of {solar, onwind, offwind-ac, offwind-dc, hydro}",List of renewable generators to include in the model.
-estimate_renewable_capacities,,,
+estimate_renewable_capacities,,,
-- enable,,bool,"Activate routine to estimate renewable capacities"
+-- enable,,bool,Activate routine to estimate renewable capacities
-- from_opsd,--,bool,"Add capacities from OPSD data"
+-- from_opsd,--,bool,Add capacities from OPSD data
-- year,--,bool,"Renewable capacities are based on existing capacities reported by IRENA for the specified year"
+-- 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 <years>'s capacities => expansion_limit: 1.1 false: Use estimated renewable potentials determine by the workflow"
+-- 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 powerplantmatching and PyPSA-Eur technology names
--- 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
+H2_DRI,--,float,The hydrogen consumption in Direct Reduced Iron (DRI)  Mwh_H2 LHV/ton_Steel from 51kgH2/tSt in `Vogl et al (2018) <https://doi.org/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
+elec_DRI,MWh/tSt,float,The electricity consumed in Direct Reduced Iron (DRI) shaft. From `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
+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) <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_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) <https://doi.org/10.1016/j.joule.2018.04.017>`_, 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 https://doi.org/10.1016/j.joule.2018.04.017 Table 13 (air separation and HB)
+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) <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
+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)
+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
+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
+HVC_production_today,MtHVC/a,float,"The amount of high value chemicals (HVC) produced. This includes ethylene, propylene and BTX. From `DECHEMA (2017) <https://dechema.de/dechema_media/Downloads/Positionspapiere/Technology_study_Low_carbon_energy_and_feedstock_for_the_European_chemical_industry-p-20002750.pdf>`_, Figure 16, page 107"
-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_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) <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,--,float,The energy amount of electricity needed to produce a ton of high value chemical (HVC) using chemical recycling
+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) <https://materialeconomics.com/latest-updates/industrial-transformation-2050>`_, page 125"
-chlorine_production_today,MtCl/a,float,The amount of chlorine produced
+chlorine_production_today,MtCl/a,float,"The amount of chlorine produced. From `DECHEMA (2017) <https://dechema.de/dechema_media/Downloads/Positionspapiere/Technology_study_Low_carbon_energy_and_feedstock_for_the_European_chemical_industry-p-20002750.pdf>`_, Table 7, page 43"
-MWh_elec_per_tCl,--,float,The energy amount of electricity needed to produce a ton of chlorine
+MWh_elec_per_tCl,MWh/tCl,float,"The energy amount of electricity needed to produce a ton of chlorine. From `DECHEMA (2017) <https://dechema.de/dechema_media/Downloads/Positionspapiere/Technology_study_Low_carbon_energy_and_feedstock_for_the_European_chemical_industry-p-20002750.pdf>`_, Table 6 page 43"
-MWh_H2_per_tCl,--,float,The energy amount of hydrogen needed to produce a ton of chlorine
+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) <https://dechema.de/dechema_media/Downloads/Positionspapiere/Technology_study_Low_carbon_energy_and_feedstock_for_the_European_chemical_industry-p-20002750.pdf>`_, page 43"
-methanol_production_today,MtMeOH/a,float,The amount of methanol produced
+methanol_production_today,MtMeOH/a,float,"The amount of methanol produced. From `DECHEMA (2017) <https://dechema.de/dechema_media/Downloads/Positionspapiere/Technology_study_Low_carbon_energy_and_feedstock_for_the_European_chemical_industry-p-20002750.pdf>`_, page 62"
-MWh_elec_per_tMeOH,--,float,The energy amount of electricity needed to produce a ton of methanol
+MWh_elec_per_tMeOH,MWh/tMeOH,float,"The energy amount of electricity needed to produce a ton of methanol. From `DECHEMA (2017) <https://dechema.de/dechema_media/Downloads/Positionspapiere/Technology_study_Low_carbon_energy_and_feedstock_for_the_European_chemical_industry-p-20002750.pdf>`_, Table 14, page 65"
-MWh_CH4_per_tMeOH,--,float,The energy amount of methane needed to produce a ton of methanol
+MWh_CH4_per_tMeOH,MWhCH4/tMeOH,float,"The energy amount of methane needed to produce a ton of methanol. From `DECHEMA (2017) <https://dechema.de/dechema_media/Downloads/Positionspapiere/Technology_study_Low_carbon_energy_and_feedstock_for_the_European_chemical_industry-p-20002750.pdf>`_, Table 14, page 65"
-hotmaps_locate_missing,--,true or false,Locate industrial sites without valid locations based on city and countries.
+hotmaps_locate_missing,--,"{true,false}",Locate industrial sites without valid locations based on city and countries.
-reference_year,--,year,
+reference_year,year,YYYY,The year used as the baseline for industrial energy demand and production. Data extracted from `JRC-IDEES 2015 <https://data.jrc.ec.europa.eu/dataset/jrc-10110-10001>`_
--- a/doc/configtables/sector.csv
+++ b/doc/configtables/sector.csv
@ -2,9 +2,9 @@
 district_heating,--,,`prepare_sector_network.py <https://github.com/PyPSA/pypsa-eur-sec/blob/master/scripts/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 <https://github.com/PyPSA/pypsa-eur-sec/blob/master/scripts/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 <https://github.com/PyPSA/pypsa-eur-sec/blob/master/scripts/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 <https://github.com/PyPSA/pypsa-eur-sec/blob/master/scripts/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 <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, 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_MWh_H2,LHV,float,"The energy amount of the produced methanol per energy amount of hydrogen. From `DECHEMA (2017) <https://dechema.de/dechema_media/Downloads/Positionspapiere/Technology_study_Low_carbon_energy_and_feedstock_for_the_European_chemical_industry-p-20002750.pdf>`_, page 64."
-MWh_MeOH_per_tCO2,LHV,float,The energy amount of the produced methanol per ton of CO2
+MWh_MeOH_per_tCO2,LHV,float,"The energy amount of the produced methanol per ton of CO2. From `DECHEMA (2017) <https://dechema.de/dechema_media/Downloads/Positionspapiere/Technology_study_Low_carbon_energy_and_feedstock_for_the_European_chemical_industry-p-20002750.pdf>`_, page 64."
-MWh_MeOH_per_MWh_e,LHV,float,The energy amount of the produced methanol per energy amount of electricity
+MWh_MeOH_per_MWh_e,LHV,float,"The energy amount of the produced methanol per energy amount of electricity. From `DECHEMA (2017) <https://dechema.de/dechema_media/Downloads/Positionspapiere/Technology_study_Low_carbon_energy_and_feedstock_for_the_European_chemical_industry-p-20002750.pdf>`_, 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_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 <https://www.iea-amf.org/app/webroot/files/file/Annex%20Reports/AMF_Annex_56.pdf>`_,"
-shipping_oil_efficiency,--,float,The efficiency of oil-powered ships in the conversion of oil to meet shipping needs.
+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}",
+time_dep_hp_cop,--,"{true, false}",Consider the time dependent coefficient of performance (COP) of the heat pump
-heat_pump_sink_T,°C,float,
+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}",
+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.,
+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 <http://tool.european-calculator.eu/app/buildings/building-types-area/?levers=1ddd4444421213bdbbbddd44444ffffff11f411111221111211l212221>`_"
 retrofitting,,,
 -- retro_endogen,--,"{true, false}",Add retrofitting as an endogenous system which co-optimise space heat savings.
-- cost_factor,,,Weight costs for building renovation
+-- cost_factor,--,float,Weight costs for building renovation
-- interest_rate,,,The interest rate for investment in building components
+-- 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,,,
+tes_tau,,,The time constant used to calculate the decay of thermal energy in thermal energy storage (TES): 1- :math:`e^{-1/24τ}`.
-- decentral,,,
+-- decentral,days,float,The time constant in decentralized thermal energy storage (TES)
-- central,,,
+-- 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_thermal,--,"{true, false}",Add option for using solar thermal to generate heat.
-solar_cf_correction,,,
+solar_cf_correction,--,float,The correction factor for the value provided by the solar thermal profile calculations
-marginal_cost_storage,,,
+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 <https://setis.ec.europa.eu/european-co2-storage-database_en>`_.
-- attribute,,,
+-- attribute,--,string,Name of the attribute for the sequestration potential
-- include_onshore,,"{true, 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
+-- min_size,Gt ,float,Any sites with lower potential than this value will be excluded
-- max_size,,float,The maximum sequestration potential for any one site.
+-- max_size,Gt ,float,The maximum sequestration potential for any one site.
-- years_of_storage,,float,The years until potential exhausted at optimised annual rate
+-- 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)"
+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,,,
+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,,,
+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"
+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   <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>`_   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. The reasoning is in accordance with the `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,,,
+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 <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>`_ 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
--- 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 <htt
 =======================
 .. note::
-   Only used for sector-coupling studies. The value for grouping years are only used in myopic scenarios.
+   Only used for sector-coupling studies. The value for grouping years are only used in myopic or perfect scenarios.
 .. literalinclude:: ../config/config.default.yaml
   :language: yaml
@ -508,9 +511,6 @@ The list of available biomass is given by the category in `ENSPRESO_BIOMASS <htt
 .. 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: industry:
		`@ -0,0 +1 @@`
							`,DESKTOP-2RNCH2B/kunde,,05.07.2023 01:09,file:///C:/Users/kunde/AppData/Roaming/LibreOffice/4;`