pypsa-eur/doc/configtables/sector.csv
2024-08-08 17:17:33 +02:00

20 KiB

1UnitValuesDescription
2transport--{true, false}Flag to include transport sector.
3heating--{true, false}Flag to include heating sector.
4biomass--{true, false}Flag to include biomass sector.
5industry--{true, false}Flag to include industry sector.
6agriculture--{true, false}Flag to include agriculture sector.
7fossil_fuels--{true, false}Flag to include imports of fossil fuels ( ["coal", "gas", "oil", "lignite"])
8district_heating--`prepare_sector_network.py <https://github.com/PyPSA/pypsa-eur-sec/blob/master/scripts/prepare_sector_network.py>`_
9-- potential--floatmaximum fraction of urban demand which can be supplied by district heating
10-- 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
11-- district_heating_loss--floatShare increase in district heat demand in urban central due to heat losses
12-- forward_temperature°CDictionary with country codes as keys. One key must be 'default'.Forward temperature in district heating
13-- return_temperature°CDictionary with country codes as keys. One key must be 'default'.Return temperature in district heating. Must be lower than forward temperature
14-- heat_source_coolingKfloatCooling of heat source for heat pumps
15-- heat_pump_cop_approximation
16-- -- refrigerant--{ammonia, isobutane}Heat pump refrigerant assumed for COP approximation
17-- -- heat_exchanger_pinch_point_temperature_differenceKfloatHeat pump pinch point temperature difference in heat exchangers assumed for approximation.
18-- -- isentropic_compressor_efficiency--floatIsentropic efficiency of heat pump compressor assumed for approximation. Must be between 0 and 1.
19-- -- heat_loss--floatHeat pump heat loss assumed for approximation. Must be between 0 and 1.
20-- heat_pump_sources--
21-- -- urban central--List of heat sources for heat pumps in urban central heating
22-- -- urban decentral--List of heat sources for heat pumps in urban decentral heating
23-- -- rural--List of heat sources for heat pumps in rural heating
24cluster_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.
25
26bev_dsm_restriction _value--floatAdds 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
27bev_dsm_restriction _time--floatTime at which SOC of BEV has to be dsm_restriction_value
28transport_heating _deadband_upper°CfloatThe maximum temperature in the vehicle. At higher temperatures, the energy required for cooling in the vehicle increases.
29transport_heating _deadband_lower°CfloatThe minimum temperature in the vehicle. At lower temperatures, the energy required for heating in the vehicle increases.
30
31ICE_lower_degree_factor--floatShare increase in energy demand in internal combustion engine (ICE) for each degree difference between the cold environment and the minimum temperature.
32ICE_upper_degree_factor--floatShare increase in energy demand in internal combustion engine (ICE) for each degree difference between the hot environment and the maximum temperature.
33EV_lower_degree_factor--floatShare increase in energy demand in electric vehicles (EV) for each degree difference between the cold environment and the minimum temperature.
34EV_upper_degree_factor--floatShare increase in energy demand in electric vehicles (EV) for each degree difference between the hot environment and the maximum temperature.
35bev_dsm--{true, false}Add the option for battery electric vehicles (BEV) to participate in demand-side management (DSM)
36
37bev_availability--floatThe share for battery electric vehicles (BEV) that are able to do demand side management (DSM)
38bev_energy--floatThe average size of battery electric vehicles (BEV) in MWh
39bev_charge_efficiency--floatBattery electric vehicles (BEV) charge and discharge efficiency
40bev_charge_rateMWhfloatThe power consumption for one electric vehicle (EV) in MWh. Value derived from 3-phase charger with 11 kW.
41bev_avail_max--floatThe maximum share plugged-in availability for passenger electric vehicles.
42bev_avail_mean--floatThe average share plugged-in availability for passenger electric vehicles.
43v2g--{true, false}Allows feed-in to grid from EV battery
44land_transport_fuel_cell _share--Dictionary with planning horizons as keys.The share of vehicles that uses fuel cells in a given year
45land_transport_electric _share--Dictionary with planning horizons as keys.The share of vehicles that uses electric vehicles (EV) in a given year
46land_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.
47transport_electric_efficiencyMWh/100kmfloatThe conversion efficiencies of electric vehicles in transport
48transport_fuel_cell_efficiencyMWh/100kmfloatThe H2 conversion efficiencies of fuel cells in transport
49transport_ice_efficiencyMWh/100kmfloatThe oil conversion efficiencies of internal combustion engine (ICE) in transport
50agriculture_machinery _electric_share--floatThe share for agricultural machinery that uses electricity
51agriculture_machinery _oil_share--floatThe share for agricultural machinery that uses oil
52agriculture_machinery _fuel_efficiency--floatThe efficiency of electric-powered machinery in the conversion of electricity to meet agricultural needs.
53agriculture_machinery _electric_efficiency--floatThe efficiency of oil-powered machinery in the conversion of oil to meet agricultural needs.
54Mwh_MeOH_per_MWh_H2LHVfloatThe 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.
55MWh_MeOH_per_tCO2LHVfloatThe 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.
56MWh_MeOH_per_MWh_eLHVfloatThe 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.
57shipping_hydrogen _liquefaction--{true, false}Whether to include liquefaction costs for hydrogen demand in shipping.
58
59shipping_hydrogen_share--Dictionary with planning horizons as keys.The share of ships powered by hydrogen in a given year
60shipping_methanol_share--Dictionary with planning horizons as keys.The share of ships powered by methanol in a given year
61shipping_oil_share--Dictionary with planning horizons as keys.The share of ships powered by oil in a given year
62shipping_methanol _efficiency--floatThe 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>`_
63
64shipping_oil_efficiency--floatThe efficiency of oil-powered ships in the conversion of oil to meet shipping needs (propulsion). Base value derived from 2011
65aviation_demand_factor--floatThe proportion of demand for aviation compared to today's consumption
66HVC_demand_factor--floatThe proportion of demand for high-value chemicals compared to today's consumption
67
68time_dep_hp_cop--{true, false}Consider the time dependent coefficient of performance (COP) of the heat pump
69heat_pump_sink_T°CfloatThe 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
70reduce_space_heat _exogenously--{true, false}Influence on space heating demand by a certain factor (applied before losses in district heating).
71reduce_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>`_
72retrofitting
73-- retro_endogen--{true, false}Add retrofitting as an endogenous system which co-optimise space heat savings.
74-- cost_factor--floatWeight costs for building renovation
75-- interest_rate--floatThe interest rate for investment in building components
76-- annualise_cost--{true, false}Annualise the investment costs of retrofitting
77-- tax_weighting--{true, false}Weight the costs of retrofitting depending on taxes in countries
78-- construction_index--{true, false}Weight the costs of retrofitting depending on labour/material costs per country
79tes--{true, false}Add option for storing thermal energy in large water pits associated with district heating systems and individual thermal energy storage (TES)
80tes_tauThe time constant used to calculate the decay of thermal energy in thermal energy storage (TES): 1- :math:`e^{-1/24τ}`.
81-- decentraldaysfloatThe time constant in decentralized thermal energy storage (TES)
82-- centraldaysfloatThe time constant in centralized thermal energy storage (TES)
83boilers--{true, false}Add option for transforming gas into heat using gas boilers
84resistive_heaters--{true, false}Add option for transforming electricity into heat using resistive heaters (independently from gas boilers)
85oil_boilers--{true, false}Add option for transforming oil into heat using boilers
86biomass_boiler--{true, false}Add option for transforming biomass into heat using boilers
87overdimension_individual_heating--floatAdd 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.
88chp--{true, false}Add option for using Combined Heat and Power (CHP)
89micro_chp--{true, false}Add option for using Combined Heat and Power (CHP) for decentral areas.
90solar_thermal--{true, false}Add option for using solar thermal to generate heat.
91solar_cf_correction--floatThe correction factor for the value provided by the solar thermal profile calculations
92marginal_cost_storagecurrency/MWh floatThe marginal cost of discharging batteries in distributed grids
93methanation--{true, false}Add option for transforming hydrogen and CO2 into methane using methanation.
94coal_cc--{true, false}Add option for coal CHPs with carbon capture
95dac--{true, false}Add option for Direct Air Capture (DAC)
96co2_vent--{true, false}Add option for vent out CO2 from storages to the atmosphere.
97allam_cycle--{true, false}Add option to include `Allam cycle gas power plants <https://en.wikipedia.org/wiki/Allam_power_cycle>`_
98hydrogen_fuel_cell--{true, false}Add option to include hydrogen fuel cell for re-electrification. Assuming OCGT technology costs
99hydrogen_turbine--{true, false}Add option to include hydrogen turbine for re-electrification. Assuming OCGT technology costs
100SMR--{true, false}Add option for transforming natural gas into hydrogen and CO2 using Steam Methane Reforming (SMR)
101SMR CC--{true, false}Add option for transforming natural gas into hydrogen and CO2 using Steam Methane Reforming (SMR) and Carbon Capture (CC)
102regional_methanol_demand--{true, false}Spatially resolve methanol demand. Set to true if regional CO2 constraints needed.
103regional_oil_demand--{true, false}Spatially resolve oil demand. Set to true if regional CO2 constraints needed.
104regional_co2 _sequestration_potential
105-- 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>`_.
106-- attribute--string or listName (or list of names) of the attribute(s) for the sequestration potential
107-- include_onshore--{true, false}Add options for including onshore sequestration potentials
108-- min_sizeGt floatAny sites with lower potential than this value will be excluded
109-- max_sizeGt floatThe maximum sequestration potential for any one site.
110-- years_of_storageyearsfloatThe years until potential exhausted at optimised annual rate
111co2_sequestration_potentialMtCO2/afloatThe potential of sequestering CO2 in Europe per year
112co2_sequestration_costcurrency/tCO2floatThe cost of sequestering a ton of CO2
113co2_sequestration_lifetimeyearsintThe lifetime of a CO2 sequestration site
114co2_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.
115
116co2network--{true, false}Add option for planning a new carbon dioxide transmission network
117co2_network_cost_factorp.u.floatThe cost factor for the capital cost of the carbon dioxide transmission network
118
119cc_fraction--floatThe default fraction of CO2 captured with post-combustion capture
120hydrogen_underground _storage--{true, false}Add options for storing hydrogen underground. Storage potential depends regionally.
121hydrogen_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.
122
123ammonia--{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)
124min_part_load_fischer _tropschper unit of p_nom floatThe minimum unit dispatch (``p_min_pu``) for the Fischer-Tropsch process
125min_part_load _methanolisationper unit of p_nom floatThe minimum unit dispatch (``p_min_pu``) for the methanolisation process
126
127use_fischer_tropsch _waste_heat--{true, false}Add option for using waste heat of Fischer Tropsch in district heating networks
128use_fuel_cell_waste_heat--{true, false}Add option for using waste heat of fuel cells in district heating networks
129use_electrolysis_waste _heat--{true, false}Add option for using waste heat of electrolysis in district heating networks
130electricity_transmission _grid--{true, false}Switch for enabling/disabling the electricity transmission grid.
131electricity_distribution _grid--{true, false}Add a simplified representation of the exchange capacity between transmission and distribution grid level through a link.
132electricity_distribution _grid_cost_factorMultiplies the investment cost of the electricity distribution grid
133
134electricity_grid _connection--{true, false}Add the cost of electricity grid connection for onshore wind and solar
135transmission_efficiencySection to specify transmission losses or compression energy demands of bidirectional links. Splits them into two capacity-linked unidirectional links.
136-- {carrier}--strThe carrier of the link.
137-- -- efficiency_staticp.u.floatLength-independent transmission efficiency.
138-- -- efficiency_per_1000kmp.u. per 1000 kmfloatLength-dependent transmission efficiency ($\eta^{\text{length}}$)
139-- -- compression_per_1000kmp.u. per 1000 kmfloatLength-dependent electricity demand for compression ($\eta \cdot \text{length}$) implemented as multi-link to local electricity bus.
140H2_network--{true, false}Add option for new hydrogen pipelines
141gas_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.
142H2_retrofit--{true, false}Add option for retrofiting existing pipelines to transport hydrogen.
143H2_retrofit_capacity _per_CH4--floatThe 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.
144gas_network_connectivity _upgrade --floatThe 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
145gas_distribution_grid--{true, false}Add a gas distribution grid
146gas_distribution_grid _cost_factorMultiplier for the investment cost of the gas distribution grid
147
148biomass_spatial--{true, false}Add option for resolving biomass demand regionally
149biomass_transport--{true, false}Add option for transporting solid biomass between nodes
150biogas_upgrading_cc--{true, false}Add option to capture CO2 from biomass upgrading
151conventional_generationAdd a more detailed description of conventional carriers. Any power generation requires the consumption of fuel from nodes representing that fuel.
152biomass_to_liquid--{true, false}Add option for transforming solid biomass into liquid fuel with the same properties as oil
153biosng--{true, false}Add option for transforming solid biomass into synthesis gas with the same properties as natural gas
154municipal_solid_waste--{true, false}Add option for municipal solid waste
155limit_max_growth
156-- enable--{true, false}Add option to limit the maximum growth of a carrier
157-- factorp.u.floatThe maximum growth factor of a carrier (e.g. 1.3 allows 30% larger than max historic growth)
158-- max_growth
159-- -- {carrier}GWfloatThe historic maximum growth of a carrier
160-- max_relative_growth
161-- -- {carrier}p.u.floatThe historic maximum relative growth of a carrier
162
163enhanced_geothermal
164-- enable--{true, false}Add option to include Enhanced Geothermal Systems
165-- flexible--{true, false}Add option for flexible operation (see Ricks et al. 2024)
166-- max_hours--intThe maximum hours the reservoir can be charged under flexible operation
167-- max_boost--floatThe maximum boost in power output under flexible operation
168-- var_cf--{true, false}Add option for variable capacity factor (see Ricks et al. 2024)
169-- sustainability_factor--floatShare 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>`_)
170solid_biomass_import
171-- enable--{true, false}Add option to include solid biomass imports
172-- pricecurrency/MWhfloatPrice for importing solid biomass
173-- max_amountTwhfloatMaximum solid biomass import potential
174-- upstream_emissions_factorp.u.floatUpstream emissions of solid biomass imports