bjoern/pypsa-eur
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

Merge pull request #1187 from PyPSA/nofossil

Browse Source 
Nofossil
This commit is contained in:
lisazeyen 2024-08-02 09:17:26 +02:00 committed by GitHub
commit 89d28ed06e
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
4 changed files with 171 additions and 164 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
config/config.default.yaml
View File

@ -397,6 +397,7 @@ sector:
biomass: true biomass: true
industry: true industry: true
agriculture: true agriculture: true
fossil_fuels: true
district_heating: district_heating:
potential: 0.6 potential: 0.6
progress: progress:

311
doc/configtables/sector.csv
View File

@ -1,155 +1,156 @@
,Unit,Values,Description ,Unit,Values,Description
transport,--,"{true, false}",Flag to include transport sector. transport,--,"{true, false}",Flag to include transport sector.
heating,--,"{true, false}",Flag to include heating sector. heating,--,"{true, false}",Flag to include heating sector.
biomass,--,"{true, false}",Flag to include biomass sector. biomass,--,"{true, false}",Flag to include biomass sector.
industry,--,"{true, false}",Flag to include industry sector. industry,--,"{true, false}",Flag to include industry sector.
agriculture,--,"{true, false}",Flag to include agriculture sector. agriculture,--,"{true, false}",Flag to include agriculture sector.
district_heating,--,,`prepare_sector_network.py <https://github.com/PyPSA/pypsa-eur-sec/blob/master/scripts/prepare_sector_network.py>`_ fossil_fuels,--,"{true, false}","Flag to include imports of fossil fuels ( [""coal"", ""gas"", ""oil"", ""lignite""])"
-- potential,--,float,maximum fraction of urban demand which can be supplied by district heating. Ignored where below current fraction. district_heating,--,,`prepare_sector_network.py <https://github.com/PyPSA/pypsa-eur-sec/blob/master/scripts/prepare_sector_network.py>`_
-- 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 -- potential,--,float,maximum fraction of urban demand which can be supplied by district heating. Ignored where below current fraction.
-- district_heating_loss,--,float,Share increase in district heat demand in urban central due to heat losses -- 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
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. -- 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 <https://github.com/PyPSA/pypsa-eur-sec/blob/master/scripts/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 <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 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 <https://github.com/PyPSA/pypsa-eur-sec/blob/master/scripts/build_transport_demand.py>`_. Set to 0 for no restriction on BEV DSM
transport_heating _deadband_upper,°C,float,"The maximum temperature in the vehicle. At higher temperatures, the energy required for cooling in the vehicle increases." bev_dsm_restriction _time,--,float,Time at which SOC of BEV has to be dsm_restriction_value
transport_heating _deadband_lower,°C,float,"The minimum temperature in the vehicle. At lower temperatures, the energy required for heating 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,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. 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.
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. 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_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. 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.
bev_dsm,--,"{true, false}",Add the option for battery electric vehicles (BEV) to participate in demand-side management (DSM) 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 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_availability,--,float,The share for battery electric vehicles (BEV) that are able to do demand side management (DSM)
bev_charge_efficiency,--,float,Battery electric vehicles (BEV) charge and discharge efficiency bev_energy,--,float,The average size of battery electric vehicles (BEV) in MWh
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_charge_efficiency,--,float,Battery electric vehicles (BEV) charge and discharge efficiency
bev_avail_max,--,float,The maximum share plugged-in availability for passenger 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_mean,--,float,The average share plugged-in availability for passenger electric vehicles. bev_avail_max,--,float,The maximum share plugged-in availability for passenger electric vehicles.
v2g,--,"{true, false}",Allows feed-in to grid from EV battery bev_avail_mean,--,float,The average share plugged-in availability for passenger electric vehicles.
land_transport_fuel_cell _share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses fuel cells in a given year v2g,--,"{true, false}",Allows feed-in to grid from EV battery
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_fuel_cell _share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses fuel cells 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. land_transport_electric _share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses electric vehicles (EV) in a given year
transport_electric_efficiency,MWh/100km,float,The conversion efficiencies of electric vehicles in transport 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,MWh/100km,float,The H2 conversion efficiencies of fuel cells in transport transport_electric_efficiency,MWh/100km,float,The conversion efficiencies of electric vehicles in transport
transport_ice_efficiency,MWh/100km,float,The oil conversion efficiencies of internal combustion engine (ICE) in transport transport_fuel_cell_efficiency,MWh/100km,float,The H2 conversion efficiencies of fuel cells in transport
agriculture_machinery _electric_share,--,float,The share for agricultural machinery that uses electricity transport_ice_efficiency,MWh/100km,float,The oil conversion efficiencies of internal combustion engine (ICE) in transport
agriculture_machinery _oil_share,--,float,The share for agricultural machinery that uses oil agriculture_machinery _electric_share,--,float,The share for agricultural machinery that uses electricity
agriculture_machinery _fuel_efficiency,--,float,The efficiency of electric-powered machinery in the conversion of electricity to meet agricultural needs. agriculture_machinery _oil_share,--,float,The share for agricultural machinery that uses oil
agriculture_machinery _electric_efficiency,--,float,The efficiency of oil-powered machinery in the conversion of oil to meet agricultural needs. agriculture_machinery _fuel_efficiency,--,float,The efficiency of electric-powered machinery in the conversion of electricity 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) <https://dechema.de/dechema_media/Downloads/Positionspapiere/Technology_study_Low_carbon_energy_and_feedstock_for_the_European_chemical_industry-p-20002750.pdf>`_, page 64." agriculture_machinery _electric_efficiency,--,float,The efficiency of oil-powered machinery in the conversion of oil to meet agricultural needs.
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 66." 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_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." 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 66."
shipping_hydrogen _liquefaction,--,"{true, false}",Whether to include liquefaction costs for hydrogen demand in shipping. 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}",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_hydrogen_share,--,Dictionary with planning horizons as keys.,The share of ships powered by hydrogen 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_share,--,Dictionary with planning horizons as keys.,The share of ships powered by methanol 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 <https://www.iea-amf.org/app/webroot/files/file/Annex%20Reports/AMF_Annex_56.pdf>`_ 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 <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 (propulsion). Base value derived from 2011 ,,,
aviation_demand_factor,--,float,The proportion of demand for aviation compared to today's consumption 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
HVC_demand_factor,--,float,The proportion of demand for high-value chemicals compared to today's consumption 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 time_dep_hp_cop,--,"{true, false}",Consider the time dependent coefficient of performance (COP) of the heat pump
reduce_space_heat _exogenously,--,"{true, false}",Influence on space heating demand by a certain factor (applied before losses in district heating). 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_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>`_" reduce_space_heat _exogenously,--,"{true, false}",Influence on space heating demand by a certain factor (applied before losses in district heating).
retrofitting,,, 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>`_"
-- retro_endogen,--,"{true, false}",Add retrofitting as an endogenous system which co-optimise space heat savings. retrofitting,,,
-- cost_factor,--,float,Weight costs for building renovation -- retro_endogen,--,"{true, false}",Add retrofitting as an endogenous system which co-optimise space heat savings.
-- interest_rate,--,float,The interest rate for investment in building components -- cost_factor,--,float,Weight costs for building renovation
-- annualise_cost,--,"{true, false}",Annualise the investment costs of retrofitting -- interest_rate,--,float,The interest rate for investment in building components
-- tax_weighting,--,"{true, false}",Weight the costs of retrofitting depending on taxes in countries -- annualise_cost,--,"{true, false}",Annualise the investment costs of retrofitting
-- construction_index,--,"{true, false}",Weight the costs of retrofitting depending on labour/material costs per country -- tax_weighting,--,"{true, false}",Weight the costs of retrofitting depending on taxes in countries
tes,--,"{true, false}",Add option for storing thermal energy in large water pits associated with district heating systems and individual thermal energy storage (TES) -- construction_index,--,"{true, false}",Weight the costs of retrofitting depending on labour/material costs per country
tes_tau,,,The time constant used to calculate the decay of thermal energy in thermal energy storage (TES): 1- :math:`e^{-1/24τ}`. tes,--,"{true, false}",Add option for storing thermal energy in large water pits associated with district heating systems and individual thermal energy storage (TES)
-- decentral,days,float,The time constant in decentralized thermal energy storage (TES) tes_tau,,,The time constant used to calculate the decay of thermal energy in thermal energy storage (TES): 1- :math:`e^{-1/24τ}`.
-- central,days,float,The time constant in centralized thermal energy storage (TES) -- decentral,days,float,The time constant in decentralized thermal energy storage (TES)
boilers,--,"{true, false}",Add option for transforming gas into heat using gas boilers -- central,days,float,The time constant in centralized thermal energy storage (TES)
resistive_heaters,--,"{true, false}",Add option for transforming electricity into heat using resistive heaters (independently from gas boilers) boilers,--,"{true, false}",Add option for transforming gas into heat using gas boilers
oil_boilers,--,"{true, false}",Add option for transforming oil into heat using boilers resistive_heaters,--,"{true, false}",Add option for transforming electricity into heat using resistive heaters (independently from gas boilers)
biomass_boiler,--,"{true, false}",Add option for transforming biomass into heat using boilers oil_boilers,--,"{true, false}",Add option for transforming oil into heat using boilers
overdimension_individual_heating,--,"float",Add option for overdimensioning individual heating systems by a certain factor. This allows them to cover heat demand peaks e.g. 10% higher than those in the data with a setting of 1.1. 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) overdimension_individual_heating,--,float,Add option for overdimensioning individual heating systems by a certain factor. This allows them to cover heat demand peaks e.g. 10% higher than those in the data with a setting of 1.1.
micro_chp,--,"{true, false}",Add option for using Combined Heat and Power (CHP) for decentral areas. chp,--,"{true, false}",Add option for using Combined Heat and Power (CHP)
solar_thermal,--,"{true, false}",Add option for using solar thermal to generate heat. micro_chp,--,"{true, false}",Add option for using Combined Heat and Power (CHP) for decentral areas.
solar_cf_correction,--,float,The correction factor for the value provided by the solar thermal profile calculations solar_thermal,--,"{true, false}",Add option for using solar thermal to generate heat.
marginal_cost_storage,currency/MWh ,float,The marginal cost of discharging batteries in distributed grids solar_cf_correction,--,float,The correction factor for the value provided by the solar thermal profile calculations
methanation,--,"{true, false}",Add option for transforming hydrogen and CO2 into methane using methanation. marginal_cost_storage,currency/MWh ,float,The marginal cost of discharging batteries in distributed grids
coal_cc,--,"{true, false}",Add option for coal CHPs with carbon capture methanation,--,"{true, false}",Add option for transforming hydrogen and CO2 into methane using methanation.
dac,--,"{true, false}",Add option for Direct Air Capture (DAC) coal_cc,--,"{true, false}",Add option for coal CHPs with carbon capture
co2_vent,--,"{true, false}",Add option for vent out CO2 from storages to the atmosphere. dac,--,"{true, false}",Add option for Direct Air Capture (DAC)
allam_cycle,--,"{true, false}",Add option to include `Allam cycle gas power plants <https://en.wikipedia.org/wiki/Allam_power_cycle>`_ co2_vent,--,"{true, false}",Add option for vent out CO2 from storages to the atmosphere.
hydrogen_fuel_cell,--,"{true, false}",Add option to include hydrogen fuel cell for re-electrification. Assuming OCGT technology costs allam_cycle,--,"{true, false}",Add option to include `Allam cycle gas power plants <https://en.wikipedia.org/wiki/Allam_power_cycle>`_
hydrogen_turbine,--,"{true, false}",Add option to include hydrogen turbine for re-electrification. Assuming OCGT technology costs hydrogen_fuel_cell,--,"{true, false}",Add option to include hydrogen fuel cell 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) hydrogen_turbine,--,"{true, false}",Add option to include hydrogen turbine for re-electrification. Assuming OCGT technology costs
SMR CC,--,"{true, false}",Add option for transforming natural gas into hydrogen and CO2 using Steam Methane Reforming (SMR) and Carbon Capture (CC) SMR,--,"{true, false}",Add option for transforming natural gas into hydrogen and CO2 using Steam Methane Reforming (SMR)
regional_methanol_demand,--,"{true, false}",Spatially resolve methanol demand. Set to true if regional CO2 constraints needed. SMR CC,--,"{true, false}",Add option for transforming natural gas into hydrogen and CO2 using Steam Methane Reforming (SMR) and Carbon Capture (CC)
regional_oil_demand,--,"{true, false}",Spatially resolve oil demand. Set to true if regional CO2 constraints needed. regional_methanol_demand,--,"{true, false}",Spatially resolve methanol demand. Set to true if regional CO2 constraints needed.
regional_co2 _sequestration_potential,,, regional_oil_demand,--,"{true, false}",Spatially resolve oil demand. Set to true if regional CO2 constraints needed.
-- 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>`_. regional_co2 _sequestration_potential,,,
-- attribute,--,string or list,Name (or list of names) of the attribute(s) for the 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>`_.
-- include_onshore,--,"{true, false}",Add options for including onshore sequestration potentials -- attribute,--,string or list,Name (or list of names) of the attribute(s) for the sequestration potential
-- min_size,Gt ,float,Any sites with lower potential than this value will be excluded -- include_onshore,--,"{true, false}",Add options for including onshore sequestration potentials
-- max_size,Gt ,float,The maximum sequestration potential for any one site. -- min_size,Gt ,float,Any sites with lower potential than this value will be excluded
-- years_of_storage,years,float,The years until potential exhausted at optimised annual rate -- max_size,Gt ,float,The maximum sequestration potential for any one site.
co2_sequestration_potential,MtCO2/a,float,The potential of sequestering CO2 in Europe per year -- years_of_storage,years,float,The years until potential exhausted at optimised annual rate
co2_sequestration_cost,currency/tCO2,float,The cost of sequestering a ton of CO2 co2_sequestration_potential,MtCO2/a,float,The potential of sequestering CO2 in Europe per year
co2_sequestration_lifetime,years,int,The lifetime of a CO2 sequestration site 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." co2_sequestration_lifetime,years,int,The lifetime of a CO2 sequestration site
,,, 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 ,,,
co2_network_cost_factor,p.u.,float,The cost factor for the capital cost of the carbon dioxide transmission network co2network,--,"{true, false}",Add option for planning a new carbon dioxide transmission network
,,, co2_network_cost_factor,p.u.,float,The cost factor for the capital cost of the 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. cc_fraction,--,float,The default fraction of CO2 captured with post-combustion capture
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 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 _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_fischer_tropsch _waste_heat,--,"{true, false}",Add option for using waste heat of Fischer Tropsch in district heating networks
use_electrolysis_waste _heat,--,"{true, false}",Add option for using waste heat of electrolysis in district heating networks use_fuel_cell_waste_heat,--,"{true, false}",Add option for using waste heat of fuel cells in district heating networks
electricity_transmission _grid,--,"{true, false}",Switch for enabling/disabling the electricity transmission grid. 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_transmission _grid,--,"{true, false}",Switch for enabling/disabling the electricity transmission grid.
electricity_distribution _grid_cost_factor,,,Multiplies the investment cost of the 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
electricity_grid _connection,--,"{true, false}",Add the cost of electricity grid connection for onshore wind and solar ,,,
transmission_efficiency,,,Section to specify transmission losses or compression energy demands of bidirectional links. Splits them into two capacity-linked unidirectional links. electricity_grid _connection,--,"{true, false}",Add the cost of electricity grid connection for onshore wind and solar
-- {carrier},--,str,The carrier of the link. transmission_efficiency,,,Section to specify transmission losses or compression energy demands of bidirectional links. Splits them into two capacity-linked unidirectional links.
-- -- efficiency_static,p.u.,float,Length-independent transmission efficiency. -- {carrier},--,str,The carrier of the link.
-- -- efficiency_per_1000km,p.u. per 1000 km,float,Length-dependent transmission efficiency ($\eta^{\text{length}}$) -- -- efficiency_static,p.u.,float,Length-independent transmission efficiency.
-- -- compression_per_1000km,p.u. per 1000 km,float,Length-dependent electricity demand for compression ($\eta \cdot \text{length}$) implemented as multi-link to local electricity bus. -- -- efficiency_per_1000km,p.u. per 1000 km,float,Length-dependent transmission efficiency ($\eta^{\text{length}}$)
H2_network,--,"{true, false}",Add option for new hydrogen pipelines -- -- compression_per_1000km,p.u. per 1000 km,float,Length-dependent electricity demand for compression ($\eta \cdot \text{length}$) implemented as multi-link to local electricity bus.
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_network,--,"{true, false}",Add option for new hydrogen pipelines
H2_retrofit,--,"{true, false}",Add option for retrofiting existing pipelines to transport hydrogen. 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_capacity _per_CH4,--,float,"The ratio for H2 capacity per original CH4 capacity of retrofitted pipelines. The `European Hydrogen Backbone (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,--,"{true, false}",Add option for retrofiting existing pipelines to transport hydrogen.
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 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 <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."
gas_distribution_grid,--,"{true, false}",Add a gas distribution grid 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 _cost_factor,,,Multiplier for the investment cost of the gas distribution grid 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
biomass_spatial,--,"{true, false}",Add option for resolving biomass demand regionally ,,,
biomass_transport,--,"{true, false}",Add option for transporting solid biomass between nodes biomass_spatial,--,"{true, false}",Add option for resolving biomass demand regionally
biogas_upgrading_cc,--,"{true, false}",Add option to capture CO2 from biomass upgrading 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. biogas_upgrading_cc,--,"{true, false}",Add option to capture CO2 from biomass upgrading
biomass_to_liquid,--,"{true, false}",Add option for transforming solid biomass into liquid fuel with the same properties as oil conventional_generation,,,Add a more detailed description of conventional carriers. Any power generation requires the consumption of fuel from nodes representing that fuel.
biosng,--,"{true, 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
limit_max_growth,,, biosng,--,"{true, false}",Add option for transforming solid biomass into synthesis gas with the same properties as natural gas
-- enable,--,"{true, false}",Add option to limit the maximum growth of a carrier limit_max_growth,,,
-- factor,p.u.,float,The maximum growth factor of a carrier (e.g. 1.3 allows 30% larger than max historic growth) -- enable,--,"{true, false}",Add option to limit the maximum growth of a carrier
-- max_growth,,, -- factor,p.u.,float,The maximum growth factor of a carrier (e.g. 1.3 allows 30% larger than max historic growth)
-- -- {carrier},GW,float,The historic maximum growth of a carrier -- max_growth,,,
-- max_relative_growth,,, -- -- {carrier},GW,float,The historic maximum growth of a carrier
-- -- {carrier},p.u.,float,The historic maximum relative growth of a carrier -- max_relative_growth,,,
,,, -- -- {carrier},p.u.,float,The historic maximum relative growth of a carrier
enhanced_geothermal,,, ,,,
-- enable,--,"{true, false}",Add option to include Enhanced Geothermal Systems enhanced_geothermal,,,
-- flexible,--,"{true, false}",Add option for flexible operation (see Ricks et al. 2024) -- enable,--,"{true, false}",Add option to include Enhanced Geothermal Systems
-- max_hours,--,int,The maximum hours the reservoir can be charged under flexible operation -- flexible,--,"{true, false}",Add option for flexible operation (see Ricks et al. 2024)
-- max_boost,--,float,The maximum boost in power output under flexible operation -- max_hours,--,int,The maximum hours the reservoir can be charged under flexible operation
-- var_cf,--,"{true, false}",Add option for variable capacity factor (see Ricks et al. 2024) -- max_boost,--,float,The maximum boost in power output under flexible operation
-- sustainability_factor,--,float,Share of sourced heat that is replenished by the earth's core (see details in `build_egs_potentials.py <https://github.com/PyPSA/pypsa-eur-sec/blob/master/scripts/build_egs_potentials.py>`_) -- var_cf,--,"{true, false}",Add option for variable capacity factor (see Ricks et al. 2024)
-- sustainability_factor,--,float,Share of sourced heat that is replenished by the earth's core (see details in `build_egs_potentials.py <https://github.com/PyPSA/pypsa-eur-sec/blob/master/scripts/build_egs_potentials.py>`_)

1 Unit Values Description
2 transport -- {true, false} Flag to include transport sector.
3 heating -- {true, false} Flag to include heating sector.
4 biomass -- {true, false} Flag to include biomass sector.
5 industry -- {true, false} Flag to include industry sector.
6 agriculture -- {true, false} Flag to include agriculture sector.
7 district_heating fossil_fuels -- {true, false} `prepare_sector_network.py <https://github.com/PyPSA/pypsa-eur-sec/blob/master/scripts/prepare_sector_network.py>`_ Flag to include imports of fossil fuels ( ["coal", "gas", "oil", "lignite"])
8 -- potential district_heating -- float maximum fraction of urban demand which can be supplied by district heating. Ignored where below current fraction. `prepare_sector_network.py <https://github.com/PyPSA/pypsa-eur-sec/blob/master/scripts/prepare_sector_network.py>`_
9 -- progress -- potential -- Dictionary with planning horizons as keys. float 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 maximum fraction of urban demand which can be supplied by district heating. Ignored where below current fraction.
10 -- district_heating_loss -- progress -- float Dictionary with planning horizons as keys. Share increase in district heat demand in urban central due to heat losses 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
11 cluster_heat_buses -- district_heating_loss -- {true, false} float 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. Share increase in district heat demand in urban central due to heat losses
12 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.
13 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 <https://github.com/PyPSA/pypsa-eur-sec/blob/master/scripts/build_transport_demand.py>`_. Set to 0 for no restriction on BEV DSM
14 bev_dsm_restriction _time bev_dsm_restriction _value -- float Time at which SOC of BEV has to be dsm_restriction_value 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 <https://github.com/PyPSA/pypsa-eur-sec/blob/master/scripts/build_transport_demand.py>`_. Set to 0 for no restriction on BEV DSM
15 transport_heating _deadband_upper bev_dsm_restriction _time °C -- float The maximum temperature in the vehicle. At higher temperatures, the energy required for cooling in the vehicle increases. Time at which SOC of BEV has to be dsm_restriction_value
16 transport_heating _deadband_lower transport_heating _deadband_upper °C float The minimum temperature in the vehicle. At lower temperatures, the energy required for heating in the vehicle increases. The maximum temperature in the vehicle. At higher temperatures, the energy required for cooling in the vehicle increases.
17 transport_heating _deadband_lower °C float The minimum temperature in the vehicle. At lower temperatures, the energy required for heating in the vehicle increases.
18 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.
19 ICE_upper_degree_factor ICE_lower_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. Share increase in energy demand in internal combustion engine (ICE) for each degree difference between the cold environment and the minimum temperature.
20 EV_lower_degree_factor ICE_upper_degree_factor -- float Share increase in energy demand in electric vehicles (EV) for each degree difference between the cold environment and the minimum temperature. Share increase in energy demand in internal combustion engine (ICE) for each degree difference between the hot environment and the maximum temperature.
21 EV_upper_degree_factor EV_lower_degree_factor -- float Share increase in energy demand in electric vehicles (EV) for each degree difference between the hot environment and the maximum temperature. Share increase in energy demand in electric vehicles (EV) for each degree difference between the cold environment and the minimum temperature.
22 bev_dsm EV_upper_degree_factor -- {true, false} float Add the option for battery electric vehicles (BEV) to participate in demand-side management (DSM) Share increase in energy demand in electric vehicles (EV) for each degree difference between the hot environment and the maximum temperature.
23 bev_dsm -- {true, false} Add the option for battery electric vehicles (BEV) to participate in demand-side management (DSM)
24 bev_availability -- float The share for battery electric vehicles (BEV) that are able to do demand side management (DSM)
25 bev_energy bev_availability -- float The average size of battery electric vehicles (BEV) in MWh The share for battery electric vehicles (BEV) that are able to do demand side management (DSM)
26 bev_charge_efficiency bev_energy -- float Battery electric vehicles (BEV) charge and discharge efficiency The average size of battery electric vehicles (BEV) in MWh
27 bev_charge_rate bev_charge_efficiency MWh -- float The power consumption for one electric vehicle (EV) in MWh. Value derived from 3-phase charger with 11 kW. Battery electric vehicles (BEV) charge and discharge efficiency
28 bev_avail_max bev_charge_rate -- MWh float The maximum share plugged-in availability for passenger electric vehicles. The power consumption for one electric vehicle (EV) in MWh. Value derived from 3-phase charger with 11 kW.
29 bev_avail_mean bev_avail_max -- float The average share plugged-in availability for passenger electric vehicles. The maximum share plugged-in availability for passenger electric vehicles.
30 v2g bev_avail_mean -- {true, false} float Allows feed-in to grid from EV battery The average share plugged-in availability for passenger electric vehicles.
31 land_transport_fuel_cell _share v2g -- Dictionary with planning horizons as keys. {true, false} The share of vehicles that uses fuel cells in a given year Allows feed-in to grid from EV battery
32 land_transport_electric _share land_transport_fuel_cell _share -- Dictionary with planning horizons as keys. The share of vehicles that uses electric vehicles (EV) in a given year The share of vehicles that uses fuel cells in a given year
33 land_transport_ice _share land_transport_electric _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. The share of vehicles that uses electric vehicles (EV) in a given year
34 transport_electric_efficiency land_transport_ice _share MWh/100km -- float Dictionary with planning horizons as keys. The conversion efficiencies of electric vehicles in transport The share of vehicles that uses internal combustion engines (ICE) in a given year. What is not EV or FCEV is oil-fuelled ICE.
35 transport_fuel_cell_efficiency transport_electric_efficiency MWh/100km float The H2 conversion efficiencies of fuel cells in transport The conversion efficiencies of electric vehicles in transport
36 transport_ice_efficiency transport_fuel_cell_efficiency MWh/100km float The oil conversion efficiencies of internal combustion engine (ICE) in transport The H2 conversion efficiencies of fuel cells in transport
37 agriculture_machinery _electric_share transport_ice_efficiency -- MWh/100km float The share for agricultural machinery that uses electricity The oil conversion efficiencies of internal combustion engine (ICE) in transport
38 agriculture_machinery _oil_share agriculture_machinery _electric_share -- float The share for agricultural machinery that uses oil The share for agricultural machinery that uses electricity
39 agriculture_machinery _fuel_efficiency agriculture_machinery _oil_share -- float The efficiency of electric-powered machinery in the conversion of electricity to meet agricultural needs. The share for agricultural machinery that uses oil
40 agriculture_machinery _electric_efficiency agriculture_machinery _fuel_efficiency -- float The efficiency of oil-powered machinery in the conversion of oil to meet agricultural needs. The efficiency of electric-powered machinery in the conversion of electricity to meet agricultural needs.
41 Mwh_MeOH_per_MWh_H2 agriculture_machinery _electric_efficiency 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. The efficiency of oil-powered machinery in the conversion of oil to meet agricultural needs.
42 MWh_MeOH_per_tCO2 Mwh_MeOH_per_MWh_H2 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 66. 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.
43 MWh_MeOH_per_MWh_e MWh_MeOH_per_tCO2 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. 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 66.
44 shipping_hydrogen _liquefaction MWh_MeOH_per_MWh_e -- LHV {true, false} float Whether to include liquefaction costs for hydrogen demand in shipping. 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.
45 shipping_hydrogen _liquefaction -- {true, false} Whether to include liquefaction costs for hydrogen demand in shipping.
46 shipping_hydrogen_share -- Dictionary with planning horizons as keys. The share of ships powered by hydrogen in a given year
47 shipping_methanol_share shipping_hydrogen_share -- Dictionary with planning horizons as keys. The share of ships powered by methanol in a given year The share of ships powered by hydrogen in a given year
48 shipping_oil_share shipping_methanol_share -- Dictionary with planning horizons as keys. The share of ships powered by oil in a given year The share of ships powered by methanol in a given year
49 shipping_methanol _efficiency shipping_oil_share -- float Dictionary with planning horizons as keys. 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>`_ The share of ships powered by oil in a given year
50 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>`_
51 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
52 aviation_demand_factor shipping_oil_efficiency -- float The proportion of demand for aviation compared to today's consumption The efficiency of oil-powered ships in the conversion of oil to meet shipping needs (propulsion). Base value derived from 2011
53 HVC_demand_factor aviation_demand_factor -- float The proportion of demand for high-value chemicals compared to today's consumption The proportion of demand for aviation compared to today's consumption
54 HVC_demand_factor -- float The proportion of demand for high-value chemicals compared to today's consumption
55 time_dep_hp_cop -- {true, false} Consider the time dependent coefficient of performance (COP) of the heat pump
56 heat_pump_sink_T time_dep_hp_cop °C -- float {true, false} 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 Consider the time dependent coefficient of performance (COP) of the heat pump
57 reduce_space_heat _exogenously heat_pump_sink_T -- °C {true, false} float Influence on space heating demand by a certain factor (applied before losses in district heating). 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
58 reduce_space_heat _exogenously_factor reduce_space_heat _exogenously -- Dictionary with planning horizons as keys. {true, false} 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>`_ Influence on space heating demand by a certain factor (applied before losses in district heating).
59 retrofitting 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>`_
60 -- retro_endogen retrofitting -- {true, false} Add retrofitting as an endogenous system which co-optimise space heat savings.
61 -- cost_factor -- retro_endogen -- float {true, false} Weight costs for building renovation Add retrofitting as an endogenous system which co-optimise space heat savings.
62 -- interest_rate -- cost_factor -- float The interest rate for investment in building components Weight costs for building renovation
63 -- annualise_cost -- interest_rate -- {true, false} float Annualise the investment costs of retrofitting The interest rate for investment in building components
64 -- tax_weighting -- annualise_cost -- {true, false} Weight the costs of retrofitting depending on taxes in countries Annualise the investment costs of retrofitting
65 -- construction_index -- tax_weighting -- {true, false} Weight the costs of retrofitting depending on labour/material costs per country Weight the costs of retrofitting depending on taxes in countries
66 tes -- construction_index -- {true, false} Add option for storing thermal energy in large water pits associated with district heating systems and individual thermal energy storage (TES) Weight the costs of retrofitting depending on labour/material costs per country
67 tes_tau tes -- {true, false} The time constant used to calculate the decay of thermal energy in thermal energy storage (TES): 1- :math:`e^{-1/24τ}`. Add option for storing thermal energy in large water pits associated with district heating systems and individual thermal energy storage (TES)
68 -- decentral tes_tau days float The time constant in decentralized thermal energy storage (TES) The time constant used to calculate the decay of thermal energy in thermal energy storage (TES): 1- :math:`e^{-1/24τ}`.
69 -- central -- decentral days float The time constant in centralized thermal energy storage (TES) The time constant in decentralized thermal energy storage (TES)
70 boilers -- central -- days {true, false} float Add option for transforming gas into heat using gas boilers The time constant in centralized thermal energy storage (TES)
71 resistive_heaters boilers -- {true, false} Add option for transforming electricity into heat using resistive heaters (independently from gas boilers) Add option for transforming gas into heat using gas boilers
72 oil_boilers resistive_heaters -- {true, false} Add option for transforming oil into heat using boilers Add option for transforming electricity into heat using resistive heaters (independently from gas boilers)
73 biomass_boiler oil_boilers -- {true, false} Add option for transforming biomass into heat using boilers Add option for transforming oil into heat using boilers
74 overdimension_individual_heating biomass_boiler -- float {true, false} Add option for overdimensioning individual heating systems by a certain factor. This allows them to cover heat demand peaks e.g. 10% higher than those in the data with a setting of 1.1. Add option for transforming biomass into heat using boilers
75 chp overdimension_individual_heating -- {true, false} float Add option for using Combined Heat and Power (CHP) Add option for overdimensioning individual heating systems by a certain factor. This allows them to cover heat demand peaks e.g. 10% higher than those in the data with a setting of 1.1.
76 micro_chp chp -- {true, false} Add option for using Combined Heat and Power (CHP) for decentral areas. Add option for using Combined Heat and Power (CHP)
77 solar_thermal micro_chp -- {true, false} Add option for using solar thermal to generate heat. Add option for using Combined Heat and Power (CHP) for decentral areas.
78 solar_cf_correction solar_thermal -- float {true, false} The correction factor for the value provided by the solar thermal profile calculations Add option for using solar thermal to generate heat.
79 marginal_cost_storage solar_cf_correction currency/MWh -- float The marginal cost of discharging batteries in distributed grids The correction factor for the value provided by the solar thermal profile calculations
80 methanation marginal_cost_storage -- currency/MWh {true, false} float Add option for transforming hydrogen and CO2 into methane using methanation. The marginal cost of discharging batteries in distributed grids
81 coal_cc methanation -- {true, false} Add option for coal CHPs with carbon capture Add option for transforming hydrogen and CO2 into methane using methanation.
82 dac coal_cc -- {true, false} Add option for Direct Air Capture (DAC) Add option for coal CHPs with carbon capture
83 co2_vent dac -- {true, false} Add option for vent out CO2 from storages to the atmosphere. Add option for Direct Air Capture (DAC)
84 allam_cycle co2_vent -- {true, false} Add option to include `Allam cycle gas power plants <https://en.wikipedia.org/wiki/Allam_power_cycle>`_ Add option for vent out CO2 from storages to the atmosphere.
85 hydrogen_fuel_cell allam_cycle -- {true, false} Add option to include hydrogen fuel cell for re-electrification. Assuming OCGT technology costs Add option to include `Allam cycle gas power plants <https://en.wikipedia.org/wiki/Allam_power_cycle>`_
86 hydrogen_turbine hydrogen_fuel_cell -- {true, false} Add option to include hydrogen turbine for re-electrification. Assuming OCGT technology costs Add option to include hydrogen fuel cell for re-electrification. Assuming OCGT technology costs
87 SMR hydrogen_turbine -- {true, false} Add option for transforming natural gas into hydrogen and CO2 using Steam Methane Reforming (SMR) Add option to include hydrogen turbine for re-electrification. Assuming OCGT technology costs
88 SMR CC SMR -- {true, false} Add option for transforming natural gas into hydrogen and CO2 using Steam Methane Reforming (SMR) and Carbon Capture (CC) Add option for transforming natural gas into hydrogen and CO2 using Steam Methane Reforming (SMR)
89 regional_methanol_demand SMR CC -- {true, false} Spatially resolve methanol demand. Set to true if regional CO2 constraints needed. Add option for transforming natural gas into hydrogen and CO2 using Steam Methane Reforming (SMR) and Carbon Capture (CC)
90 regional_oil_demand regional_methanol_demand -- {true, false} Spatially resolve oil demand. Set to true if regional CO2 constraints needed. Spatially resolve methanol demand. Set to true if regional CO2 constraints needed.
91 regional_co2 _sequestration_potential regional_oil_demand -- {true, false} Spatially resolve oil demand. Set to true if regional CO2 constraints needed.
92 -- enable regional_co2 _sequestration_potential -- {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>`_.
93 -- attribute -- enable -- string or list {true, false} Name (or list of names) of the attribute(s) for the sequestration potential Add option for regionally-resolved geological carbon dioxide sequestration potentials based on `CO2StoP <https://setis.ec.europa.eu/european-co2-storage-database_en>`_.
94 -- include_onshore -- attribute -- {true, false} string or list Add options for including onshore sequestration potentials Name (or list of names) of the attribute(s) for the sequestration potential
95 -- min_size -- include_onshore Gt -- float {true, false} Any sites with lower potential than this value will be excluded Add options for including onshore sequestration potentials
96 -- max_size -- min_size Gt float The maximum sequestration potential for any one site. Any sites with lower potential than this value will be excluded
97 -- years_of_storage -- max_size years Gt float The years until potential exhausted at optimised annual rate The maximum sequestration potential for any one site.
98 co2_sequestration_potential -- years_of_storage MtCO2/a years float The potential of sequestering CO2 in Europe per year The years until potential exhausted at optimised annual rate
99 co2_sequestration_cost co2_sequestration_potential currency/tCO2 MtCO2/a float The cost of sequestering a ton of CO2 The potential of sequestering CO2 in Europe per year
100 co2_sequestration_lifetime co2_sequestration_cost years currency/tCO2 int float The lifetime of a CO2 sequestration site The cost of sequestering a ton of CO2
101 co2_spatial co2_sequestration_lifetime -- years {true, false} int 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. The lifetime of a CO2 sequestration site
102 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.
103 co2network -- {true, false} Add option for planning a new carbon dioxide transmission network
104 co2_network_cost_factor co2network p.u. -- float {true, false} The cost factor for the capital cost of the carbon dioxide transmission network Add option for planning a new carbon dioxide transmission network
105 co2_network_cost_factor p.u. float The cost factor for the capital cost of the carbon dioxide transmission network
106 cc_fraction -- float The default fraction of CO2 captured with post-combustion capture
107 hydrogen_underground _storage cc_fraction -- {true, false} float Add options for storing hydrogen underground. Storage potential depends regionally. The default fraction of CO2 captured with post-combustion capture
108 hydrogen_underground _storage_locations hydrogen_underground _storage -- {onshore, nearshore, offshore} {true, false} 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. Add options for storing hydrogen underground. Storage potential depends regionally.
109 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.
110 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)
111 min_part_load_fischer _tropsch ammonia per unit of p_nom -- float {true, false, regional} The minimum unit dispatch (``p_min_pu``) for the Fischer-Tropsch process Add ammonia as a carrrier. It can be either true (copperplated NH3), false (no NH3 carrier) or "regional" (regionalised NH3 without network)
112 min_part_load _methanolisation min_part_load_fischer _tropsch per unit of p_nom float The minimum unit dispatch (``p_min_pu``) for the methanolisation process The minimum unit dispatch (``p_min_pu``) for the Fischer-Tropsch process
113 min_part_load _methanolisation per unit of p_nom float The minimum unit dispatch (``p_min_pu``) for the methanolisation process
114 use_fischer_tropsch _waste_heat -- {true, false} Add option for using waste heat of Fischer Tropsch in district heating networks
115 use_fuel_cell_waste_heat use_fischer_tropsch _waste_heat -- {true, false} Add option for using waste heat of fuel cells in district heating networks Add option for using waste heat of Fischer Tropsch in district heating networks
116 use_electrolysis_waste _heat use_fuel_cell_waste_heat -- {true, false} Add option for using waste heat of electrolysis in district heating networks Add option for using waste heat of fuel cells in district heating networks
117 electricity_transmission _grid use_electrolysis_waste _heat -- {true, false} Switch for enabling/disabling the electricity transmission grid. Add option for using waste heat of electrolysis in district heating networks
118 electricity_distribution _grid electricity_transmission _grid -- {true, false} Add a simplified representation of the exchange capacity between transmission and distribution grid level through a link. Switch for enabling/disabling the electricity transmission grid.
119 electricity_distribution _grid_cost_factor electricity_distribution _grid -- {true, false} Multiplies the investment cost of the electricity distribution grid Add a simplified representation of the exchange capacity between transmission and distribution grid level through a link.
120 electricity_distribution _grid_cost_factor Multiplies the investment cost of the electricity distribution grid
121 electricity_grid _connection -- {true, false} Add the cost of electricity grid connection for onshore wind and solar
122 transmission_efficiency electricity_grid _connection -- {true, false} Section to specify transmission losses or compression energy demands of bidirectional links. Splits them into two capacity-linked unidirectional links. Add the cost of electricity grid connection for onshore wind and solar
123 -- {carrier} transmission_efficiency -- str The carrier of the link. Section to specify transmission losses or compression energy demands of bidirectional links. Splits them into two capacity-linked unidirectional links.
124 -- -- efficiency_static -- {carrier} p.u. -- float str Length-independent transmission efficiency. The carrier of the link.
125 -- -- efficiency_per_1000km -- -- efficiency_static p.u. per 1000 km p.u. float Length-dependent transmission efficiency ($\eta^{\text{length}}$) Length-independent transmission efficiency.
126 -- -- compression_per_1000km -- -- efficiency_per_1000km p.u. per 1000 km float Length-dependent electricity demand for compression ($\eta \cdot \text{length}$) implemented as multi-link to local electricity bus. Length-dependent transmission efficiency ($\eta^{\text{length}}$)
127 H2_network -- -- compression_per_1000km -- p.u. per 1000 km {true, false} float Add option for new hydrogen pipelines Length-dependent electricity demand for compression ($\eta \cdot \text{length}$) implemented as multi-link to local electricity bus.
128 gas_network H2_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. Add option for new hydrogen pipelines
129 H2_retrofit gas_network -- {true, false} Add option for retrofiting existing pipelines to transport hydrogen. 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.
130 H2_retrofit_capacity _per_CH4 H2_retrofit -- float {true, false} The ratio for H2 capacity per original CH4 capacity of retrofitted pipelines. The `European Hydrogen Backbone (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. Add option for retrofiting existing pipelines to transport hydrogen.
131 gas_network_connectivity _upgrade H2_retrofit_capacity _per_CH4 -- 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 The ratio for H2 capacity per original CH4 capacity of retrofitted pipelines. The `European Hydrogen Backbone (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.
132 gas_distribution_grid gas_network_connectivity _upgrade -- {true, false} float Add a gas distribution grid 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
133 gas_distribution_grid _cost_factor gas_distribution_grid -- {true, false} Multiplier for the investment cost of the gas distribution grid Add a gas distribution grid
134 gas_distribution_grid _cost_factor Multiplier for the investment cost of the gas distribution grid
135 biomass_spatial -- {true, false} Add option for resolving biomass demand regionally
136 biomass_transport biomass_spatial -- {true, false} Add option for transporting solid biomass between nodes Add option for resolving biomass demand regionally
137 biogas_upgrading_cc biomass_transport -- {true, false} Add option to capture CO2 from biomass upgrading Add option for transporting solid biomass between nodes
138 conventional_generation biogas_upgrading_cc -- {true, false} Add a more detailed description of conventional carriers. Any power generation requires the consumption of fuel from nodes representing that fuel. Add option to capture CO2 from biomass upgrading
139 biomass_to_liquid conventional_generation -- {true, false} Add option for transforming solid biomass into liquid fuel with the same properties as oil Add a more detailed description of conventional carriers. Any power generation requires the consumption of fuel from nodes representing that fuel.
140 biosng biomass_to_liquid -- {true, false} Add option for transforming solid biomass into synthesis gas with the same properties as natural gas Add option for transforming solid biomass into liquid fuel with the same properties as oil
141 limit_max_growth biosng -- {true, false} Add option for transforming solid biomass into synthesis gas with the same properties as natural gas
142 -- enable limit_max_growth -- {true, false} Add option to limit the maximum growth of a carrier
143 -- factor -- enable p.u. -- float {true, false} The maximum growth factor of a carrier (e.g. 1.3 allows 30% larger than max historic growth) Add option to limit the maximum growth of a carrier
144 -- max_growth -- factor p.u. float The maximum growth factor of a carrier (e.g. 1.3 allows 30% larger than max historic growth)
145 -- -- {carrier} -- max_growth GW float The historic maximum growth of a carrier
146 -- max_relative_growth -- -- {carrier} GW float The historic maximum growth of a carrier
147 -- -- {carrier} -- max_relative_growth p.u. float The historic maximum relative growth of a carrier
148 -- -- {carrier} p.u. float The historic maximum relative growth of a carrier
149 enhanced_geothermal
150 -- enable enhanced_geothermal -- {true, false} Add option to include Enhanced Geothermal Systems
151 -- flexible -- enable -- {true, false} Add option for flexible operation (see Ricks et al. 2024) Add option to include Enhanced Geothermal Systems
152 -- max_hours -- flexible -- int {true, false} The maximum hours the reservoir can be charged under flexible operation Add option for flexible operation (see Ricks et al. 2024)
153 -- max_boost -- max_hours -- float int The maximum boost in power output under flexible operation The maximum hours the reservoir can be charged under flexible operation
154 -- var_cf -- max_boost -- {true, false} float Add option for variable capacity factor (see Ricks et al. 2024) The maximum boost in power output under flexible operation
155 -- sustainability_factor -- var_cf -- float {true, false} Share of sourced heat that is replenished by the earth's core (see details in `build_egs_potentials.py <https://github.com/PyPSA/pypsa-eur-sec/blob/master/scripts/build_egs_potentials.py>`_) Add option for variable capacity factor (see Ricks et al. 2024)
156 -- sustainability_factor -- float Share of sourced heat that is replenished by the earth's core (see details in `build_egs_potentials.py <https://github.com/PyPSA/pypsa-eur-sec/blob/master/scripts/build_egs_potentials.py>`_)

2
doc/release_notes.rst
View File

@ -10,6 +10,8 @@ Release Notes
Upcoming Release Upcoming Release
================ ================
* Add flag ``sector: fossil_fuels`` in config to remove the option of importing fossil fuels
* Renamed the carrier of batteries in BEVs from `battery storage` to `EV battery` and the corresponding bus carrier from `Li ion` to `EV battery`. This is to avoid confusion with stationary battery storage. * Renamed the carrier of batteries in BEVs from `battery storage` to `EV battery` and the corresponding bus carrier from `Li ion` to `EV battery`. This is to avoid confusion with stationary battery storage.
* Changed default assumptions about waste heat usage from PtX and fuel cells in district heating. * Changed default assumptions about waste heat usage from PtX and fuel cells in district heating.

21
scripts/prepare_sector_network.py
View File

@ -542,14 +542,17 @@ def add_carrier_buses(n, carrier, nodes=None):
capital_cost=capital_cost, capital_cost=capital_cost,
) )
n.madd( fossils = ["coal", "gas", "oil", "lignite"]
"Generator", if options.get("fossil_fuels", True) and carrier in fossils:
nodes,
bus=nodes, n.madd(
p_nom_extendable=True, "Generator",
carrier=carrier, nodes,
marginal_cost=costs.at[carrier, "fuel"], bus=nodes,
) p_nom_extendable=True,
carrier=carrier,
marginal_cost=costs.at[carrier, "fuel"],
)
# TODO: PyPSA-Eur merge issue # TODO: PyPSA-Eur merge issue
@ -2898,7 +2901,7 @@ def add_industry(n, costs):
carrier="oil", carrier="oil",
) )
if "oil" not in n.generators.carrier.unique(): if options.get("fossil_fuels", True) and "oil" not in n.generators.carrier.unique():
n.madd( n.madd(
"Generator", "Generator",
spatial.oil.nodes, spatial.oil.nodes,