From 9138901e5d35467331a1956dde856fff6c3e1d49 Mon Sep 17 00:00:00 2001 From: virio-andreyana Date: Mon, 3 Jul 2023 03:37:41 +0200 Subject: [PATCH] add table for biomass, energy, existing capacities, solar thermal, plotting (need suggestion) --- doc/configtables/biomass.csv | 7 ++ doc/configtables/energy.csv | 5 ++ doc/configtables/existing_capacities.csv | 5 ++ doc/configtables/plotting.csv | 29 +++++--- doc/configtables/sector.csv | 92 ++++++++++++------------ doc/configtables/solar-thermal.csv | 5 ++ doc/configuration.rst | 56 ++++++++++----- 7 files changed, 127 insertions(+), 72 deletions(-) create mode 100644 doc/configtables/biomass.csv create mode 100644 doc/configtables/energy.csv create mode 100644 doc/configtables/existing_capacities.csv create mode 100644 doc/configtables/solar-thermal.csv diff --git a/doc/configtables/biomass.csv b/doc/configtables/biomass.csv new file mode 100644 index 00000000..f5b4841f --- /dev/null +++ b/doc/configtables/biomass.csv @@ -0,0 +1,7 @@ +,Unit,Values,Description +year ,--,"{2010, 2020, 2030, 2040, 2050}",Year for which to retrieve biomass potential according to the assumptions of the `JRC ENSPRESO `_ . +scenario ,--,"{""ENS_Low"", ""ENS_Med"", ""ENS_High""}",Scenario for which to retrieve biomass potential. The scenario definition can be seen in `ENSPRESO_BIOMASS `_ +classes ,,, +-- solid biomass,--,Array of biomass comodity,The comodity that are included as solid biomass +-- not included,--,Array of biomass comodity,The comodity that are not included as a biomass potential +-- biogas,--,Array of biomass comodity,The comodity that are included as biogas diff --git a/doc/configtables/energy.csv b/doc/configtables/energy.csv new file mode 100644 index 00000000..640a9bc3 --- /dev/null +++ b/doc/configtables/energy.csv @@ -0,0 +1,5 @@ +,Unit,Values,Description +energy_totals_year ,--,"{1990,1995,2000,2005,2010,2011,…} ",The year for the sector energy use. The year must be avaliable in the Eurostat report +base_emissions_year ,--,YYYY; e.g. ‚1990‘ ,'The base year for the sector emissions. See `European Environment Agency (EEA) `_ downloaded 201228 (modified by EEA last on 201221)‘ +eurostat_report_year ,--,"{2016,2017,2018}","'The year in which the Eurostat report year are extracted. 2016 includes Bosnia and Herzegovina, 2017 does not‘" +emissions ,--,"{CO2, All greenhouse gases - (CO2 equivalent)}",Specify which sectoral emissions are taken into account. Data derived from EEA. diff --git a/doc/configtables/existing_capacities.csv b/doc/configtables/existing_capacities.csv new file mode 100644 index 00000000..6b53d5f1 --- /dev/null +++ b/doc/configtables/existing_capacities.csv @@ -0,0 +1,5 @@ +,Unit,Values,Description +grouping_years_power ,--,An array of years,Intervals to group existing capacities for power +grouping_years_heat ,--,An array of years below 2020,Intervals to group existing capacities for heat +threshold_capacity ,MW,float,Capacities generators and links of below threshold are removed during add_existing_capacities +conventional_carriers ,--,"Any subset of {uranium, coal, lignite, oil} ",List of conventional power plants to include in the sectoral network diff --git a/doc/configtables/plotting.csv b/doc/configtables/plotting.csv index bea345ca..82bf7af6 100644 --- a/doc/configtables/plotting.csv +++ b/doc/configtables/plotting.csv @@ -1,10 +1,19 @@ -,Unit,Values,Description -map,,, --- boundaries,°,"[x1,x2,y1,y2]","Boundaries of the map plots in degrees latitude (y) and longitude (x)" -costs_max,bn Euro,float,"Upper y-axis limit in cost bar plots." -costs_threshold,bn Euro,float,"Threshold below which technologies will not be shown in cost bar plots." -energy_max,TWh,float,"Upper y-axis limit in energy bar plots." -energy_min,TWh,float,"Lower y-axis limit in energy bar plots." -energy_threshold,TWh,float,"Threshold below which technologies will not be shown in energy bar plots." -tech_colors,--,"carrier -> HEX colour code","Mapping from network ``carrier`` to a colour (`HEX colour code `_)." -nice_names,--,"str -> str","Mapping from network ``carrier`` to a more readable name." +,Unit,Values,Description +map,,, +-- boundaries,°,"[x1,x2,y1,y2]",Boundaries of the map plots in degrees latitude (y) and longitude (x) +costs_max,bn Euro,float,Upper y-axis limit in cost bar plots. +costs_threshold,bn Euro,float,Threshold below which technologies will not be shown in cost bar plots. +energy_max,TWh,float,Upper y-axis limit in energy bar plots. +energy_min,TWh,float,Lower y-axis limit in energy bar plots. +energy_threshold,TWh,float,Threshold below which technologies will not be shown in energy bar plots. +tech_colors,--,carrier -> HEX colour code,Mapping from network ``carrier`` to a colour (`HEX colour code `_). +vre_techs ,--,subset of carriers,Value not in use +renewable_storage_techs ,--,subset of carriers,Value not in use +conv_techs ,--,subset of carriers,Value in use with unworthy significance. Used as the definition of conventional carrier in solve_network +storage_techs ,--,subset of carriers,Value not in use +load_carriers ,--,subset of carriers,Value not in use +AC_carriers ,--,subset of carriers,Value not in use +link_carriers ,--,subset of carriers,Value not in use +heat_links ,--,subset of carriers,Value not in use +heat_generators ,--,subset of carriers,Value not in use +nice_names,--,str -> str,Mapping from network ``carrier`` to a more readable name. diff --git a/doc/configtables/sector.csv b/doc/configtables/sector.csv index 6a6fcd0d..7a6f3c14 100644 --- a/doc/configtables/sector.csv +++ b/doc/configtables/sector.csv @@ -3,7 +3,7 @@ district_heating,--,,`prepare_sector_network.py `_ to one to save memory. +cluster_heat_buses,--,"{true, false}",cluster residential and service heat buses in `prepare_sector_network.py `_ to one to save memory. bev_dsm_restriction_value,--,float,Adding a stage of charge (SOC) limit for battery electric vehicles (BEV) to manage its own energy demand (DSM). Located in `build_transport_demand.py `_. bev_dsm_restriction_time,--,float,Time at which SOC of BEV has to be dsm_restriction_value transport_heating_deadband_upper,°C,float,"The minimum temperature in the vehicle. At lower temperatures, the energy required for heating in the vehicle increases." @@ -12,7 +12,7 @@ ICE_lower_degree_factor,--,float,Percentage increase in energy demand in interna ICE_upper_degree_factor,--,float,Percentage increase in energy demand in internal combustion engine (ICE) for each degree difference between the hot environment and the maximum temperature. EV_lower_degree_factor,--,float,Percentage increase in energy demand in electric vehicles (EV) for each degree difference between the cold environment and the minimum temperature. EV_upper_degree_factor,--,float,Percentage increase in energy demand in electric vehicles (EV) for each degree difference between the hot environment and the maximum temperature. -bev_dsm,--,true or false,Add the option for battery electric vehicles (BEV) to manage its own energy demand (DSM) +bev_dsm,--,"{true, false}",Add the option for battery electric vehicles (BEV) to manage its own energy demand (DSM) bev_availability,--,float,The percentage for battery electric vehicles (BEV) that are able to do demand side management (DSM) bev_energy,--,float,The average size of battery electric vehicles (BEV) in MWh bev_charge_efficiency,--,float,Battery electric vehicles (BEV) charge and discharge efficiency @@ -20,7 +20,7 @@ bev_plug_to_wheel_efficiency,km/kWh,float,The distance battery electric vehicles bev_charge_rate,MWh,float,The power consumption for one electric vehicle (EV) in MWh. Value derived from 3-phase charger with 11 kW. bev_avail_max,--,float,The maximum percentage plugged-in availability for passenger electric vehicles. bev_avail_mean,--,float,The average percentage plugged-in availability for passenger electric vehicles. -v2g,--,true or false,Allows feed-in to grid from EV battery +v2g,--,"{true, false}",Allows feed-in to grid from EV battery land_transport_fuel_cell_share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses fuel cells in a given year land_transport_electric_share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses electric vehicles (EV) in a given year land_transport_ice_share,--,Dictionary with planning horizons as keys.,The share of vehicles that uses internal combustion engines (ICE) in a given year @@ -33,7 +33,7 @@ agriculture_machinery_electric_efficiency,--,float,The efficiency of oil-powered MWh_MeOH_per_MWh_H2,LHV,float,The energy amount of the produced methanol per energy amount of hydrogen. source: DECHEMA (2017): Low carbon energy and feedstock for the European chemical industry page 64. MWh_MeOH_per_tCO2,LHV,float,The energy amount of the produced methanol per ton of CO2 MWh_MeOH_per_MWh_e,LHV,float,The energy amount of the produced methanol per energy amount of electricity -shipping_hydrogen_liquefaction,--,true or false,Consider whether to include liquefaction costs for shipping H2 demand. +shipping_hydrogen_liquefaction,--,"{true, false}",Consider whether to include liquefaction costs for shipping H2 demand. shipping_hydrogen_share,--,Dictionary with planning horizons as keys.,The share of ships powered by hydrogen in a given year shipping_methanol_share,--,Dictionary with planning horizons as keys.,The share of ships powered by methanol in a given year shipping_oil_share,--,Dictionary with planning horizons as keys.,The share of ships powered by oil in a given year @@ -41,69 +41,69 @@ shipping_methanol_efficiency,--,float,The efficiency of methanol-powered ships i shipping_oil_efficiency,--,float,The efficiency of oil-powered ships in the conversion of oil to meet shipping needs. aviation_demand_factor,--,float,The proportion of demand for aviation compared to today's HVC_demand_factor,--,float,The proportion of demand for high-value chemicals compared to today's -time_dep_hp_cop,--,true or false, +time_dep_hp_cop,--,"{true, false}", heat_pump_sink_T,°C,float, -reduce_space_heat_exogenously,--,true or false, +reduce_space_heat_exogenously,--,"{true, false}", reduce_space_heat_exogenously_factor,--,Dictionary with planning horizons as keys., retrofitting,,, --- retro_endogen,--,true or false,Add retrofitting as an endogenous system which co-optimise space heat savings. +-- retro_endogen,--,"{true, false}",Add retrofitting as an endogenous system which co-optimise space heat savings. -- cost_factor,,,Weight costs for building renovation -- interest_rate,,,The interest rate for investment in building components --- annualise_cost,--,true or false,Annualise the investment costs of retrofitting --- tax_weighting,--,true or false,Weight the costs of retrofitting depending on taxes in countries --- construction_index,--,true or false,Weight the costs of retrofitting depending on labour/material costs per country -tes,--,true or false,Add option for storing thermal energy in large water pits associated with district heating systems and individual thermal energy storage (TES) +-- annualise_cost,--,"{true, false}",Annualise the investment costs of retrofitting +-- tax_weighting,--,"{true, false}",Weight the costs of retrofitting depending on taxes in countries +-- construction_index,--,"{true, false}",Weight the costs of retrofitting depending on labour/material costs per country +tes,--,"{true, false}",Add option for storing thermal energy in large water pits associated with district heating systems and individual thermal energy storage (TES) tes_tau,,, -- decentral,,, -- central,,, -boilers,--,true or false,Add option for transforming electricity into heat using resistive heater -oil_boilers,--,true or false,Add option for transforming oil into heat using boilers -biomass_boiler,--,true or false,Add option for transforming biomass into heat using boilers -chp,--,true or false,Add option for using Combined Heat and Power (CHP) -micro_chp,--,true or false,Add option for using Combined Heat and Power (CHP) for decentral areas. -solar_thermal,--,true or false,Add option for using solar to generate heat. +boilers,--,"{true, false}",Add option for transforming electricity into heat using resistive heater +oil_boilers,--,"{true, false}",Add option for transforming oil into heat using boilers +biomass_boiler,--,"{true, false}",Add option for transforming biomass into heat using boilers +chp,--,"{true, false}",Add option for using Combined Heat and Power (CHP) +micro_chp,--,"{true, false}",Add option for using Combined Heat and Power (CHP) for decentral areas. +solar_thermal,--,"{true, false}",Add option for using solar to generate heat. solar_cf_correction,,, marginal_cost_storage,,, -methanation,--,true or false,Add option for transforming hydrogen and CO2 into methane using methanation. -helmeth,--,true or false,Add option for transforming power into gas using HELMETH (Integrated High-Temperature ELectrolysis and METHanation for Effective Power to Gas Conversion) -coal_cc,--,true or false,Add option for coal CHPs with carbon capture -dac,--,true or false,Add option for Direct Air Capture (DAC) -co2_vent,--,true or false,Add option for vent out CO2 from storages to the atmosphere. -allam_cycle,--,true or false,Add option to include `Allam cycle gas power plants `_ -hydrogen_fuel_cell,--,true or false,Add option to include hydrogen fuel cell for re-electrification. Assuming OCGT technology costs -hydrogen_turbine,--,true or false,Add option to include hydrogen turbine for re-electrification. Assuming OCGT technology costs -SMR,--,true or false,Add option for transforming natural gas into hydrogen and CO2 using Steam Methane Reforming (SMR) +methanation,--,"{true, false}",Add option for transforming hydrogen and CO2 into methane using methanation. +helmeth,--,"{true, false}",Add option for transforming power into gas using HELMETH (Integrated High-Temperature ELectrolysis and METHanation for Effective Power to Gas Conversion) +coal_cc,--,"{true, false}",Add option for coal CHPs with carbon capture +dac,--,"{true, false}",Add option for Direct Air Capture (DAC) +co2_vent,--,"{true, false}",Add option for vent out CO2 from storages to the atmosphere. +allam_cycle,--,"{true, false}",Add option to include `Allam cycle gas power plants `_ +hydrogen_fuel_cell,--,"{true, false}",Add option to include hydrogen fuel cell for re-electrification. Assuming OCGT technology costs +hydrogen_turbine,--,"{true, false}",Add option to include hydrogen turbine for re-electrification. Assuming OCGT technology costs +SMR,--,"{true, false}",Add option for transforming natural gas into hydrogen and CO2 using Steam Methane Reforming (SMR) regional_co2_sequestration_potential,,, --- enable,--,true or false,Add option for regionally-resolved geological carbon dioxide sequestration potentials based on `CO2StoP `_. +-- enable,--,"{true, false}",Add option for regionally-resolved geological carbon dioxide sequestration potentials based on `CO2StoP `_. -- attribute,,, --- include_onshore,,true or false,Add options for including onshore sequestration potentials +-- include_onshore,,"{true, false}",Add options for including onshore sequestration potentials -- min_size,,float,Any sites with lower potential than this value will be excluded -- max_size,,float,The maximum sequestration potential for any one site. -- years_of_storage,,float,The years until potential exhausted at optimised annual rate co2_sequestration_potential,MtCO2/a,float,The potential of sequestering CO2 in Europe per year co2_sequestration_cost,EUR/tCO2,float,The cost of sequestering a ton of CO2 -co2_spatial,--,true or false,"„Add option to spatially resolve carrier representing stored carbon dioxide. This allows for more detailed modelling of CCUTS, e.g. regarding the capturing of industrial process emissions, usage as feedstock for electrofuels, transport of carbon dioxide, and geological sequestration sites.“" -co2network,--,true or false,Add option for planning a new carbon dioxide network +co2_spatial,--,"{true, false}","„Add option to spatially resolve carrier representing stored carbon dioxide. This allows for more detailed modelling of CCUTS, e.g. regarding the capturing of industrial process emissions, usage as feedstock for electrofuels, transport of carbon dioxide, and geological sequestration sites.“" +co2network,--,"{true, false}",Add option for planning a new carbon dioxide network cc_fraction,,,The default fraction of CO2 captured with post-combustion capture -hydrogen_underground_storage,--,true or false,Add options for storing hydrogen underground. Storage potential depends regionally. -hydrogen_underground_storage_locations,,"„onshore, nearshore or offshore“","„The location where hydrogen underground storage can be located. Onshore, nearshore, offshore means it must be located more than 50 km away from the sea, within 50 km of the sea, or within the sea itself respectively.“" -ammonia,--,"„true, false or regional“","Add ammonia as a carrrier. It can be either true (copperplated NH3) or ""regional"" (regionalised NH3 without network)" +hydrogen_underground_storage,--,"{true, false}",Add options for storing hydrogen underground. Storage potential depends regionally. +hydrogen_underground_storage_locations,,"{onshore, nearshore, offshore}","„The location where hydrogen underground storage can be located. Onshore, nearshore, offshore means it must be located more than 50 km away from the sea, within 50 km of the sea, or within the sea itself respectively.“" +ammonia,--,"{true, false, regional}","Add ammonia as a carrrier. It can be either true (copperplated NH3) or ""regional"" (regionalised NH3 without network)" min_part_load_fischer_tropsch,,, min_part_load_methanolisation,,, -use_fischer_tropsch_waste_heat,--,true or false,Add option for using waste heat of Fischer Tropsch in district heating networks -use_fuel_cell_waste_heat,--,true or false,Add option for using waste heat of fuel cells in district heating networks -use_electrolysis_waste_heat,--,true or false,Add option for using waste heat of electrolysis in district heating networks -electricity_distribution_grid,--,true or false,Add a electricity distribution grid +use_fischer_tropsch_waste_heat,--,"{true, false}",Add option for using waste heat of Fischer Tropsch in district heating networks +use_fuel_cell_waste_heat,--,"{true, false}",Add option for using waste heat of fuel cells in district heating networks +use_electrolysis_waste_heat,--,"{true, false}",Add option for using waste heat of electrolysis in district heating networks +electricity_distribution_grid,--,"{true, false}",Add a electricity distribution grid electricity_distribution_grid_cost_factor,,,Multiplies the investment cost of the electricity distribution grid in data/costs.csv -electricity_grid_connection,--,true or false,Add the cost of electricity grid connection for onshore wind and solar -H2_network,--,true or false,Add option for new hydrogen pipelines -gas_network,--,true or false,"Add natural gas infrastructure, incl. LNG terminals, production and entry-points" -H2_retrofit,--,true or false,Add option for retrofiting existing pipelines to transport hydrogen +electricity_grid_connection,--,"{true, false}",Add the cost of electricity grid connection for onshore wind and solar +H2_network,--,"{true, false}",Add option for new hydrogen pipelines +gas_network,--,"{true, false}","Add natural gas infrastructure, incl. LNG terminals, production and entry-points" +H2_retrofit,--,"{true, false}",Add option for retrofiting existing pipelines to transport hydrogen H2_retrofit_capacity_per_CH4,,, -gas_distribution_grid,--,true or false,Add a gas distribution grid +gas_distribution_grid,--,"{true, false}",Add a gas distribution grid gas_distribution_grid_cost_factor,,,Multiplies the investment cost of the gas distribution grid in data/costs.csv -biomass_spatial,--,true or false,Add option for resolving biomass demand regionally -biomass_transport,--,true or false,Add option for transporting solid biomass between nodes +biomass_spatial,--,"{true, false}",Add option for resolving biomass demand regionally +biomass_transport,--,"{true, false}",Add option for transporting solid biomass between nodes conventional_generation,,,Add a more detailed description of conventional carriers. Any power generation requires the consumption of fuel from nodes representing that fuel. -biomass_to_liquid,--,true or false,Add option for transforming solid biomass into liquid fuel with the same properties as oil -biosng,--,true or false,Add option for transforming solid biomass into synthesis gas with the same properties as natural gas +biomass_to_liquid,--,"{true, false}",Add option for transforming solid biomass into liquid fuel with the same properties as oil +biosng,--,"{true, false}",Add option for transforming solid biomass into synthesis gas with the same properties as natural gas diff --git a/doc/configtables/solar-thermal.csv b/doc/configtables/solar-thermal.csv new file mode 100644 index 00000000..2daf99ae --- /dev/null +++ b/doc/configtables/solar-thermal.csv @@ -0,0 +1,5 @@ +,Unit,Values,Description +clearsky_model ,--,"{‘simple’, ‘enhanced’}",Type of clearsky model for diffuse irradiation +orientation ,--,"{units of degrees, ‘latitude_optimal’}",Panel orientation with slope and azimuth +-- azimuth,float,units of degrees,The angle between the north and the sun with panels on the local horizon +-- slope,float,units of degrees,The angle between the ground and the panels diff --git a/doc/configuration.rst b/doc/configuration.rst index a5de4453..cd926b6a 100644 --- a/doc/configuration.rst +++ b/doc/configuration.rst @@ -398,14 +398,15 @@ overwrite the existing values. .. note:: Only used for sector-coupling studies. -.. warning:: - More comprehensive documentation for this segment will be released soon. - .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: energy: :end-before: # docs +.. csv-table:: + :header-rows: 1 + :widths: 25,7,22,30 + :file: configtables/energy.csv .. _biomass_cf: @@ -415,14 +416,36 @@ overwrite the existing values. .. note:: Only used for sector-coupling studies. -.. warning:: - More comprehensive documentation for this segment will be released soon. - .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: biomass: :end-before: # docs +.. csv-table:: + :header-rows: 1 + :widths: 25,7,22,30 + :file: configtables/biomass.csv + +The list of available biomass is given by the category in `ENSPRESO_BIOMASS `_, namely: + +- Agricultural waste +- Manure solid, liquid +- Residues from landscape care +- Bioethanol barley, wheat, grain maize, oats, other cereals and rye +- Sugar from sugar beet +- Miscanthus, switchgrass, RCG +- Willow +- Poplar +- Sunflower, soya seed +- Rape seed +- Fuelwood residues +- FuelwoodRW +- C&P_RW +- Secondary Forestry residues - woodchips +- Sawdust +- Municipal waste +- Sludge + .. _solar_thermal_cf: ``solar_thermal`` @@ -431,30 +454,34 @@ overwrite the existing values. .. note:: Only used for sector-coupling studies. -.. warning:: - More comprehensive documentation for this segment will be released soon. - .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: solar_thermal: :end-before: # docs +.. csv-table:: + :header-rows: 1 + :widths: 25,7,22,30 + :file: configtables/solar-thermal.csv + .. _existing_capacities_cf: ``existing_capacities`` ======================= .. note:: - Only used for sector-coupling studies. - -.. warning:: - More comprehensive documentation for this segment will be released soon. + Only used for sector-coupling studies. The value for grouping years are only used in myopic scenarios. .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: existing_capacities: :end-before: # docs +.. csv-table:: + :header-rows: 1 + :widths: 25,7,22,30 + :file: configtables/existing_capacities.csv + .. _sector_cf: ``sector`` @@ -463,9 +490,6 @@ overwrite the existing values. .. note:: Only used for sector-coupling studies. -.. warning:: - More comprehensive documentation for this segment will be released soon. - .. literalinclude:: ../config/config.default.yaml :language: yaml :start-at: sector: