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

add table for biomass, energy, existing capacities, solar thermal, plotting (need suggestion)

Browse Source
This commit is contained in:
virio-andreyana 2023-07-03 03:37:41 +02:00
parent b2c4a5a4cb
commit 9138901e5d
7 changed files with 127 additions and 72 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
doc/configtables/biomass.csv Normal file
View File

@ -0,0 +1,7 @@
,Unit,Values,Description
year ,--,"{2010, 2020, 2030, 2040, 2050}",Year for which to retrieve biomass potential according to the assumptions of the `JRC ENSPRESO <https://data.jrc.ec.europa.eu/dataset/74ed5a04-7d74-4807-9eab-b94774309d9f>`_ .
scenario ,--,"{""ENS_Low"", ""ENS_Med"", ""ENS_High""}",Scenario for which to retrieve biomass potential. The scenario definition can be seen in `ENSPRESO_BIOMASS <https://cidportal.jrc.ec.europa.eu/ftp/jrc-opendata/ENSPRESO/ENSPRESO_BIOMASS.xlsx>`_
classes ,,,
-- solid biomass,--,Array of biomass comodity,The comodity that are included as solid biomass
-- not included,--,Array of biomass comodity,The comodity that are not included as a biomass potential
-- biogas,--,Array of biomass comodity,The comodity that are included as biogas
1 Unit Values Description
2 year -- {2010, 2020, 2030, 2040, 2050} Year for which to retrieve biomass potential according to the assumptions of the `JRC ENSPRESO <https://data.jrc.ec.europa.eu/dataset/74ed5a04-7d74-4807-9eab-b94774309d9f>`_ .
3 scenario -- {"ENS_Low", "ENS_Med", "ENS_High"} Scenario for which to retrieve biomass potential. The scenario definition can be seen in `ENSPRESO_BIOMASS <https://cidportal.jrc.ec.europa.eu/ftp/jrc-opendata/ENSPRESO/ENSPRESO_BIOMASS.xlsx>`_
4 classes
5 -- solid biomass -- Array of biomass comodity The comodity that are included as solid biomass
6 -- not included -- Array of biomass comodity The comodity that are not included as a biomass potential
7 -- biogas -- Array of biomass comodity The comodity that are included as biogas

5
doc/configtables/energy.csv Normal file
View File

@ -0,0 +1,5 @@
,Unit,Values,Description
energy_totals_year ,--,"{1990,1995,2000,2005,2010,2011,…} ",The year for the sector energy use. The year must be avaliable in the Eurostat report
base_emissions_year ,--,YYYY; e.g. ‚1990‘ ,'The base year for the sector emissions. See `European Environment Agency (EEA) <https://www.eea.europa.eu/data-and-maps/data/national-emissions-reported-to-the-unfccc-and-to-the-eu-greenhouse-gas-monitoring-mechanism-16>`_ downloaded 201228 (modified by EEA last on 201221)‘
eurostat_report_year ,--,"{2016,2017,2018}","'The year in which the Eurostat report year are extracted. 2016 includes Bosnia and Herzegovina, 2017 does not‘"
emissions ,--,"{CO2, All greenhouse gases - (CO2 equivalent)}",Specify which sectoral emissions are taken into account. Data derived from EEA.
1 Unit Values Description
2 energy_totals_year -- {1990,1995,2000,2005,2010,2011,…} The year for the sector energy use. The year must be avaliable in the Eurostat report
3 base_emissions_year -- YYYY; e.g. ‚1990‘ 'The base year for the sector emissions. See `European Environment Agency (EEA) <https://www.eea.europa.eu/data-and-maps/data/national-emissions-reported-to-the-unfccc-and-to-the-eu-greenhouse-gas-monitoring-mechanism-16>`_ downloaded 201228 (modified by EEA last on 201221)‘
4 eurostat_report_year -- {2016,2017,2018} 'The year in which the Eurostat report year are extracted. 2016 includes Bosnia and Herzegovina, 2017 does not‘
5 emissions -- {CO2, All greenhouse gases - (CO2 equivalent)} Specify which sectoral emissions are taken into account. Data derived from EEA.

5
doc/configtables/existing_capacities.csv Normal file
View File

@ -0,0 +1,5 @@
,Unit,Values,Description
grouping_years_power ,--,An array of years,Intervals to group existing capacities for power
grouping_years_heat ,--,An array of years below 2020,Intervals to group existing capacities for heat
threshold_capacity ,MW,float,Capacities generators and links of below threshold are removed during add_existing_capacities
conventional_carriers ,--,"Any subset of {uranium, coal, lignite, oil} ",List of conventional power plants to include in the sectoral network
1 Unit Values Description
2 grouping_years_power -- An array of years Intervals to group existing capacities for power
3 grouping_years_heat -- An array of years below 2020 Intervals to group existing capacities for heat
4 threshold_capacity MW float Capacities generators and links of below threshold are removed during add_existing_capacities
5 conventional_carriers -- Any subset of {uranium, coal, lignite, oil} List of conventional power plants to include in the sectoral network

25
doc/configtables/plotting.csv
View File

@ -1,10 +1,19 @@
,Unit,Values,Description ,Unit,Values,Description
map,,, map,,,
-- boundaries,°,"[x1,x2,y1,y2]","Boundaries of the map plots in degrees latitude (y) and longitude (x)" -- boundaries,°,"[x1,x2,y1,y2]",Boundaries of the map plots in degrees latitude (y) and longitude (x)
costs_max,bn Euro,float,"Upper y-axis limit in cost bar plots." costs_max,bn Euro,float,Upper y-axis limit in cost bar plots.
costs_threshold,bn Euro,float,"Threshold below which technologies will not be shown in cost bar plots." costs_threshold,bn Euro,float,Threshold below which technologies will not be shown in cost bar plots.
energy_max,TWh,float,"Upper y-axis limit in energy bar plots." energy_max,TWh,float,Upper y-axis limit in energy bar plots.
energy_min,TWh,float,"Lower y-axis limit in energy bar plots." energy_min,TWh,float,Lower y-axis limit in energy bar plots.
energy_threshold,TWh,float,"Threshold below which technologies will not be shown in energy bar plots." energy_threshold,TWh,float,Threshold below which technologies will not be shown in energy bar plots.
tech_colors,--,"carrier -> HEX colour code","Mapping from network ``carrier`` to a colour (`HEX colour code <https://en.wikipedia.org/wiki/Web_colors#Hex_triplet>`_)." tech_colors,--,carrier -> HEX colour code,Mapping from network ``carrier`` to a colour (`HEX colour code <https://en.wikipedia.org/wiki/Web_colors#Hex_triplet>`_).
nice_names,--,"str -> str","Mapping from network ``carrier`` to a more readable name." vre_techs ,--,subset of carriers,Value not in use
renewable_storage_techs ,--,subset of carriers,Value not in use
conv_techs ,--,subset of carriers,Value in use with unworthy significance. Used as the definition of conventional carrier in solve_network
storage_techs ,--,subset of carriers,Value not in use
load_carriers ,--,subset of carriers,Value not in use
AC_carriers ,--,subset of carriers,Value not in use
link_carriers ,--,subset of carriers,Value not in use
heat_links ,--,subset of carriers,Value not in use
heat_generators ,--,subset of carriers,Value not in use
nice_names,--,str -> str,Mapping from network ``carrier`` to a more readable name.

1 Unit Values Description
2 map
3 -- boundaries ° [x1,x2,y1,y2] Boundaries of the map plots in degrees latitude (y) and longitude (x)
4 costs_max bn Euro float Upper y-axis limit in cost bar plots.
5 costs_threshold bn Euro float Threshold below which technologies will not be shown in cost bar plots.
6 energy_max TWh float Upper y-axis limit in energy bar plots.
7 energy_min TWh float Lower y-axis limit in energy bar plots.
8 energy_threshold TWh float Threshold below which technologies will not be shown in energy bar plots.
9 tech_colors -- carrier -> HEX colour code Mapping from network ``carrier`` to a colour (`HEX colour code <https://en.wikipedia.org/wiki/Web_colors#Hex_triplet>`_).
10 nice_names vre_techs -- str -> str subset of carriers Mapping from network ``carrier`` to a more readable name. Value not in use
11 renewable_storage_techs -- subset of carriers Value not in use
12 conv_techs -- subset of carriers Value in use with unworthy significance. Used as the definition of conventional carrier in solve_network
13 storage_techs -- subset of carriers Value not in use
14 load_carriers -- subset of carriers Value not in use
15 AC_carriers -- subset of carriers Value not in use
16 link_carriers -- subset of carriers Value not in use
17 heat_links -- subset of carriers Value not in use
18 heat_generators -- subset of carriers Value not in use
19 nice_names -- str -> str Mapping from network ``carrier`` to a more readable name.

92
doc/configtables/sector.csv
View File

@ -3,7 +3,7 @@ district_heating,--,,`prepare_sector_network.py <https://github.com/PyPSA/pypsa-
-- 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 -- 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 -- 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,
cluster_heat_buses,--,true or 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. 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>`_.
bev_dsm_restriction_time,--,float,Time at which SOC of BEV has to be dsm_restriction_value 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_upper,°C,float,"The minimum temperature in the vehicle. At lower temperatures, the energy required for heating in the vehicle increases."
@ -12,7 +12,7 @@ ICE_lower_degree_factor,--,float,Percentage increase in energy demand in interna
ICE_upper_degree_factor,--,float,Percentage increase in energy demand in internal combustion engine (ICE) for each degree difference between the hot environment and the maximum temperature. ICE_upper_degree_factor,--,float,Percentage increase in energy demand in internal combustion engine (ICE) for each degree difference between the hot environment and the maximum temperature.
EV_lower_degree_factor,--,float,Percentage increase in energy demand in electric vehicles (EV) for each degree difference between the cold environment and the minimum temperature. EV_lower_degree_factor,--,float,Percentage increase in energy demand in electric vehicles (EV) for each degree difference between the cold environment and the minimum temperature.
EV_upper_degree_factor,--,float,Percentage increase in energy demand in electric vehicles (EV) for each degree difference between the hot environment and the maximum temperature. EV_upper_degree_factor,--,float,Percentage increase in energy demand in electric vehicles (EV) for each degree difference between the hot environment and the maximum temperature.
bev_dsm,--,true or false,Add the option for battery electric vehicles (BEV) to manage its own energy demand (DSM) bev_dsm,--,"{true, false}",Add the option for battery electric vehicles (BEV) to manage its own energy demand (DSM)
bev_availability,--,float,The percentage for battery electric vehicles (BEV) that are able to do demand side management (DSM) bev_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_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_charge_efficiency,--,float,Battery electric vehicles (BEV) charge and discharge efficiency
@ -20,7 +20,7 @@ bev_plug_to_wheel_efficiency,km/kWh,float,The distance battery electric vehicles
bev_charge_rate,MWh,float,The power consumption for one electric vehicle (EV) in MWh. Value derived from 3-phase charger with 11 kW. bev_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_max,--,float,The maximum percentage plugged-in availability for passenger electric vehicles.
bev_avail_mean,--,float,The average percentage plugged-in availability for passenger electric vehicles. bev_avail_mean,--,float,The average percentage plugged-in availability for passenger electric vehicles.
v2g,--,true or false,Allows feed-in to grid from EV battery v2g,--,"{true, false}",Allows feed-in to grid from EV battery
land_transport_fuel_cell_share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses fuel cells in a given year land_transport_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_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
@ -33,7 +33,7 @@ agriculture_machinery_electric_efficiency,--,float,The efficiency of oil-powered
MWh_MeOH_per_MWh_H2,LHV,float,The energy amount of the produced methanol per energy amount of hydrogen. source: DECHEMA (2017): Low carbon energy and feedstock for the European chemical industry page 64. MWh_MeOH_per_MWh_H2,LHV,float,The energy amount of the produced methanol per energy amount of hydrogen. source: DECHEMA (2017): Low carbon energy and feedstock for the European chemical industry page 64.
MWh_MeOH_per_tCO2,LHV,float,The energy amount of the produced methanol per ton of CO2 MWh_MeOH_per_tCO2,LHV,float,The energy amount of the produced methanol per ton of CO2
MWh_MeOH_per_MWh_e,LHV,float,The energy amount of the produced methanol per energy amount of electricity MWh_MeOH_per_MWh_e,LHV,float,The energy amount of the produced methanol per energy amount of electricity
shipping_hydrogen_liquefaction,--,true or false,Consider whether to include liquefaction costs for shipping H2 demand. shipping_hydrogen_liquefaction,--,"{true, false}",Consider whether to include liquefaction costs for shipping H2 demand.
shipping_hydrogen_share,--,Dictionary with planning horizons as keys.,The share of ships powered by hydrogen in a given year shipping_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_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_oil_share,--,Dictionary with planning horizons as keys.,The share of ships powered by oil in a given year
@ -41,69 +41,69 @@ shipping_methanol_efficiency,--,float,The efficiency of methanol-powered ships i
shipping_oil_efficiency,--,float,The efficiency of oil-powered ships in the conversion of oil to meet shipping needs. shipping_oil_efficiency,--,float,The efficiency of oil-powered ships in the conversion of oil to meet shipping needs.
aviation_demand_factor,--,float,The proportion of demand for aviation compared to today's 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 HVC_demand_factor,--,float,The proportion of demand for high-value chemicals compared to today's
time_dep_hp_cop,--,true or false, time_dep_hp_cop,--,"{true, false}",
heat_pump_sink_T,°C,float, heat_pump_sink_T,°C,float,
reduce_space_heat_exogenously,--,true or false, reduce_space_heat_exogenously,--,"{true, false}",
reduce_space_heat_exogenously_factor,--,Dictionary with planning horizons as keys., reduce_space_heat_exogenously_factor,--,Dictionary with planning horizons as keys.,
retrofitting,,, retrofitting,,,
-- retro_endogen,--,true or false,Add retrofitting as an endogenous system which co-optimise space heat savings. -- retro_endogen,--,"{true, false}",Add retrofitting as an endogenous system which co-optimise space heat savings.
-- cost_factor,,,Weight costs for building renovation -- cost_factor,,,Weight costs for building renovation
-- interest_rate,,,The interest rate for investment in building components -- interest_rate,,,The interest rate for investment in building components
-- annualise_cost,--,true or false,Annualise the investment costs of retrofitting -- annualise_cost,--,"{true, false}",Annualise the investment costs of retrofitting
-- tax_weighting,--,true or false,Weight the costs of retrofitting depending on taxes in countries -- tax_weighting,--,"{true, false}",Weight the costs of retrofitting depending on taxes in countries
-- construction_index,--,true or false,Weight the costs of retrofitting depending on labour/material costs per country -- construction_index,--,"{true, false}",Weight the costs of retrofitting depending on labour/material costs per country
tes,--,true or false,Add option for storing thermal energy in large water pits associated with district heating systems and individual thermal energy storage (TES) tes,--,"{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,,,
-- decentral,,, -- decentral,,,
-- central,,, -- central,,,
boilers,--,true or false,Add option for transforming electricity into heat using resistive heater boilers,--,"{true, false}",Add option for transforming electricity into heat using resistive heater
oil_boilers,--,true or false,Add option for transforming oil into heat using boilers oil_boilers,--,"{true, false}",Add option for transforming oil into heat using boilers
biomass_boiler,--,true or false,Add option for transforming biomass into heat using boilers biomass_boiler,--,"{true, false}",Add option for transforming biomass into heat using boilers
chp,--,true or false,Add option for using Combined Heat and Power (CHP) chp,--,"{true, false}",Add option for using Combined Heat and Power (CHP)
micro_chp,--,true or false,Add option for using Combined Heat and Power (CHP) for decentral areas. micro_chp,--,"{true, false}",Add option for using Combined Heat and Power (CHP) for decentral areas.
solar_thermal,--,true or false,Add option for using solar to generate heat. solar_thermal,--,"{true, false}",Add option for using solar to generate heat.
solar_cf_correction,,, solar_cf_correction,,,
marginal_cost_storage,,, marginal_cost_storage,,,
methanation,--,true or false,Add option for transforming hydrogen and CO2 into methane using methanation. methanation,--,"{true, false}",Add option for transforming hydrogen and CO2 into methane using methanation.
helmeth,--,true or false,Add option for transforming power into gas using HELMETH (Integrated High-Temperature ELectrolysis and METHanation for Effective Power to Gas Conversion) 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 or false,Add option for coal CHPs with carbon capture coal_cc,--,"{true, false}",Add option for coal CHPs with carbon capture
dac,--,true or false,Add option for Direct Air Capture (DAC) dac,--,"{true, false}",Add option for Direct Air Capture (DAC)
co2_vent,--,true or false,Add option for vent out CO2 from storages to the atmosphere. co2_vent,--,"{true, false}",Add option for vent out CO2 from storages to the atmosphere.
allam_cycle,--,true or false,Add option to include `Allam cycle gas power plants <https://en.wikipedia.org/wiki/Allam_power_cycle>`_ allam_cycle,--,"{true, false}",Add option to include `Allam cycle gas power plants <https://en.wikipedia.org/wiki/Allam_power_cycle>`_
hydrogen_fuel_cell,--,true or false,Add option to include hydrogen fuel cell 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
hydrogen_turbine,--,true or false,Add option to include hydrogen turbine for re-electrification. Assuming OCGT technology costs hydrogen_turbine,--,"{true, false}",Add option to include hydrogen turbine for re-electrification. Assuming OCGT technology costs
SMR,--,true or false,Add option for transforming natural gas into hydrogen and CO2 using Steam Methane Reforming (SMR) SMR,--,"{true, false}",Add option for transforming natural gas into hydrogen and CO2 using Steam Methane Reforming (SMR)
regional_co2_sequestration_potential,,, regional_co2_sequestration_potential,,,
-- enable,--,true or false,Add option for regionally-resolved geological carbon dioxide sequestration potentials based on `CO2StoP <https://setis.ec.europa.eu/european-co2-storage-database_en>`_. -- 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,,,
-- include_onshore,,true or false,Add options for including onshore sequestration potentials -- include_onshore,,"{true, false}",Add options for including onshore sequestration potentials
-- min_size,,float,Any sites with lower potential than this value will be excluded -- min_size,,float,Any sites with lower potential than this value will be excluded
-- max_size,,float,The maximum sequestration potential for any one site. -- max_size,,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,,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_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,EUR/tCO2,float,The cost of sequestering a ton of CO2
co2_spatial,--,true or false,"„Add option to spatially resolve carrier representing stored carbon dioxide. This allows for more detailed modelling of CCUTS, e.g. regarding the capturing of industrial process emissions, usage as feedstock for electrofuels, transport of carbon dioxide, and geological sequestration sites.“" 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 or false,Add option for planning a new carbon dioxide network 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,,,The default fraction of CO2 captured with post-combustion capture
hydrogen_underground_storage,--,true or false,Add options for storing hydrogen underground. Storage potential depends regionally. hydrogen_underground_storage,--,"{true, false}",Add options for storing hydrogen underground. Storage potential depends regionally.
hydrogen_underground_storage_locations,,"„onshore, nearshore or offshore“","„The location where hydrogen underground storage can be located. Onshore, nearshore, offshore means it must be located more than 50 km away from the sea, within 50 km of the sea, or within the sea itself respectively.“" 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 or 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) or ""regional"" (regionalised NH3 without network)"
min_part_load_fischer_tropsch,,, min_part_load_fischer_tropsch,,,
min_part_load_methanolisation,,, min_part_load_methanolisation,,,
use_fischer_tropsch_waste_heat,--,true or false,Add option for using waste heat of Fischer Tropsch in district heating networks use_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 or false,Add option for using waste heat of fuel cells 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 or false,Add option for using waste heat of electrolysis in district heating networks use_electrolysis_waste_heat,--,"{true, false}",Add option for using waste heat of electrolysis in district heating networks
electricity_distribution_grid,--,true or false,Add a electricity distribution grid electricity_distribution_grid,--,"{true, false}",Add a electricity distribution grid
electricity_distribution_grid_cost_factor,,,Multiplies the investment cost of the electricity distribution grid in data/costs.csv electricity_distribution_grid_cost_factor,,,Multiplies the investment cost of the electricity distribution grid in data/costs.csv
electricity_grid_connection,--,true or false,Add the cost of electricity grid connection for onshore wind and solar electricity_grid_connection,--,"{true, false}",Add the cost of electricity grid connection for onshore wind and solar
H2_network,--,true or false,Add option for new hydrogen pipelines H2_network,--,"{true, false}",Add option for new hydrogen pipelines
gas_network,--,true or false,"Add natural gas infrastructure, incl. LNG terminals, production and entry-points" gas_network,--,"{true, false}","Add natural gas infrastructure, incl. LNG terminals, production and entry-points"
H2_retrofit,--,true or false,Add option for retrofiting existing pipelines to transport hydrogen H2_retrofit,--,"{true, false}",Add option for retrofiting existing pipelines to transport hydrogen
H2_retrofit_capacity_per_CH4,,, H2_retrofit_capacity_per_CH4,,,
gas_distribution_grid,--,true or false,Add a gas distribution grid gas_distribution_grid,--,"{true, false}",Add a gas distribution grid
gas_distribution_grid_cost_factor,,,Multiplies the investment cost of the gas distribution grid in data/costs.csv gas_distribution_grid_cost_factor,,,Multiplies the investment cost of the gas distribution grid in data/costs.csv
biomass_spatial,--,true or false,Add option for resolving biomass demand regionally biomass_spatial,--,"{true, false}",Add option for resolving biomass demand regionally
biomass_transport,--,true or false,Add option for transporting solid biomass between nodes 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. conventional_generation,,,Add a more detailed description of conventional carriers. Any power generation requires the consumption of fuel from nodes representing that fuel.
biomass_to_liquid,--,true or false,Add option for transforming solid biomass into liquid fuel with the same properties as oil biomass_to_liquid,--,"{true, false}",Add option for transforming solid biomass into liquid fuel with the same properties as oil
biosng,--,true or false,Add option for transforming solid biomass into synthesis gas with the same properties as natural gas biosng,--,"{true, false}",Add option for transforming solid biomass into synthesis gas with the same properties as natural gas

1 Unit Values Description
3 -- 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
4 -- 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
5 -- district_heating_loss -- float
6 cluster_heat_buses -- true or false {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.
7 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>`_.
8 bev_dsm_restriction_time -- float Time at which SOC of BEV has to be dsm_restriction_value
9 transport_heating_deadband_upper °C float The minimum temperature in the vehicle. At lower temperatures, the energy required for heating in the vehicle increases.
12 ICE_upper_degree_factor -- float Percentage increase in energy demand in internal combustion engine (ICE) for each degree difference between the hot environment and the maximum temperature.
13 EV_lower_degree_factor -- float Percentage increase in energy demand in electric vehicles (EV) for each degree difference between the cold environment and the minimum temperature.
14 EV_upper_degree_factor -- float Percentage increase in energy demand in electric vehicles (EV) for each degree difference between the hot environment and the maximum temperature.
15 bev_dsm -- true or false {true, false} Add the option for battery electric vehicles (BEV) to manage its own energy demand (DSM)
16 bev_availability -- float The percentage for battery electric vehicles (BEV) that are able to do demand side management (DSM)
17 bev_energy -- float The average size of battery electric vehicles (BEV) in MWh
18 bev_charge_efficiency -- float Battery electric vehicles (BEV) charge and discharge efficiency
20 bev_charge_rate MWh float The power consumption for one electric vehicle (EV) in MWh. Value derived from 3-phase charger with 11 kW.
21 bev_avail_max -- float The maximum percentage plugged-in availability for passenger electric vehicles.
22 bev_avail_mean -- float The average percentage plugged-in availability for passenger electric vehicles.
23 v2g -- true or false {true, false} Allows feed-in to grid from EV battery
24 land_transport_fuel_cell_share -- Dictionary with planning horizons as keys. The share of vehicles that uses fuel cells in a given year
25 land_transport_electric_share -- Dictionary with planning horizons as keys. The share of vehicles that uses electric vehicles (EV) in a given year
26 land_transport_ice_share -- Dictionary with planning horizons as keys. The share of vehicles that uses internal combustion engines (ICE) in a given year
33 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.
34 MWh_MeOH_per_tCO2 LHV float The energy amount of the produced methanol per ton of CO2
35 MWh_MeOH_per_MWh_e LHV float The energy amount of the produced methanol per energy amount of electricity
36 shipping_hydrogen_liquefaction -- true or false {true, false} Consider whether to include liquefaction costs for shipping H2 demand.
37 shipping_hydrogen_share -- Dictionary with planning horizons as keys. The share of ships powered by hydrogen in a given year
38 shipping_methanol_share -- Dictionary with planning horizons as keys. The share of ships powered by methanol in a given year
39 shipping_oil_share -- Dictionary with planning horizons as keys. The share of ships powered by oil in a given year
41 shipping_oil_efficiency -- float The efficiency of oil-powered ships in the conversion of oil to meet shipping needs.
42 aviation_demand_factor -- float The proportion of demand for aviation compared to today's
43 HVC_demand_factor -- float The proportion of demand for high-value chemicals compared to today's
44 time_dep_hp_cop -- true or false {true, false}
45 heat_pump_sink_T °C float
46 reduce_space_heat_exogenously -- true or false {true, false}
47 reduce_space_heat_exogenously_factor -- Dictionary with planning horizons as keys.
48 retrofitting
49 -- retro_endogen -- true or false {true, false} Add retrofitting as an endogenous system which co-optimise space heat savings.
50 -- cost_factor Weight costs for building renovation
51 -- interest_rate The interest rate for investment in building components
52 -- annualise_cost -- true or false {true, false} Annualise the investment costs of retrofitting
53 -- tax_weighting -- true or false {true, false} Weight the costs of retrofitting depending on taxes in countries
54 -- construction_index -- true or false {true, false} Weight the costs of retrofitting depending on labour/material costs per country
55 tes -- true or false {true, false} Add option for storing thermal energy in large water pits associated with district heating systems and individual thermal energy storage (TES)
56 tes_tau
57 -- decentral
58 -- central
59 boilers -- true or false {true, false} Add option for transforming electricity into heat using resistive heater
60 oil_boilers -- true or false {true, false} Add option for transforming oil into heat using boilers
61 biomass_boiler -- true or false {true, false} Add option for transforming biomass into heat using boilers
62 chp -- true or false {true, false} Add option for using Combined Heat and Power (CHP)
63 micro_chp -- true or false {true, false} Add option for using Combined Heat and Power (CHP) for decentral areas.
64 solar_thermal -- true or false {true, false} Add option for using solar to generate heat.
65 solar_cf_correction
66 marginal_cost_storage
67 methanation -- true or false {true, false} Add option for transforming hydrogen and CO2 into methane using methanation.
68 helmeth -- true or false {true, false} Add option for transforming power into gas using HELMETH (Integrated High-Temperature ELectrolysis and METHanation for Effective Power to Gas Conversion)
69 coal_cc -- true or false {true, false} Add option for coal CHPs with carbon capture
70 dac -- true or false {true, false} Add option for Direct Air Capture (DAC)
71 co2_vent -- true or false {true, false} Add option for vent out CO2 from storages to the atmosphere.
72 allam_cycle -- true or false {true, false} Add option to include `Allam cycle gas power plants <https://en.wikipedia.org/wiki/Allam_power_cycle>`_
73 hydrogen_fuel_cell -- true or false {true, false} Add option to include hydrogen fuel cell for re-electrification. Assuming OCGT technology costs
74 hydrogen_turbine -- true or false {true, false} Add option to include hydrogen turbine for re-electrification. Assuming OCGT technology costs
75 SMR -- true or false {true, false} Add option for transforming natural gas into hydrogen and CO2 using Steam Methane Reforming (SMR)
76 regional_co2_sequestration_potential
77 -- enable -- true or false {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>`_.
78 -- attribute
79 -- include_onshore true or false {true, false} Add options for including onshore sequestration potentials
80 -- min_size float Any sites with lower potential than this value will be excluded
81 -- max_size float The maximum sequestration potential for any one site.
82 -- years_of_storage float The years until potential exhausted at optimised annual rate
83 co2_sequestration_potential MtCO2/a float The potential of sequestering CO2 in Europe per year
84 co2_sequestration_cost EUR/tCO2 float The cost of sequestering a ton of CO2
85 co2_spatial -- true or false {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.“
86 co2network -- true or false {true, false} Add option for planning a new carbon dioxide network
87 cc_fraction The default fraction of CO2 captured with post-combustion capture
88 hydrogen_underground_storage -- true or false {true, false} Add options for storing hydrogen underground. Storage potential depends regionally.
89 hydrogen_underground_storage_locations „onshore, nearshore or offshore“ {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.“
90 ammonia -- „true, false or regional“ {true, false, regional} Add ammonia as a carrrier. It can be either true (copperplated NH3) or "regional" (regionalised NH3 without network)
91 min_part_load_fischer_tropsch
92 min_part_load_methanolisation
93 use_fischer_tropsch_waste_heat -- true or false {true, false} Add option for using waste heat of Fischer Tropsch in district heating networks
94 use_fuel_cell_waste_heat -- true or false {true, false} Add option for using waste heat of fuel cells in district heating networks
95 use_electrolysis_waste_heat -- true or false {true, false} Add option for using waste heat of electrolysis in district heating networks
96 electricity_distribution_grid -- true or false {true, false} Add a electricity distribution grid
97 electricity_distribution_grid_cost_factor Multiplies the investment cost of the electricity distribution grid in data/costs.csv
98 electricity_grid_connection -- true or false {true, false} Add the cost of electricity grid connection for onshore wind and solar
99 H2_network -- true or false {true, false} Add option for new hydrogen pipelines
100 gas_network -- true or false {true, false} Add natural gas infrastructure, incl. LNG terminals, production and entry-points
101 H2_retrofit -- true or false {true, false} Add option for retrofiting existing pipelines to transport hydrogen
102 H2_retrofit_capacity_per_CH4
103 gas_distribution_grid -- true or false {true, false} Add a gas distribution grid
104 gas_distribution_grid_cost_factor Multiplies the investment cost of the gas distribution grid in data/costs.csv
105 biomass_spatial -- true or false {true, false} Add option for resolving biomass demand regionally
106 biomass_transport -- true or false {true, false} Add option for transporting solid biomass between nodes
107 conventional_generation Add a more detailed description of conventional carriers. Any power generation requires the consumption of fuel from nodes representing that fuel.
108 biomass_to_liquid -- true or false {true, false} Add option for transforming solid biomass into liquid fuel with the same properties as oil
109 biosng -- true or false {true, false} Add option for transforming solid biomass into synthesis gas with the same properties as natural gas

5
doc/configtables/solar-thermal.csv Normal file
View File

@ -0,0 +1,5 @@
,Unit,Values,Description
clearsky_model ,--,"{‘simple’, ‘enhanced’}",Type of clearsky model for diffuse irradiation
orientation ,--,"{units of degrees, ‘latitude_optimal’}",Panel orientation with slope and azimuth
-- azimuth,float,units of degrees,The angle between the north and the sun with panels on the local horizon
-- slope,float,units of degrees,The angle between the ground and the panels
1 Unit Values Description
2 clearsky_model -- {‘simple’, ‘enhanced’} Type of clearsky model for diffuse irradiation
3 orientation -- {units of degrees, ‘latitude_optimal’} Panel orientation with slope and azimuth
4 -- azimuth float units of degrees The angle between the north and the sun with panels on the local horizon
5 -- slope float units of degrees The angle between the ground and the panels

56
doc/configuration.rst
View File

@ -398,14 +398,15 @@ overwrite the existing values.
.. note:: .. note::
Only used for sector-coupling studies. Only used for sector-coupling studies.
.. warning::
More comprehensive documentation for this segment will be released soon.
.. literalinclude:: ../config/config.default.yaml .. literalinclude:: ../config/config.default.yaml
:language: yaml :language: yaml
:start-at: energy: :start-at: energy:
:end-before: # docs :end-before: # docs
.. csv-table::
:header-rows: 1
:widths: 25,7,22,30
:file: configtables/energy.csv
.. _biomass_cf: .. _biomass_cf:
@ -415,14 +416,36 @@ overwrite the existing values.
.. note:: .. note::
Only used for sector-coupling studies. Only used for sector-coupling studies.
.. warning::
More comprehensive documentation for this segment will be released soon.
.. literalinclude:: ../config/config.default.yaml .. literalinclude:: ../config/config.default.yaml
:language: yaml :language: yaml
:start-at: biomass: :start-at: biomass:
:end-before: # docs :end-before: # docs
.. csv-table::
:header-rows: 1
:widths: 25,7,22,30
:file: configtables/biomass.csv
The list of available biomass is given by the category in `ENSPRESO_BIOMASS <https://cidportal.jrc.ec.europa.eu/ftp/jrc-opendata/ENSPRESO/ENSPRESO_BIOMASS.xlsx>`_, namely:
- Agricultural waste
- Manure solid, liquid
- Residues from landscape care
- Bioethanol barley, wheat, grain maize, oats, other cereals and rye
- Sugar from sugar beet
- Miscanthus, switchgrass, RCG
- Willow
- Poplar
- Sunflower, soya seed
- Rape seed
- Fuelwood residues
- FuelwoodRW
- C&P_RW
- Secondary Forestry residues - woodchips
- Sawdust
- Municipal waste
- Sludge
.. _solar_thermal_cf: .. _solar_thermal_cf:
``solar_thermal`` ``solar_thermal``
@ -431,30 +454,34 @@ overwrite the existing values.
.. note:: .. note::
Only used for sector-coupling studies. Only used for sector-coupling studies.
.. warning::
More comprehensive documentation for this segment will be released soon.
.. literalinclude:: ../config/config.default.yaml .. literalinclude:: ../config/config.default.yaml
:language: yaml :language: yaml
:start-at: solar_thermal: :start-at: solar_thermal:
:end-before: # docs :end-before: # docs
.. csv-table::
:header-rows: 1
:widths: 25,7,22,30
:file: configtables/solar-thermal.csv
.. _existing_capacities_cf: .. _existing_capacities_cf:
``existing_capacities`` ``existing_capacities``
======================= =======================
.. note:: .. note::
Only used for sector-coupling studies. Only used for sector-coupling studies. The value for grouping years are only used in myopic scenarios.
.. warning::
More comprehensive documentation for this segment will be released soon.
.. literalinclude:: ../config/config.default.yaml .. literalinclude:: ../config/config.default.yaml
:language: yaml :language: yaml
:start-at: existing_capacities: :start-at: existing_capacities:
:end-before: # docs :end-before: # docs
.. csv-table::
:header-rows: 1
:widths: 25,7,22,30
:file: configtables/existing_capacities.csv
.. _sector_cf: .. _sector_cf:
``sector`` ``sector``
@ -463,9 +490,6 @@ overwrite the existing values.
.. note:: .. note::
Only used for sector-coupling studies. Only used for sector-coupling studies.
.. warning::
More comprehensive documentation for this segment will be released soon.
.. literalinclude:: ../config/config.default.yaml .. literalinclude:: ../config/config.default.yaml
:language: yaml :language: yaml
:start-at: sector: :start-at: sector: