From 2b9ac511b57a4274d091e37872a51f9dddeda8f4 Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Tue, 20 Oct 2020 09:34:45 +0200 Subject: [PATCH 001/132] update mocksnakemake for testing --- scripts/prepare_sector_network.py | 57 ++++++++++++++++++++----------- 1 file changed, 37 insertions(+), 20 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 6e79e897..e068fd02 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1736,7 +1736,7 @@ def remove_h2_network(n): capital_cost=h2_capital_cost) - +#%% if __name__ == "__main__": # Detect running outside of snakemake and mock snakemake for testing if 'snakemake' not in globals(): @@ -1746,25 +1746,42 @@ if __name__ == "__main__": opts='', planning_horizons='2020', co2_budget_name='go', sector_opts='Co2L0-168H-T-H-B-I-solar3-dist1'), - input=dict(network='pypsa-eur/networks/{network}_s{simpl}_{clusters}_ec_lv{lv}_{opts}.nc', - timezone_mappings='pypsa-eur-sec/data/timezone_mappings.csv', - co2_budget='pypsa-eur-sec/data/co2_budget.csv', - clustered_pop_layout='pypsa-eur-sec/resources/pop_layout_{network}_s{simpl}_{clusters}.csv', - costs='technology-data/outputs/costs_{planning_horizons}.csv', - profile_offwind_ac='pypsa-eur/resources/profile_offwind-ac.nc', - profile_offwind_dc='pypsa-eur/resources/profile_offwind-dc.nc', - clustermaps="pypsa-eur/resources/clustermaps_{network}_s{simpl}_{clusters}.h5", - cop_air_total='pypsa-eur-sec/resources/cop_air_total_{network}_s{simpl}_{clusters}.nc', - cop_soil_total='pypsa-eur-sec/resources/cop_soil_total_{network}_s{simpl}_{clusters}.nc', - solar_thermal_total='pypsa-eur-sec/resources/solar_thermal_total_{network}_s{simpl}_{clusters}.nc', - energy_totals_name='pypsa-eur-sec/data/energy_totals.csv', - heat_demand_total='pypsa-eur-sec/resources/heat_demand_total_{network}_s{simpl}_{clusters}.nc', - heat_profile='pypsa-eur-sec/data/heat_load_profile_BDEW.csv', - transport_name='pypsa-eur-sec/data/transport_data.csv', - temp_air_total='pypsa-eur-sec/resources/temp_air_total_{network}_s{simpl}_{clusters}.nc', - co2_totals_name='pypsa-eur-sec/data/co2_totals.csv', - biomass_potentials='pypsa-eur-sec/data/biomass_potentials.csv', - industrial_demand='pypsa-eur-sec/resources/industrial_demand_{network}_s{simpl}_{clusters}.csv',), + input=dict( + network='../pypsa-eur/networks/{network}_s{simpl}_{clusters}_ec_lv{lv}_{opts}.nc', + energy_totals_name='resources/energy_totals.csv', + co2_totals_name='resources/co2_totals.csv', + transport_name='resources/transport_data.csv', + biomass_potentials='resources/biomass_potentials.csv', + timezone_mappings='data/timezone_mappings.csv', + heat_profile="data/heat_load_profile_BDEW.csv", + costs="../technology-data/outputs/costs_{planning_horizons}.csv", + h2_cavern = "data/hydrogen_salt_cavern_potentials.csv", + co2_budget="data/co2_budget.csv", + profile_offwind_ac="../pypsa-eur/resources/profile_offwind-ac.nc", + profile_offwind_dc="../pypsa-eur/resources/profile_offwind-dc.nc", + clustermaps='../pypsa-eur/resources/clustermaps_{network}_s{simpl}_{clusters}.h5', + clustered_pop_layout="resources/pop_layout_{network}_s{simpl}_{clusters}.csv", + simplified_pop_layout="resources/pop_layout_{network}_s{simpl}.csv", + industrial_demand="resources/industrial_energy_demand_{network}_s{simpl}_{clusters}.csv", + heat_demand_urban="resources/heat_demand_urban_{network}_s{simpl}_{clusters}.nc", + heat_demand_rural="resources/heat_demand_rural_{network}_s{simpl}_{clusters}.nc", + heat_demand_total="resources/heat_demand_total_{network}_s{simpl}_{clusters}.nc", + temp_soil_total="resources/temp_soil_total_{network}_s{simpl}_{clusters}.nc", + temp_soil_rural="resources/temp_soil_rural_{network}_s{simpl}_{clusters}.nc", + temp_soil_urban="resources/temp_soil_urban_{network}_s{simpl}_{clusters}.nc", + temp_air_total="resources/temp_air_total_{network}_s{simpl}_{clusters}.nc", + temp_air_rural="resources/temp_air_rural_{network}_s{simpl}_{clusters}.nc", + temp_air_urban="resources/temp_air_urban_{network}_s{simpl}_{clusters}.nc", + cop_soil_total="resources/cop_soil_total_{network}_s{simpl}_{clusters}.nc", + cop_soil_rural="resources/cop_soil_rural_{network}_s{simpl}_{clusters}.nc", + cop_soil_urban="resources/cop_soil_urban_{network}_s{simpl}_{clusters}.nc", + cop_air_total="resources/cop_air_total_{network}_s{simpl}_{clusters}.nc", + cop_air_rural="resources/cop_air_rural_{network}_s{simpl}_{clusters}.nc", + cop_air_urban="resources/cop_air_urban_{network}_s{simpl}_{clusters}.nc", + solar_thermal_total="resources/solar_thermal_total_{network}_s{simpl}_{clusters}.nc", + solar_thermal_urban="resources/solar_thermal_urban_{network}_s{simpl}_{clusters}.nc", + solar_thermal_rural="resources/solar_thermal_rural_{network}_s{simpl}_{clusters}.nc", + ), output=['pypsa-eur-sec/results/test/prenetworks/{network}_s{simpl}_{clusters}_lv{lv}__{sector_opts}_{co2_budget_name}_{planning_horizons}.nc'] ) import yaml From b4f1c570d62de5e60fe0689cdaa5a51113cb33aa Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Tue, 20 Oct 2020 10:13:02 +0200 Subject: [PATCH 002/132] move input data path for emobility/transport data to snakemake input --- scripts/prepare_sector_network.py | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index e068fd02..31feaa21 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -449,8 +449,8 @@ def prepare_data(network): ## Get overall demand curve for all vehicles - dir_name = "data/emobility/" - traffic = pd.read_csv(os.path.join(dir_name,"KFZ__count"),skiprows=2)["count"] + traffic = pd.read_csv(snakemake.input.traffic_data + "KFZ__count", + skiprows=2)["count"] #Generate profiles transport_shape = generate_periodic_profiles(dt_index=network.snapshots.tz_localize("UTC"), @@ -504,7 +504,8 @@ def prepare_data(network): ## derive plugged-in availability for PKW's (cars) - traffic = pd.read_csv(os.path.join(dir_name,"Pkw__count"),skiprows=2)["count"] + traffic = pd.read_csv(snakemake.input.traffic_data + "Pkw__count", + skiprows=2)["count"] avail_max = 0.95 @@ -1780,6 +1781,7 @@ if __name__ == "__main__": cop_air_urban="resources/cop_air_urban_{network}_s{simpl}_{clusters}.nc", solar_thermal_total="resources/solar_thermal_total_{network}_s{simpl}_{clusters}.nc", solar_thermal_urban="resources/solar_thermal_urban_{network}_s{simpl}_{clusters}.nc", + traffic_data = "data/emobility/", solar_thermal_rural="resources/solar_thermal_rural_{network}_s{simpl}_{clusters}.nc", ), output=['pypsa-eur-sec/results/test/prenetworks/{network}_s{simpl}_{clusters}_lv{lv}__{sector_opts}_{co2_budget_name}_{planning_horizons}.nc'] From cdaa4587ad8bbf2dea2c2f09bf859d4831c2c5c8 Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Tue, 20 Oct 2020 12:59:19 +0200 Subject: [PATCH 003/132] Snakefile: add transport input data to rule prepare_sector_network --- Snakefile | 1 + 1 file changed, 1 insertion(+) diff --git a/Snakefile b/Snakefile index 57792c24..7e4d6afa 100644 --- a/Snakefile +++ b/Snakefile @@ -305,6 +305,7 @@ rule prepare_sector_network: heat_demand_urban="resources/heat_demand_urban_{network}_s{simpl}_{clusters}.nc", heat_demand_rural="resources/heat_demand_rural_{network}_s{simpl}_{clusters}.nc", heat_demand_total="resources/heat_demand_total_{network}_s{simpl}_{clusters}.nc", + traffic_data = "data/emobility/", temp_soil_total="resources/temp_soil_total_{network}_s{simpl}_{clusters}.nc", temp_soil_rural="resources/temp_soil_rural_{network}_s{simpl}_{clusters}.nc", temp_soil_urban="resources/temp_soil_urban_{network}_s{simpl}_{clusters}.nc", From 50b4e822c49b09f299bad17c52295ab887c26197 Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Tue, 20 Oct 2020 13:00:41 +0200 Subject: [PATCH 004/132] config: add missing color for industry electricity --- config.default.yaml | 1 + config.myopic.yaml | 1 + 2 files changed, 2 insertions(+) diff --git a/config.default.yaml b/config.default.yaml index 3498a33b..ee4bb885 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -320,6 +320,7 @@ plotting: "today" : "#D2691E" "shipping" : "#6495ED" "electricity distribution grid" : "#333333" + 'industry electricity': "black" nice_names: # OCGT: "Gas" # OCGT marginal: "Gas (marginal)" diff --git a/config.myopic.yaml b/config.myopic.yaml index 454a8525..8ad7f1b3 100644 --- a/config.myopic.yaml +++ b/config.myopic.yaml @@ -320,6 +320,7 @@ plotting: "today" : "#D2691E" "shipping" : "#6495ED" "electricity distribution grid" : "#333333" + 'industry electricity': "black" nice_names: # OCGT: "Gas" # OCGT marginal: "Gas (marginal)" From 2dd97c39edeb73a054f402e359c0c529bf122a06 Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Tue, 20 Oct 2020 13:45:34 +0200 Subject: [PATCH 005/132] Snakefile: add path to biomass transport cost in rule prepare_sector_network --- Snakefile | 1 + 1 file changed, 1 insertion(+) diff --git a/Snakefile b/Snakefile index 7e4d6afa..0b8cacb0 100644 --- a/Snakefile +++ b/Snakefile @@ -291,6 +291,7 @@ rule prepare_sector_network: co2_totals_name='resources/co2_totals.csv', transport_name='resources/transport_data.csv', biomass_potentials='resources/biomass_potentials.csv', + biomass_transport='data/biomass/biomass_transport_costs.csv', timezone_mappings='data/timezone_mappings.csv', heat_profile="data/heat_load_profile_BDEW.csv", costs=config['costs_dir'] + "costs_{planning_horizons}.csv", From 651a7ff693d864400c860adba041d90f72c3e59d Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Tue, 20 Oct 2020 13:46:39 +0200 Subject: [PATCH 006/132] add biomass transport, split potential for solid biomass to nodes, add costs for upgrading biogas to gas --- scripts/prepare_sector_network.py | 97 ++++++++++++++++++++++++++----- 1 file changed, 81 insertions(+), 16 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 31feaa21..282465f1 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -51,6 +51,33 @@ def add_lifetime_wind_solar(n): n.generators.loc[[index for index in n.generators.index.to_list() if carrier in index], 'lifetime']=costs.at[carrier_name,'lifetime'] + +def create_network_topology(n, prefix): + """ + create a network topology as the electric network, + returns a pandas dataframe with bus0, bus1 and length + """ + + topo = pd.DataFrame(columns=["bus0", "bus1", "length"]) + connector = " -> " + attrs = ["bus0", "bus1", "length"] + + candidates = pd.concat([n.lines[attrs], + n.links.loc[n.links.carrier == "DC", attrs]]) + + positive_order = candidates.bus0 < candidates.bus1 + candidates_p = candidates[positive_order] + candidates_n = (candidates[~ positive_order] + .rename(columns={"bus0": "bus1", "bus1": "bus0"})) + candidates = pd.concat((candidates_p, candidates_n), sort=False) + + topo = candidates.groupby(["bus0", "bus1"], as_index=False).mean() + topo.rename(index=lambda x: prefix + topo.at[x, "bus0"] + + connector + topo.at[x, "bus1"], + inplace=True) + return topo + + def update_wind_solar_costs(n,costs): """ Update costs for wind and solar generators added with pypsa-eur to those @@ -1354,6 +1381,16 @@ def add_biomass(network): biomass_potentials = pd.read_csv(snakemake.input.biomass_potentials, index_col=0) + # costs for biomass transport + transport_costs = pd.read_csv(snakemake.input.biomass_transport, + index_col=0) + + # potential per node distributed within country by population + biomass_pot_node = (biomass_potentials.loc[pop_layout.ct] + .set_index(pop_layout.index) + .mul(pop_layout.fraction, axis="index")) + + network.add("Carrier","biogas") network.add("Carrier","solid biomass") @@ -1363,8 +1400,7 @@ def add_biomass(network): carrier="biogas") network.madd("Bus", - ["EU solid biomass"], - location="EU", + biomass_pot_node.index + " solid biomass", carrier="solid biomass") network.madd("Store", @@ -1376,12 +1412,12 @@ def add_biomass(network): e_initial=biomass_potentials.loc[cts,"biogas"].sum()) network.madd("Store", - ["EU solid biomass"], - bus="EU solid biomass", + biomass_pot_node.index + " solid biomass", + bus=biomass_pot_node.index + " solid biomass", carrier="solid biomass", - e_nom=biomass_potentials.loc[cts,"solid biomass"].sum(), - marginal_cost=costs.at['solid biomass','fuel'], - e_initial=biomass_potentials.loc[cts,"solid biomass"].sum()) + e_nom=biomass_pot_node["solid biomass"].values, + marginal_cost=costs.at['solid biomass', 'fuel'], + e_initial=biomass_pot_node["solid biomass"].values) network.madd("Link", ["biogas to gas"], @@ -1389,9 +1425,38 @@ def add_biomass(network): bus1="EU gas", bus2="co2 atmosphere", carrier="biogas to gas", + capital_cost=costs.loc["biogas upgrading", "fixed"], + marginal_cost=costs.loc["biogas upgrading", "VOM"], efficiency2=-costs.at['gas','CO2 intensity'], p_nom_extendable=True) + # add biomass transport + biomass_transport = create_network_topology(n, "Biomass transport ") + + # make transport in both directions + df = biomass_transport.copy() + df["bus1"] = biomass_transport.bus0 + df["bus0"] = biomass_transport.bus1 + df.rename(index=lambda x: "Biomass transport " + df.at[x, "bus0"] + + " -> " + df.at[x, "bus1"], inplace=True) + biomass_transport = pd.concat([biomass_transport, df]) + + # costs + bus0_costs = biomass_transport.bus0.apply(lambda x: transport_costs.loc[x[:2]]) + bus1_costs = biomass_transport.bus1.apply(lambda x: transport_costs.loc[x[:2]]) + biomass_transport["costs"] = pd.concat([bus0_costs, bus1_costs], + axis=1).mean(axis=1) + + network.madd("Link", + biomass_transport.index, + bus0=biomass_transport.bus0 + " solid biomass", + bus1=biomass_transport.bus1 + " solid biomass", + p_nom_extendable=True, + length=biomass_transport.length.values, + marginal_cost=biomass_transport.costs * biomass_transport.length.values, + capital_cost=1, + carrier="solid biomass transport") + #AC buses with district heating urban_central = network.buses.index[network.buses.carrier == "urban central heat"] @@ -1400,7 +1465,7 @@ def add_biomass(network): network.madd("Link", urban_central + " urban central solid biomass CHP electric", - bus0="EU solid biomass", + bus0=urban_central + " solid biomass", bus1=urban_central, carrier="urban central solid biomass CHP electric", p_nom_extendable=True, @@ -1415,7 +1480,7 @@ def add_biomass(network): network.madd("Link", urban_central + " urban central solid biomass CHP heat", - bus0="EU solid biomass", + bus0=urban_central + " solid biomass", bus1=urban_central + " urban central heat", carrier="urban central solid biomass CHP heat", p_nom_extendable=True, @@ -1425,7 +1490,7 @@ def add_biomass(network): network.madd("Link", urban_central + " urban central solid biomass CHP CCS electric", - bus0="EU solid biomass", + bus0=urban_central + " solid biomass", bus1=urban_central, bus2="co2 atmosphere", bus3="co2 stored", @@ -1443,7 +1508,7 @@ def add_biomass(network): network.madd("Link", urban_central + " urban central solid biomass CHP CCS heat", - bus0="EU solid biomass", + bus0=urban_central + " solid biomass", bus1=urban_central + " urban central heat", bus2="co2 atmosphere", bus3="co2 stored", @@ -1467,7 +1532,6 @@ def add_industry(network): index_col=0) solid_biomass_by_country = industrial_demand["solid biomass"].groupby(pop_layout.ct).sum() - countries = solid_biomass_by_country.index network.madd("Bus", ["solid biomass for industry"], @@ -1481,16 +1545,16 @@ def add_industry(network): p_set=solid_biomass_by_country.sum()/8760.) network.madd("Link", - ["solid biomass for industry"], - bus0="EU solid biomass", + nodes + " solid biomass for industry", + bus0=nodes + " solid biomass", bus1="solid biomass for industry", carrier="solid biomass for industry", p_nom_extendable=True, efficiency=1.) network.madd("Link", - ["solid biomass for industry CCS"], - bus0="EU solid biomass", + nodes + " solid biomass for industry CCS", + bus0=nodes + " solid biomass", bus1="solid biomass for industry", bus2="co2 atmosphere", bus3="co2 stored", @@ -1753,6 +1817,7 @@ if __name__ == "__main__": co2_totals_name='resources/co2_totals.csv', transport_name='resources/transport_data.csv', biomass_potentials='resources/biomass_potentials.csv', + biomass_transport='data/biomass/biomass_transport_costs.csv', timezone_mappings='data/timezone_mappings.csv', heat_profile="data/heat_load_profile_BDEW.csv", costs="../technology-data/outputs/costs_{planning_horizons}.csv", From 3944e19c515d84ab622291a7a41ffb4d97458ae5 Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Tue, 20 Oct 2020 13:48:05 +0200 Subject: [PATCH 007/132] config.yaml: add color for biomass transport --- config.default.yaml | 1 + config.myopic.yaml | 1 + 2 files changed, 2 insertions(+) diff --git a/config.default.yaml b/config.default.yaml index ee4bb885..88697285 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -321,6 +321,7 @@ plotting: "shipping" : "#6495ED" "electricity distribution grid" : "#333333" 'industry electricity': "black" + "solid biomass transport": "green" nice_names: # OCGT: "Gas" # OCGT marginal: "Gas (marginal)" diff --git a/config.myopic.yaml b/config.myopic.yaml index 8ad7f1b3..e1a2a15f 100644 --- a/config.myopic.yaml +++ b/config.myopic.yaml @@ -321,6 +321,7 @@ plotting: "shipping" : "#6495ED" "electricity distribution grid" : "#333333" 'industry electricity': "black" + "solid biomass transport": "green" nice_names: # OCGT: "Gas" # OCGT marginal: "Gas (marginal)" From ae9c0d9530b09634579340ad7a10435b29eb1cd9 Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Tue, 20 Oct 2020 14:08:17 +0200 Subject: [PATCH 008/132] prepare_sector_network: split industry demand for biomass to single nodes --- scripts/prepare_sector_network.py | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 282465f1..f75ed459 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1531,31 +1531,31 @@ def add_industry(network): industrial_demand = 1e6*pd.read_csv(snakemake.input.industrial_demand, index_col=0) - solid_biomass_by_country = industrial_demand["solid biomass"].groupby(pop_layout.ct).sum() + solid_biomass_by_country = industrial_demand["solid biomass"] network.madd("Bus", - ["solid biomass for industry"], - location="EU", + industrial_demand.index + " solid biomass for industry", carrier="solid biomass for industry") + network.madd("Load", - ["solid biomass for industry"], - bus="solid biomass for industry", + industrial_demand.index + " solid biomass for industry", + bus=industrial_demand.index + " solid biomass for industry", carrier="solid biomass for industry", - p_set=solid_biomass_by_country.sum()/8760.) + p_set=industrial_demand["solid biomass"]/8760.) network.madd("Link", - nodes + " solid biomass for industry", - bus0=nodes + " solid biomass", - bus1="solid biomass for industry", + industrial_demand.index + " solid biomass for industry", + bus0=industrial_demand.index + " solid biomass", + bus1=industrial_demand.index + " solid biomass for industry", carrier="solid biomass for industry", p_nom_extendable=True, efficiency=1.) network.madd("Link", - nodes + " solid biomass for industry CCS", - bus0=nodes + " solid biomass", - bus1="solid biomass for industry", + industrial_demand.index + " solid biomass for industry CCS", + bus0=industrial_demand.index + " solid biomass", + bus1=industrial_demand.index + " solid biomass for industry", bus2="co2 atmosphere", bus3="co2 stored", carrier="solid biomass for industry CCS", From 13cae7d66f17555005c85a87f0bfafeef4fb7e4e Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Tue, 20 Oct 2020 14:19:07 +0200 Subject: [PATCH 009/132] drop nan values to avoid runtime error when removing todays electricity demand --- scripts/prepare_sector_network.py | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index f75ed459..b33cfcea 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1701,7 +1701,7 @@ def add_industry(network): p_set=industrial_demand.loc[nodes,"low-temperature heat"]/8760.) #remove today's industrial electricity demand by scaling down total electricity demand - for ct in n.buses.country.unique(): + for ct in n.buses.country.dropna().unique(): loads = n.loads.index[(n.loads.index.str[:2] == ct) & (n.loads.carrier == "electricity")] factor = 1 - industrial_demand.loc[loads,"current electricity"].sum()/n.loads_t.p_set[loads].sum().sum() n.loads_t.p_set[loads] *= factor @@ -1800,6 +1800,9 @@ def remove_h2_network(n): carrier="H2 Store", capital_cost=h2_capital_cost) +# def remove_biomass_transport(n): + + #%% if __name__ == "__main__": From b4fbb47d29ab7ea1719b9f96ed1f11d94f458966 Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Wed, 21 Oct 2020 07:21:09 +0200 Subject: [PATCH 010/132] fix bug when adding biomass industry demand, add option to remove biomass transport and have only single EU biomass node --- scripts/prepare_sector_network.py | 78 ++++++++++++++++++++++++++++++- 1 file changed, 76 insertions(+), 2 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index b33cfcea..ddcdc85b 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1542,7 +1542,8 @@ def add_industry(network): industrial_demand.index + " solid biomass for industry", bus=industrial_demand.index + " solid biomass for industry", carrier="solid biomass for industry", - p_set=industrial_demand["solid biomass"]/8760.) + p_set=(industrial_demand["solid biomass"] + .rename(index=lambda x: x + " solid biomass for industry"))/8760.) network.madd("Link", industrial_demand.index + " solid biomass for industry", @@ -1800,8 +1801,76 @@ def remove_h2_network(n): carrier="H2 Store", capital_cost=h2_capital_cost) -# def remove_biomass_transport(n): +def remove_biomass_transport(n): + print("no transport of solid biomass considered") + + # remove country specific biomass buses + n.buses = n.buses[~n.buses.carrier.str.contains("biomass")] + # biomass potential + biomass_pot = n.stores[n.stores.carrier=="solid biomass"].e_nom.sum() + # remove biomass store per country + n.stores = n.stores[n.stores.carrier!="solid biomass"] + # remove biomass transport links + n.links = n.links[n.links.carrier!="solid biomass transport"] + # total industry demand for biomass + biomass_demand = n.loads[n.loads.carrier=="solid biomass for industry"].p_set.sum() + # remove industry demand + n.loads = n.loads[n.loads.carrier!="solid biomass for industry"] + # drop transport and industry links + n.links = n.links[~n.links.carrier.isin(['solid biomass transport', + 'solid biomass for industry', + 'solid biomass for industry CCS'])] + + # add back EU bus + load + store + industry links + n.madd("Bus", + ["EU solid biomass"], + location="EU", + carrier="solid biomass") + + n.madd("Bus", + ["solid biomass for industry"], + location="EU", + carrier="solid biomass for industry") + + n.madd("Load", + ["solid biomass for industry"], + bus="solid biomass for industry", + carrier="solid biomass for industry", + p_set=biomass_demand) + + n.madd("Store", + ["EU solid biomass"], + bus="EU solid biomass", + carrier="solid biomass", + e_nom=biomass_pot, + marginal_cost=costs.at['solid biomass','fuel'], + e_initial=biomass_pot) + + n.madd("Link", + ["solid biomass for industry"], + bus0="EU solid biomass", + bus1="solid biomass for industry", + carrier="solid biomass for industry", + p_nom_extendable=True, + efficiency=1.) + + n.madd("Link", + ["solid biomass for industry CCS"], + bus0="EU solid biomass", + bus1="solid biomass for industry", + bus2="co2 atmosphere", + bus3="co2 stored", + carrier="solid biomass for industry CCS", + p_nom_extendable=True, + capital_cost=costs.at["industry CCS","fixed"]*costs.at['solid biomass','CO2 intensity']*8760, #8760 converts EUR/(tCO2/a) to EUR/(tCO2/h) + efficiency=0.9, + efficiency2=-costs.at['solid biomass','CO2 intensity']*options["ccs_fraction"], + efficiency3=costs.at['solid biomass','CO2 intensity']*options["ccs_fraction"], + lifetime=costs.at['industry CCS','lifetime']) + + # set CHP buses from country to single EU bus + n.links.loc[n.links.carrier.str.contains("biomass CHP"), "bus0"] = "EU solid biomass" #%% @@ -1916,6 +1985,8 @@ if __name__ == "__main__": if o[:4] == "dist": snakemake.config["sector"]['electricity_distribution_grid'] = True snakemake.config["sector"]['electricity_distribution_grid_cost_factor'] = float(o[4:].replace("p",".").replace("m","-")) + if o == "biomasstransport": + options["biomass_transport"] = True nodal_energy_totals, heat_demand, ashp_cop, gshp_cop, solar_thermal, transport, avail_profile, dsm_profile, co2_totals, nodal_transport_data = prepare_data(n) @@ -1943,6 +2014,9 @@ if __name__ == "__main__": if "noH2network" in opts: remove_h2_network(n) + if not options["biomass_transport"]: + remove_biomass_transport(n) + for o in opts: m = re.match(r'^\d+h$', o, re.IGNORECASE) if m is not None: From 4f2135a43a45e0d9d491d05167691e85cbd24efc Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Wed, 21 Oct 2020 07:23:52 +0200 Subject: [PATCH 011/132] add option for solid biomass transport --- config.default.yaml | 1 + config.myopic.yaml | 1 + 2 files changed, 2 insertions(+) diff --git a/config.default.yaml b/config.default.yaml index 88697285..6d7c8998 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -104,6 +104,7 @@ sector: 'electricity_grid_connection' : True # only applies to onshore wind and utility PV 'gas_distribution_grid' : True 'gas_distribution_grid_cost_factor' : 1.0 #multiplies cost in data/costs.csv + 'biomass_transport': False # biomass potential per country + transport between countries costs: year: 2030 diff --git a/config.myopic.yaml b/config.myopic.yaml index e1a2a15f..7159607b 100644 --- a/config.myopic.yaml +++ b/config.myopic.yaml @@ -104,6 +104,7 @@ sector: 'electricity_grid_connection' : True # only applies to onshore wind and utility PV 'gas_distribution_grid' : True 'gas_distribution_grid_cost_factor' : 1.0 #multiplies cost in data/costs.csv + 'biomass_transport': False # biomass potential per country + transport between countries costs: year: 2030 From 846f57fde6433770199fae31145575c14e97358a Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Fri, 11 Jun 2021 14:36:56 +0200 Subject: [PATCH 012/132] add script for biomass transport costs. Converts JRC-EU-Times transport cost' --- scripts/convert_biomass_transport_costs.py | 62 ++++++++++++++++++++++ 1 file changed, 62 insertions(+) create mode 100644 scripts/convert_biomass_transport_costs.py diff --git a/scripts/convert_biomass_transport_costs.py b/scripts/convert_biomass_transport_costs.py new file mode 100644 index 00000000..57bd455f --- /dev/null +++ b/scripts/convert_biomass_transport_costs.py @@ -0,0 +1,62 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +""" +Created on Thu Mar 12 19:11:20 2020 + +reads biomass transport costs for different countries of the JRC report + + "The JRC-EU-TIMES model. + Bioenergy potentials + for EU and neighbouring countries." + (2015) + +converts them from units 'EUR per km/ton' -> 'EUR/ (km MWh)' + +assuming as an approximation energy content of wood pellets + +@author: bw0928 +""" + +import pandas as pd +from tabula import read_pdf +import numpy as np + +# read pdf file +df_list = read_pdf("biomass potentials in europe_web rev.pdf", + pages="145-147", + multiple_tables=True) +energy_content = 4.8 # unit MWh/tonne (assuming wood pellets) +# %% +columns = ["Komponente", "Größe", "Einheit", 2020, 2025, 2030, 2035, 2040, + 2045, 2050] +countries = df_list[0][0].iloc[6:].rename(index=lambda x: x+1) + +# supply chain 1 +df = df_list[1].copy().rename(index=countries.to_dict()) +df.rename(columns= df.iloc[:6].apply(lambda col: col.str.cat(sep=" "), + axis=0).to_dict(), inplace=True) +df = df.iloc[6:] +df.loc[6]=df.loc[6].str.replace("€", "EUR") + +# supply chain 2 +df2 = df_list[2].copy().rename(index=countries.to_dict()) +df2.rename(columns= df2.iloc[:6].apply(lambda col: col.str.cat(sep=" "), + axis=0).to_dict(), inplace=True) +df2 = df2.iloc[6:] +df2.loc[6]=df2.loc[6].str.replace("€", "EUR") + +#%% +df.to_csv("biomass_transport_costs_supply_chain1.csv") +df2.to_csv("biomass_transport_costs_supply_chain2.csv") + +transport_costs = pd.concat([df['per km/ton'], df2['per km/ton']],axis=1).drop(6) +transport_costs = transport_costs.astype(float, errors="ignore").mean(axis=1) + +# convert unit to EUR/MWh +transport_costs /= energy_content +transport_costs = pd.DataFrame(transport_costs, columns=["cost [EUR/(km MWh)]"]) +# rename +transport_costs.rename({"UK": "GB", "XK": "KO", "EL": "GR"}, inplace=True) +# add missing Norway +transport_costs.loc["NO"] = transport_costs.loc["SE"] +transport_costs.to_csv("biomass_transport_final.csv") From 12257eeb3e8147ecc74c5a0345b063e75bb946d0 Mon Sep 17 00:00:00 2001 From: martavp Date: Tue, 15 Jun 2021 09:26:56 +0200 Subject: [PATCH 013/132] Update .gitignore --- .gitignore | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.gitignore b/.gitignore index a55300e2..abfb926e 100644 --- a/.gitignore +++ b/.gitignore @@ -27,7 +27,7 @@ gurobi.log /data/.nfs* /data/Industrial_Database.csv /data/retro/tabula-calculator-calcsetbuilding.csv - +/data *.org *.nc From e2354c18ac63d327d2171721ba07ee46c75a7c4c Mon Sep 17 00:00:00 2001 From: martavp Date: Wed, 16 Jun 2021 17:52:42 +0200 Subject: [PATCH 014/132] Add fictitious load to account for non-transformed shipping emissions The share of shipping demand that is transformed is defined now for different years to be used with the myopic code. The carbon emission from the remaining share is treated as a negative load on the atmospheric carbon dioxide bus, just like aviation and land transport emissions. --- config.default.yaml | 9 +++++++++ doc/release_notes.rst | 2 +- scripts/prepare_sector_network.py | 14 +++++++++++++- 3 files changed, 23 insertions(+), 2 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index 617e716a..06f4af86 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -116,6 +116,14 @@ sector: 'transport_fuel_cell_efficiency': 0.5 'transport_internal_combustion_efficiency': 0.3 'shipping_average_efficiency' : 0.4 #For conversion of fuel oil to propulsion in 2011 + 'shipping_hydrogen_share': # 1 means all hydrogen FC + 2020: 0 + 2025: 0 + 2030: 0.05 + 2035: 0.15 + 2040: 0.3 + 2045: 0.6 + 2050: 1 'time_dep_hp_cop' : True #time dependent heat pump coefficient of performance 'heat_pump_sink_T' : 55. # Celsius, based on DTU / large area radiators; used in build_cop_profiles.py # conservatively high to cover hot water and space heating in poorly-insulated buildings @@ -381,6 +389,7 @@ plotting: "solid biomass" : "#DAA520" "today" : "#D2691E" "shipping" : "#6495ED" + "shipping oil emissions" : "#6495ED" "electricity distribution grid" : "#333333" nice_names: # OCGT: "Gas" diff --git a/doc/release_notes.rst b/doc/release_notes.rst index cca25c7f..e5bd8d10 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -6,7 +6,7 @@ Future release ============== * Include new features here. - +The share of shipping transformed into hydrogen fuel cell can be now defined for different years in the ``config.yaml`` file. The carbon emission from the remaining share is treated as a negative load on the atmospheric carbon dioxide bus, just like aviation and land transport emissions. PyPSA-Eur-Sec 0.5.0 (21st May 2021) =================================== diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 94fb5048..f3dec3e4 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1682,13 +1682,25 @@ def add_industry(network): p_set=industrial_demand.loc[nodes,"hydrogen"]/8760.) + shipping_hydrogen_share = get_parameter(options['shipping_hydrogen_share']) network.madd("Load", nodes, suffix=" H2 for shipping", bus=nodes + " H2", carrier="H2 for shipping", - p_set = nodal_energy_totals.loc[nodes,["total international navigation","total domestic navigation"]].sum(axis=1)*1e6*options['shipping_average_efficiency']/costs.at["fuel cell","efficiency"]/8760.) + p_set = shipping_hydrogen_share*nodal_energy_totals.loc[nodes,["total international navigation","total domestic navigation"]].sum(axis=1)*1e6*options['shipping_average_efficiency']/costs.at["fuel cell","efficiency"]/8760.) + if shipping_hydrogen_share < 1: + shipping_oil_share= 1 - shipping_hydrogen_share + co2 = shipping_oil_share*nodal_energy_totals.loc[nodes,["total international navigation","total domestic navigation"]].sum().sum()*1e6/8760.*costs.at["oil",'CO2 intensity'] + + network.madd("Load", + ["shipping oil emissions"], + bus="co2 atmosphere", + carrier="shipping oil emissions", + p_set=-co2) + + if "EU oil" not in network.buses.index: network.madd("Bus", ["EU oil"], From a57135b086f63e0a6dfc6e84c7ecfdf56421247f Mon Sep 17 00:00:00 2001 From: martavp Date: Thu, 17 Jun 2021 15:12:10 +0200 Subject: [PATCH 015/132] Split colours for H2 in Industry and H2 in shipping when plotting balances. When plotting the balance for H2, the rename dictionary merges all the demands containing H2. This commit disables such merging and keeps different colours for H2 in shipping and H2 in industry. This is useful when one wants to look at the H2 balance and have an overview of where the H2 is consumed in the model. --- config.default.yaml | 2 ++ scripts/plot_summary.py | 4 +++- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/config.default.yaml b/config.default.yaml index 06f4af86..26937853 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -388,6 +388,8 @@ plotting: "biogas" : "#800000" "solid biomass" : "#DAA520" "today" : "#D2691E" + "H2 for industry" : "#222222" + "H2 for shipping" : "#6495ED" "shipping" : "#6495ED" "shipping oil emissions" : "#6495ED" "electricity distribution grid" : "#333333" diff --git a/scripts/plot_summary.py b/scripts/plot_summary.py index 9b3a81e1..276dc842 100644 --- a/scripts/plot_summary.py +++ b/scripts/plot_summary.py @@ -20,7 +20,9 @@ def rename_techs(label): rename_if_contains_dict = {"water tanks" : "hot water storage", "retrofitting" : "building retrofitting", - "H2" : "hydrogen storage", + "H2 Electrolysis" : "hydrogen storage", + "H2 Fuel Cell" : "hydrogen storage", + "H2 pipeline" : "hydrogen storage", "battery" : "battery storage", "CC" : "CC"} From 0a92d23698688ef1b6f4a5863d61537a426f9ece Mon Sep 17 00:00:00 2001 From: martavp Date: Thu, 17 Jun 2021 16:13:05 +0200 Subject: [PATCH 016/132] Make transformation of Steel and Aluminum production depends on year Previously, the transformation of the Steel and Aluminum production was assumed to occur overnight. This commit enables the definition of a transformation path via the config.yaml file. This requires adding the {planning_horizon} to the input and output file name of the following rules: build_industrial_production_per_country_tomorrow build_industrial_production_per_node build_industry_energy_demand_per_node prepare_sector_network --- Snakefile | 20 +++++++------- config.default.yaml | 26 +++++++++++++++++-- doc/release_notes.rst | 3 ++- ...ustrial_production_per_country_tomorrow.py | 21 +++++++++++---- 4 files changed, 52 insertions(+), 18 deletions(-) diff --git a/Snakefile b/Snakefile index 9ab7d2f1..9babe249 100644 --- a/Snakefile +++ b/Snakefile @@ -189,7 +189,7 @@ rule build_industrial_production_per_country_tomorrow: input: industrial_production_per_country="resources/industrial_production_per_country.csv" output: - industrial_production_per_country_tomorrow="resources/industrial_production_per_country_tomorrow.csv" + industrial_production_per_country_tomorrow="resources/industrial_production_per_country_tomorrow_{planning_horizons}.csv" threads: 1 resources: mem_mb=1000 script: 'scripts/build_industrial_production_per_country_tomorrow.py' @@ -214,9 +214,9 @@ rule build_industrial_distribution_key: rule build_industrial_production_per_node: input: industrial_distribution_key="resources/industrial_distribution_key_elec_s{simpl}_{clusters}.csv", - industrial_production_per_country_tomorrow="resources/industrial_production_per_country_tomorrow.csv" + industrial_production_per_country_tomorrow="resources/industrial_production_per_country_tomorrow_{planning_horizons}.csv" output: - industrial_production_per_node="resources/industrial_production_elec_s{simpl}_{clusters}.csv" + industrial_production_per_node="resources/industrial_production_elec_s{simpl}_{clusters}_{planning_horizons}.csv" threads: 1 resources: mem_mb=1000 script: 'scripts/build_industrial_production_per_node.py' @@ -225,10 +225,10 @@ rule build_industrial_production_per_node: rule build_industrial_energy_demand_per_node: input: industry_sector_ratios="resources/industry_sector_ratios.csv", - industrial_production_per_node="resources/industrial_production_elec_s{simpl}_{clusters}.csv", + industrial_production_per_node="resources/industrial_production_elec_s{simpl}_{clusters}_{planning_horizons}.csv", industrial_energy_demand_per_node_today="resources/industrial_energy_demand_today_elec_s{simpl}_{clusters}.csv" output: - industrial_energy_demand_per_node="resources/industrial_energy_demand_elec_s{simpl}_{clusters}.csv" + industrial_energy_demand_per_node="resources/industrial_energy_demand_elec_s{simpl}_{clusters}_{planning_horizons}.csv" threads: 1 resources: mem_mb=1000 script: 'scripts/build_industrial_energy_demand_per_node.py' @@ -260,9 +260,9 @@ rule build_industrial_energy_demand_per_node_today: rule build_industrial_energy_demand_per_country: input: industry_sector_ratios="resources/industry_sector_ratios.csv", - industrial_production_per_country="resources/industrial_production_per_country_tomorrow.csv" + industrial_production_per_country="resources/industrial_production_per_country_tomorrow_{planning_horizons}.csv" output: - industrial_energy_demand_per_country="resources/industrial_energy_demand_per_country.csv" + industrial_energy_demand_per_country="resources/industrial_energy_demand_per_country_{planning_horizons}.csv" threads: 1 resources: mem_mb=1000 script: 'scripts/build_industrial_energy_demand_per_country.py' @@ -271,9 +271,9 @@ rule build_industrial_energy_demand_per_country: rule build_industrial_demand: input: clustered_pop_layout="resources/pop_layout_elec_s{simpl}_{clusters}.csv", - industrial_demand_per_country="resources/industrial_energy_demand_per_country.csv" + industrial_demand_per_country="resources/industrial_energy_demand_per_country_{planning_horizons}.csv" output: - industrial_demand="resources/industrial_demand_elec_s{simpl}_{clusters}.csv" + industrial_demand="resources/industrial_demand_elec_s{simpl}_{clusters}_{planning_horizons}.csv" threads: 1 resources: mem_mb=1000 script: 'scripts/build_industrial_demand.py' @@ -315,7 +315,7 @@ rule prepare_sector_network: busmap=pypsaeur("resources/busmap_elec_s{simpl}_{clusters}.csv"), clustered_pop_layout="resources/pop_layout_elec_s{simpl}_{clusters}.csv", simplified_pop_layout="resources/pop_layout_elec_s{simpl}.csv", - industrial_demand="resources/industrial_energy_demand_elec_s{simpl}_{clusters}.csv", + industrial_demand="resources/industrial_energy_demand_elec_s{simpl}_{clusters}_{planning_horizons}.csv", heat_demand_urban="resources/heat_demand_urban_elec_s{simpl}_{clusters}.nc", heat_demand_rural="resources/heat_demand_rural_elec_s{simpl}_{clusters}.nc", heat_demand_total="resources/heat_demand_total_elec_s{simpl}_{clusters}.nc", diff --git a/config.default.yaml b/config.default.yaml index 26937853..70dfc009 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -230,10 +230,32 @@ solving: mem: 30000 #memory in MB; 20 GB enough for 50+B+I+H2; 100 GB for 181+B+I+H2 industry: - 'St_primary_fraction' : 0.3 # fraction of steel produced via primary route (DRI + EAF) versus secondary route (EAF); today fraction is 0.6 + 'St_primary_fraction' : # fraction of steel produced via primary route versus secondary route (scrap+EAF); today fraction is 0.6 + 2020: 0.6 + 2025: 0.55 + 2030: 0.5 + 2035: 0.45 + 2040: 0.4 + 2045: 0.35 + 2050: 0.3 + 'DRI_fraction' : # fraction of the primary route converted to DRI + EAF + 2020: 0 + 2025: 0 + 2030: 0.05 + 2035: 0.2 + 2040: 0.4 + 2045: 0.7 + 2050: 1 'H2_DRI' : 1.7 #H2 consumption in Direct Reduced Iron (DRI), MWh_H2,LHV/ton_Steel from 51kgH2/tSt in Vogl et al (2018) doi:10.1016/j.jclepro.2018.08.279 'elec_DRI' : 0.322 #electricity consumption in Direct Reduced Iron (DRI) shaft, MWh/tSt HYBRIT brochure https://ssabwebsitecdn.azureedge.net/-/media/hybrit/files/hybrit_brochure.pdf - 'Al_primary_fraction' : 0.2 # fraction of aluminium produced via the primary route versus scrap; today fraction is 0.4 + 'Al_primary_fraction' : # fraction of aluminium produced via the primary route versus scrap; today fraction is 0.4 + 2020: 0.4 + 2025: 0.375 + 2030: 0.35 + 2035: 0.325 + 2040: 0.3 + 2045: 0.25 + 2050: 0.2 'MWh_CH4_per_tNH3_SMR' : 10.8 # 2012's demand from https://ec.europa.eu/docsroom/documents/4165/attachments/1/translations/en/renditions/pdf 'MWh_elec_per_tNH3_SMR' : 0.7 # same source, assuming 94-6% split methane-elec of total energy demand 11.5 MWh/tNH3 'MWh_H2_per_tNH3_electrolysis' : 6.5 # from https://doi.org/10.1016/j.joule.2018.04.017, around 0.197 tH2/tHN3 (>3/17 since some H2 lost and used for energy) diff --git a/doc/release_notes.rst b/doc/release_notes.rst index e5bd8d10..ebdbdd7c 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -6,7 +6,8 @@ Future release ============== * Include new features here. -The share of shipping transformed into hydrogen fuel cell can be now defined for different years in the ``config.yaml`` file. The carbon emission from the remaining share is treated as a negative load on the atmospheric carbon dioxide bus, just like aviation and land transport emissions. +* The share of shipping transformed into hydrogen fuel cell can be now defined for different years in the ``config.yaml`` file. The carbon emission from the remaining share is treated as a negative load on the atmospheric carbon dioxide bus, just like aviation and land transport emissions. +* The transformation of the Steel and Aluminium production can be now defined for different years in the ``config.yaml`` file. PyPSA-Eur-Sec 0.5.0 (21st May 2021) =================================== diff --git a/scripts/build_industrial_production_per_country_tomorrow.py b/scripts/build_industrial_production_per_country_tomorrow.py index bc66077c..4bb9fab3 100644 --- a/scripts/build_industrial_production_per_country_tomorrow.py +++ b/scripts/build_industrial_production_per_country_tomorrow.py @@ -1,23 +1,34 @@ import pandas as pd +def get_parameter(item): + """Check whether it depends on investment year""" + if type(item) is dict: + return item[investment_year] + else: + return item +investment_year=int(snakemake.wildcards.planning_horizons[-4:]) + industrial_production = pd.read_csv(snakemake.input.industrial_production_per_country, index_col=0) total_steel = industrial_production[["Integrated steelworks","Electric arc"]].sum(axis=1) -fraction_primary_stays_primary = snakemake.config["industry"]["St_primary_fraction"]*total_steel.sum()/industrial_production["Integrated steelworks"].sum() +St_primary_fraction=get_parameter(snakemake.config["industry"]["St_primary_fraction"]) +DRI_fraction=get_parameter(snakemake.config["industry"]["DRI_fraction"]) +fraction_primary_stays_primary = St_primary_fraction*total_steel.sum()/industrial_production["Integrated steelworks"].sum() industrial_production.insert(2, "DRI + Electric arc", - fraction_primary_stays_primary*industrial_production["Integrated steelworks"]) + DRI_fraction*fraction_primary_stays_primary*industrial_production["Integrated steelworks"]) -industrial_production["Electric arc"] = total_steel - industrial_production["DRI + Electric arc"] -industrial_production["Integrated steelworks"] = 0. +industrial_production["Integrated steelworks"] = (1-DRI_fraction)*fraction_primary_stays_primary*industrial_production["Integrated steelworks"] +industrial_production["Electric arc"] = total_steel - industrial_production["DRI + Electric arc"] - industrial_production["Integrated steelworks"] +Al_primary_fraction=get_parameter(snakemake.config["industry"]["Al_primary_fraction"]) total_aluminium = industrial_production[["Aluminium - primary production","Aluminium - secondary production"]].sum(axis=1) -fraction_primary_stays_primary = snakemake.config["industry"]["Al_primary_fraction"]*total_aluminium.sum()/industrial_production["Aluminium - primary production"].sum() +fraction_primary_stays_primary = Al_primary_fraction*total_aluminium.sum()/industrial_production["Aluminium - primary production"].sum() industrial_production["Aluminium - primary production"] = fraction_primary_stays_primary*industrial_production["Aluminium - primary production"] industrial_production["Aluminium - secondary production"] = total_aluminium - industrial_production["Aluminium - primary production"] From fa8f7887f94af007d49b07a6158ece8250413a25 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Fri, 2 Jul 2021 09:31:41 +0200 Subject: [PATCH 017/132] Update scripts/prepare_sector_network.py --- scripts/prepare_sector_network.py | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index ddcdc85b..c54e2a2e 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -72,9 +72,7 @@ def create_network_topology(n, prefix): candidates = pd.concat((candidates_p, candidates_n), sort=False) topo = candidates.groupby(["bus0", "bus1"], as_index=False).mean() - topo.rename(index=lambda x: prefix + topo.at[x, "bus0"] - + connector + topo.at[x, "bus1"], - inplace=True) + topo.index = topo.apply(lambda x: prefix + x.bus0 + connector + x.bus1, axis=1) return topo From 4ebbd294ec47d48649ae2e3f401504e4acb0b771 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Fri, 2 Jul 2021 09:34:24 +0200 Subject: [PATCH 018/132] apply suggestions from code review --- scripts/prepare_sector_network.py | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index c54e2a2e..13b4751e 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -52,14 +52,12 @@ def add_lifetime_wind_solar(n): if carrier in index], 'lifetime']=costs.at[carrier_name,'lifetime'] -def create_network_topology(n, prefix): +def create_network_topology(n, prefix, connector=" -> "): """ create a network topology as the electric network, returns a pandas dataframe with bus0, bus1 and length """ - topo = pd.DataFrame(columns=["bus0", "bus1", "length"]) - connector = " -> " attrs = ["bus0", "bus1", "length"] candidates = pd.concat([n.lines[attrs], From fd1121af4a45f203ce97bd6c8fe1af23a9165f4e Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Fri, 2 Jul 2021 11:07:35 +0200 Subject: [PATCH 019/132] add rule for build_biomass_transport_costs --- Snakefile | 18 +++++- scripts/build_biomass_transport_costs.py | 70 ++++++++++++++++++++++ scripts/convert_biomass_transport_costs.py | 62 ------------------- 3 files changed, 85 insertions(+), 65 deletions(-) create mode 100644 scripts/build_biomass_transport_costs.py delete mode 100644 scripts/convert_biomass_transport_costs.py diff --git a/Snakefile b/Snakefile index aba8ff71..45c33da9 100644 --- a/Snakefile +++ b/Snakefile @@ -180,6 +180,18 @@ rule build_biomass_potentials: script: 'scripts/build_biomass_potentials.py' +rule build_biomass_transport_costs: + input: "data/biomass/biomass potentials in europe_web rev.pdf" + output: + supply_chain1="resources/biomass_transport_costs_supply_chain1.csv", + supply_chain2="resources/biomass_transport_costs_supply_chain2.csv", + transport_costs="resources/biomass_transport_costs.csv", + threads: 1 + resources: mem_mb=1000 + benchmark: "benchmarks/build_biomass_transport_costs" + script: 'scripts/build_biomass_transport_costs.py' + + rule build_ammonia_production: input: usgs="data/myb1-2017-nitro.xls" @@ -321,10 +333,10 @@ rule prepare_sector_network: energy_totals_name='resources/energy_totals.csv', co2_totals_name='resources/co2_totals.csv', transport_name='resources/transport_data.csv', - traffic_data_KFZ = "data/emobility/KFZ__count", - traffic_data_Pkw = "data/emobility/Pkw__count", + traffic_data_KFZ="data/emobility/KFZ__count", + traffic_data_Pkw="data/emobility/Pkw__count", biomass_potentials='resources/biomass_potentials.csv', - biomass_transport='data/biomass/biomass_transport_costs.csv', + biomass_transport="resources/biomass_transport_costs.csv", heat_profile="data/heat_load_profile_BDEW.csv", costs=CDIR + "costs_{planning_horizons}.csv", profile_offwind_ac=pypsaeur("resources/profile_offwind-ac.nc"), diff --git a/scripts/build_biomass_transport_costs.py b/scripts/build_biomass_transport_costs.py new file mode 100644 index 00000000..ee681566 --- /dev/null +++ b/scripts/build_biomass_transport_costs.py @@ -0,0 +1,70 @@ +""" +Reads biomass transport costs for different countries of the JRC report + + "The JRC-EU-TIMES model. + Bioenergy potentials + for EU and neighbouring countries." + (2015) + +converts them from units 'EUR per km/ton' -> 'EUR/ (km MWh)' + +assuming as an approximation energy content of wood pellets + +@author: bw0928 +""" + +import pandas as pd +import tabula as tbl + +ENERGY_CONTENT = 4.8 # unit MWh/tonne (assuming wood pellets) + + +def build_biomass_transport_costs(): + + df_list = tbl.read_pdf( + snakemake.input[0], + pages="145-147", + multiple_tables=True, + ) + + countries = df_list[0][0].iloc[6:].rename(index=lambda x: x + 1) + + # supply chain 1 + df = df_list[1].copy().rename(index=countries.to_dict()) + df.rename( + columns=df.iloc[:6].apply(lambda col: col.str.cat(sep=" "), axis=0).to_dict(), + inplace=True, + ) + df = df.iloc[6:] + df.loc[6] = df.loc[6].str.replace("€", "EUR") + + # supply chain 2 + df2 = df_list[2].copy().rename(index=countries.to_dict()) + df2.rename( + columns=df2.iloc[:6].apply(lambda col: col.str.cat(sep=" "), axis=0).to_dict(), + inplace=True, + ) + df2 = df2.iloc[6:] + df2.loc[6] = df2.loc[6].str.replace("€", "EUR") + + df.to_csv(snakemake.output.supply_chain1) + df2.to_csv(snakemake.output.supply_chain1) + + transport_costs = pd.concat([df["per km/ton"], df2["per km/ton"]], axis=1).drop(6) + transport_costs = transport_costs.astype(float, errors="ignore").mean(axis=1) + + # convert unit to EUR/MWh + transport_costs /= ENERGY_CONTENT + transport_costs = pd.DataFrame(transport_costs, columns=["cost [EUR/(km MWh)]"]) + + # rename + transport_costs.rename({"UK": "GB", "XK": "KO", "EL": "GR"}, inplace=True) + + # add missing Norway + transport_costs.loc["NO"] = transport_costs.loc["SE"] + transport_costs.to_csv(snakemake.output.transport_costs) + + +if __name__ == "__main__": + + prepare_biomass_transport_costs() diff --git a/scripts/convert_biomass_transport_costs.py b/scripts/convert_biomass_transport_costs.py deleted file mode 100644 index 57bd455f..00000000 --- a/scripts/convert_biomass_transport_costs.py +++ /dev/null @@ -1,62 +0,0 @@ -#!/usr/bin/env python3 -# -*- coding: utf-8 -*- -""" -Created on Thu Mar 12 19:11:20 2020 - -reads biomass transport costs for different countries of the JRC report - - "The JRC-EU-TIMES model. - Bioenergy potentials - for EU and neighbouring countries." - (2015) - -converts them from units 'EUR per km/ton' -> 'EUR/ (km MWh)' - -assuming as an approximation energy content of wood pellets - -@author: bw0928 -""" - -import pandas as pd -from tabula import read_pdf -import numpy as np - -# read pdf file -df_list = read_pdf("biomass potentials in europe_web rev.pdf", - pages="145-147", - multiple_tables=True) -energy_content = 4.8 # unit MWh/tonne (assuming wood pellets) -# %% -columns = ["Komponente", "Größe", "Einheit", 2020, 2025, 2030, 2035, 2040, - 2045, 2050] -countries = df_list[0][0].iloc[6:].rename(index=lambda x: x+1) - -# supply chain 1 -df = df_list[1].copy().rename(index=countries.to_dict()) -df.rename(columns= df.iloc[:6].apply(lambda col: col.str.cat(sep=" "), - axis=0).to_dict(), inplace=True) -df = df.iloc[6:] -df.loc[6]=df.loc[6].str.replace("€", "EUR") - -# supply chain 2 -df2 = df_list[2].copy().rename(index=countries.to_dict()) -df2.rename(columns= df2.iloc[:6].apply(lambda col: col.str.cat(sep=" "), - axis=0).to_dict(), inplace=True) -df2 = df2.iloc[6:] -df2.loc[6]=df2.loc[6].str.replace("€", "EUR") - -#%% -df.to_csv("biomass_transport_costs_supply_chain1.csv") -df2.to_csv("biomass_transport_costs_supply_chain2.csv") - -transport_costs = pd.concat([df['per km/ton'], df2['per km/ton']],axis=1).drop(6) -transport_costs = transport_costs.astype(float, errors="ignore").mean(axis=1) - -# convert unit to EUR/MWh -transport_costs /= energy_content -transport_costs = pd.DataFrame(transport_costs, columns=["cost [EUR/(km MWh)]"]) -# rename -transport_costs.rename({"UK": "GB", "XK": "KO", "EL": "GR"}, inplace=True) -# add missing Norway -transport_costs.loc["NO"] = transport_costs.loc["SE"] -transport_costs.to_csv("biomass_transport_final.csv") From b2872cc6b059791f199f275e45859de36f35febb Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Sat, 3 Jul 2021 12:59:09 +0200 Subject: [PATCH 020/132] Cherry-pick from #137 (#142) * Update config.default.yaml Some people find it counterintuitive that battery and H2 storage are not kept from PyPSA-Eur. An explicit mention can help here. * Update installation.rst We only use one config.yaml file * Add an arrow from biomass to carbon dioxide. This signals that we also have BECCS in the model. Co-authored-by: martavp --- config.default.yaml | 3 +- doc/installation.rst | 6 +- graphics/multisector_figure.pdf | Bin 38867 -> 33610 bytes graphics/multisector_figure.png | Bin 184449 -> 306851 bytes graphics/multisector_figure.svg | 1978 ++++++++++++++++--------------- 5 files changed, 1006 insertions(+), 981 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index 676450d7..5f1fa1b8 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -71,7 +71,8 @@ electricity: # regulate what components with which carriers are kept from PyPSA-Eur; # some technologies are removed because they are implemented differently -# or have different year-dependent costs in PyPSA-Eur-Sec +# (e.g. battery or H2 storage) or have different year-dependent costs +# in PyPSA-Eur-Sec pypsa_eur: Bus: - AC diff --git a/doc/installation.rst b/doc/installation.rst index 3ab3d328..cbd4c948 100644 --- a/doc/installation.rst +++ b/doc/installation.rst @@ -89,10 +89,8 @@ The data licences and sources are given in the following table. Set up the default configuration ================================ -First make your own copy of the ``config.yaml``. For overnight -scenarios, use ``config.default.yaml``. For a pathway optimization -with myopic foresight (which is still experimental), use -``config.myopic.yaml``. For example: +First make your own copy of the ``config.yaml`` based on + ``config.default.yaml``. For example: .. code:: bash diff --git a/graphics/multisector_figure.pdf b/graphics/multisector_figure.pdf index e49994d7f55fffff5c31bc1e3091ee7291754c8d..35bbaf1d5bafb890174139854b0ea3699296dcde 100644 GIT binary patch delta 29674 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⁣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 _2%3x`&RNlF(axQv97- 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 diff --git a/graphics/multisector_figure.png b/graphics/multisector_figure.png index e5c17c73b917414fb81f4636f0d6a879db418f7e..415e7e6d615e5527716f99f44b6067b9e9953ac8 100644 GIT binary patch literal 306851 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

smWx8hoA^JU z7U~V$p(kkgw$$Kym@!N$EhcHNXC#T%SH?j0&Q zCWGx#R9*X%Q)Xi^5i`~0{V+3VXRWup-lV^y#TMOE&o|Oe!OeR!cQ-<*aE$Q^K3st- zmk@H*oj80Toso1zDxYvn&^Fy|(4YL`F0ipOTA-5S8bTiq9KZ@$1*@a6Y+C35!iDw8 zvHs)|b#Gv7|B8#l)+a!r0-GRFKnjdKYDsFRFMqXCqi;6RU;ds=_)mYTNY|s^QHLf+ zyF#|Z?#4f@2G3D)^LLtz2A9*p)T}|cfr@yoqTOlQF|wQ>=SRgg6_SrPGtZ}jkGYOX zX7co?`6J>(IdV9BiCku!M?<{_nmAMb+p(TcOMOEbXa1gXxZUzGtDaWik6DEAbLH>5 zBB!QrzXnW!E7Zu5O!H*`cO-wE~})w~OZ>Zf7ilYgzfs5q-0+B)rSp+Uzphj#CN zt)(l}$m^dV*VnIn|E`)va+|&-7Ekvr#3oVNzM3CXTQt@m8R*4((!U)QatuQhP4IBu zPGdj9l4$Zp;%{7;>~U4Tb%wiG^}35q!2$T2H$QxV^w7z+*=LkrUZ*Qn987`&%L@u- zJg$gCy+%QDZ~=EU{vPPR6V)?f|jJS3mj;T)P8C9U)Mm6tPuO{#g7r1N7qREcSau(SwMaDC*mB9@o%dVf{+2xK5f zYT~?X{I!sZv#o{ukPZ9-3_#Jl?Kvn5TVYFz5UEX~wyq)SdI!Vn5~`6iZ^_NW`fLSE z`o2M3u?&Bci`w1Z7HdA9Eo#&x%2_2b{FvMxO#X12O3HHSSH|^P-|C4eJLN62Gubro z*78<&?WY#w=g?@zqs0J>QqLiSQ$k4I2Zn2@+mN~OZBC;oC=c;?53xKmvhJ7$A|mYuwVLZrjF63 z_mG&%$or_!RS$2Fo`#R5;OHMO(L|Iip{9zKrujiI?dp&aKm;W^b?X)r0h&Fd~AKzXCTS>ip`?t@kiM^>8Uk$7fy_6y8#3=8}uItN}G zx8l(_Z2;2pv1IhBT8*k^TTC*soxWk3bZ!i;|svEEL*FO96*t= zsZX9lxS2TosGjENC#R-uAo1Dzd*jf^|NFG%@i>q-;G}fKI}CF3bZL>WSGbr(ISM+!~L)N>!6LzwJFbLeM}x4?*I#( z%#0;uF7r4-w0QpXqPLMYSnw~7lHZh#`O0crwCgooVkDpOW{FF%Lk61O#n9cB|4qIN)J?JC9=scQOS zL8+Wkw~Ce$Cj{;QP_Yoj&{_I*8yBFEK7j!c9mFG+eAW;kSRaELX{0nl{{trmQ`&Q4 z(4r(Or6ym28YB73*pmDl4o4R~uL{VU5@wF>*Bw2Gvzbt?gPRD?-jI49)==@|Z%7n( zeJA^_6}TxFfV%EgXMEX8V?gF1`rEDw=P3NU+N6NWsVh_9Sd2UAe*oR*^qJ&qXA4H0 z2rM34|Nb~8oh8OTegypp_uL7$0rPRb?;K8tr*Us`-2ERD0f6~_WAKri@IWu=TG!|C)v-Eq0Zk&BVYhgAuwnCU;iaD7KhXMh z;)VmrHW?Y1TIszedJ+kyJ->HCtDjnpA8G*;<(NAWC;`fq&(q;OWe|#A29ZTuvS!O4 z3V&h;ELYlmg`4adTbrb)L3dG5MQ)j;B}bWz(Lx_6iJhI%e9Pjm;_D65zcf!My#Mo; z3MJC5D#}a&945EL)(WA8I8;-3f*2vQc}-|}ZN(Tc<$!7Fij5xJ9;~vb|A~+Ta zb=MHl1KSXGt1tlX+SWdh`h4R@nNUQg19V z*WPO5Yd$3gFI-x0m;=K3uJ$0jf8ATbgNc{zrF+2)h!!BYhUD#=m` z6&q=T_-<|B03i)mi!6?5dX8+>z?K&uM0uVBwL3y}_#?yq@O$WvgdC$_<3$MF^l

    19fJj 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
      2b1#3wK-7#(jQXH^ZAQ zOVVFhD~V|QSphX}y*u5qb!EXh!grN|@;=+gv9kgTo>Lsb(275`Rz!Y>A;ByKW}VKmvHJ!%5!D) z-FmYO7(GO<)e=Pv8K<#C88ZHdp0H-{Xo#BjZMsdc=a##-i1)D*g{!@zV6x1FH>n0i z9^4*IK$d#^n=pKUca_BK6m`~Da|cSZG>;LrU=atC{QoUZAU^Y$3WWL#vH$@7nAB1M zOla+4Ugrq<`caO_ubatkDBAY&rDD&Q^IaZa@-5i!AYEUW?vw90SkQlpY?CP1Oo`4W zZk(*95BlDMi{kkFeN)HAj9-;`9xe|K@CY2|eE4&oy}7DLBp!^cElzHUzdKvskBqs1 zSz5sz5gC$-)P%53YPmN5X;vh>XKggGHcmsmM>>b1C`Gfg(%iDz22ZRI;7;|h&h{^@Q-{kWK7J=Vn1O<# z2c6TDL*E#L8fe(2%um0>7mq`vtzo)l(9wfZ7V5G99hG_VosM&zO@cAq8fOKY+Kho3`2C`HP0q5d67rYa*$~0lvoV%g{&C6 z5Bwrp1P=&UCL`nM8qbuMoLSELwHtRFj;X)0&i8#?S8X>uiVB?Mn1eY3`5&a$^UNN$ z-np$FMl!UEg{!!w`QQ3nLa+|FQO2MfeEg`p-}K+ z5uI04uh*P&h$Q!2_e)&;aPc=4#}k80r*m)_OgJ1guUNLG4U-WD8fsVaN&X(cS~tf0 zR%L}WLDv$oJ>y4*-5Q(PGu2+IF)ylS0bUdn;ibb$4dw^mPIczOiu(HAo&kKYBeFqt z@Li-tv#~R%Mv!5ONhJI~3-AxfuR1*0LN5-*g9X`Z9lr`FaZzJf;*Jy*d$rhnpxN91 z7{ZX$T}TNVDAeaZX!wQj7Qzf&A>Y5()585TM~3}I#(|JlJuVr2&+REt$57Mdb(!gS~+sOwrKI%*xuxe4Lb14E*A3^)h@f<8qf-Z#`%gaQp}avuEc*q3uMA zpgF2BrMTtTz()s#Y&n}U{)+mtJI%lE8PGCd1&WYg|99=ozaFoM#K4Dm)3W$$kE0rP-dxykjO)EzeW< zD4l%7R96m{j=NOoWv_6_K!=)7(SoenxF*RS0Xie>&RS2fQTpwjbnm%^XNk`3L|Pfxk;m_rL2se zSxURpD}UNnY!_emJwCck-Ez4_DOQxX(P98gLxXh_+IORql>JCX&Hw~!-=X#Y?A#lX zXdIxVB%L{J6OLso?w;MroZ;q?!#)-h&RGcMR0oPI$#=Tm=85oiyV|PDsnbzLJa_Ic zG%Nef%USKBwCQcQ)OE{s{;!gxcxr-m zNBucfLe<1B)_Ppm6EYS2Je=gZ(r+5)TGX0HJ?q_(u8bC0Z<_Ip)DmUNZ2$NV$+?bi z^;#;sD;HZbHx;?wB~mMPpzUHNYP>9lQ`?=JkmsUn66hTle-?lC>Iw>lHD`>F{wWLI zsa0#gMrK8n13il9vT})Ig#N^mm|6HGU(TSxf)Rf?YLaTxxW`_40r#GpZVAVE*qv+C4_E<~XZS_@A z*Rg2&*;x@o=&&|;)V{*fAhkL*PsORX>d&M&9m!nPE=CKvYJDLs92an9a~srTy58cP z{N}ih8YONNIjKu$*-HLpKZJ|z`+xA|k>_+YHEzi(#F_L(fz09b--saFU3WIp)L-g1WT=;H@1NjG`WnudP`-+okAo%ui8{ z0q#o4XSEFcLY8j0ka{`Sxfok!AAI+dp^SB^xqzQXWPP(tOwJ6mk!0zy^s`EVBM$x$ z`M67x_nFc_?L;mRMQlFC%!-O$EC-lCp-KEmWBE?@@9pj>Ntoc;#$#;>b8jZPAg{yl zV>_O{vCUmgJM}NcXBm$E;UofEs~Bj?-f-K3gRGE(@MfFCMa?>4{qhSgGjD#LQ%y7X zmtc#BoAX)@t?@y~v@aoSq!IpPvQ2jLJq}C_Dlm6S|HbMX=!1ab92iFf$4kO~q2e-k@eBV*SDsmnfZGwaKn zei;-(h{o(RUZ8VaoC(@pN^oChe&KRnHPl9K65V%3H5!Pj1{Dlw2ni7ZQ^adnB@VMS zHp6JVzP)I@npwGcC`?3p%oq7iT%FW7XnZGuphScVV21(1940q*&NriBhj1L?)*o~qr|Ty6$6E)V{{7;PL^FN7=KS_XYB9x%Q}Z1|6xI*Rk)N?FxQ7ON~G!uoGB zLAyg^47vql#fG2ip`BuzYPp*`uDLe1>N>V9Mk7azydQU2G+*4=iJz&oek$JXLq)E$ zVgmFnCO2srM4V%?EgtE-kBZvd%tyrjl@NGj94Q*#lnQwuP_ILm={g|nxd0SqZ;Hyd zO?K(i8^ba19gM(Nz)$orGFZ;jGc&nz-YzTgM!-+2PR}$inkPN`)pYwRZ{7y?2vYR# zCC$o%XJB^~xL+JBRA6C2<*xH>;jEJ=Lj5$1)ifgVIYzPwqiF! z(>|zdhmnl!B5C##F3g5e?=s%IYrC>?HV^xsjEbj<2*ckD@kh{Q?i-7W3fJpn1pN&FpTL@OmJ_ zCX3F}vS+2at(QEMTs8O=vhy5AhUUA^w^m16wX=ezx9j|^ULd1f9M@h8PFnMAJrt%w zthTiT)YRlKiy(R~<^JH}DRtDPL!|2#k{uook{5mB9`U->Xgm*g9Sh84xLZr#n0G*F z%l|!?H=)JK_rC<-|7JI|c*6%3q-Rp~v}sa5Ht`UWlN?(n$`>GyXmCKimnrr4;+<1{ zGV3jpZ@7T8FH{3oOnUD({w_(>80Ej(Sh=D!c=}kLU^Znw-dSME*BsWmJaSsSc$2xM zW;?iGcL@iZCRBZQk&7CUFaEt_Bs0~imlF0q4}13!2&lkrq-%#j zwNATQo1HOiR6TK$vUlQ=uiVTeVt-EKrh{@w3mxaC({C$Wb@O)#55y$21cRLG8zvwz z@NdYy7OCVM7owQ${BkIr&HR81HjM{`(vJRZSV+rkgMS|vADLyMMt(*kzjR3pVvxjDO~)P*V}Sw(cUC z?}Uaccs)mmK%4Xo;=Dlsi$|1&k!+G4?Vm%?sXESSgy%@|f;uzzL86tFn(&%|;%@j4 z`983_u+g94Wz|K2T{etL)GN8db}%luBkG^U5i<3;aUkICv|OJzFcdbI2h?tcPQ0sM z)^fV8+MJgw-pQq;iy@MdSBz;dA5(KfTf85dvN+bF5St_yj~ta8?uZ= z4Rb3E+g2upts-<43{C+b^I*jmkZ)|{R4HQFH3Iy?Y>C}Q)-!G=mSdzFB9pD!%a5H$ z*da}smoM>J!IondwUO2$S(Oz2@vBJ#~*8tzplEC zA^%NwF#Ze1#<$l^KL-LA4w0Pt7o*ZB2NiJyBnj?YzQXw9hLT&B%U7bytsR^tmE|1) zz8Fj{f}Y-6S9~kGxjC*m$Dj8JwIGgSg-vi^ldiEAcXNUN#OkYl2?$nL7CsxUgndxYym zW;hjgNwPRe&$5`C6c&+_w_aP<2V5#qIy}n>zS>8gwlEqy-?pTzRyS___6<$m08ifD zCwea5!G{(}8C^{_YFGF?7i%3#z{Rx4I!8ObPpZcNyFfh_OduV~$W}N);5rahk`&9%PQX>K}v+W+Q4{v{57ZRtVv5uZ7Nr-Bb5AI=q|5#Ldc~GFc zDj8@$jv({uzFC6n(z+-h!7On!jbE&fP8>0N!S2o{fx<%Q7=hHjy0HX*S?9P6o;=aBTfIksd7-(+NzmP=UIB_UkCZ4Q7% z_!r8-arrMVnXE4r^XQwG?QLg%pP6Z( zj6-x>9lg62URL+A!1AE_f94Tzz2{OfdNDeS#R6gX7JHZkzj!JXJV9s^?t4>-I#*7B zzio5V&fukaM8(_Lc-K;U>qm}SPOX!q1zuz@s)WVYw6+rM0jUvrIH$SF2xEuBVk3Ru<0SUXaV^2yiBl|Kpbg=Id_X-mxv|qgEuwDh`3+$J zn$)O!i^!F(9{bl)c*g&It0}}Cf?{(18tH>c-AY8rA|8eWWRiCl@N;Y%4vwdN!ANtz zSmGaigfCzK$ZDhKF9|L=cDR3ITQZlIm;0J(u{Z*Zmu^P!sI5od#`^I#yozYTXIFCZ zFheaB-3GGOC!-`>2Gy^EfBTndV%a5Ru=od8Jy^Dp_I+6{dV0=L?e0hb7RSYgZUxVu zK6I55bw+p)WW8`SzElBfSY?eB8XPa%*G}KGt9@KW#d(qP0v5q>wG7e@k8xXaFW}k$ zqkV4jcA@V^sR)Wy8L~-Qo|>R1aQiQL3n|4Dqwa15{|?_%Lz1s*j1nmbvMcB9tVr^_39hH*5lf-IN=+*4C~L`}Tai@iDaJvA^nMW}4xbIZxU`)js2TsXy*yX1 zEfVQ!q@CxwkQU8ai@c!o^JFQBkC!D$`o(pLg!1rev#kO3B=(e)NaIoMAbkECVYRb!+ z9Bg1}0dZpjgiCI&f_WfPgOH)pCBP?KM_kTX8%c@s=er8Aoc^MsmwG+!+}JYFN2j^Q zkH#ij-x*ED+QwLIs<^cN$eks=_Zh%$hs!Zhg6hfwsrAOSyMi0JQd-RMaf(rX597UI zdEAEd2BVDiviZiBpC*Mq@!y5)>&(i_OiO77aW=$E3kpI}bcI-$YHK~*=*4;@eSm%% z0O%=-Yr@^2{oct?#@d z3kyw7tOa*En5~DbZcaaGIjtx_Q1Q`*Cbje4sKzk*mo)JgQ)^yLkjB+l`UqR|B{ha& zz{&^*7;34lPcm9-PZ(=C9UY73^s@>oYt|K2RV4$6fwT0UT~f9bB6Edwacd}n zIL$4I!x?Ai;!B#MfATpVd+fID-D{Hvzsfa@Q~Q_MN%ik3dRw;@wrJVr@~qvGE9Hl@ zsNVuGN5n?G&w2Vs-FML3@Lg{MnGq+lyUEblYtQhGB?(T>1kMh8?nrzy>iMXYLlA@4 zt{=zk>+|_uhD7-hVj~V#)wz0vml!EA54|vBfiCgtQO~}$0n+_#lS9Ktd^~;36O>pg z8bY#MKv6jmPbRzg8teak1ZI>Rqd3aBuU-r`a%dVQC%nq^TK$hM<^mdAc6&cV2K=7! z_I{IkfuDLpS=HQhd7eyO?k$B4Gpbts3nwjCrv;PZA)ge8%*4lXf>)O)LGd|y#P@8O zYvL5V{lAnf$*;3&Tu0q4FBGz2=g6@9Wl+Hxuy}zF{NYTSD>JXV-tBaT411D|kAx@_ z%;dxk5foq6)#^Vx!bR%;UPWA}HJ*x^bkah>=W|lIkYe<<)H4QNh!(=f;5&EkTa&K= zJmA!sSlKQA)!x6|Q!)Q?K}hQJ8C){R6)9Nk1C%qop+?Eu$=xK(U>_pusVhmm8My_+ zTGiK!<~|YKmdAVnMYVal9^ zBy%$J?!&Ya6Jp{_&a^9}#Sj3^)&xF7+U*R%QGE)ohU4>b8l?%-`a>So133mw1OLb7 z-mQ5{5~5DCn~4EZ$5HnbZ3z@#xs`bVT|d*VQKu@aeeK>YN}3>-vcH_Qtz$>+^{QZ)@w->W0t4 z!UugY7_QK9+V5c?5fISlphf3~81_BaI)%Qa@c3E9%9wn6;3q{R`7trNf5mgIm&~*8 ztaEa%)I z2ufl#Pc&a;ze$ZPwk_hgD~Aq<_KEoMvOP49M=M|mu|&oiYnqm8%cEdwNZ)hhM;?v! zC9mz1%2Wp_Hz3d8J)Qli)>5|me-=Q&HrzxuoQ`t$Y=fMAT(j9BpX5+^h5zL2Q&l}) zU0Zf@bK{Gf_0Q|1_ba(#uedU9>|ZMSQWPP6W@36oc3MABZVL%`ow~i@SIv>j# zoQDs?9F^r8>3m@n?)2Ts7N^3i$sr#L#PUP_ptZ13GKcVe|(Y+uLy$< zv9vI|b>ZQ3icqH1BT(`&;B}t-?sF)L4L9(nV~MYUWOb1?mGx~-NL56vazN;bF%%k# zwfRf4XzvKaK0aHgp0}Y|=rUu$#3D;Ojfh7YLJUNe3*v9qO_Z74w#$GJ8YZo8QZ%U| zEFb&_QiU7sEzmJMyzT|M6xgql7?dQ1Z6S~W%COKjS(Q~Y6g}TBcgJu4R&BS4{yAUC zSolUqYWy?_(M=NwG68NQIVS{&4R!4)9oP_FiF>GiyvAilsv#-H8F{5}PjqVv0RdAIoAu3R|+*=aU%c13yz*SPcYKN2~e$v-}!eSvoKrDA8~+IV^i51|o! zy<9caI2Wb*`IhdJOC>7ZcFlmBq-msX-F49Jx~Z}td_f=bcSvan7U&J+#Kf&4DrDG0 z2z_O+_=2%7zT#g9S}gbI7vY|IAthNHgm!3MqkEBTBtpN6IPb0TG0q>aHDu=oQ}<|BOSy0}jsE zpFk=ba2u6E#zTyA=J!8+P@{N0{g64tpN2al#f+s{ zW~(y3nrNSnOqn1J%Hbm?iUzxc3MQglh#0e{6+kZ(`T%pK+_lNCi%CI~K|n#qR&Gc; z-5OowXXowu=9~lp=lQ2?IIb#^nuHVZjMii!rvo@ zb4&63EyBR_*)yBt6Jm!Br4oD_)S#OEQ}3ZA+mK<6$j9TFss$J3TO^?$?0Xh}G4FeM zn#t_*cx5(Fc<=&^tgAjt#>R#`?o)LTl!HnlZv6vGOZi(gO z@YWjrfh?);`GoHqT&3-|56&j1$GZHfnlo#T_$~t?8RgF6*3W)+my>7XO(*swK*Vvw zi-qBr%ppU5_ZY%taadoM{3);_VGsYRwY@f+WSwV*Wf9sAzKe4z`q1gSGDuehvS2V_ zA_5H7tcSB?5k=iu$+B_g(IJJ`OvXRMG*0A`PG-WKXaTd9uL#&5o|Nc#kvsJR#Zg35 zj6>SBJ6$1DnZJ&XvYNhj_Xbdd z84#CjG(UEK&wa}9CsU*Kxvj>ybL8UGgJ$WH4tq6a`nwu(ujX4t zR?7f&KAN7QIwl`QfozV!*&-RI_-^#Yp8(qg07P6N7cQ@N3b`bC7$nlsWA&B90_M(q zwp~_j?A@!pi}nJ`+dU+|rAKzFevv7Dg^$kvj$ayWllo>X89M_BLk9g8dLZ%^90@hL zXqEP|)siNcc+OF0iV|kj;Y(6fT<;a1j=r#8LpYG`vYp!3#y!o+z&MUPWxdq$<6V1+ z3rUy@GGY)#%RlF!PG(sip6o2FxP2YZL~D`02pqrW({OOkDO^&Ls-eW`Kn0CAgu=^Ty;6Jm$L zMjGWMJ9JzxXl5g4i*u^kioK|mf2exf2tWKgE3$I1F?x?R8l%F1FJAPOtdnwQ!Y0zH zbpAAqvG=WudW1;OmXqxJobOJJmMXUXKegybyb4@35|sVdq_EsN9Q&NdyjL7IpTx!zwVb?gMNi!$H&N@hx4O z3Hm`wr1r)!AX z+OpSM)8Q{=AjD2J9p8RoNey?YKJj@U|oZ1n$1jg=kEfoKNGJOUEh=C$? zmXl^QqF#7cb+Sd{rKZK0B~xg}suVff@TLuD;35Tg6j5TJ8?+&K0mwtzabM??yA;;6 zX?@3o-))h8%zlFaU}8Q}xp1cr1hTu4KdX*U3eCa1nS{cuKV@52d28kC5r)%kUQEARFh`-XdTCt$8R%GzF+K?VH$ zTt^?ZKsQz$PC#WiUA#%BAl(@K1q*y#?OIp;rC0EYkZN#wnr#^Y-!EYV;qu*RLagK} zAG;(QT=+PxjJV1SNj+JQXTj;J?aWJ=Mjt)-xZjUN3DZ`M4d)y-s1$POv*&rwdFFaRLeJ*osk`Ji>e z=(7!FkSNCdKT`()LAv`c2+5+ZOmuhIa018|j^pI+H&fxeRz=MPd-M%EhJ50ceTj|i zdu1!}i@j_?6gl71`BMfN>Ngf-PF*di79}W^dM-wioh_grbZ&PfL=UnJB2?E(S{oBi zhb_#batO&J28+9e*Z)4l72sd@-kjO?UQ^isR=6;^*HMPVvH!OeO-FTa#=el(NMe(~ z{+bsus`Dy&l#S^gytcg@aClxLLuzO z(K_UqJU2&0Tubf;WL{b z82g<(HI!Xsn+@b2s8cBo7V9Td*xy8-_`r8FLp3e%#vr_*>MfPb*)Dj47M0n$6E@^* zYBeXxp{MlK(1@At>voOfYANfcK{k2`RJdq%sO`UW40ye|tQait{1&h|)iuOX-rw?j ziOF62n-eOOxo;T&xUd7_$*(i#^1S04v4p|N2}RilcKk0bk~xwkJ!>{fl#C*_R2I_7 ztQp>zJ0;#&opO`Jq;Lb?_)SJ`Qzaw0`0+W0&6W$=AyC1woX!mp_0A1`Od+qB$A3gv zdz^S|wFEt$N=erR3L4t?+nf)|n7fE9Lg=Jd*46}$<2D;A%Kips80-JL0wFg9WIsUr zawM%II7KF71cp+@-3yI;{kiqit!Jr~nf<4=w%-rSk8?D29J+rkp8cQ20|378LUDId zyX}S78cu-}T28F87)zh0KvZVM(=Re#F&9IV>YZQsmF@r#7+cis>tI30OT-NKGY2+a zXyjMz>gzbxqOm^)CT>d6M^MjYDSVh%DhnJ{3osmFvtG?6e#HUb(74@e$ShS7j{{dh z#>GnK@5%bqU0(?kZz~Ffbv*9ATNM|Jh$Em*RknNl#R$|S{(ANtl8^gX6um}qiU8oq z{T#@>cWi#pVo%t#S(~`w%6+Zqr)ZuEzA3&Z`+{`R<_1VX6b4oJIGoT*t=a_S&_OE% z)5uQvN>D%nYKLdJa&0A2bbA5UT`iO)v$=T`#jSZonv6vG>PP4qeXfz3>7x&4&1GLj zq{8q;O!h|0Ak8EWV1{OJ&pjD)gQ&~5E>o%XP{YDpS}l%2fOre{Zw!YB4o(VTs-m*D zDgfEXK@feEjUYH1vq^$32+@gs+B~Oy5v0O1{|3H2WSEByE}GxogeP9euv1wmLQ9}P zj&4*>1*H>+^xxq>hofs0wV!4$O_LIr(|?QvLvBaI#|TSWuKBS*gf|75Ix_YTNLVL( z2ozOye}Y{lwFC`RZ1?jGLeHI_-Zwo=d5 ztX?8`-9K%YH~&DliMOn2=zV<2RYMl&4OGllelMr0CN`B_B{4f0h{IC|OQ*u{ow_Bx zC@%i}y^4nD(Q$Y6+c6SQ5dHWyO(221=@MaHY1L-1G(xynGx?*(d{q`u`G#IOm+~V` zr=9Wc3wnsp9nAQ7B>Fjl!#o7!9P~i%U|OwPbZI_kxj}I$L=vsFW9|Fv@DNe^3=t)a+&llb8XcO z5@RMc2hx`b7Wm{0c6daB^Y!IXM68lgB)8vdD z_Qhe9Gk|%W8=Kkwb z>!AcfOKkUL?#B-U=iFOkEw-XZjm)cwH*y2w_yRBYZVwk+T&ht-%j<5}rJ1Pr6ri@H z_>T^QN{2uPeDPS{;h@L%XKydO;q-34O~R5@Mn#FHE*e5ogS}PkQI-e>g+)#PtC&I& z2V$XS9jQJvyCR-8^E1_8Q6xFD^}E$8{s1gI*${qOAEy=NTXibL5_*b(NS-up*tACB zR9CiGgdE9pc00&G7+&*NjrShu`;jPkts*Enu)G6c=FD|xrPg_>!;P=&hOuLDCndt| z@^x3~$KukG2|OPs*>`2iaksm))RUxnl}PjBC%D2q5?N`Sm*~i10sh}}mq-mnm&Q6C zI$PQ6^2bW(r(dzF<&xSjKxjQK$gghFn0&wlVq6oKdG2@Tu92Nso@l>OI-r+oHI^ip z;LdS*Rj|iusBqw({`F!j!)k(1g4H7~`(P<~G@BQrh5Dwr9p2A(@uF?wyJS*(LsQdy z(eze0<<+|fWh1cWxCMdvt7<=skO4 z#l3xWWwTc(w-DV{K+$Ur<%kx0jcNK@ZzsUttpi$M)$YtHx675&S7F?k`Tb}>9+%NK ztU}y$2I-;0IIQkEHVL)e-`NOonrYirO&kVsPi#I*w_Sh32Q|1Ppt^QwTD5`b`esP?E*D1@$+MP|a;$*zNm|~F^{vH|!7j7=$Bo~U zNWHK7qozZwx@{NiSFKOvy~@aQ~=wem#z4Y9d?gN zx5@SaTa17bBCCJD*<5vKud?DqNM7J=B<6ZrZF9`{Zzdr)8-F8O0z&q#EJ*UN-Ug3> zXh}Otr4?{(_9NOdPeR>)~rCp?0=s;ks=_C*%^vBGK%ws@7m?47zK#u9i?4 zB{4_5!#UOf!%x;+oSvk5<=)~n7>w37X9(MR81UrXVzF}hS#-Rpeu@y>C>p)uD5Ce0 zpHjQmpDV(~vPY%_f(6km>|`-|yN@ViRPW!l)~V0DNqLzrAXnDadDV;>YfO1?@y(dK z!(Twnq5aIy|1!Q?OUq;%kp%&Gta01Lc5klx6v%%RA*UFUwbjtUZ?3Xi+i_g9GN$@Z^cfh`Dnis(mwko1`x%tQ>d{G$X^o9lAkNah3w zVmRgmr>*9=%Z){X-?#Kf%5Pco+ABxLDBL;hHxS@z=wx+Ju%d#3RYsWxI@95pA}2?Z z>?;F#s}cB#4QnMynM!z{J||R~-~iA@dXuz&xK_XP)NxgjxLDQ<)*1C0VU3Himb@Ko>8cQF{7H1UJ>EGUsdUgCkI6wfz@3{cW z2^Ufdwoabr2Y7;BMue!@DuD;;G(1}b=Zn_y*#NBd45)O_%J&BJB|(m8G^jc#RH^}`tsnrs1Tn`bdo-Or6C8by!e z{+iPxnXhncr+rbla$d&UwFMmeSY`yAE%MYu;<^@jV;Yx}fddn&lklgo<7g!8t`$Xb zQf}TX%<%19O?LL1X-VlLI#gyp2Y7knC=wxh(vv8aB&pY>cf&NeKj4j;tSDI8l1_Vz z)}q;fdk5WBUrSwnr_+#!A0%?+KE`qqua-J=%{IF_6J)l&)=<+o!>rHg12xJwCBA_T z4wa^p0}u7>sT#`!1D2z`(-!RJAH%qw`It$b)*hjppFd@!R{FH)n9mGy5cVd8^UmmK zSkq(_CCD|DJufcj@2_9>$DP{<9*n)Gj?hnO_>J_)9ewv<&cdQ?`f{z2lSdQPZK7y5 zHx#9%FDL}$+DOGsN}P$LYx~mG!4iT13cNA88uJj}e)uIZY)XF=JgsL^fmUi&$1hGC zrGOMi9A*>7%Bc4iK{@5K)s1mu^W>Ct7VwB<_kNdO%;NB74d?dV1W~!P`fNwBP_+|o`E>`H)mokW!n0Z8Tu~f5|RIl+=HHPjILQKYQ zHonJGvAAvG`k`78m`oq{k?Fj%VF9;G4(&Yy9fHSEdHi@MFBE}CzBvbY-fcVg2MTvz zVV9lRd>pO!3I-f!?krJAO1>fX*zXfc(O83j3U9maskeNuh8Mq$Lg2M~JUiy&Uq{DdCv_(?Rg$!l^!)IvN4pT%Fer}Rmm`=#Y*Hnz;DeG#%Z{9u}qi64~Df5--BH=tNe-kTba{a%S`%_aJk zfy9x#=y``e9^#Zpr z>#vn)@{tJ1WjFFur9wVsufx~S`s(wvd_m?JJ{1Sh4{PAh;Z2Q@JlY(`(LpknLjax7 z&z%zr(Gb4X&lyreo_Xu|5}*GR9(I`8oHVz#v(odTCU}Dbe7Yuoy6}o5h!+aIi@-=` zJfy`2J^i|+JX{Yd0Bun9;H^1lY>c`H6&TTuP<|CY_jW79qO&osXtORNl!sH8s0Eg) zyZYh5K3Xfy>rj(mQ54lLyk$5=Gv@3BYb?2i4NMQPea>LD)S=0=0(>9VYFEW(cvi;z2IKAy zZob5Y%1zZ5-+c7==yL>V?K=DH<<$rD7{!_4z6?}aw0KBs__I_D+a~~B!;lIGSC@7{ zn+pzu%Y*<)`nQ&2ClShTviPZXgY;%~3A^iaMv0%(WPpqHdE>K#_a&a`+38^H1__Ot zpBWoDMUf2vh!F&V$yl7wGdE^mmj=5Mg>)bGzcrMN5K6r4chWOa^xFZz6g+V5tezF# zMAapk%fDsB=pc{s-uRw3cEWRKE#Y56LH78@Q|Vz-Xl|ZLf8cM4E9xlziqvJH_1DCb zJ&T-={c3*Mp=;_WR<~!r7gPXZ@>tN&z(+x?t#Qj57#AvXisqt?C`fc|cqead6ric~ zZnZuFagPyp^W_oGZgC6hN@@=!eQ~d0jcODsb~9K^77y4k+sRdRqMj2FG)pntoN}(I zJ>B{_57!Q^l}jl5#k8jJtIUjs&_eBdIwBREuI87GA$T0@=NIt*U2-3HB&VJ6mM@+; z4nKAWgmbj-EAcn!W2{ud$N!-UkjQz82g!!DKVTKlXW@C5zx1o@$7hzmEK2)^zzz7@ zeZF-v*ntA)$FNFDa`Oj4LiEfJ7Eg`*z;8|^sLD%s5<@#s^`brH`P^#IJaC=@0l*UG zs$o|&-}dXP`Cy+e7^G;fMx6c-gsRkUzO)H`k6oDd6@D~QPQ1>nPi(srns=U>F6B4O zrYM=aL~4*71IwZZoSzmn1%50V#J#=dd}b!wYF^G`g*n6gdM74Kc-YTratJ}Jr)Tw@ z+R@p{3Tmx6sCsdTn6T*wGgH5>SX5j#3lrrYTAuDKc_)o)yKF?*7nt8d_&VtJc`eK1 z_;@MBbQ6CgnM!zA%bYhkkhhjB2M2C9?;oDSMfe~VKVJn%_2WuVN&;jVzXR$EQ``m( zbgU+Fqg}()hX_;EnzJ^dB*d?Kf{SRF>65u`Z_~eMF13XCa?^EFLI{5YGXS9sB5?g# z$jik;0azN&5c%9a&J5!BVP8UyVcvtQi#|${?J%jNO5#fXOJrm#nmwB~M;=~dfprve zZj*F^vjm%VjX5nWBKA!~*NQ)7kI7i(t^OI>@J16(yT}k#Ts3j@TPeb1v3UG61+|aQ zR&Q!_kX=m=jfqABY3OQnc5AKU8kaN9u}6K>pb3;z+Dd%I z>w*I5ol!X98&n~G@I4G=IP4u3q56LofN2xPS4Spw|J?OfuvE06U73Sfv6A3~@rE{i z{m+S|juS_UOez{6KRXN^{ONrQ{putYm@65F`1o-iPfp0b6{eP2{;ffOv66M^4`?!# z^Pcbb7gl%N_IU+BqCvJ5tO{Z{Mb15Sh=m1wL8y*8TgZ%p5p5y56U{m?i+PB0qYn-d z+-O(R-EDabTPmvraigZz>+b>tW!=Sl2B$WePix3s_Df~$RJ+Py0^cfi|7Pi`$;^PR zVh06`0I_l84CBK2Ux4o)sTEz60+_@kCU3_HLae0@s4tqU^o79`Ia<>bZje9+&(X1} z679s1-@R*a>u_;){nYDekzgt0$a@h?0C|Ymz0-X$HV_NgxcvAhT)RGn*o{eI;2(tP zH#tKNOd8A-+smweH=+nE%~m=ICGbrq;HT)ntee1U%s53oYg6)u6=fWg{_qPz0^}>R0vVe_?Z?fniGusDeFez6vUF(aG zO%WtI8PgQzUn19?S`UTjj%(L_nDb54etboU=O#;zvX-fZ1et8B@s;eDfkEMbaMjY5eI3h-LHwG&jJViHvm`WNnj(L41v z=r1VRl&fly0p=iCH|g9wPqz`EwMdBA55yXmz2sj!3{Y=`lggG_=qVzGOu*D$T_`W- zpu^RhTE=WjaTn3V!lcsqkxezD-vzmR%jxu!znahT<@V(=Y7giAd{3cRyd}F14^c^Q z42tzHtVzN8q3MW8jHRP>s99H_K(`@9cxn-=$BGpi)kJMCn}hyT+gs}|?<7Dv#$>a+ z>|`E;mA(ZPsk7o}bt$vwjbvJHrGCn7%OBc&ZzKTey=qiC=lQ|H%sc^Ros*PY<@xLB zVDG+Krp0y2#q5nhBcBu7htjdUm3_3G3Z`ogOh1LW4{08KL+L&?MZ*mpKjO_RVSO1x z+PrkWC{GD>&YtsXSTDqUCUl|n{~18j_4?30S`Mu@fMGkw$(*2-sC#6qqTYI+xA}BA zJ*`wKAEAxGSCmSCD3RVXT4%Q2mbcLeMgCp_1%)k$Q4)n18_OQ?ZH2+!WK!mA)SLYl zT%_u>WLrppV%VN}&D?chAzlt#k`79cz`=q{j*hnPs~TXb!#tqC%H8qqkELh9IU8`1 z_A(+wr_*k-wDE2Zj2)vlKHnL%7S3a1d2CR>tEd4^*ee8k2Zu5*-sZvER@Y zDX_WocKpj|L_Pm7doD)A`_YHQmHk#IVP=4AQUT{`%elNySreZ-`J{%m=!F&|%dd+2 z75j4F+4|tq@5W^hA67@t4{1xUFAsYtL)p~wkU?6S1;W-G z+vce6>y3^Vwu?)nKQlzdCKI$}Qz}l?#%D6}&zCPCpU`A;oxo_ucvp}EzbP>aM7vpf za$uDLHIMr;FC9haiqtyzYfd4B3m}EfSBDn=$df#qn8gT!<$1x zLya|*V${NFbZxrY53&A${*hwA9@t3@9BAev@*0k$`d3g`0{8 zgd@96s%?3F?=&>HnqPNXh-tYJlmhT5$q1ag2$Hka z=I^Z<%CMg!&*30hTum~|xpZPZ?;lhPC9Q-`#(2LDOQR%0eyl@!?Ssk~=-`@mHk%9F z=_#!2{2R=GqWGP6?Ne`2ecz9cfs)7_LsdyOAdd$A{Ee7)h)oO2WwNuJNe+A&*oYRB z`O@aOu(tg&yUkfJf*VT!fVHh6*u_}cKgCD9Gi#JemY3v;nMUn4(rB6wzD}C)^D(b{ z0*>d#V%oHsFV{PRjMQsu)QOpuuHiaf&e5etKZQ+Yn*!gM{_Ss}7-!{|%z-B)BQpxj z+>nHyqe~f`gwksssOLP|8ma7fQgsI;i;@ZBwbp(-6IBfR`&NdKBJ%-N-zh=AEfE+i zJgAfx23m}CuYz0@84rFy>2C$%dyg-xL$rYKhm`8e-Z_tu+k-37Izvlbo5m(V%SZ0` zoiPZX4GVvCxhK+_Ds)l{D<-$s>@XOmP&R}6!Nz$6IoLk09u_IG4tLshMexI~1!z?&|6LCJWHoKHg8Yx5n z+?|~FsS}!5(3so8>l5LE*c}a@c&Yzh(Bf^XE9u~xp0uJ&&}Px?2QRx|oum^hZ|ilA z)w}sLk5eo2^_v(p^~I%Thz-{n_PZAwcasS1-3r1@Ubj{F`6TCH?2vcJQe6Pb@MJrJ z%ap*fyEEn1`4m`dGYhOBjQR~rZX_#cjQvR?gP@*!pyf?mFWObB8F~mpF9n&P#e{e5 zKok-Sw-G+hWX`8B-6?@M29TSLbGA^wN=s{jIV%{&bN_|=esckj$OCH4QgE&FcFU~a zsUi^3=Qj0G-fL6AGfBQv-bhe5a-XMbzA{)UdildIEwgDJ8<)jO+-BL^cRBtwD;IasA9Y(#+!`*z8;x|e${$`oVFfI~a$ zL&^~Pn3pD9i%j^!dne=>T`kv+*_(4hZysXbfbmgQ1Qz{-euKk5F_FuGXA3n++@x6| zK$j8&4#7@?{#}_?lkM4igBGxx^zcW1$lBNaJ@318E0?&ifb1IOvVWwN=ikUmB0U#j zaj+QU;;=f!`=@>(tY0pZ#go&n!b}$)ArVr4VH`NZ7~WY}e^T*oE8|xBq*RgRC!=-{ zI>xi>_}r&#`&-%Lr&0Y~0nF(=*nv@#xzz1t6G`@hxhCgJ`9Ie@gary7ZarxXz5L&P zn*dRKoHV2b!_5uGKs1%lTU9@#7BM6B3)1`ZhVmm7ZI0@huRbI=H(ZqLz_I8v7 zEw^Cmjf~0goConw;m$cF4f@_wAZ@A|Fs2 zonfdM7x}na^B*$0Gk9Fjs5Y)P)Y-hNn(Wr9_V&`ONUEZp6X{_jK+FJz{#iUb)DhB~ z%3@PA+pkT@jdfADm6J4v{Z z@nHQn;VNy2E=loJDt?HKxPm>MWY){U#=?eshz6)^R60IhW(|-j4ihN;M`QGS5G;r6l*m49H%)eY~20b+xI0K#ahn+LZv&5R7xX0}RXj>87U5Vq$wMaJ41yE&V47+7vvtYGE*y8w_5l$KL?SbZ_}Fm7?P19_0`47OtGmWjmZx}<*&2iLZ-WdeKUIZU%C?Cc)k{3rGj}{vED7}8% zHB9;zCT{;Q6?A|%Gpw3xB-o|#zN)w3S!lx8vi00e%9uXb*ZOT>cL=F z!mxUksfY>3cJ((dqd7!CGr$mby_V(m+!ULgx?pRvn#R47@yoKlL8>Tt$1(rItSK;T z4hg{8JD_P{fv4nXL6u)92TeX}^2^B4IB()Ig0-=<&JjfVWNbc8bH?T6%{^{}&jmGTm;)dV5cy;U+<7E~9dvJn(2Pcjw!YBaQBsTh5JT^7b&G^@_Y~;0nyLNj*}us7^^l_E`MXhP!8>As0(wc z427xoOM(|kt{x_K@*EpP1pFmkJ0reQC*y*<&ZFnX@I(bf7cp~bvBgO(uI~x0;uDO0 zdv9n3?knC-H8y)W69=__yO@fscDRZCF?-QW+zF#W3B$gRHI)yL87R&sr?A%^jR`ou z=9phEKdRBOi!6}9Uepd?L)-vyrmQV)A&i$3;EiqLn#0_m8 z0>}?+5h1`&9sJQj#0Q0tua%h@iuDY|G34Pe^o(Ky>G~g{fDE8F`zTjPP{r+<_W9GF zS%|I%io7!VjS>0T4f;;=A0c|@M>FUI8PfI!HxFJHi*iYJJu~+-h4kYX1%BN+<>RdEbZ7HOxGRRzpNW0A#{gyuY==&!Vn5D~jWcTqQ>3l(yNS84hV%Y`}hnplSgr z(q&!er?K#s@IMe;fs21ea`{YDZO7JJ^871HkS4{Y7g9Ao5?EkaEiBL`bhKF3+&bs1 zDsr;%q7UtnSPYKRpqq=L!d3CKC~=CAU0@$KG{S!eg2~={w>#_(r!+S=!{SMZlz)sp zsBJK^{<-r~vKgR#(1b%Uw?xaT@Cw`Q9=^YIn;}nLU82mU+L3c`b6n+?P0KmWHLDWG0P3 zm52q=wmP-1>Lm0O8)cI|gGHgHye*wj8HXfJE62mh(AF3PyF=QjP<*q0d%9@q^&UY6 zh>dGzKR(#}_;I05CaXhUGKNZn$2jz1x0k3q=Ve+|4gEN3?JK&Sg~wU z@sH=1gZ9KCov(4RXiQ6duG-oVxV*5n2o&Jj19CX11>#?N;4s}BFKEsPlNr^&9->#^ zq-v#fAg`!7c66As^(SU!s~5dBH*=y?1yzy@7DKxB%nJ0s#v;YXu*tvg2N`01CVJ6KM1w%n zg9xD;Ya-zZ1>}86?f4i27iQQL(A6alb{MVLG+H=jaleE7tQ0_QJxO`X=TuTr5C`^G zIrio&=dQ(xDAQXQ2gKUbfO6||)3*<&2nf4n=912$duv@Ad8yjX0ZamGiWl2wgaCd3=*9bydi2O8k|XU82LYIKaHq1m5Eu>! zY+HFHie_`ey??%W{sU+c=Fgx(UfA{6>pRB(`zWlA?x&0{4LKrQ>G$TaAc_N(XR*MSx>Yn z4UtU`9udYI{Xep{q{#H+8;F2)arS~lbTQ(}A+NQ!Kom3pyY4}+_^e;ThyYHc?hjJ# zSu3ri4=z!3LKhU=k2dcV4LDfxIky>^wvZm?-k>cKo5=6AMe?k5~n!YhS&hGpAj%_x!ZQC{)JB@8yjT<(0(#Cev zps{TmjT_B7&+mV|ALi4{HP_s8_E~4Iwf5P2lJ#(O(KE||V57~7T+-nxTf)RB*wu8u z-(yl&)EghwCvN-4jm{<=uePljj zOf%wev*G`3rJ_#Kg@32CVLlpaT4tu;yUM}scQXG>o~v!4@O8nDV+gU+f{RCwU12sR zwxaxtX!eS#rO~xWt&6i^ogY=AikkZfr#w9{H+MuTs3N@0iuz7hlePbaT)3mQO5hXc z%W-d)%l2(-6qgL7*jIJ$-(&CRJO`+q9yTK%RB=mxN`&0aer*JjB|w{Z>DeZCMS<#V z!If>nQ2Xitn`!yC#c$;g3MZc5v!yk{0?E?xYt`rk3M7Dn&%@9=f+!;eC6NOKD9;e- zToZwWVohku{}+_jjxA~TH}5gl%jOyj06G6XTXWjHYW~KXW%VxiZ@iY`I}Oz^HVf_| z@dZ=gk8u;?^M{-Ct+G7g=;CvU`c{;$4ll808sJ9gRgYKdbX-)HKF@LWl=~A-R7w}# z0+r%_b{-`CG>q(x6dh2F60g|r|2dZVgR1A$%+bHzl7sJji4Avy%M#6FENVNZy{REe zvR6$G>r_;mJM6F?N(qc^(EnEi>LF6c^M+7N$)uzNLy=iq{hwNv?+PzCaijL~6@1QQ z(bN0Hi!p17T)~&Bsz6g}c@Hi;pyc@m0W*598mX%@Yv1Gs++jk3J-vwHYU7&&wz0TD zrTd2P&;-j1a;gf~sl0~}1vD8B9I`}}JM!9|T>1)Ei-vXx7-!$TIyzKy^f>n=F3&HJ zPes=sYyMZnR4dY0IA;*ZimoKN%EswDsP!!h(+b)`^#&va^;@UbuOd`wKy5 z(OU&-5ZE@ehE810|8rGvKxeJ&JoN$YWr>}K0HrtQLZrUj^gp&DW3g%WF2!C525$%# zjpwLPLEQzm!%|a0ePAd!?_R6Io8IT(HnhU{x%!!qZ5RL~|HEz_HcdWIXyod^LesGQ zcN#l*-Aq?IB0ehtk+s?+`k%P_b^%9HJSkg0_{4AciB?Edm@!be5vSfeFTm`euL&G= z2)kU^NeYs&5K2{tNYx-439{D|h*vl$x)>*|pPZaFM@2CH$M1DyZ~5Sk{^7{UGpqw$NB0BU|u|AQ#H>cgn%{GnZXB zW%;T`G+2}MMM;us|HwgPFGrZAOB2L`ZG@K!HaYVsUtOS6&E!SRvcG*Nm{)Dqy}}gs zPXE(D+k=1ou+Bn3e<{W(kR<)5-Hfa5d|T0HdMRZVlL3XAXEyp2#=6K1b1^=Yss-Z& z5-eA4@CPi>g8gx0noxh3{aOF6l1bJim`)>hdN5lXA`6ws|+GaIt zn78_o@0ILhJu9eb0|nZUEqR_-w97*L{id9ZeAZCvSlq~?Cbos7%W#nX{iN;K{Wi04 zva>Cwdoy|MG8DztQSvg;i{~-WK?Q|n>yu_fR^}4Q#HwscpQ_tcl;MS_D%Y%jmtPA2#iM_1@%p>s%H*h=|h}EfE3@4EVl6 zAj1F@0%-k>m9U<;S~^Sb4YHk=U1XM!Vr6|CHeY`2DLPM$8sLG8f)S++vAUz`pwMU6 zT>fuC=0=^AKTV6tOvDoK+iW=JRtMQD$bQOfMA!cIuUBRb2rQ^IVgqV5; zA~f){%ffz)Ngr$@xSC3g-8DmaIm&x}2@1Dw6Vn-v(sI6k-KRYJ!c9I-p(eIHq5Ep8 z4?oQvOmNa*mDZNj%f{*Pd7+E`jW+n(A8a@s+;!~cfQCen7mdfqI8#!bc8Q7|@2{sL-G^ zn|Sl3Di!O^6s^Ha#08f-@>p@^7g}L4r!bYlIj3g&Xsp?Jd9|+jIuYw;>xv*hg|=J~ z#dv)6{ljHnOePW@w{Z>|Ac zz=xn;7f_KgxA-reb4@_kK>O6%-l5<-8(GNfW+(S7D82B!sw+zPC)FQzG@`FZ)fuxMHbAmq$CUu+FvO-Br#Ju$M2{ zs3g;He9mEoR=~OJ$_TykBPlwd0!H$I+tA)wGcR zUkl)wTYKvLWkF+m@7tJyYLH#0BCLVmc{xAii2xWr;4xqQXsuBgs#sioRy{%>C|vIh zBJaF5c^sAmXA{B0ItQtdAnsvq{DEAEH@uKGh~}Cuvo=ibZXDW+-ZQscYxh5;TTp_` z*CKOTBx||wu$Y{$eh(3YP2IEUl}z+X&>@4y@77k*fz6T{_q+dgO4D_5qU2VtZ3vKdVURV^V>N%PipC)(O0uzQ~Kly5wYY@gI~^%=X^1^{LLpZ65UxSa`Tv5fA%81&DB0zq^<7 zNJa=$5DU(IU*WRK+TaSx;c!bDu9y8?u5_3Vi+u?I0%X1 zr7y*>a~ty~Qb!{CYj6@PhB+nl(y#D1mImtvenyxvIx8^YwH%XmzWi{J=toX~0#y5R zUw1zi3F`D=(#zc8TUBmhlXEdf~;J zex9rO828%n?KjxV7=tMVXSqLE$Jvm*(Rb zgpu#`r@bK+Yv2}C2GfmilkYW2#DDZ&-}ZHrI`)sxqmQ<{PVNJR4oALQ`SU!<;=NGB z;z|)zpa_BZ06t7ji`ukEiq>R}vtJXaG#tf*%ACnAk@>9}#~vcSZj)(H$UGL+`B69& zpCM}TxZyqink?a2y?e|h?}KvO>cT+;Mf{y39i`HOR6rCxnE8C@@hMXt-0w| zg#Wch_bL$a)|_Q+-rC=KUvJ(|Y|a~bek&4O5)$C%B0t=3-%UIBt2VI_D6J0o1;rX1 zv?q*$44CV@S3M4%q!q(9kZjn&^;Zn3{zf7pM6aof&i=WsI^ruBA5BD>W7-p+h0PXm zvuFP7hKYi_CIemi9Xcn<3kn(aW`T{ER%lJQ`u56uD}9e4q3UTyFLRmeyB-fChT}P- z(g6a8t4e!z8|{$kh_;1v{_0-A3SY@Z|C*K0#7s_i=iVVs?U_GBh<=nK%euR)pVZjz zp3SyvB&PI0!|7l}|Vx2zQE)|b8g12eCrgdbsBK5jyH(tM}# zhY2))rx+T@z6*Q=JlF;P{biceb2oDD5C8MppHx|tym)C0F=C#=E_q?3HNODOQh7qa z(aKWr_vXCJ5_-h8Ekc;f7w5;3!t38e=%?TwZkNk^WE#JrM~Xgg-rmY2_*@8o%tATu z7QumP`Z|9mXXtRvDm$SKqig0C;lvd-s^#7WeI|OptY|t26E%ty-EgPxaoxlo<2E>W z;?THjEIJOvu;d6nHF>nV8U-=0xQIJHp1uyg-Ty-wq;u3Kx9YoFBrAquPRfp+EbAbV zhTc>bQy=%6`DTw=t2ZMk%*DpW#^>p0d81{q1iV|mcBsMz4p6AEL(<0r^JocvuP}doxSMox96Lqr~Rj&py`;X)HnPP3=tRG z!$?{)@^N3v$THhM zPui@g`Z3eF-x8egW8+CV^~ep}{!q@v*4$2eSo-b>B|k{|v|$A3uRvqX+I3xkvodrW z&u^cQ=U&$l;c9gQwNh2tLjnV^rCLe7S6kNs!*wF8=|**;t~#C{wGgH>=&pl>32_KW zL4C{|o|gL!mtAMo6CDM$^0g~X{0+TSqHCZvs1RzVF%g%Ej%XPZZ&ek495V*DR;df$ z^K5m`XtY6C5=N~iTz0x14y$2pU;5*ZN~)WzYN+)A@4kQcm7T?bt~u+UToUBbR2Axo z+@=oyeGzT{Xiu-?j1p5XNg{|;sGoF(6T2NOy4-|7AlStG!P;==@x7^r%|aMrK0q=3 z@t}ObRk0l9U#+*l)r>9%)#twLg`Q$q&SD&;PqE?!sfikYxA9~QLiaiGp0OVgK4-qmxE@DYW_XjV6YrLjwi&634zHGl!Tnd&b%>8^=izU! z9cR^HP)Y8*i=Wr*obQ^Rk{CZ8OFV`wXC2fLP_BkQ=U#c%So!yo+^%jr#kZdnEsN+( zEbTkYq6O4*_%5HTDp^+{p*K)7t<~l*<&?AvHD9Tzye&^}VDa8o4{ci-zw8h6?+Yc$ zv{b#hPyrVPPkYJ2&dj;cz|jsHt)lYx32e>HqVF-zCVsXA=U~f>w_b&grl)Gp#nNK6 zsFHaa6jWZ)d67Gz=*%qi$QLXsG&Q`xwH?>9nqngAKdl6YJP5$v(y+w5)i&|0u|5h+ z&9}R=a164$0YUW`c*{yBDzC_`|+y?Q=5Exp_Hzo2n-~@h~Fj~V$H$tR!M>FwYGPi&&;5g%?`3X#)3@`iA+%Wt)%+b zGML%y%&k_(!Naygq%>(rO#bT+L91zlaT@TUCv{-}G9UZHhzE+sa~4D)^u9NFfTra}YPr|KF-`hpA4l&VIzg-x$P8OkxFB4wRF zE2CR)R?ZhMg5RBTmcO*=4HRE$I{Eu(Zv3fg`EWG&cP?>l5_Y$5Nbn;96X3?Yn(yNUWZ#zbU;R8*LMA=B6@> znSXk5iWxQjIL|hgwV1hT%OB0U-;YitV9NPH{&_9}2@SPp=jE-$*q~}Y6it`P|hC~_28vMD|3=N?emFd?VY+Fb5C4>%(z zQ3p2Ab|3)9uPu83GL#E=628j!+db0pHIe57afgUF6aXD%@|YG@nT}BgsP*2}gpQE3oqweru3wOL7%u&7 z1A6=G{2m4iR4$nY-d+Z8VF-ID#V&BC++E#WMv+AgQZMKGU%Ti2_mO9~N29Qqip`FD z#=b%bKpew0KigZhZ4?vNF|)J$BGAUSLXsTqM=<@+rW&!5M2ZdQBIRok_$N&K+FiS+ zRt>=7aj~TaE=)jkm5kCYU;NX<5(O>v6G=(IWrai%XGD_v-BrvS|Wr zh!34Oe;;`if{rxvA8rK4_O^QyE0!G&zxf`%y~5HOoh~M;DE%Bs+6C`jq;ecI?S1HqVUyWDh7X)#0DmG?Jx~%R;9+l|Ludu>c+v{{Dz1Y%2JELhXNen(Ka8zP*h2U z&A%77ez&%U%NyYK30SF7_zk(dd~l8G$i$og8UQ$>KTB zfil8yU!(L|iP*a-H5=g{tpSJ9&BAI2pwNJXutIDF^uvSPp(Y@NI6jnQRb~J_yYXeUOMalg+$iHv&TMFncfkw2^c;lwu zz~|%%G;i{LMkZ>cCGX8GaIfe=JZfrp*Or65P%WP5Ebpq5G6!z)@iKsr9SOS0^(UZ^ zdBSv#_e4Sc^eh!GM!ou7Q{AOa-C#5+7ze9ua*7?09WSbUS)0lN^ue|(N`jl>dEHxTFiW|=FPXF%5?P>ps*wF zsI&N;Jam@ma#qh68v($O|GlP+5J${jM(xqV;OuW{uqP`Q;P$)W93Z3OX^=jFC(K&1 zR!HEs3vnj3cH>>D5#OC1K`&4(?(pmfs-EY8R zpZ~hRFgWopj7JaI<`rduc7e#5-(A}Q0>VZJfC2!2ru*%)f#6d@rCEzF(7$hckxCjm zV(bh7XsWq%LCsE?wnnxH(rGUqd8AuYYKl%pRg-Po894;(;T?M)3H`^T4T@#-B;1xY zmDl=lg$p-xeP0zy9xmbRBr)J zD8kO;(S|dwSB2UGrjLGY{|tgA|100(`kR(?wEg+$&7wqccoMX!;_s<12hQK0C2)}%=}Y^KXCaA9Mo|u<;Uc%GIw3^vYd#KlYFg^NzB99G z)%iR(w$V|l@VK{?M33$h?4J!B%F?j{v}7+ zy25*fi9m_1OBb-8N3vI+*{Tx+bPvZEnm>|;+OH&+Nby%X@T!Zz{Gn!B;xt20Rtk2^d;RZgOkz#KhDS% zFY9}`%`%ap8F?{bt~Y9$aga5*{TTJ#{L$0D^CB=*7uawC!D|PXwk9+1RB-)yfH52! zVn6ybbV>=BgHbY(x731j)bCxrG%MP=R;Y0?rx9}GvkOG>=$N7>5vUc!5(^ItXq&Wd zmAJV!I}xM@-bd)}wpzKT+;JV3bSbqG#qY)RrOoASe^e&wVJK!??UdF-hlQt?$FK4X zb(>kYERj6RCfe<``(2yH!YtAZ#WB=LOb!wU&)bx{aVJI|X26O;@69h=9-_5-CyCKk z6sQ^`uMse*mdF`HljZqFn#lCxXEdz8{IQqYtiRlH@C`On)}PhKbn#d^cRNY+_L3H= z=FWSl>x@A%mm!|=zZaULF|WgcwzmVZ*Wa*Wi|J);q0VN%9a)NBR24RGsEp6$V;WQ>f8BEBDCAVkb~@U{1Hk&b_+bE#FQHcpEq;Uzci zFoEiH`|jg(Ewu<$DoIM7=jp=&(l3;31KNu1pyfO{k|#n2YzE%kgAX;%Yf@~BtzhGF zUQv;BuI<0Q@Exr#60km|4NAy_Gv$SjGl3D&5q|Rn(L%j_EZ6GRU(7QU%p89iQCg%1 zf3k=ZD3d1-Z#5(44>E9sG&k7-xlME@_-gm8*Gx&qF-Jcv@e`yCL71i@e=(BLy$z!5Y7F&f!Qx5jQ+(Y#Ac}RE>J*IseGH|CGIiPG6xg@!IO?wpl=vUrVB;fNzsH&m>{*bQ$2EP$` z-&oMNiRgOUU}=oxFKh1UpI;1E10QpLUTb&j#{Bppf(^xhyP33E!ccIr1edXBp_Uh)nk&RH zd6|-(3~!G^k_ciL2iS9=n?@suYO>uZ9XNO`fa?y^_R1S#S)iF`-4>~BWYbNU98=}D z?EXEQSf6cQnZaxgptAN#p9MHe> zPp5dBK62~^g59&LZC8=I0GU>r$bA?g5>#7@7MmHm;#axKO%}eva@ESwUwwuChUKZm zCNi{%f_2L{&rzw}F^{c_#A{fn&l7r-sY$$8j`83_U=936RutvG%T|MiVEgz?Ighmy z&G@WSNKffkNeEbkU$OgBj(07rtADMObk~p-mE03LUlKPUN~Wt;ZZZv6W_w6l%(vT8 zWhL4u@ z=I|jwYBV7bt%xhg?ZHywXF3!ira1mBNQ1M_C9TYc(e_pvBXYu;Jp}ne%lt(R(r-GB zV1m+sMDgJMq@y!sh!b{MN_g2!)v__~SculC$IVn>$#3wO+u!QU*c}Ml*@{ymW-XDcL`n*xgEoreb$QE^7x*Q zDgQ;s*~TT*d7RrC7vAK%ttTu1Ej`FH)T&Kh7L88R1Px@Q=8VPt81dDY%exf`JS-&| z`3+aTE*|I_no8D8|$0$#*T)4Cp-I_<<1zu7w#>`BDj@=%aDwLgQ z$4^75XY9wMe(TWGpDCDKfD;w{Z;(&%-4d((^~ax2^blv^<}#e065GPf5ad>EW-W?k zmZE+X%B(~`!^J6`=nmUf_Xm5#@|(g#X6xTggx8g~iHn-rRAJs4)zbbPt1VqKNJt-P%QPM{^C)G9a3C3+_#-m=ujhy|rY*@Doydvgthng$M4Ab=&av-%X4ompXK z6E%og`q0fne|Vnt`v&&kBHj-8o&=iNCyg>JU?tlj>gSqq+cq43L)+*WzzKOCg*)?%R?y z0;m6c?yFmGqR{=5K!*2i`}*!Yvj^aa_$17e^C@Um6>(2ii3Kubj@YC$=;dbM6OMmV zQZ=1M@Uz&Bt}0Wu$4$wi1wh8c-eUJQuzktj`g10N9JMIN16cXDHka}hY`rXX>Y&~a z!hiRiOudeQUdAJidA)FMQ?}@6UVT2uJ6>Uo zGeFkmt}yy{7E7I$*Md_7ri*Wl>jHUqqF^e1H~9-grOMuXe%`x4Q#Wf~16SK`lfwUB z-N?&OnHk{v)&LA?O$#HN}Tkri1-{kBJ1(gqhy^_ht{&5=NIAY0qj(W2$HeBHC z%va7kkw9vBzfIY|^0H;-)}L>E>ZUZ9aS5cpUM+o-NhIA@-5W`|Xmi3-`$_um%NQEV z&IkZvyA#rZ%hNnO=9UW9sLKMS=Rk}Hh9{QDO!-FoB0-ZoU+yePb%>FZ^ z>S$cCU_8iiswo#FWV4!)%Nl4s-yEND86)^Dh*&ndO1LL{2-jobNBlwl-GVJT%5MlK z_ChP$cLi|$$SQp#*~cVh}@X?o$%WG z4xO>yXFg@np=mGd<96jvFM3juGTK593~H#WVPjJ949dpfaik4iI|~_PKV{lK)9UNq zm|PY7uGg8e6@$VALeU#h2H_SUlKt}6W!3$1gG4a65)17O_glaiWlB|^lMdOO#>)nUGJ zuKQ0fsMCZd>-zUs1JL!XuPZnQgf`xuv6^N4iKLUH?4GlOmN{2*GdHh=8!wxhbHaq7 zdVMY`pp=%-+xYo5PCeI{N&Jn*L#PEDJx2NaeC*s6tL1^XRfaSg!(;=n?79D^73GU; ztE1eVvm(B5kLe3*{!6*wOD@;Hy}0r*%I%By?Z()}4nf$U=aG)s|HSR1WS7kJ9G69H zm@Y!QFbJ~UA73IjU8fS|vRxOq!dO9qZ{gb}o?lk_i?k)wtt91xnvcA)Ajm8pmDkr9 zI@UjH*?d{XtZyIE<=UMne&gBY%5$kt{HnVu2fq zbg=sHf=ZNaD=zYWjgre%%gDwh7V4^JotcXK)}ZSb&` ze*{&Q7w%tqVU0{y=RDNliL5m|{%xwhYo+DMz?FGzgBd~op(qII4E)Vv*R>|Ark5U$ z{foxHCAW?k+SA7gK(E$s?NyPL4NEY%Iq!)ZD#r=Ek8=bon%saj1fht@)LLc?hS`_(<#zJmJ%V6X-g0fTPd80cu~a&0TaZZg^#yx$H; zvzpWIv-xM;d9MH2CSS`UXTSc0b6p8ZKWn~oUdiM+Uvug(Ysg6-HYq4@-OdQBepZ$x zsI6@2vX+ZNtVa>!!+?QOLT(4VIFKkLnB*43#!x31_@NVap$Vp-Lq1_59x;vA+PIL2 zA7HtYr0`K`z0a(RW`8E};X-i9bnsK*?5x(4?ynzD$X66Kn~@7Xi%suljem&>wb#`X z67~dXnjAWl4`Xi=+7KqwjlZW z>1-fVNi9u&7qTYq?GO5xVx0KLzwEIT)24FLO`T;HE{!wUcPHM{()@ZaFWQ^4M(SxD z9EIqzArwDY&IuuUr-OMD@F+D61z~KUy1T`DtL3y-m89U&CztaxEN$p~b0#xO`4Iv@ z??d$hZfC}c^j@AS-T)LD2G2M2l9q{)cAv-~c+- zqJ(=pA*rZjokCg?R-xweO1{%#4DcY-sOT()`em$}W*0B-0S>$i4<|OouSD8bxU$M$ zlGT(sgxD90)&|ya%^;_2>KGn~OR_9&&8vSC1%z32%E=@=Jk*RJZ(N!Ld5&OoR5b6p zjRtT-SOX03v&d4I;bI3sNnAD|%(E}1LIcZ#85sfW0GoNU{o@*jl1rFtOjbNTUAK?h z-}WrFW#q`xX!x#L($1T5C;z$4e*NHQ4@feDyUXrcB=7f!#ZWOdZ}%CrNP|+b*Lf6?uv=xC7TsOR3#}J|4qK2~)&-2K^%orWl;7dyv4Rz68dT zGN*j*^S7>+vj=NB7`H9SJ^^CgXD`i>?`HxHT`##K*|x9%`dwy8G41B!B9G2-PZo<_ z;DB=uB7mHJs`NCiS`fT8$KyL)mrDM5gz=%S_FuReww>t==iB||%ZY9)x8Xv!9<-?o zFPA@R06krrYW+4Ia3up520QaRgK=!n=4e6Z%H#3T-P+NpFiCoCi99xPN+I!gA&XpB?-oeWK1 z`-nl1qg02kN}0#fCZ!$Z5MZ;l`0D_S>%CWCI{^%_?+AcRqrs!U5Ez9W*g zZ>B+#Z39eLQrXajKLq$#R}H3SJsbX)$DY>vH-6&X<;PmA|jBj?F*9 zep6-(3=Dxy=O!x}{pwR;fO=y~vBl^cGJM3BN^3%s3@wPQO~jKXM1(07T_QPDH0bh_ zayQ3}V;zqSziWDbL9NdZzP;+7x2f@>X2ZMzS}Cm@R&r!@J545a@Zmqst76%7=K;`N zt^x_KbMKx`gH4v#0|hlrZ;V4yAwoJp|0%>ou+snlo2LbGR_Z$3$q5AYepNoAjY)w7 zpsDDRr~3k2hD?siSOY2qUmZ+MU50OQLg;~EAPd2iFGTLyDaLM>(`F0ss3q9_g2RoB zjGTBBzAm!__?+z>KmE|@e*6dB3v0>>H7kXUWK9SV>X``G_+~#o&^G&lcccpwe4X`7Hg!J?}Id_TA1Z- zg9~Rg0J0dqNgQ|n0N?m+gI?yD0r#4)y_)kD=q@}26*RP&(wL_+xnvEQaHu|1=-?bU z&$*^BXzpr6QdAClX`M8tMAW0=d%pQycaH8w*;i}1=eJN*=a~ZS7LtceS6gF6|5q;< znzn8KS>SG-JEM? z;Z`gS8P(UwGeLTh%=rz`4Y&Ac$+xd#r zZ8(`CWU2MdFtzM-tbAS2i4o9nqh*KeqiIoaCaZ`-O~!k%h%7W*w9?b?0>+AEd@Xtq z5o$n(NIdlaEl;Uz8P@?fk?)b5=09hMkYD5kcLj}n=Z_yJSPRQ!-yWM!QjphkrCHG+ zlDFfH&M?maJdA|9WKlvnq}|IJTLBPI+}{ zH$4;<_rY5NSs)(l2H@Y5ix~0^qwbWAXF3Ne+q@$}20;{qsU;g07LE9=$p!Z|Q_h{? zBSG}g-zA&22>~;O;b>983P>@SkP-%%NzwKf7VBQ^<GI(KV@K<>N}1COn|wxy@!tQ6(QXtlj%pcy&o+^%69f z(d1JDooj#Zyx-^D;9H^i>-7!0)&T3h)AWm|%G@JdLopT@pPZ6JFyG}C@I_4n4r|YT zYLg8DAwbfgJb2{J3{lzb{TUQ!l|JGbD^vn3f9(r9bvL$}4*ho5#0}aK?%@S%9lzNj z;G?f;YDi?KrSi}v7ueWN!n>Pni=p~+>@%HS>V)-1A?x9hu^__8F@N1)x+G0n^;m%k z`!XL`&lr6+23t8213wYHawo64!H3DmXy4^pi~mF-gDfVJ3ZyHhB2}mqrXCH1ob7+( zuy7$$e|?_-V!&ZGKpRx4Ry16b^={}z48e_D4dY%mUWVe@@nAdpqhV?b93Ybm-1>MI zOJ^os{-4{ViP?Pg#sR&V&?~z(UVS0v!@CNeBWKzfy=?;D`MX@yzW?e>dUR08`%-^K zF2dK;*O;NgMf3OgWhr768M6)urBZqjn`yXJT4IzdCYsVq8c4_W|B2J7OjE}V%F<(y z(8|G1&&Jlb)>OkKqEOfmuL?LYWg*5LN8R>)laSuwf2~`>`NIEs!B&M=kQ$X+I}(mX zHX_QibFf`}`ZoOe%lJ0)hb4Z_Rb>k86-tAWr%@YSd9%H1&5`8Vm2C zQ#9{Cr^VjJBQ&qgkSFvsQ8>!U6$~S8`|poNA6!5=OlN_6exdK)syl48Vpd z#ubu<1%WIkC_+N~Sj0a$B--S}6OXTrGfB^ZU7{F>18v&Ikk!MqE?Fo5dxl_$R!B1F z3BACnp0{9?Hn31B$(5}&`)6*xGCFRUzC$yovGKEeVH1yK)z<~CK~dvxsc2p;+krUp zx1@;icn}njtKaAR8AD`M%O>v{c`BFaYLwYW)#@U?$*n{bf0jSPKt`k$$IuvqH%|;H z{PSw^?Qa;Jh7F=U_r`sNZ8No2GqbS=Zc(8M&=QC6%{tVsNrIaPNjEA>os-Q_M`@fZ zvn@mRA^6}uh1iA#XAs}=ie8>RdY3#4JbGvh6E4gq&IT$_I=}8|{2Ok7s ziq(&(=y&qy?bP?TAQLo?Zd_fJGY&%Hl*~nv|%<@v)y8}W()%ErDDQXBc1dq#^ znLewx?%`@uf)Zoiv@yl{zt_XBSN`WN2VL#V>k>XoRu0A)L-a9fM|7B z9&*m)1m8y5q!fMxCgU3v?>PBnFR4-pAekuuz%0N!#BPW2k2ewnyrGp}mWw{Kv-#es z)u&4(Qw7kF zUFgN?uo`S}?&<+;9jxkbB`qwHL2U$#&ktG9`ox5eBEx?uZn`0j60C(v$ohwRZ&dy` zp>q?Fc!LK9PPkbf%ou|%2%B${+(}0}y!U&iIrnXPxrOMsgzhtekBu7Q^JDZ_VN>78 zYxc6b&88(G?*l_s=ck&c69%uAu@`K&MOGWMsj)GJlf+g$8m4Bb=gYHqMjk|%r?&DE zGX3QPq`HIJ0P%Ka(5Y%&CV20*VZoR{59>pmC-&Rmenu%M#DFqo3W+$nL;@@UK2ovV zl+&n6Gt(I~AMnPU9s+IL)>Hf?W#h$|fgbR(zD4J&?`?_|bN8q+67tu7lr6Ow>MT(G z!kZ`2nEt_WEw%7-7??aNL;-Hs){p-KVC9Fet_K+GOnh--?0{?|`Ye@ILhYRg?0~!& zIi&Z}Oas;m&=`tg)5sO6XaxNV+dVinypkP~HKp;QA`3b3F@lJX83wP^yYMLrvI@cy zQmYHeJp%@}lpHU{z`sXINO+iujRP23rSM7t(-3qjkhhVYFWO{l5SW)UzniXIrDb&oa|rSa9>} zGVN&sOqfVQ#sNU71ZMu>N8^~lG~5ZM9XljhWQbznPU`A-qc{4j;(3t3sbXJlB&m3@ z)mqN!J&1&>q8*zTL_7kf(kIJ+5x9U>VjG13{Ucd-nF3pl4{P8PHVgc2DqWbK44XT2 z=)fm<+U=do2pkfojNy#H?wmzR{nO#lPjI2LXGUT`=x+hO!ZfvtCTfpS5@okM1#n4G zbs?LyS_?~uzcVTVa=8Fk1q4K;%~5AE*=>Yg#Jb%Qp^~*7a$66XX|6Fe2W5AYDz*l^H@wumNIoq(N!# zx#u8`Lsl89xHMC--Q8`G>!WRy*3B?Z~ zJ%5*y=Jb((gGD=`{m`pZGjR7k8xSO0U_MK%`%vlft$l^}u~+HE4MuKfVg^oM(`)OG z&QlayNkBlSV>c*y?)hE_(15mJarzG7AUmLfZ_W{j>p}NI;4NDCsAfs%AU_!Im9f|X zCkgWuJuB1*27Nvs`zn@=dJzbh{LuVv&t4i53DVk0|J>G2ARY$=n}q7HBMancjfc-e z63cpp5M}>Zz%TUnU6iOUa0>i^6K-$20HRBZzlIaS!oGyxd^A%Z)lYm8f!c)v5ZdlH zcXYCz3@5rLZy+Ee^7;hXtM!$91??`@Jt9o9D<*G7$bDIB(?uQM5O>8yV3~c@@-Nko zmJeH#1YRVtwZpViaz9*N+$JPhz>B->+>LufPvx);$N*&*$(WG;0*k(ly+ON1h}~q+ zFnNNE+Au9e5c%g2APrkG*SXN&UvJ+`YA9kx^lrx`@mawG)vm{xd#6 zeN7vJ{ei|CzDcK$mXu@M?dQVRCVhBg(4WE0RRQxnAGcy(wtX2{yNF1m&2=@~QHC1` zbNbyk3ae`)QlY(xyVKXrRp)RA3;=!WxS40wedN>gOYQ2ZPP^o|607tRu7}H+TmBJz z&Px1)6+mvdKO0|G7ZHKwJuK>GcNq8rIcYrRqaRx_CEL$sP%z#T=L*I;njAiJ@s#=; zhDN@#O-!OuY|RYcO6C=m)i{GbS5dy1fn*^v7i&D*P`t|_Tenc};n2~@o61NYm&qaQ zw`>#6k>c-W2?9Yw>dg<2hq-Bwiu^IB6YdE`eA>~n z^EUl3f6C~_QhxrVi3{O@P=qe=a`!*NCvUAuOBSh|-=_vK)cq+I;bYlJ^nJCpz7r(N z!!kfL2redw^sLx!tHC*K_4cZ2heUj#z;^Mifrh%Lm=E^WCiR5S|42iEWGj5FFrwcF zh(Jl^rWcNDJ7{>(l@(71Ke%?pTLWQU;rYusOUiOqoo+)(pr@+tdQeL3{siB-tTiM4 znu!sYcXD@s$|qMlRAm@mBuFdqUQ31%02e^1(=0MwZ>=82bRNj4{zxSLJaG9#3gv_8 z$K23`uf=>bx5!?JGWjBt?Ym0sq}Ub`%e?-Z^m8@ZA>&O`AMtK)jeif5hOSfa~cs10HDVd8UHu2`G$C zi3X#ig~Qe9Y{n~TWIgfEpjy&f$L?ai%CJ&8?8SR*3d-fiMznC1@64*W1@MM1S2l`6-4n9tcCe=ZoW(2 z+J43)}#2;UOab<7+zocTQMl=$+T!kkV~Y>TE?9_`WZ7w=%OPQ zh08@Qd4OlyF+}KU4S9uwK^>i@D=_)28{ajfR&H}A^b50N2(W`ahxh5tq9e3N2e!7no9XP+m}x)~vMtH6UA}&HlNRm%_W3n*7hM=if%cO> zwAtU5-+OE*3dH-l>8Z25N}uwC?wC);$b5M zF6A*zM0k1#CPE>%NDK|o_RfI;%mu)@{;{VA^K4vUF2fr<%yF|({;RX7w6x;0TDMIo zAyyCM!|8u~N{aaCw}MNXeFs4Rnqd5kmy%x4jeQT!FAV(!eo+bscKo~fvcsH@SxcA9 zN1C;#(F3L=oC_QdC8~wT0kSBRN;gA)KjmaMFP(j7%w*$zD^h%CEo&TLj}qnmSRzsF zk6L=Pl1XsQN!v3`Xs1NH84xzin)O+7wzKzJVaE=rPL}E=H!GHlXUO?(&;2bmL{kwQ z)d};H^jY!N-i~#!#qHf9!g&t>L|_cnGxIQ|HWaGOt+#<;PH@Y9#j-8Y^Uy}eWav*4 z`D$@G#zA*{WN^|b^ zpHU?wFv-w%N2n?jSRNP5pF+*EX<{PJDLuktIorjo{Wnl-jnx5NhCW8Ve4}2 zEsSJgeqd?8tCnkCvWMtmv|A%-sikeQZ5&0a2!a# z_A>`tje7<%Cc@qyWwDlg8P&GV;d;%bC*|}wi3=F|YYa;mNB9z+x5q5xGnaHHtkiJ^ z0K=-J6}K|1envk$Pl)+Vk`^~><#xx<$BoW^5+CF7E;Lg~CR10BC4BtCXac(aR=8ol zF&=^gkm^^Tt+9x5yYIuo+ecpyCtI$ChhlqF zIt7#cE757f=s^`R7Yqq~&b>w^KFQ~AtryoR>?Nag%<>vC=QZyepkBSNir*uu;ceX`MRgJcYgLl|4AY+YOyX6QBmH}5 z;crmBkwwfmQ(X1YK&W<&AkHd7xky6*vBQmdu#Vc0Bx-oxcaT|B{u z#HPC2fwI}sp*A~(m-1;MwWH~vVZ`fc3$>RhlRzXEBD=EVfxYwLIYkL!76-Z?JeHk| zVsYF(e2nU4&1Sh}_boNq+#$C)+D!W?Z{}wsTfgbYUf;%Cv$Wy|+QQH=yP|EXsL9E{ z>(CT_Dfz6EWMIp{JfkjI=3A4?HjgEdDA!QaH$UUtHMHhBafMxJ zMd+sSr5Uxq`gBiL!b+H_)67H=YO^0-Gy}9@oGbU4wbTj%*d8o&jb5zYFcW6F5CM<>iWJ(xl85$71o-aiiv&(Y7`4|>R ztX*IZJ2Ec9dwJ^Dpq49^ZR9W)=1!3OCt>`(6>AK#n;>Z-sV*UlY!)qnv@w6Lp_t?Z zP&_tBRSb(>jHRcAu~tG}$9ra>0(ENqdBI3C-h>DQ@SvbFS;$R$n9H1G=MV}}GJmdq z!s61`R+~AijpF)E%x~THgqGNVsZLUO#^bB9ANS^N?o+O6y>?tNhRW3~^mtYkVd^?L zc`TZO#0RN5&&~=-9v_qw)W6=aa}5dmnwYqr;mxU=FX}BHKi(NeFc{tZ3T^w?UMBSV ziiYJR9;I@r+4t-Bg-}5&pUgCV9A?ocS)6aofj=I(DJR}rIjp7O?e+SzJ1cbH;Y)7Y z(6R=V$A$_8iwQRK^4z_qm_S{b zsk$&>GFJXPcT^~xIhnv~PLy!>%D6>Ioi%db!X_DFz%nTEw3SChuTHXwdgN zPk=kqa=MEDKDgPKPCjnuA&HWxSDyFVaB-m99RPy7&xC6E++-^*#P0eqQvI60D#57I z;FHI~{QkgfCSl^vNrk{mjjm%Ifxx3vY-8k#b7=QOv;Na{#`m?RoF5CwzeX5%+BpBy zVk8tffy!d75D1)R{LW8*Q>~2VT@C3;&>SihM%6Q&knbdbpCU1`4Wp=QMzA z!`ptJOq-a1QupaQ$;MiGP2Y>T!3!VW2vXhrWT}C=UJuY)kfOZeo3}InQ)qYwb>KQi zs8;ALQAgmogbIZK?WJV;VKnmoYOZK z0K=b^cY0}Q2&jc0q~8V4aP(nAd0dT}dgIM}nJ+i*eKEYg(4v8f)OmMNw(#BQHlh6O z_gZgA7#itqC_?473Lv zm;)W_HQ~vH1|Sc%{$H+Mvf(SoU-~{AY*C%juAbh8>|^eahGukqb+bp0L*{{Pg3tVJ@{`R>HMCk4yy0jFN;0)o z9dBfst>NCB#JA%D5JKHB|~Sz->`;}N9bo0hY4J$3rz10`x2h0@K9W1A+{8~a8?X`{hloee#SF59o`u;5x#Um*#C8*rp zWGwDIP#s8f()RX6HqrpPFbxY*-SpRKz6ESM+NUF)o=2w2mko!H6V^l}A5pOduvXVp z(}bG}4nC!BGAx4r$+YQ_Hz`x zWK{BD0Vv|m$mVp^y~yJb9Ul3v%dv0jwo(jL6uPJ@$6MPVBO3$Npiaw74W*>YLN*iF zgR8ln){fL?fdBAzl;)^=xh0jr~Ib;rCm?gpj!@;bSgXj z>u!P~A$&k{tJr^B-S?0gfHmWWVue?6Rqz=8xTmuOf@`GqZl(?){8>0Lqa|$8_&UVY z?m4^ewy^C^(w}1N_;(VzA*Y!50$gL_z6`B`8!jAmT&Bfif;(r5RGT-&C7>Um!`#v=j~BbcdKn%b41o|QwA%b z!z96*%-{KMrIh69>l)1AL1dISaz|Dmaq1=|uf8+A@k+#UJvDC}#RxJ!{8vLWs-V9e ztgLdPh)|UYqRddo3fQQaVHHXvy8dl9?R<{Bgu}FBZY~zN^dbkaEo`Sf9M!WTFYS`Y z5A8AI!54Sxb)z+tI~tjIti#P>(@22m^o|c#_)a}}9138FJjm2v8!3m7neFS|?!5aQaK!z{-vcd)}wW!K1Ud`Pl7IE!R4Je|hV4@dde~gZ5^OI({4xbL+%)^-3 zXGMslq!PSb(j9bUvSNg&cD6GS{zw%W^{+2Ep<&8q(M38J`(MZ^ym*i76fMx8uHV6% zui?m=c9}$@_kDw$hO!0w9bL~huDrN3-$ILJzZAmOc(1$;nQ0uK2Qw>=_iu+QcPXA> z?r>Km_O_!$WZkjYcyiK`6{*wb-JS}u!#_mrez$6a=xJ2mVer9si9xxEeU=ZFXN3W$ z!kg?Dzc=ajl$zM86xK5 zAMbNALRJR+DzN@4Y?oG2ZIAvk3e#`q+l}{BmP{Q00bEf8*P=;uk>RyxUWXVwx>o)$6!?d z2giVw>vxXa2($b=C|Vis9$GoCYAyJ$-VcXKUl^<#nt!q0yJqPjh*x;gTYx?+cH17z z`5DeC5W(ki{I2w6Xv8nYQVk;CczrY1Oy1zM&Uc00di;@L4k5=!E9IzTqhw0>k{@0RAvOD&?Zu!T0 z_LJ3n{>1mr3GLFVWp9(QgI<<}Hs@!m@wm2yP~a7*QC|N(fo}l_z4QR@mpqv-vqNC} z;k#(ZzUKOQN4c#p_jxi~8bm&;JVX<~S03Rv9&kIf1Be&OJrNd&yw>_n@J|J|2{e38 zD1k8qmWoO-G2>5Z{1Bx)x3u`(CoSYzf7~$9OF!<BM%-;*- z9Nx&DUsy?uHsK-dpTZg0Z48H0Fb6;$@jJY*IEm(BN_5uNVb)vuJ*T38b6e%N@`0lS zg9Vm|y{BV&m)WCs``HuujS#V=v^tB==ah}SFrD?+4)?3AL)xx%x)ZhVT;kFp;joan zW)XACV|Gy9^dr%VtNaMhi4btZo%gm8*a<(*W*ys@rAQPPGb|WgEFrRbgylaA1^p@j z85&e_7_CgennDrk3i3!jo65$Bsp0ljRY#XWw?I_M?{zf)>7Vm}3+1K_F+tx60a5Y_ zjd#CYrGJ&}T=n&m8a(vRdu~Y4RcTqY8;v(E5Q)-R@+jQg)TKMcF?y);^6NWX)AvGaKfWJ~urSW-?0YjZI z)QZrd4#gbgIIXjVde@9;Y`tisfnH-kv#rEVG(wSkD00PZ5aVHRu^6|fv9DKVmqx~d zD_%_GLFS66WNg_V7cJ3O94;A?6WEJXP)6BfE)?iye94A$m zkNFdlfn~{mpQTR`LwjxZ>AIbYhWEd6A-O(9)fvpgwqlkL2gnjJ*j%YPC|H*5Cq{=!U*mq{RlDcTIPtale@ih`Ub{QMMIUjh;UbBH= zq90}I*~1=xn3k!_W|A^@wCTh2z00i*AA^Q)>ddZ}EbX;T73Qy@Rpl)k(yZzB?WibE z|M3oINPl@koa1?*$!sKOwn%NMj46F{(m`*rVPy!-x2UwAwZOs)Zcgo%UeI~c`?&4Y%XOyyzV2J z0m^R_D!>NSN~LVw;7XmiZL9L&rvf$#K+T8Maf_s&=3+!jM&@aF6%nsbzn={ts(R4XS5y{nY1$cb!uJW+Fljb$Tic{%7KUA7!gdam=!DU)QU&v&lEWUwndz8(u` zNom!?hsz|N({%7Z&P;$sNkc+U*tL5BbEH1ea6I6>O0QW5QK&;2F{*S=QoVJ0p#k|92_ zhwP2lvQ_Lit`46;hEe(RaX{`&O405Vb4G1#AEDRSny%2H@=-BI()PS`snG0rb7xQQ z1myPwm7#9d7{ulnqb&Z3&pWO!644j|^?OU+%=f+APOH6#Y-A_Jt((mpqq+AEM&A)| zMp`nZ?>J|CZmx32{=o(Z$cxG5%1>83ryfETOS`eVaUb%#K>x~ELu|i=rF$;S4iw?1 zDL}!}r)_dfkRw%I?Rix}HRZpMCZ6G0Xi4wtCg;oofD*r`Bxn`di2NR(HLi^hUUC%L zORTS_{_>?+pB2A5CYYQGfz$U7`y=ZHTXS#BSC-|f5E}JhI>}N<(JCvt^Wi5EeF7)D z$J$fwN8FmH?+3K_Lqi5mJ-ujOcZDH7rcb-}yls1xB^Nr;XqQojws1Rj0+A?tE zCfxX1R4?WMaaW8ZH2xzPwrhKby-otGzymN7d61E3^k8Dxa@%F%suBy0`S5Lw!_9J} z^F5tSr(&X92;;V9O@M| z4NIH+{7QnX$Uf_LQQdt5_f0QxChQPXS^dz6Kj;%>ZBvbf#7Y#jxIBc4&$o~{11CTEp0N_b-nE> za|IXyAhGORWF3~1R?4NOKsx*RZf|Q8`Q>EJ8i9StW|Gn97i@bvW~0OW#_MWL{4 zOl!HOaP6N0bz7Wvey23AFBRM}MoOEY9a!;~rb+xLoPdJVuxj;&e{toXo71t$ zkuw41jxEK1v{0^a23o)5_nL}!&l&lbwDod-gVzE?J6x5^{V!)V=voiYwy!QFjp1PI zVAgMD8dx6Mn5huaC+hNx6(*5s_hdWzIJGA%Ek71XLNMvS90^o0j{@AnE1z-t34<_E zT!S#FuAp8rgD{aHKQ3mrPVkJXybVPJ_#2?TY@yt|Y*9gRN4UrEOg{uQG)^BVk1W6oC}pIw>=I@^rh8*AW6; ziW?szR20d>77Vp{c-ykpnzdgGow)A55#F+Wco{qWn!6vWS*AV!`@(0omLTWlH5;l0 z9fnn;HESr=x& z-BaYncm9XZ@0*Z<^S?Xqf~8O{FQ(B`_pwt5?dA*ei1`x7@HaItWOtKFNC&+FGosT( zJ#d00_C|k8nzaovIcz`I%dMXiOMe?%r)1F5DJA&Q;A!L2YsKn)){jUL+MO5dM<1>a zP?3nT;n&8(D?ie%*}pkR?HPHUl_aGi=Z}bo$7f<(WYw6Jk1VXeybz*&j}1MeTrL62P}IM}*dNkIV3+dMg^xK!>893QQct;Q~=g=7JfF4Pb#3!kQJ2 zK6ASAUeKU|aqK#`#+aB2A%-eB%^k-$T;VOg*(~8dmZvAV!ZQiYB_vmye2qCvzUbcE z=f?j;i+VBKkudSkwRRC{e$smSm~cEn?O^j_@t9L4QdSm4GVPN5yiI}# zVjxBevz)*@Og-EF>s2HJ@F(}8vLa7x5aL<6Pm8XKFz-9{W5v}fVC3q=Z*p3MfB(-{ zEYHVjM7s&F86Zq=cWO zei`*}CH|RYRy!lMF+-;43yhL^WsZ1NT6bUt(AhN6;bC|I?u2X?&RL0Q9k06)G~dTv zmjqRgOm{~q6>{3u#P@#xkXlT@(T}P2c8&;JjBZcO7vg8?jFzplPL*N zSKpyi_`JuKX=pa&31{%BU&pU263NX>(>miYQ0HRBrNA|%h`aHQ*UXb7Aitx}@JDzQ z%B_P*kdR|&HY>meredwp89I^S$u<@#Uh#7gvR{T|Yp-vF}1{Ppthxl1T^zPq5-2MK= z7`&u-has$PY>u9$-f@p#{(j-M`XY)s=h2asKRqD6nnv~`-8-`csK61ZH0yTPh$Dr* zmz|fW<7+IZ2lI9=HC=!=`xZ0&GMBBwPpws4g=eS7LOvUpoeqJj8jrQz zM%FyocN88f8>zd$C}4}lD`UhZ1n`3;@VBY6V?~eK4#vd6UT}OiA>xh*9=3z&DAnA< zuV6442mtxoz%Drh%t!Imux-D3Z-ZbQzx>&<BI{Lrq|8BG1cxDO%QHwDu+o+ zXA~;PEqKujZIwt+Bo4kAoy&u5{6b|w4O-%(GkMk{H6c20{Jx#DPX+BaBZmHE#?3_j ziyq`q+g>Drp#glv$WW@h$y~;)K}r}ZfE~RddB?!8(4MXEjAe@!B;@sB93c8*t?Oml z!rGpYPKgMz z8tgS+?g`Ec+^>-2MF@ng$FNXF&!W<0?FR)eMX2bZe6XJ(r%QcoJPctsKYndvLJ zIakdsC_tX<_%0#T!N%0M;yrnXo;)^woM4VRRI|_$rXWS~#XonP5a679{iN>x9oT!r z?qm_|)al2SkaUK<5oFC!3@r;UR%VeYv%lL$6@E~ImW-x~u5J#6L8>SS4W6Y}j!GPN zwL3)o`@UYOwh1tNK%RsYpf@Mq!m4)5`K#%P;{AGu&!8stcUjJ zbmf<`;VV8N&(JxmT&wfFmF(>|!tC#N(-yE?)~-6o?vXR}|9#40ncmj6%Z}B#g4mi!HV={lx7Vr@^2;*n9F77{)r;Ak4?89e6ox$tj)&asOah)j&t%~- zP==txp6()KBl3EDNQNG=$!Q2cG@eVGRaAKkb#(ysLYL}@alyJd`j#^tsw;QvnaesW_?&O3C zqyllXr!F=@NDV_l2~wU&lb^iM;I3pL!ip%$c0T-fGZ7U&#K-f@T!DYI*h$|3P$7q& zC{!RD6emp(2fO3)hR{xk_$uEx#4LD zH0cszVZ#(t(**fkQCa`~{%fQ* zMOC&wOa~J1ktRH(Skp#cy)2_XrtLaCpRa^V8Y6#6_tXQ^<(qwm(nK^oI68_!;bFBi zrLZ&9yG3=fKn&T$toG@3dRZtNdtJ11XQmNP_pV5P+1{nQYvq5Pf$oetopdtq6$%sP zf7JgVdI5-HYWzZqAhf$D0^30YZgb6J2u`99E6yY5mJ4f`Wx9tGw*&~b{2qG+@%GW= zPd1pHnf~y`OrJQXI-F2aQTkWx36&LVyx^FYLy1&WwbnzmDxLZ$akI3z?P=?!~XD@VL+u1JExlZBQy&PRj@l_YF%)6~zzauhUB-D_JeNi9% zxhL>iBIoP&W^CMhrbs)5lG^c#OWZ3)7KA*eUI)dCKu&zJ{37`ehF*cEoc7>UhJtg! zo~_?^R4qCR+r;t-IPPPB$7`(-klB)qVaOkddA$Je`ei7;Pt z4qx*;-tv3>3(@Vq1`&t)GlZWZPXZoeG4gQcF!8mehQZth}ykQOc^?$1d>C8HP; zEH4<$L0Kf30sr04SjcA~EF7bjjSH88RRPO+Slt0X%Un1|1i8L0=`^WFm3+e;Z#nbC z)Rxnk6C{hG>`v^3v-5D*NS>Hw{U#R;6R}~49NO-L1CYzZ#iE{%bnOH(eNLFdvlZ&h zhK3>jdJYPj@H}r9$AI%2XYY!QMN^D zesV6e#RpdcKo{4)oBBdbf z#nd>{i^maF2jVB_F6I?D80PTnBbFht3&TP^uP ziZUKAIUiyz`Z^A}J_!%`=g#Xw7k(_vlm$IHjn2p*H1~ISpOHzb^-S4jo%=gsAn$C+ z5_*$EBh1BK%qBKi4QRVQZgpPWRY{Zj3ZH{Kun(<5#`=gp4!w?4e?}__)d025AUFvx zA>Kd@P;;n4VMxh`W&n8Mh@HBl!TgD`6z429a+W6c+BG{oS;CyB4l*rHkUhv%R8;yX z@zv$C0qh+Jfc3kc?kzwaPT@5-{bO<@8y=oS>gNuP@d5xH$z8)0=&mFzl(QBna&1UJ z@_R20xl?#RAc!~-GFrtc@n5+cI3Mtx71311bc%2qK@x>_o#8B`!J!dy=K$fhUh+F9 zfAkA-DwhV^dc%@Fyw%fEcVSE{?KtI$k>f;uhM&M1E|QdOF?53i(2=_pkS$=8HAt9Y z0Ao(z2b?%1o8oLrk{Qb)zx|Gc78#U?)!keXq=iWO(N6!<-EgnDS#$0yDZCNHf4aiI zbz=@rzwL3yZdEQ~4$4k72po(S?c?wc+}auS!2x1Ey!fE^5RHi52Y|;d=>MfT@A?1N zk;EA85{r!*gXTee=N!^p3Xq?BJ`*ydNR$pmji+(K@75({u{Jk1H}HI|$Kuj9K2gqx z=A@1j3*?GB$PFQfttCclh_)e z@VSt?eX{Cdz~7e)=xu#|QKn=!4!RY%`g6NSw!B$t2Y=)~x6edSk0P?V_+YT|bV@S$ ziwI7H*U$H`7FyX|GEy%^MDclQV1dZ29U@%-i^ZWs>@bqiYJJ=4EHhk&;^spl74uwU zYwoo(2b{Vcz|3L0P^bolZ?Aq^Mu~U)?oFhY@=#m;!!`%9R3iUf-#9jRf>iyu&1UH+ z2<3*ij~bGtTGhR*u7}gN{m~8Y#nG+KTiLD9lu=lFJey$&LdrpAv9jlt){6h**5c5!oqQ^n`#1C8VJLazfH+*O^p4S#USLylr-$)4_)He5qy z9ABf!9vtAhKIOY@S_& zL?(shT#?!AHXFJ?reZ>f2eQ;vY=_<|DqnYYVN=N9pSkIbyW_?>7XpBZT3{6s;>s)G zK3Mw|y`IzVc3v+*0O;s6?1h-&VYmG+s9WtF1Qv! zZxO1JWh=cT#Dz~huMjaky%B@EiiyuwlQ-v-yi3 zJ+z!`#lAeZ(WKE?n*E&{zF@=N~uUnGcQ$E`ejG@B2Kkpk#ndMrWn2z+6=9#>R z@nNAlvLzdu@$kiXVY-NH#tSOE-X9^vWKUpxCSi=`Z**FN2jG=sm_{G}Ue~_Dpa87F zDSAQvUNftzW2@&<7UGh=GCjGxct*2dCmU9KO!SlMEIWi!(!>lkTBll`Zn&@lNz!th zFAk?QK1N({ijsCNii$r?K{f@Z9@w2=UZuZ0~e z^V=O370bZb#k`0+it#`o%)myBUaM3x%B8roaVT{bmd;G)W?|PzpSSuki+r8Nv~+__ zv@)8XnAMu8E&AJw)I^`~ zDp$j>@jGH;d6@bLIo&ozoTPv3K* znb-Jg{ykK(YRMf;NR$Idi-X)CV(qRe|2Yg%_<#pZNHsx&RITA+f4wQ^aQ?Xh_4b-; ztR`t;*!#7`2pK^3^w_)|?+y>Gp8JzDmlEw$!!yTF zDedp_k#`UpUDT29=-H&!ilN}W-DvEjUcprQ42n@#F5h1@6M1ic|NXXH$Gz9n7stzL z-&RB(;uEzr1A+>k28FJ|Mn*Xd97yOQ9ceJtT;16gV|SliUa968%^Zu=Iu#-w;@7Wa zt`@e)Fhc2fsACW-^#@HZXL1Iw4n?=j*-N*3$H4HFc1%cccd4Ag7(zsv1>bcvi$%#n zww#nc2pypwe1Q*f4$g(kV zo9PJ{rfay@q?hwENAXo&N$EoMhq9L9iuzhre7&ENu9gdYt)i1?vT*kJ-t3>=9!FxI z$Iy`J#3s@0%IA(U%)F(1yNhPvq(2`s$qzjH-fBxEKcu&xY>}NEI=d{4GTOPEacL@` zOcoIxezcunbaF}4!D9PST38f$ zYrA(v{Oa+7w>>)QVYIFj&%BLo(cKe0$z(~-Yshv{u#W%G~KFAi@%hIm( zFPt)~KhCW0jeU4JAo7`;CQ4t-3c(W5bJjhYuI4~5T2WQv0y2dvzcLpsO+9VXf z%6+p^k2I0|qBGl^K2GrE(_y=?o=W4K4d;x;uW97<_y~x(4U%!L1P_$xaCR%7ELO^!gv2T_c_-!DIA%-P zu{LA#3QLXc5ZeEv=^Ml2{JyU5*lyUEZEUj*8#lJ?#>vEK)TFU(+qP}1QDa;0^!I<> z5A!LLYi7=U&faUUwa;GS>~n-nC|rR_Dakr3rANJ2o!rdy-pWVQbl!s7T8?G?Wa%y3 zZ<*`(gF+h|1K@?bSl9X}uKRf7yb3x68pAGNBJTY*JFeGf zlXC%#Hae^}Qc5d5ZWrb?LoNwpWlalSeU|yjYUDxNzR#?#Vz=^TF7qoWg^Pq|?z;h} zM(Oh|quH*Fs6>~$_02Yq?z$mUffuk~EFxxO;H-T+ToWjKz*G7$yj4$&ZCK?PolfhKFuu|MvDQ*vt)Ilhb@d@cx4Kk7gD3lP`>va9&~5{4^<+hdhEqta zk;0d?896|BRn}_u_M~`A#W9_-yoJYNHDYRjtj)jly0YSMceNrpZf%d;#04I$!vQ7# zm7+pG$Kuhpdtl7yeJOc3M(c)Uh2x;KIzITDhoxx%#ZJREpHjiyB$tF1VTDJb>c#DL zhJ@f+hKhR;xAXa*2#O#9!Dg+eZ*_sS!LP3SZ2P)nc*p>0#@k#$q03}4^FgKvYPrs% z)POvJAot4#HF^aUAmRkIMsuhGOI-%BL;G(iK}C*iC`AknbX@*F2nw)H8~apGO*;52 zG7bX#5L*;Ywfrw(1pjHV;*y4&u{Wx(K5QJx=k`%-9MDBN0vzi0#bLg$1p!od_2_?Wg3q3K=S=zETU@~A37ZB^AgaFk(i5eKsRE&i$kkQf`~A@+(MbS> zJs#%Uu>7m#t5U8%zM4c9hR;TwSg~~E`)1ab*sKR~iWSk4S4Q_(k3M3v;1bI})cNxO zR)PoEEK{GnmHq(u9Q=BRRY23n(`3d4_u~J{i%r9y;5y)hOfyRyF}dC`DeD?@7%h0TSrUQoa=sJEp#-zK?_YFX57c zh-OX=v&4b`APiE}g}6(BjXh{)SzBvhtm>*k`TxBD+y~uw_fL25Aw7g9qftwUgx5`fX@Vv4O zs%Wo2NDx_WTDl(6n|xkRQLk?=_%YPRX<&=V_E~K`bs~?mvAceK2Q!UoMh>-hwygWS z8KTES0G%ywa5$-Z_yAsGULkJyb{eOhs1M*--EqxU{5J!dMVkdLLvv>QylIhwT$zaJ^+ z0U<*nbl>n|RgdgsM&|rr3jU&hJpTT{hIb>E^aU5{8E8rZ4}WrK zl1=~3Z2uvULKGApDi1jXr_hTmYyNu#{TIWzVQ1x3%9u*t#vM+%M}X4k`yc(ub|fz3 z&BsEfnjb!mmi`BdS_(u^z{F7y4$~cjRJ31mE+)5uC{w3R^iRdu1Y*TKunngg@$s@= zbtCh{HUHbloFhnpU-a%56NGPz|4~!IfGFCxn~#P05^;@cHMuQP%txQ{4{4%U@udJ?~3z7ytu}51%C=8oVi-PqZ+D<`hE2kd?!c&~7A=8xNPBq_)dS)@ zj99ip9b{zV!g7xoOv<;^=Z9n(fRaNn^2$-${htVcun>6GPBuZRUJeOiN>#;3CxD`a z*F8Q*N`pL3x#*#`dNzd=_9b>BS2W_6{&Nh=#P+1u8z&M0v^b>j8Q(%6Jo6$XWpXIO z6aZatVW=8Y-vO(*DVTsHLuN ziOAX1&yUC?<1E?r!j2I6*)?D)P7*zsTB2boosyj_2M5TLw)}nMk^7mo?(rSY@6{R0 zVbJ8l)JHP0ttcjIVXKZK5Qq@Zgm6<|8nqnPZzQ#n3b(#AvpK{+#Wp*^zCDPu3ZxF? zLiW&KJ|9JwDh(YoYmb z&~enXy_{5tP@rO(Dex7^(~tJpf;7;s^V2f&9S zAr0a-7tU+fMckLk6YfB)h;u(%mPFG%pY@5y4ps4g^$ za4pfn&F}(eoo}*=*$jvj#N;!Ebd2l;t6%h=4W7?sev(;`5<>&XYd50B$R7P&4nYs7B*aFw zpy0@D9F7b~d&n+0`)4ZyAuL-te7oZo(z& zEON@W`2jlASB2VNTP^JEvN^DL1{ufvu%8uo469@M-a&69QBAPIya59EkPdy?!=k)N zm# z0m56wnIAxg%{+ViNQk=WFtDmnwu(@qhpi=zD1;cv?#%yVn|cZXZ-^~jc3ch|z>V;X zHJ0jvDPaO)O9-pp%LuHHiS+9O#yjJpcRnohn6`?&0*S(TBxRv+_KL3kt6_5HE}0(2 zHRJOIbPys28CS9IneEr8kvVH`5BFo%(oE1XQwV`Lyq_eop!*?l;%v{~Dp0zAsI+%dGyk;P zA3@Wyr#BWMx$a(|vFqEQw)SNzCIuG~kZqAjeB`nb%+xW$|5jEN=Sj`RoaYr-Tz3m& zQ2?I*Yfk(J?2mUiHFwQ_?&cAqC#qk3&i4LA?i299fiPAcF8@~lWg zyS*b z)~#ub$8Mh6ku34gec-7|KZY%0M(WKln@w!+8o5)7hB@3P;4tU!d@_HIq6sGc#FNqT z>cpmH0Q+^eRMY)!u!mP-|L6(n-oJ9<1$ku?j%>Eq8yviT{4NU{#As)hO^f+db#vdQ%oR1m1}r z^)eG-opS?DoNO~roOH}ZvJWObfBR7eN9naJR~q+tu9wS9c?Q30?Nb;040N(oE$tAb zg*sJYyirtHe-6dUqWl&oHr7o030H<%>if0ucShxY=mLJ#J$@-Q{SrIKp%cGaSAqM3 zYZA-{DS-3~mg;4KL-M7=j+;^YxIziCYeVu6ONW`99cU+Lz?2{WmeR6MG3`}yKVw|R z-aUYM)0my${a|#$up~c=u2lP&C>`3rlcHO*LaMUeEiT=;6-^iy01x(oLWkbs*Zv|= zY(irzdXMFoh0&d{g5_&(!obdeBMs|$N>STuR(>O?(mpC*qUQ0ZCw5?B428OXanZ@g zWL&}1`0jpeh8++qzVBNGNT7S6v$Cd$6_F&fWw@#MPR{3y3B57=8Ya+mYXc|^Ju5iu z7p*!s?4Jq)Sg5oDOTxYtugZ&^fgJjs3lm71G^_apj-fQ0S|ak!1y?t~>pJDxIo3OD zfRK6GR6uP6>lqdGtNuigNQut$H{Rvxv){ynR=oQoIlHUu852awrtODL;`&zwSkn@MOEZq6 z?+mRRJ6k`&so9z+V__%RU{5zBE^mD)1A$UHjBWF*@x9!6k^9<)I9f?XIqcnB8V&rE zB>{6UCGBdY+`vj#7nbyiaB_|BtpY4=t(;3+fbV{fn^2}RXduIjbVz9vVKLcG1qQ}q*Vp4 zipEZ1eZK(9LuJgfbJEnksN5IL+LPSR<&za*=jjdC)-uAQQ!@Q$bGzwdA>Xa#h@|oc z#R5Dc?M@S zZ661(v;vICzf(q(B~6%c-WoUG*u>90B~;kbIOm=5&ffH_^brG7E>3H2)B;)_sU*3_ zMggb?=_BR|J}g{+E<97=P?9{KNeG0%PO17eBBf5=4=L#qZ>{cb-al+(i6&p!dGm~B zjUzG_3>pnZSGJ`uOaOqQ~L|4JUCB94QR0>#~hOv552Q%0q>h**v| zn)b^OgfRjNq# z87%qReHv*2b&I2_yc`pQYs(vp9}iyoFV#HGEBar(e{EMw{P(u1rhPGQ?CSBW76AdL zSi!N$JYE%^XZ3HTbvg%zvSzFl0V^C*%}1MD@7X9Uah8HA*p%dFTt;&VAsGzvdwN5* zDGkTk)_2u$swGPCP+CC+_wIW^&Scg3iN-hX&U1I1T(0Ytm$NH~tYc*OaEyJ%B(fIe zOKB~>f49cYl!9%{y^I#GIk2sqqrnG)u}>e>oH%B=PVYEx>9g7?UW@)8c^zVWx4e=J zlGA}Z{`u4QAloY|g18-e`@gk+nCgeQ-N*(KbkOq!_`MJqqsdca3}_>Pz`xRw3E(%NN`|o)_K~v zCi;OntGVJ><_9tUl~r?n={8Gnty4K*iB2S5Y98=GkD|s9g8<-Zg*jo9@#3U~5m_c! z?1OX`W+X!MhMUr-}Oe+Ya7bfGV}wRIFMkykti=JKi0KB2?Y24PG5=)BwJ z&{gvqrSVzsp?yOEkeAeirhT^JPdd3RwtW!T;Q`4WJ1oO9_woXxGURnrYdm=cy-(U> zy!?*4C@KO8)8=tw6j$$tO)Ipl(o7R1yq;bW&?_M!snrJPB3{wH`~8dd)NF!0Im>sB z!#LgRx;m>rDe0k2I3j_Yv!l_*m@kgFUlFrsjamIGf!f;2K+`33qk^cP_V*@saq zaTPxsj1!eojqfrYa(uI2rFO?|?;Hp@v{voPNLY3p678~MgMK6z06-PX>EIBrj>2}D{8^{A;qv55n|Gug+Nb5MXU_TZ=Y%o z$}5?P0?^Yu@-{d&%%M(}v2kg5Q*L@Oc%urZ(h?uZ0h>@&U8U@8)aYR)!r;4Y*t!`6 zDy*PuW6LVUO?OM->8!uy%B3%TtTUKhV`BL9IWKv54g;s#F_zvqWgFTc6h8b1U0MYp zUVc~Q;>_h}jYX2D{c6S$bS7Ws{=kYCE z40F2DSSfcmL$URKO%eo4tPGMl>b8xS%^>H{5tL(06%$3x7%J3XzeW(gD$Dh2sinK< zb$eJt+C_!%vP~fiBf?`s5OqgE^Z{#W03X|ei|R?|yea>@$wU?pT*m6lS}LU!V|6;Z zez4=2QYY9(?wPAo&w^s*sV^|;vu8s3%RV7gIfO8zE!>p8Xhf!xhQ)FO;M8gQ-9v-;^n(^awzr2D$tW5r8f>obCy(wu@6 z1E(WJ@zJJjL90_zOM8n;S)RH#Al(mxlH=8Plt;l{t@OM8IQ~jatd(x>F=sEK$9A?cP$7y-YAjTy(DoB11?+)}g?;F) zgcSZNbPi~Lap=-8i8=k2nll;zh+z%Oh(#0N2opsqDJUYVwZ71$rp`>JTfl8;d+~IN zT;v1^i!$}jGmb`tN~XK2uUs{`;!C-oyibPI*3b(P*b#1KY0)D>M?^2#MZ>ASQ|5q7 zZNJDY>kCS5K>}nzYVu(k^6i^Z?2XZq`g zdoCU(PudRX<8=IX<@_tMshS0O^ohd5KB5Z-JhYDnp`&B^*aZXm9X^V3 z;BO!F`gLfm|Iw{XYjk+Yy0uTdaK;1|vP?#c$rDjWcxg$vjk_MTXJQ(&t)7dwM!;pz zU-UV)2>8~u(XyG-{%?XXkbYU*bO1kWVpcUtmyiO~pP>I9MPOs0c>LWW&#(GF?5nJx zol=octO>>y2}Rws$L)#rdF5&oZ_Z+A4o1q2_{VPtBNG>SnE`&rfIN}6*RJ&Cz{lDV zos%0y47Pp&b_UFs}Uw}1=b$3OWNL~NDT6UM0+uZ=jZW=XWTNR>i;TfllfzxlnV0(B7i-` z*U&U5&(iC=|MxMafRe=-6~kinf}pa*cb8-W0bMON@$d2Z{VR2tY+qj$nS$l`!N~!Y zB!~tb-V$G`p8#@#EtjKqB^iE@DpcsaZmC&i`pA^!QtG~;?*d8+jU?09ZL3dqD$!M2 zkJWCftu}AV&!r!8C+|j_mq?+;rl##*m)Q(@S>2yR`jR*Bh!H+cBhcsGVhDS%EHEC zHM{TtFhmP#qLD%nmf6nT-Bb-(Y^fo(8TDWxvxJ9^fY(s@#m`YP^}74_K*BL8jFkeu zL|zm{rJP3|#XL+e?m7A8jWb6)^3V#hWm26lR^tt~smK`zB9T(+X)rpOtF3x*Ngl5d ze5BHr@*85o_A$cJS;(;7zh4);KL9QC>?STp#+jvxKzml5E42i*BD8u9`(C|21p_RU&JWlzI2`g-6 zo>lBHtHaGY$3UGZSj%D`Ex9%dUyMjpm?+?j{|0MKwTRA+B`@AW72PWVkcCP8#F{}T z7DF|;`2os%nFrL)v;z(vx0oIp`ep?$%)I4XnZ7eOHpF&dABU&W{~TcDAaXB zO6IMOsM>@ZfgN0}1Rm){Rlk(p+$w!?OyAENS;(j@T~(D3%n#t`W@b*iAqrld4@n=$ zUGW)p+#eADbSd2KwZ&WTBz%G?w=0>DlD*<=+7gKG+h*j7xts{6cULWvKPpm(MZMZ~ z8PKO0mkpj5-?;4Lm^|(Lgr}0oe3k0%Tyt>9I@?bFB=n9|dAWgdwt1liztYVUYb(^A$httE%R2^&KS(vK z^5K8KCW`9hv9@St>Ywg2G?V>B%Hsn{+XiKRvZ8!gA5Wfw6)^ZBdxHJP80`^|C_y`zv*R@l%erN&QY5T}8bj!rV zW$}bNJIIM;a+1Gx7#Qv-`N*%V%i0^t8TYnz-wqn|s)C8f?O`S0zQHs)G3OmDE03!M zBWe;!fxTF{$r@4P$CX+h(~k+VSrTvEmp(|A#+J#VL3*bGXWT6#bPP2YKn7!W7wi&rm57qWv6M^KBfguSdg* zd3|=s*)EimE<3j3TA|xn-#*`$+2r@4m41Ny3F`zcli6YN)ZF}a|7~yQg0}xbb*DBV zP5pt-R|~>dW$kI_XQdF)>Q#pfNwDhYtL!)8t{dc#8$dYBiO<&+M7XdSbBSw@aOxg7Ndi*96s{(61 zTI@UM2K)($V*)LX}3G$m}3_uhv4j2i7X>)sZe9c4CpsKMy|XoE$w- z;7qo=oE;uCbX>?AzA<&NcCoT)2gwut|6Tx7q0ZAsxC7)A$C^JB55!^#oe3I5C_$p4 zyshzPkQbqqJ0-|aDab>7G0kRBP+SncqU`%OhY=+8R$Oh0W>O1gGN=neb*yH1Ku2Zp zdv=n-veQN$^o#e*!r7M$%&YE!PRHsJv!837oHR?r?OvTB*7;1ZR0u{5x3H-{)meRKB@ve#DA3eN3)Qfsp*{ znwc^vJ-1~E?pphRg1rK#qDES5*N5+OPWm}<1KcJQszP`3qkFA=fF%cPgGE||bK2pL zUFDs^Jsk!73AInmWk%al&{+)(O_Aqis-}GAmE*dGo7~_zowTs?|EmH3WWp+s>BXJ$ z?eFOyH;1nr+^|`xOh=aUX>e^!^oy(lX+Sjxv0{<8o@F9wlgZ{hUEqs@P~H1kTdBZ{ za<{F&COP=m*CWNV`6Q!vu=L1Z$(+c1M7RHw!o(_mu(WhO3ze`$R_@#iWa$)XGh3-o zO%M8vau7~BaYmrdC7Gfi@oFwyW@^TIs+js6ZL+FQJX&Z!1mTFpNbIJ~5aFuPXfW~L zX`MNzPOhxJ#h42?YtekQ95yo6Qt7l0Fn+W#d^nPmWn{8)a1@kBI3>uIdbR*96_BRq zH4SE-;M)JVSj5joA}o7$^6?HvvqfA!Z{J*!^TvIz)a&|uet*87832U|9wFLtX8e1` zctg%Hk;x8aU1#Iqa}ld6R1ty@*GJzMJgkW7y%Ll7Cg$d#V0zn`MeViK%`HsI#fhS;aNEK2oFlgp1 z17>cp$vJo1=j?+cJ~QLl+esKMSWAg>xN&aOSYHN{(`Js1Q*RZd>PF zr?v6dd!LD8gfmk0$us)Kls5$ZSN6(}{aq8=veBlcCsGY>X&^`i*Qe`f2iH^oz;C2l z+aUmK!7!(HIP7a{bKOziHde3rfI6Wby3#^*Mhowju)9AvmHBNplkGCui9i84P*khV zHcn>1mShS=&aU@*ip5wy0)g+bqgz(uI}5OsesU4d^S0^7V{ekCa<6F0lM06UkRmJt z_3c6t#h>{6^IN!(Oe$p}EIlpf^gl~`>95t8{Ag5L6olDN?z?b|WaG}DbRXGXlqkD1 z0fCdjCFXVdZCR&bX1}i)wK8N~UeP@<81#~Q6COpFqqi~Y3nsnM6J%!;l)d-_D4yF@ z(e!ULlI*Vg1)b>(j2?}fX<;Du8%>M^CVj>C^n7N`=wyRM;aSV4q6$TEOb*;vUsi}W zdiUrd7zZGoja$jYGZhzHymC13fvBiM>+cJkJ1uy$V|R#Lk_l%faluaTi@OlQ4e_tv zw9cso^yY1N%+Q`$x(W8Y!5fYUFxF7hfA9Z8@U^ML+!MBP}>^=Ti)SA7gpO7aa&9#OJwJ9!iQy-`RZm zTErip4jN>HI7l3YZf%^fb3cu!)lg0{X z8uez{hF$cmF4Zpibh!*6eawWW-jX(<*fZ)GfsAzQ@ARqY6HYhwwNTa%@p){8{c~|} zk>t0<3ifZZWeNB+0!KENR0x}8xdxlE<~u6y0WP~qRP(qXK8!n|UrEKhc@1$J2G~Pk z!$Uj&Y~>pn9)5B}+%Yf>gaiUK4{v{~{gz+wUcTfTgwPwbI5De}0qdn2s+ZWlrT{61 z0I$t)9nv-IWa*-YjS}z1`@tV9q)1FfH2~OtGr1h~#wX$0INO<`rDU{idsSFC!-j4l z0YaGRhn=c4g0nINaa-SP|5DDa7zg*C(PDG1YIN@8v^$Hf@{OPq`rjyjt~E$ku5T!P zU(*kJeu~P60|Jlo{fVPf=FkI-krt#~+L1X5h38+B%ugYKFxqeVmZ9%i39pZVMgNFu z${cb}g^C=-Pk^a5`J`k085;+sc@wjTREaKlR5yD@WZ*}`0$8QU#RWOz0<*0>G{`OX z;t`}^T@vS(F&!9x+AW26Rn&QWBmjEpmHnx_4@3GFUq-=Vz)?$ACPQfVG@v8A-0&|F z;E0qdQ35+?4hTK5=8TZ@J$kAP2$05zP#&yWyFxrnEjl1rq6Q3bD1KN}j(s{kHMqU< z{A1iOd!E{xU<+Kh>AibZq9XD#O7&Mpy6RR1w}_#L^osr8qjwmdh4?vCm_eYgJo+h) zDn_v=YR*?kB7J7DX>hZm>>an3J?DWym&km=+h~w)=h!(cZ)|~qsE1b*6sH^*o=>Ic)6W|4|I5(1g#bX?Iov^Pu9l}oNVCv-Ut24P!c%ZM{0K$=_6K`JrE_?L6NZ|^eeZ?Bh!NXqQF|V zMy1Lc*7ujYrTr{0tV^OqxR6#OL5uuZSssQh2%0JZXQx`mOd%bPy2#7q6I?*5ClQ7lo z9CM9U$vC}#i@P(~AdXiN(`IHTeXHMFt!U<~1&^2X-|N<;hy@YFZjC4q)!dfzf&?J( zq-{#&WMu0(Utumyx06nG!2j4CFRb&%Z0y}4nfk+xCVPe^(C6Xl*N!n!r!Z71g)R>Z2nJ? zf4#}k;TgY5*9`tl2{GPl!_+8*um>+f)S`QZUtH#Y3UkZ@k{c3%Fah6Tbr88ZJXpmh zss43(Dc8>_4dYou0#8WoS4fijmuo7q8lr2B%&{|2RO~?E56*Yrm$SK3rP0%*E$QFh zj+R&f0zKrlPeXPz-m}lF1tT-<7MTKDIZN16#(D!3Mf~FdR7gPDq>_L6#LPKvaO1p5 zKgWC?WY<`EL20BZHx&3Hi)Kg3YWxZOXDct8>6#0#JgvDdo#DGtU7u+(=}{tF+B+zW zIiLSM!M8XfwEGHy+kM|G8~AgvZo(jG($qC5l?@o}}-i zx_V^_{5@h~wbgQ1(>x%yX>?}KgFPG?0rv`uomDmSjT60boBVp9nkIN0DoN{LvSUZF z{7AbvD#OqnPX-3F!uI$(MkF$3RsHQ_a+XSom3p}hIv?TFbswmT2E*&mS$94+O^)}C zb@lYlI7ia7@vzP|Vj#XTO75P%={nmeU)<+!LUQvmxPVZmxUzB_xmi#`e=o=j@Sr*i z8XXTvigPUCKOo{sgo(S`AMe}f-KfZ5vwXhGkky~3uw;99vy%g1os1^YN@w(6egtAY zH4N8|d+nj)^R(C^9+%%BJdp{0Xb&lU@sX`@etAo(KfWI<(}^_w;I7aYWJTX81OJ|D zr6g6u=%<11FFW92i)@ItkglI+pyBFuToaT7F0I@ zR?NU56Ay=5+!B>BdTv0@bSDVJ>NRu8cl=qe&xFvnPHvUkhL?RN5ojH&N*STf_RlBqu-42mnWk587J&NPZn6}lHk;#fN||FA6>5;=jJ^xasMA0 z2&8Qn?zT3aN&n-hMM+)hl*Q*GzUVw(^FTVg2uP%xSvCbEHm4*Llprd2-R!zdU&q%6 zsKC?$Zu2=mN{;dlb~Xv!=gj;Nz~C2U%AlFS;{DXEcQVT}9PBFG6|P|F{nlsvI$6EB zyzoF?;of^-0_HJZEfNkLnc={9MLeFG$0yAuI$h-2*=o~1cy7K?Ng*{t?Osun$-J>x zY+qFqoylH1m}8S$ymqLhCrFXbu+&o0U3~y*K}2d_&6L9hbIY8)Qmw9^I2ZTh8+}sI zho9`3-W~UBu*wqCzG@!VKZgJ0ODcF5MnqxehT6O}eN ztG5ZHt(ywQ?q{e)YdYL@6hIcoUv6S*%OUG`5wLMvcn+c@Mub3=&Y;Cq-CG28ngF@^AVm2la# zvi3x;-CCCWmF7Zh>{*ctBs*9vsU#Mg*}75?hP;?0rWf#I+yzV0F8C&-(x?R4fy_aJ z)FR%@m-(sc(SDsE3JI+1MEp8S-=mUhR}G$G)v$~@5DB;vZ==k0cqx+A2JUwz>P*B2Xrrxc+RIM|7z z6)OzU#SJwN@Jv=&i;wEyC~EV92G?6P|GuQTD6@OAgmPg%oo|$H6x+rqrp0kVWMedy zTY4&ilJuhOz%3Nj&kk6M0V{6V_`~h5m64iOmPfm}yttudg_n>g;1`m)Zz5;@2=s zdoN)Ei53rLM83YYpNaeI#&WH3)8`jUC*sDs_qBfV-pL9Dmn3SZBu+O`-cy36@Nu-f-!>5Pxo9fJxz7!XN2WsgkN;co}EP| zV#o4d7H#h0-)tIFH`_~$C*$IKr#qLyMK56dRoRL;T{1(}wCKQmdWS5@ehHm9^~_8O zrj#YobHMCc(Zy3@0l}wM(!02DoK+nY_j!7vmjVMvMbt1yz7nGHHIc1%L&6+Ls$sRoY`2sZ+} z+vw*~vFgBt4?>%!uVciAUe6VE394_|?a0B$i8K*e4l@>^&cA54 ziO^*-M83GT%HDtZlb03J5^mC+1cTFm2qN%Jto#tk8p$lAm*}7@3T_fCO=|u$8hJ6) zllOBRg!er^1gY6F5&EjHob}9PpEuJUOn^in{U;$IQ1@G9uizqp`*tju9n<47ld^HJ zh>a@>3WK17pFcaSgU7C$m9>h;>{dcpo^zy$*IfP0)>tfW^8YFTu@#FM*$BZ8nWe+? z{1a*kZY!VeSKB_1>r>nQDgL{aPO5*eryYG#)l;yLYMEa1=Yl`wFpwf%xyP;zSTRb^ zoL$2iA_X|Kt9o*2dB@s`)opw)>x9X9g@D^Pemp!ba6$Qe#QOV+nIM9;>zo-;fL8cT zGbZEKSvy`tasFopOlS(p@H$^k+BnQ@V6VkQ*FR(h0z)i$y}|FZ^t{Fvk2fi686;=* zb+^v+{w4pw5V*loAwK6o`SjhcTwB@ui|BSH4M_J`ZqK;UyggCHyd-set6pf{uW0*f z5_srDKF9e9n%eFY2oBHvt-TGA86@3>r}mHpy#)h+@hWuH2S$ioN(Z0@;>Ee&E;}gs z@BL!DK*mZe2IWifBWxbxrFN2$|e3dwez!|5}<~F7`u__ zq3m^b#veWDu8mdEaK{vNKVvaG90pUn_EtIrio~&o=c`Oobt~;MV_fudn(R}FEGj`H z@At>B_KMV>KJYWva2yHI)TTphlGM7qf)P|{rBN}xDotJ;NF`Av%W`z}Y|`;==sZ%R zwL-|mN>QyE!4l_x0wO|8;ai~ae21_?R@$xZUF@r6C-l!aLsPRD%Hw=XRG5)r$;jda3t5UT-rgf`#nZ)_x>FodJ3aUq$%*1eN$izDG&fr2Ek0+RoS%0 zWGuaXhg5Q7Y6+em6x#|R9Q@nnkJT}UOWM;;e69xH6DpoZe13!OSJEPe8rGV#0PKZ0L#JGRs1AzOV1GlTat|%_2U9X( z@_ht^SSQ!(rj~1Q53?;kshIFX{Ur$BZqbsbBS$SgJl*LIXBdmyb4YEtr2-;Ss+2uZ3yq| z9psiu2N~Vz=yIDlX}PwHtXbjFC#%(O+21lI11T#w6mthlKk`;*-Z0=%2n6(@Qr`*% zoBjqFo%?&MxRbPR@yeewvDm^^p>&x8S`f&9y;`V^;r7+sMFEU&2Y?K`K&+vvxl1=< zuGT{{<98VW;*b|~G~%?N^k)cu)GgDdK0IJ*Q{X5%V_9Qa4a#@Dz_LJ)J$H33*wjg@ z+S*x?XApXeR?Gdz)s3Jla`VBRRt163V@4_ok&FI)_GmbiJaxu`oR_(HBiiN*{fg&H zzr_2z$$lLV3vh84{$5Y)IKJB|j+VrIIP{j=W7A2f?(D(O(Ny)ClXcg0-r$4W(J-2H zyUKa`MoqWQkYGaxC5F!5IY96x~9s+RX4h3A>{T6*itEUmw23GZ<;Lp>w6O4w!jfEkN4 zi3dvkcR9^t*<=|FCzR86#FKawL=R&MyE3IsI=`;*c7Yf9c0qdc)m*PvEV>O%1(N>> zFbXP+KM?beCQVUD1lNW)OtZsQvRekrlKvzU7)PDX^QI|NhE;vrD?U$@z#1!x)JIG-da-U;`a=EO(r~I)E*VJwcZ|AP7B`YwyME zTe;0T^o-Lr2rNKK_U-k+0XG5C_RDZv(f~Jg=l&{dDomS0% zaqw+B68l)qj$tv^rVRh}w`)F?>5;2$R}>u)Ww zW=k~jt@gHX1drp3wyAAHcbM>JR!OhUFz0!gh3_YOVtNj7r7y=m(pbNC4NQhlN-@?M94_BuJS|G>>)Lu`*kA{0F4nrG~J7C&xcD{7-qa z{fC;t$>0_vI|ST)fDjt@Ws;eBKFK^8I!gdxE?N*nX&7z!^ONoFD3l;7{X(W{-nu|s zZ|9p&>YsZ=sQy_~1W!WLwixE?uu<7>e>%25B^PgxANFL9w-2nD&`E!@UWM}|VkFxY z0#v)>EuvwC;q<9|-vCqK0TJx0wF-bB^jUn*bO#9leJEdP`}i*FpL79vXkasJ8NdaN zz~Oev=GfH+6&Y2X@2sOb6{R+s$r%rp@t#8>hX` z_wxdkY8$NAZduz{m12Hpo}vOaEAZl#q$Z7LFPo31gWq!n|NNF|0(7_bi!IaZb{b*wb*9{P z5nPzAn-(&?-OCz(c_}Us>Gp$h72?0sF0>`0bF8q2%fk2Fv3Eba`TXKeP+`?GVIP`5 zh~$$X284x&VQt6DDx!`9brAL#!arbEJ^q3r|!D8f^u zVd9FM>Ye($!N%6IklZG3`)4*{Ke`ZfYS6{YzyV1b8%XY(PM-pfc&_5>SqIZ5rI@ZH zX=sQO@_6aki<{S({>_eO=bQI|QsWxZ4;`%{naI9DCM_adu8x$==i6WZgm>Oy0(VX| zgevZ=P*h6k18U9LB0R4k%Ivw#NF|tZ0h5R&&tZ%Vt6@3VHaPoA9?!hDtrAtDT}A?6Jd|=W!lur?!_bQ9dqjN+(hSO}zFk z(YqIWZOINSBdmfpHrOY@l)j%a{%XHavr3gQgUxE}vRvnNbBSJ4=kDKW86#SoRB--u zWnafHninRT0~cv4oP116U+?pIzcQtK@KJ#gdx)*~N*Vxpg_BVTAM@Jrs7x(5-c?Dv ze*?hs480w%5!3&p=_`ZcXq&DFcPGIK1c%`64hin=?(Vv1u;A|Q?rwqL5Q4kAyTiBl z^VT<2`(taXW~O%L>h9~D(|z^@=NV*-EwQ#E?!=O3K8&)h!Y)%z|KoB@yEbfbPV=;< zz@rnfYX!c;NiM+Ko*!z6rVH<^`PGIsw3TmxTfR5+B}eBbn%aQc_r|V~Xr$&aKHf%p z$Pp)X^^ZvUz;bmf`v0qp4N4LFvbgnpsAFsNpF;y~?;MaFQt@pMQYU{T#vz{63=npuBOgtIKaE5``4BQ*Xxq6|=9HLB+n@UOXxN5dNJ3BYkjjuSfjv zC|Mm`It)=qY+G(T{qEPl)@ri8+F38M@tjB8inz>U#`j*e{l1sB48o@Os|6ld)v-D zUcNv@dG4L-jLFzN2=#9lijM&@&;aC}uGet~?f^?Kb0nh!2wg6cmFA}9xctjhD z(8!H{5cvj#=koGuHdq5fM0mWn)R5;z`*_^^_m?{7!k$-5ja)suudDO=T#AfUU3~*u zTnq=P(|smJpFfIS)fj_kXPWl-8fR8hJR|S_*8(&(5zI^YKZkd}hs(cb^Kz}_!+P1@ zfGPaMJ@*h>1TbMacs0NOv7E`-Yhy0|W8eIR9(PsC-EG>|koV5%i1QeT&8|5n)=1(t z*r4!cHlBFu_%^!Z`}*+Vtgsm#|MKdt?l<&bd3hf_Oa8%AHnJao0%0(RV7*(BArl1U zYQp>OKN0bEmObhC%-=}sZXgocFgrh}#V!BzSiJd*)0L^PWWS<)M9|!uGV|XztK0_` zfNyo>qxWP1mIw;8v@)UV2L=Z_i$l&=(RTWqllboA*vvO){CDpe&ze5oN=B})H*?n# zwvkhG^?iJ)d%y##=zX=|#<-;~kT)KO%TKMN3waAVTRh!U2A}@r_UgvmT?uMC`3vv0 zokIHG9~Y2iM$nEbK?mX&f@e63a=L^|Re6jZld{sB6L=UkNr<7ieI22XL05dNf1K(c z8sg7Xeb<{4rq}b^o>jB{6RO%Aq$3g|rb4ENxTdG=9jUCUm%putwPfIRHe4CUYqib3 zdEIpgxe#TU)&L8v?pLh`3R{}eb#1a>=?0F${6Yt&AQq#y14A>6Lj+fPDXdeCY$ zl)>x>V*>v7N-N+bCZEIa>Gvl=Ia~0u$Ns>>-0cn`7R`Viqz{Y-opd%4Rm(&ww7$AW z0eZo7Cq}rSG@u*eZ<&LCuWEKPo{&12&5FT;S6?~&=uNu1OIxshU|4;i0tA02-4)UC z-5Wc&+AV7=J*?Y95F(!(ASB$DVH&e-TFq3&-}cu1cs9$zSy97~%IT~A0r?YplGT=7 z9ANuTt6b2KvEl8qSMbqdFb zlVSFDXu6!WQ8J+}k=q}C%QLsU(h}>kkcS{$SP)oZ7xOjU>Lzhvl+NbY1Aj`A+n)ncvoOJkNB2 zS#lV+`B%r$`F)pY%=h>6S3fO0K3^dNC0XBWWP{NuZqcb->MaPZdNk_--WhPt`G-EM z61nZprwm4rtzsq{+Rkl*TolfajkwZdw~z(n&!Z4$wlmSPpkRY%a+>6vD5jjFmh>`X{&x{YRf=*iCZ~6w@@=UAka>k=1Vx)^^vGmY#=I; zpkq5Stob15DuC0JhSH`SdT#oYpd0P?e_kVG<$ZsNh0en9SuFFgbyH{q+U8ghVfZ*3 zb-K4qLvGp6uiQ(Q7@1}cjp)MeEeV^|?|VF*yOAgVPN0;oTVdwn6;QH2;lrk@6288t__=OHD7VY^&i{0 z8U3Mw@UTidQc=}8bV2_hbG3W$hREyZ8U_I_wuVgU$P{B(f(ecFq&cha`oHGBE&8AH zJF|D8<40gGN{C$BpYs&H_M=7G7uC%{W!iR(%s!VRBQsMqFScV3;ga(A!qXqVT%cx$ zq|`Me1I6&SRSF$Uko6`e1(0$fhYc!o$Rb$n7Ru?}>v2W`ZFEK7;OOKZlTl-`H#%hf zb^*>suWTTwbReZUbplEu76=T%DpncXixik2St1}AK zct!R<1m>v?MId@SUsK2$q$2+Ub!0Ue@(oji`P27_q?BMe@kqE$Nvb9|YouP@n%2A*p zf@LyzOHE~zcO{O789^@bB~hnMvc(KJM76iiH*4~`T6sbfxzg7P&lHwM8#t#rU^WLdz0aP1Tg1$UWXSHgh}<0$-fDPKAOLrHs2C2 z41NT5bQZMR@ED^BCKLoqL+g2&FD?rxE|0MkC|#>&<+uM!3c8EG=~5(xGq+`R=lgGw zuz#O_kO)akxznPYs%F0%tEGYpN`S|diOw3g(2o%(rykin=g{xJw={AV zvZKT@@WK_Q&TUfqDZSSu^sBr7qNcTPvrvkOdZgUh=OZ8xShPNx?Fq3{S2eZYNzKxYj~VT&vLs4x_UqQ)d0y_pFMls0IEH}DPjmCySg3`D$gHzzt}w)W>J zZ(R>jpE&kgzlfHK5q16EKg^pO#W_!9YoEm{iYHw39lm@g$nnjvZ$>`-%e|kpgcQ{k zV|sDw#bzyeQTMRQLkzqIz4A9m=5#;UQkl&M2V+lAQxJ1kJ1-Iuy+OU+!+#(P`;u>% zwBZAGoxUDPEFJ%$J23~o7<=cGiRtmgD8TrjPmtGd3X50J7z|48A>j>21T+e#UEHj$ z-omHq`p_>5I)4G3Y(j*Pm0oLaew}Uck!!dIS*4^gb{7d*URtwB$`3^Hf)e?Mu z^_d>Nx8dzA1_CrP8QPU{YU-wozb@fF3O*O`1Jd6^d6?Lre#sWm`t#{n42|^%-Cp3x z5gb73HKLWC3jruX#CH{U(L@(=Lp|UmFY?VVe8jfoLbMJf{HLFz!Qk5HYnMmWSWb4W zOo4+tyZQ{ib@5n}4hpp#XyE4zVbQw)Op+)V&=)2PG-aqp)n8OR)4LNJFt}?pPqSW8 z|6TDKJOZI&Uz{2qIe{6hCCX@xphdisOrPNWA5s2k^njZ74(K&gn!|}1@ANyT+__vn zELMyw%?qj63Ht)l1XlHTVO#B}rOp@NdhvjwBJK8-it2!hy%5&dM*VIZ6BS@I&C;%QiG+3k{QlY)Wn4zh;MA_)!DbKb zPE};}=I^FuBTrpxwLxA>g%qE{U`DchcW2^i?Fa~%S`Y~ zVgr%jDPo5RmQRG2S^kCLsskR(-D1#UyHhbTDOyM*^W=4&ov`*~)k-XXN=E3NQP)4G zSNyC!xl{m<&?<})OslC|Sq>C(i8|#@CbhL*HCD~`+$8ro+5L2wFfCF5KYzS^Dor5Q zTiLdJMP(*KK(U?gYsz0oT1gb@w)F|3ER-Td_AS5oo$~!<6JRmPrl#)W_ac+50I;i} z+T+PPai;pIh@xzk%UVv83=br>De3)^Lt~p!je+l+0xydXoOUWaUx-nb8uJoJ(L+T> z{@n+JlErOnMfAXqH{kchxWDYPaw*ZSIvFwM=`jcr$X%YCjqO~nRzfMnV2ya9DJ@iM zhb~HSG+qf7-O6Fzp#eph2_blEm-X&3W)T#T@e5AS7uCs@((n0sz1E}IpHy>D|a{P9?=f-pOC(%3t8WbD5X{7&N z!*?e!G%Ib11|`%Ypv%wdrMbkd3-K!GeLzGkKG%HpGJZN~$I(RafMkIoYj1|p$$ zEBuawfeoRE@uosvqk$m?qf$E)*#&|}goONufd1XS@WH0}V*KenboQWnvOH- zWfq3D&)?`ryW9DfKteY_D0LXg!k;Um&3&^t>CV`>IvkqYwEd+Wjue-MMP0OD`qhKo z<>AynHMaeNS7dniX7C^@owvBaDKE+$20(+8AUOWhyf{Ns65$RDlADZL8zlkZqHJAI zpHEd{p8CPPaM#H`JG5y)$4xRst#Poxs!)(o0)Nxe@696bt=dJt=SFHQk?Y&~`>2b4 zOzN0MwN!>dYWRuGFupg$zm&Y{EM4qiEywaT{iS_qzaK8$)CGI}^&RS9%OoIaWa(BGcinda&o(`)O53vv*?+~RpeGomahI}mA2}6 zHvi?Eul?Ck`aX4 zR>hx|T1Nk-VS0Pekv$j-L|zG*RkZIWW#E|}@t8aT0pe;q() zM7tHGT6bt_%?BAM51ooFh%_BWz;=cq2R*;$TNOTg{ZuNAaj0B}`D8Fm*I(p5Qivab z!? z&{bBIh}l;BahWyQq}|f#vl{ba zcFsS8umz}<#zej3<}|nE2gq1xMUpPF*LhJaU5iIh;Oz4OI^?JE)EpLJ?o#$=i)hmp zdO8lQoteaCu|5o*`?fcv?Ek%H)1@PDfYwVkx|H2gdh>hSezc`MeDEAcj1F|0o!85+ z{bNOffiPujF>&eXv{FK#lPDcWgimGLuj)r_hTI7WnXFuQ6^?sRlqJJ*JR}HIOtsio zT~9f5c=G+*PJw#TxiuQ3!Oib;IEi4of4j(!ELpkB35M|gJD}(Jcl~5OHXG5UEN_BD z8(S1MO6H=ewE(u4>__f;aNxi{6EvrgPWS5yzm;9V|DGQjJTMU)UiAPY1>;;1hA-3g z9c3GxnK@tCI&*;`anX-d$GH$zzVXg3Q?uMkZ8pr;RNWxc;iV)vHiah4c15PPzp+6& zv`Sp0BGKA5+77*dju4{L_{kHh*CdRt=0fP()H5U~l#}sZ48?oJX5^>EdkR{e&JImj zLbNWrbQ?$1cTH$!6JK;O#u$~biavSa%4`GiFNE_?G@*vKnwH#=Q`w!hv{wTm#reVj zkn>S{U0c#Jv>*{wcalv6*Zt;rGD(zDe_i}Qv}i3rIxs-f7O9pKl{v1HHf?ddy_s9t zvR$EiVx*Z&pDAGOWBro({d*%KL-nLTMDIZbXOwOEM9Emst@ib+cN6!KL=dym{nu$$H;C0{d8J?Y zcDGj6*bo@dezx;yI7h8JmU7k;R!3ffbDsVDrj8tRQDzz_1cV~GY==0m{%%Yg(X_tY z>P2(bklF{uF6;P&~yid=1RT#tyuwWneYfOBN-Gs{m_a zlsp4J(cf`WB22in$1a=An(+l01}v&>D>7RS*VaGO5tN9UGjUM1vSst#xsZS=tmCUw zv$$pX-DXC(%B7QmjQ-kz+v(}Ii;E5XW1r1+cyTEZt1^W`Y@t%aRACP7`SWoU$EDPZ z4Qj|9|Fn)oZdoI|rjGM=h*-wI(&zBt;DKLAbmn)R3hw+xD)Y4Yp`o0`B|x+Q*(NrbQE7K%3wXYtU&lu{7ElRZ*52W!>9~!U zu(_r^_s&4|JXzlL<+Pl+=*C@+7>9%m#z27z8jNjC{>?M?L znv0GSuplBsplLYs?hZ64;t;99GK*NVg9Om&GBpas+J(N|S;;HZrKdEPmqKXJ7TB1os8Vm<(M=jKAd|ny7s-p+|cw{X?)ej70K4ToPxZo zUrBzOReR$Y+L?~2Xeq4rM?n^Vfq@blx$e*KemKwKF!`S0A*{>FXY7}=l}1kz3`1>h zH113)fxgb<;%3MWD3pK7WTULT@1#53DllrqfxxzYH0$~##g@Mi5>x(k7|={!)qje6 zI=b|$nN}fk=b`b@T_aBWA0wL?8x6XN>P?C)x052%zU7)~O68t1+Ai)|&QpPvkm0Y* z>m?f7mZ5FcwiI4T=_^+g7eJx9AR1e?q5#I~ivLQ5`Alp6sV54%jFi+7OBmPr?K{e7 zb42Nt$L)?4Xf`c64`o6G;jY?SsHV;3n`qjz{&O$~Cj0j1x4Dcheh#I-R1ijV7CK+~ zK1{abx4!5|3PYj8ghap!(xb>%3j2b;jV-HfUhii^f?UGGthN#GGPJJiI+okr#EC4&AlLt9 zd{KSOnrq(m;IRw!dlpJ^J>T+&ASUKnAJRugmiNWs78bW$wqC40oBa;X#(7)C0U6EA zd5-h>R2E!w3XZyrT3ONGuk-H2zB^%33Z79IcvuBVUEX3KRE*n(Y}fH7ElX%o$TPxPy%g52P1 z4^uFQ_ItU0V;}bm_Y*m^q4XJS;9-8RbWF>F2ZLm%_J<7mb-^7oOlTH^z~ zKU>_4E>gYJBI24MC2B)g3Sauha+X!QKzH6Gs0SC!j!uScrH!%a%}z&<^Ef}u(eacV z8~b=sf7`H-fLiqCH$_AS7mb37;`6(w;o>JLhH&J|>ay>j`l*kFhk+vBn5ATLy`G(f zo)Q6mI}-?QK^sn%Dgya8Wn)y?sSx zSUa$cM&>lavia=+T%)HtcjI^DfzqfDU_B_c_#a+Ay3v@S^ahG_4`e>yLI`L2B!85IEAcp8F3mC`4kH3nkg6CTSm#y2s^R3!=I!ZJC#qmpj7I-! zc}43jAcDC7LGvaivP~IiNQB&cM3q~02rru&nd<@oOwiL+Zh8cNY*zm0@kx7YK)ph1 zQ5EXYBajPwocBT!L8yS?aNeKfr>gDnuVQ3V@-V4hoCLvt$%T7Y%r|iT`rh#<$nET? z%PL}fzr&i@MkGWg)S8W5?^tY+e-v?MPxu}EGViHhYc{x2PWekhbeT0L&EmJ-+yKZL zYbTKt-6_ka??9)^S=PmyKGjLG9KW15;#~>OVwcDbcw?^;g2Dta6QQZ8A4L9yQ2tWIX}s z{TLz|w3}zPM=Qic1Om;+*XFI=F76#&+d6|+H3Or@fGPUjWv3z;7AB@!hLGMYLsm7A=cAB&h9;P@daqBHg!{1~EDH z%X{14aDTSRYxB|!4TfH@Zb|bBfK>>-O=B%Qd zqUTTMVh@&jF>AmZy(~`cSzum84Ou~R#MfpU?i!?59z`5)^U|-*VyRyR*VWbb#+iMp z)79VO^Dk~EG<699WF%FSCE|r1R&`SI-VEs4f|ew-ZhnopgJNqSbt8w7dMGI*a2}~re0!b1nX*qe z9s0jAT2|~LaQ(TUThg|fsfyAHUZr(d0|%R$$5v+bP@oR%oNbA^Fc898{e~cFbwh)v z#mL9K_Cx|Hl^fwLjUGG*3VJ`~ z?)|WxvsaEn%}%YO@O`sV-~+d3U2eg=8A%=81jnLM=^fA1{lEx?gMfwvpv)%oRz8X%$)$kM_bseW>RSv`UU*)f4B~&0ow%m0J?B_`T z+4N_?JHhLyhwhKcE@!=Y=4rMT>y;$aL7QAw7*yKy#&x_Rc#e!MI#mbZerNYcu?t3S_}PRQ=g1Uu=WNzx%9vG>On{j_>6N=)lA zzo^7tuAK;D5??NltFAi#L_Y0At|$r)4`0Dp{)5kT4Z`Ojwt&B5DU7zHEXneikL}X1 z1(@xST(epSU~joU^EBOD817A@zrIkE(l9W9mz6vDCN74mVM#%>D;s1AaOE&< zrt|ZW|99}9#_<~FB80{yD7Q+63&BDdji_S{zV13+*Az6TM>nZ%fV1n$^=m)~F^Gu> zpf1IN*X+97?59dW)$!8(s%C?S!(lnI--yzM8^{ZQ&{-^`kDn!{xk5_Uj%G??j%=3d zVuXiR03l&t9hFrvAgAT#ua?XQP<=dXyv{4YTZZz?yYjb8<2P?QO;`t11)8&QIdO#3 zFwsAf^Z-CZVEpbh)#B&sow;is&geKX4^|SdZp%nDwoQu zO|(OA@02f4oI%^9@cUqmc;FM~oS7Bc9CugvsMqtHpnPLVrI{Dn93Fs+*`IXbGi!Ws zY@9wkfZ34p=R5ZoNj285I&m*5_Nr>iq3K}1!E2%zuhYlFQp#hWvXPmApgTts_6Kp= z`Y$JWqx`BCPHF3+t`ZbA`pNf2E1AmAFb<~v2e`gUQWJJXUVXy$`A#9o`wpC%d%n7f zZDN$d$8TJXTos8c*S<$Cb*XBS z^|$7;Q@L)LM?|g9!ImqGhH zhNR~(+x$Y3Y2o2;MM&nbl6%t{lmA%wLaC5lY9~8FI6*+`B*VreF1DiewuGm$Uyefz z2f|b5L4yAW^d=$@yuG$z_OP+8b+De<{f;IwSWcLjm&1q8u@^Z;G^1qn`OTF8YD@IQ z81h*WT%w*-KXoGb-(Fr(uT;+PKtljiV`Fz-;uwI!-ZOrd9DrRxU0nd}$T6 zC;~ObW8Mkn@9O4LcW`ZYL(Md3rW^wJ%}1=Lo3ME*5Y&;n21Q0;a0Fud1G&NJW#N;V z==|(gPD9Ob2ei@t5@i+w(m>U8Z`AqTMn!P8KQp|{norSXLk*5%UL8g&c&pfSGoFn< zb#}n!u1UNP96A)`QCx|LZ0{GS^_AqN(EoC!K$l{if2Ys2cDAhvUPtim!iBF{v?*u8 zZ4}fQ<2J^8Kg4LUc)$-e7g(6(T27QK`X+=#lNUKfkH;a4$wp3|9-v@3ceoz{z(W}< zOn;b>J0%#V0Q&@1WyfOF@MN1?yH~4R%PviStj(5sP3eS(TR1XS@rDJmdLD{mn~xi4 zD8=Q%UV9~fI@pbB*)gKiN&?Y;5QyDbseHSarD1?EnN=`5HLOdpQyu!Xu4kQKA!{;A+|Vx0x?7Ko)FkQe-&b4z zFMUbs;<3S7%+>lQ3)_mLLq6I_t?$n1yo^o146apEIuDj4&SHIk=X?3{m(GbR#`{S9 z;k@Q7&FZ%5HC*9Z5H!mgXN0SVg`KFpTJaEmTl@F66U+J~wc2zQ^Vgx}6MdS=kMFBo zxAm{@Q@(Z`Htc$vxYq(ORyPL-e{b@&m>J!XmnlO6Ks+ceUIZk(RTdMd!TXa*^PfUp72K}=kD&(8Div77a74pU0j72oI6-uPxQAj=3Mw+?(zP~{@5SvKI8u!UXjnyAJFLZ9G)%N#Zm(O zs#=me(B0lq5%-%D1uXoRW8Xud=Mnx7IvxGuyRG-K<2wAQM^mbY9loI06!7h_-|$z5 zf!$9W(a_6HbQwlpu?~iEpaV$)$Z(r0VjU!aDA>r^fdEt-WfG*QPV@(>ml_}gJUA^5 z0A`=AF9RbG=AMMGLJ$DsxDNK?(KRE%Tmc-&9j6NM`8mP%F1SuU#s8?~c%mr_*c^U0 zE+2W|a~*2s{qn`}@_{TGWkr_oX&@`%Je%8O=|kXXb>Jp8_OSN!{q9SN<8QN7_RgW- z@==FR!?!=&rwE;%HH^BZ3a1Uo8OJrSZ#F>)1wZdREapqQjj6u*Y_oSLIx$X2g=N2Q zX0AlRl6gLStY1JIP=XGCDCpj0HVPmVqIKbVaq!v$_xQSS=UdF#8r407Siuj1uk>d` zBzmmH5FQvpF|cRt5McLhh=CJ@4&9jF97hcZTk9}+A@jD#;yCnU^y8VZEzO6l0p#$L zP((Obfr3_?N{=I9K6f|XIX%VVfpo;uB7wcspCYLhtdqaf_*yydx4$nq6Vj9Rb9bi( zE_>L-*;x{|tgZQx#m7F{Gy8*1ju0N)h~~)tn3I4|pO!id%X1Ftu9I*$I$44d`Jez5 zCZfwDSN8@=jk1j{0=QAEk9RaP9vHWdZ3Q=Q$i{$F5~bfCNi@_}olV7LF7l9GZdU?% zKmdl*pLzr6xFu!!Iii_6nw?bKEfV7GTS#Q~0PQgq-ObnWVOD*?zpKtg~z z1(1QOT`|ib8;HHNr|;1RtVHWklJC_@UYUXJI&O}&eS3c(Nzi`Db9QOaaVlX-KF4hxs(jBexk)Etj$>gjBVU(l>*uTzXh6+%eMOs*%ORs7~^ zCFjMz&TA$k9e;wTcDMJ7pbzXy_w#wmM2CPjxLJo*eCxZ5hr~S|D?QcDzlJ~(E-Vq5 zL?ul(Gln#;kIV#f#Ct(VV6W)Y>6u~y>LuR=90*h7Hc{#4?X1o7)Vs0%TSDgz%8K*( z>(!L|gxR{c%Ey)dp4lEfsI}hq*Zd01l|-TlHj%C1jkV1?F%$_wuQ?zBEMk%OKq(;R zwoEj)0DOSr_ow0F4Hck-6fs|41X~HbTEw;*hFPlJ!as*ES2ECNMinJd+Mz-qV70`{ z!9ul=xFSCo?%t=z?@u}Gk;g)l8rt_;TeV3bNWnn>Ferghm7e#18{{i-Yq#4~x9|zL znti~JHw0TlT8Im>A5>y*Fa2(Iy;xf2xnNC5A3#6+s&$Ffg%lhNfE4%nnr8FHdi2_{ z%dFCZ#R#yrXl87D?gPk&+4jhtiq;UB&n8gFtgs2+Nf&7?0HNs-UD6aR_6Yfp>5yx) zd5T8!aB{2fuj;vwRdvf*O>TwYu_Yq$)Pp2f5M6=aQKZ_bUfIPqLrR3dJMc3H#)>-4 zpA}&t_%_~0NBvkl8A2>3#XdzJogoHNC9>^;mEgH#;5(QdM`8<_{qT@2LKGJMpnDBu57;%?AB~bw#sL~jb9eKEMd4OEK59h$g|KmYf^aSGNW|oS+Jt?z zKpZ#;I4jS<-|jLb1ofODZxC$XZO6c_fZ3r99av_bUG*`~a#F;i4iX7xJ{SWifC%JG zqSwIzgtbMa)T>@)5XBs4jhXV9 z{&7$r6{hG6ppRdk9^=IHJnnY*uG=OYTioM*VcuJvzr7oy8T<&>4ntxjyYNkVn!6nm z`C?sODj7b~Yfm% zIKj(&v^6q@6X1M37+v;8PT2{?V3(SDBZ35?yA3JQ^N}x(D;psGlw(Fa-*Gfw41@P5 zpRpT5H7H-98|S1gl_DZR)K&^x*PQuACZQ`#Ox~1=*)F6UM$ko@!iVY3<9#)8u_TMc z3uK1&@b(;Nq{yKPeXB`Ip}p0pq=`ZCS>Nbhwr)>E>rbPXWaw-HYfPQpCtdZzqs!Rz zA>@Uz*^))0=4<1TX7_$*KdxUJj~xI;5PVR~x`SF9Yw6}WNQ#TK5|cKKr{1W&0Kf}@ zoy$<^%L&3lc|Jq{-UIv&2vEDJd$>LWM(yrppZHMExxaFJ4JWYRGUT;rN(D$y5@8D?KDFhj>&tLxQMa z?MH^P12zyS0yS~sUb$wz;4Db9Kz@4ex+5-GjEne%T>^}<8HW?fm=I?NY_6|#%%#1 z04E!su`p@}JcM}8W6SBFRcZcS(>gta$2~7!;fnN=vKQDTr;^p5#eHa%N`2k=t-Ih) zi2S>q^m8b#f|nqG9>G8>eE${nppr8{@jKl(*3 z=TVavtp-Dt66)qU{FY&8lqopB<1*~mgpk?NG7qlloyP14r9oNe~c0Qk9;_|Ws)+g6&_$l=<#MU(_|F+ zD-YOhd3IyL2fPKwtK?!2Aq+ocvpjYCB8ZMp{7Q3bg!IWu&3964>-$4;4m$v`Jz<7F zfFLa$D~imE7R-eZu*YmbV{g%C_58$l42?oJ|0BBUr+5wQi_H-NP(X}3Ppu@XtBWNK z&phsTbj5bk+$k+y2cY8MTlF zB>%U=>*a_!0%>U4l&q%BC$@Cshnf#A+jk#lpC5{CJ#r;Ckbr9wB_V)~2=}W=_utYi z*tr4zR-g5(tgcApjr`k5@G3`AVcV3gGi-j>+35)av(qU7+h?{;QpDO92ttvyrlE*C zXX0QtY<2)dE|kkuB~LUorywE$0Myu!qWe0jBp>xBl**#h_vxB=ZU2~VQqrclJK8EC z|E{sbGh{Yw2f>(s9@qWcBQtY~poKvh<^5BBMiM=8>Qhmxz4G&OBEnVzr#|=vfeuye zlJ{H#!tx2(oGz%4Gl%d(>N-UWiHT_#Ts;_>d(6|-Hd;n4PR%h(85w)y0?UPH#_9{% z212CUU(>*-M|CiP$SgI_y)`_*^&FDI1tT`s>VA}?>trUcvb5xzcQ5uUb4@>3-8APe zFR&L7TJNjUjg&t_tUEX7hEr~#vHt=G$ofSn|A~&-0Z7b7GbEeDm&z*z1!BrZr0=&- zv_i&5ba$3q4b&F98W>qviU45m2VAGqgMIY;XLC~!~&T_tE)>t_pS|--WzLhtJo0^=%K%?i%ad)s*m=4dvc&_K; zl!D23xl{BW+(^UlIk>&u|D)|Ku(AUau%**g(ba)Af{gbrrsX_jjr5Pu`M&x>32aw3 z1-@25;BeL|TeV@=wW#EH>u}pMK0dK>`eTZG-*nFJJ=Dq2!*FT2WGbS|QT|$XDfPr7 z%lQTBE+e=S3He9;vx&sIa*epIg9?TuypmVhV-_mf%P5(nN_W(78f0*?gh}!raP1(q zh`yF8xEK>8zu%Xgog30jE8UW%D){`K=)!I)&4^T&R;j#vOliX+mqw0zyv_qfu?Aq1 zkp_ex*he1F;7JW<=Ovo^4t`AE`R-H4%4_)i5XLm5oLG~EkgU>0+7;1PuG=;xLZKGH-Gw77b$4$*v>-KtFo{kH= z-kMW#l>0fq+Z^))3Ti6MJd@tNrJ*kqW_=lksRWv(@vS3E_4~Z?S!x?YBZH0)<4-dY z>DJoHy1!RB4fNE^j~8BpkdJm7jDBG7EMHunBysVtGVQhb}Qw}h{| zftXO%L((e>s3a=E#Hx5DkX12F;%Rq;MVdtg5WS87lO-*; z^-6rhOT#~ZuMf38n?wu=N(EZRaeZANOk3ip8xGxAyg8=%6p(Q9e2`Z$s zq~$&^R2{Dr92UUQs3Y{gypdl{Klwl-$&ps!{IGiD=_I2zQ?Tb8g?4t*(KDg@{=?>| zt*1-5$M=O}y>w?lKqDZIPKMI9sGRR8r*<^aSopsvvOD7}M!KA4)WzJaWKBqOc}Y_} zt*mg!6(U9OvV6`096_^%E5*ZzI3fH#K+GLfXR&MvsV&UBZqiCHx;*ZZd&wqNnptI5 z?_cb#+sl}l$5D!qqhxg)9#$TY@IIUR*@v_SgH9y^@~Vf1fS`s8NK}R`gBAk`<-mlH z!8>ysBau;XNeMmFN1a~GAc)dt*xP+^H?J1a)uXav+9as{yl$aEhsY+wS~o-qpotzH^WldKKGgzKaGD5^3?K_p>EaG~y02N;q>j2ze2dgCPU|o}*O^Rv!6woD zmQmAFi}9?nwLfeB8B;_6mV}A~+4LwwTdBv-#%H(jb}W07=jv>9!w;9&en3NNsTwed zFO$G&{d4+I!?SVxP9=M_Jrecz4aT%388_<9g_1M^G8(cp0bu$@fuBs86wLIzT%#lv zE>yM}mt-0pdD&){O@oQ~@rkFiRPpwLF$*R^Z?e{Dy=KEV1?Z({^-cU}n$!0T~Im6KB zI49vslX7#=9@bwVI9T2=1zY&mny)>5rQgvec{hdF_A+uqdx2in{Z&8hYHW1zI`U_~ z)a3cE+n&2E$LI2q~S__YdRyyw6b4?sBbH)NqZHlq=8`G3PGQmIpJE_l$ zo6l|Vg0;HDt*PhetLVlc1jzj%k0#Gu(6tXgjx_a7#?>redn-Jvj|GmZgRZH)Uiv(} z-{s52xu~+pMV5QEvlAzR1WHEJN#yV=*~U;A_*P9`>+7utM3GL{W^;My>JkiChN0{T zoGA_dKFUlkjg``mD4D+BJKBhk_K=$Xfcs6C@G;>Md8}{$Rq?+>yFV%a9Hg|pUgWQK znKi=zE?O2qh8C{(nklzmHZH1YMlZWtkM35y1Yaf?(ng!6A3cL4;$9Zo^(KXxpZb0m z=eQ$8mvNlTvgleyBLY?ox-N1{_kYd;m#CeO33YKfGFS=M#CMv)waG@j01G)f9JOHbJ+t(lg%QQ&;EQ-YB znahTQOi!LjQz%9aAs-1Jha+rO{@3eL)$-=N4Cksp;|HGc&RL04s~2Rem14nvfOMY@ z#yAT+CN%=33j7b53dFNrTU1yWQt0*ETTCGnzywHw3Wh2TRO)8}1whV`IFMuWpH3yw zqe}_L2?rPln?^f1@UJI&9wx=2Cm8sE$#Hs&n*m{%V@I&MgG)`ZSg}zV%7`>s_LVRn zCzQT`1phJ1=C5A#A4@7w>oN~)K3G-f4>_}M*W0HPdcsCICuQH2x?wsfoU*=LYW)JeJiJN z183#j+x}`O05&VHBq->*70kZl@@r}J;opW<2geroUmOTylls*y&13a)1NYJ4FbQQZunSo1 zhA1GGo8T(-fv`t}WJmz&rY3YK7*(cVX09<)rQ>ig`1E&6{MYtOhbTlZ1>1Z4_;l6% z*aGW$bfvVvy;IG1ZhZ38yOOFhQh;QK(9$qoFqk;)py&pFGV z4lxPUy$kGAQk=x8++1LQsnnI3f6Zh|`b9Ew2_B}3CHeoyBfdAhJWS_od8|6OvCc+4T%XVLeD;aZ}q^Kf9Y zTAa#11{I%!es2BbH$h`W>=tXZD=|x(8;tlKQT`c^<;YdRMbs6$bp>IB+y!Del@&bX z$YNbPC%CO<8j7XTQb0{7aHo97%+Fstz%H@sQF_%vhZ;yr&uG_&3Fi=7xw()K80DjL&c>hLJmc~<5%PFMg!-7U12rLPSs+xzspGH|aL~6UgmtNl zCV{JbY&(hW{$GahWblbF5TXc%EH_EC`e?r(a|f2<)JHY?`gBe-g*`xElL0vZ1;#=d zfdcph#KZg*3*AgjbL4XqFciwDY{rtJ6&kqCO*FK-t*=&#Yeq|tnXmOSV?%azg}JQW zv)2~x#}CJV8uJ&*@I@ls-(86y+e+TRb9=sr0o4A?V-?N&T{c}5Wd?%hGxPB@-fKOb zpmi8S^iIrF#eKj6!zT4cS!xRx1r*kh_|LXr4hbGwGIXDa*9A7obPn7n>3*eCE`knC zm27&Vi{#AWY?>jk(vA%%a+g^NQqiqzU`f%aDoS1L2b$*9eA6}{xMPAf`jqcZB4Gxx zZO#kaDStO;nELdK>NFZq(|&L6GUF1hw5o3kFEJ(>>jKtW8uU?L`lWu7cr`FzZR74a z1r#~sU9khuEaaY@|KhHnYew$9{KOW<{{=|TA)zt&EUPW%V(Wflh?rYYU4+kgy-9Ag z&j-v10Z^=5rIbed{$u)5!}Itt`bA35vx(ZT{ui8t@grdXog`+&p~LsP#^8ESwd9BX z+Wg&Vrznp8+m+JMiG&oHFpVL+F(eS6WFDY|lbj0z!EZl?#iN%$sE=r^xu}VV7tW7Yu5(#XS<6L)*dyG z;N?jLK%-{4)NT1m6k})dy3>_^=f$t28*yw}Q};M+0Y)=4L~!xFrffPeF!CP8yA{Bj z>_P*MQN)-Jd~COkS0tc!_!A$X@c(GK#_+hhu6<&oNn^LMZ8x^9#!ebLX>8k08ry8_ zq>XLc&NqF&>-{mm&NXNDti6}+b+5J8$5Wjx)5d$B99nOpU|X$%-}uER+cdm9T(L$o z7Pry6U5|O)l+^mznPJRy4|vGgmnVlm`)iwf=^Z`2eQJwe^_XhDUFEkka{k2v1g^a$ zu63CpPnuq&3gJA7`$U$@@L~FqtJ(Pn%gNOpEafqb{7^U`e}WJ^=tZYr^qlHpoUNWJ zZMfA}_fR*2_i(_cW5GWUu-X$xzHCOhNQ#dgZmKzIDrLjFhaNdk;DRv{nw2_9&l zs}em34}2;hvV23Vps0FD5uW7-Qr*Eih$+KNB5<6LA$~SLt17_z9nh`8COc{vj-RwT zD4~u?P&OW;ZNK|F;DAv=0L;*{Lu(aN40~l@We`Q&8e@X&ZseaE5&WtU zglyH(+Y1#tG2lxNa}^$+(hd(`_rtk1<9}QLK~@Ahs7tJVYSJszvDV4J!^SwoD_KwQ zo*Yzfk!K;=cJrwFnyg$6$0Hu?$v3cm*r+8y@27^(47<{AYI>Q5%=W=+9;oE$yRz_6 zxSNu0j}B>LiKFbSmzP3432i|t4NyMoj&3!O{JQFo4TOfm*V0%*LcV;Yx{&N7PpR8z zc<%QvaS)|49(#TFiDSMxZ1uY-QHEAjaMAz6Fs6NfEh(YnyZ(6jq2#-E{{ok#=4$m( z)4m>Yw7w@UPLZ^)B==pxcD|_H4rlSCUNs{*>y#z8BzkApg1hp3ev6OLCtrK2>SMq7 z0J?n^9f7B5GO4K^LN6ce1=b8XDQ><_{taT6=AFHOQEea`310eGA(^C z!fhn5&KL6XSSWJ{z%l}zTtk|IOSe8_+i(oYZk>_^8=?nu!wfFIF>mRt zIs*ptR>yP0RU`8EkU(ohiq_Hkh;64`T0s3$Z@FVoF=L;0R*o9ak^@piwSflL6rS_y zFIAS1=Lfu`?KyAr@5%=juwzuRazEEjaTQ1L*JP#CH!OACvpr??>R@mWCWVjA_16+V zQ67MX0Rii|l^iowP zrWK{}c<$M5qkEqr6QLhd%WkAwnf-vkc~oIXNa7IK;o{sSMB^ogH1Y?L-`)$EQVw?t zC)8x2g5Jw^_?5!kA|zWZp~3-lFN$V_>4;a*wYEX%v;xg9@TxPIL70Kwm>^LN^4-lh45v>f7Zk0U?jI=`Nif2p^VJDc zW}uSkcb}`jx}KtQ;l4$pCba;galeft@+nu{<6-a4hK9=(s<+cVxH)zd7nC8_p&7B5 zwzatK(t#Om%tk#gJ@_Sc|A-CgaRlxJPBgfoXhJ)&Ub$Y=tHucUr6T%}Gi83$$u+&q z54}-bq$vedeSlanaw*EQ%D(REYxkY`+~D`@>wC8$b_)2zBbRMatDR0Y6YcS*xRWm_bg!3&?`V}v zt3$L3cHm!pV3a8-gW^%mDJdzw%3OU61T|YF5y6FJBt_GJ!Z0dn?$6*r_Dr*B-=t-S z{A-Q1^Zk-vddFvdZ^`I@KRm;Fgl-W(E@5jtdE*>;f#J{8-;|5f12I+>)3v~X>R)OA zaBwr&{l_vEOix`k!zb72q7Vg_`_A}YU;lwwWw+hr?72dJzG|wc)uUWDpdHK2 zmB?YFVCAexHcNT`aNa9tl28kzG3}DtzZ#nL&v(~%Pez8Va_l<)U=AKL!~DasRKzz3 z-wYhzAOO4BAE=Oj6nMWUMMDQWHsH-$RM5KsfE1L2*VFC`{X&R|j*e#p?tRVUcT!Cs z>)gVFkF#55YGbfS&3U-UO*z;O${?7$NDh-vf>d_~l=xJTW}!JIYU6ZJG_Z*#8Z`hJ z?Kd}t-vJ8#!9^0*+>oI-xxD>wOej4vf=(*q2~~hO6D4aRiIzec`;Bo;Mg*51)T57L zx)DW!uAZr)@@m&_(Z8r*WV6pl#-Xn5$i>c!$OaVslA@IT4^&Ww*&TG%!k_s)AW8!% zJyZk{u}Vr2SW<*&sU9i%C1M!?SHZ|;uE64`SG^F*%txWf;~I=yv!REWkD1)6qw~{! zt>^6w$C&>6Q&Trk9%aVc$#)!9FVD+i5vFJ3wxV`e6QpeK^bxd?Y^!;*hSlzR9z{)0 zeNpJ3qWS{!gwfG-`$USu@SuhS@ge`seC;9C7=5`+CWocV_&M|HukVX(${46KD*#f+ zz_znUU9S&bh{)&8)bP4BktC;5VhJJse=}b1za)kkp}DQUi=@QTbY)?Ti(vwwG|WT%BQ$=ju^B%o*wH3&CF^ZK{3WJCq_xjdqG%0{@WDt>4?oz+eU-VGEG?}*h+3(=%FqSq?9VX}BJ`899Wzvqm(MEHRsS@4L2Het zC-PQrAkgHPz|o-zY6#kY3A{ukQ3V9SVEhg{2so+kM1=FB4r}toX2J;a=DU$Fo@|51 zykrx}&rp!sKhh9vNMv*nDuhiS0VCPgZ;oe?b0*X)_f4G6(Q4xS*A8F&M2tk^@^@eP zH~!Rn2F$f$y_PdiImx|k@dfaGl>x!$bJjU*d(=QIRTjNf{<4xWHP%;Pm|(5p2Ma$Z zXkLD!==tUsF&)(4!3m8YEd`wiXFtid`+!;%ir@Tv>B3Y|&_FcV?J8cM_F8H<{B6U8 z^u?-;k{dQ!?ELau17@O`l!T2S>Xl3`oDBF;%NH3Q1EjA4bJjF)aAC-O;T-(PpCNna zmX>NYufFBq!M@>oa4%kdudCjM6YjrWhU{0DPeS-hKBgv8QB7q#@qP-2N6h-%29Fn~ zEN>(GvCjs7jY)|OI0TbPHy2grFtHmtwEJGP<2jVkv`&^gA^TK^Yh$azVewBz6w=zB zSW;^L4cFb^%V_K$?~Cw*bqL;P5iw;|USFYw&C&>_%7v5)7Dhifrc4Wzl4$rO8ZlIiXJGNFgPUE#ZGm`pCL# zNi={N6OAkCB3V(AiGzrC$KTo0^dzzlr&}9ew7KnnEmOLtLr5L-hQLOtrCO@d^S1nZ zQa{vk`ODKST(xm6fb*(H98|DBK_yhpJN_oFsi&UdARN{q-ga=-w^BFtb)X2jn!K1C z+a1?nZNDn^?QJEiHm1#Sl|DEYH~WvAN-i>DKpEDvXmRtN8!74gn3IHJ!RBy`P$EY? zF(Oju%P-Oou$W!;J9K74HR^-oN@%})^zNYLZ1G};83;c~?eD&Zz66(%odp0Y#pct8 z7nX6g>`bjbk7fZiZ~OYZAq2^R-=PDrdB+Cdjzmf34$~C0xT0!*djJZO6#+l>Rf0-W zt=+#y8em^{##J`cPB#`rn&;hZu0l_>>0R%q0l{fq=7v^9llksso?xq-A z8Xq*?tzscz6?N}67y}7Q*PvSzgxvU@Grx4S8dV1;HIu5;Bf7)06Y6{p-GX`^dF{NZ zmQK44`;@Q%2fk+NEdvmJCA;{D|B$Ya>s^Qd*3#H=z0TfZ;#&9=ck%ZYFujY^v5jL0 zWZWgqiW@H)6C(NQy(L~@*7$UhUd~Tmno@+{Ss=8a1nm=w50SRlX#}|j z(3FgG-Gu_)r<#(p_pv0j>u4Y>P?ryzli%KQ~I7r{}voL$W8S+=vh=l(B0MXM)dJMZv_C+ z5}%mKR~yyDPFRfkCMg$-i|6T%0PQn)zKP$%=FV;s8w~45$fDQPKqxs z*8CfHW{H^dK90KX5*Z3`8QxkTN)znkeKA4B`>b5?57_y5a^ZRibbpuE=10-aAM9{=9baz!24V%26go4YIA6!mDz&&< zA%a{7h-ATl;U>1fS#iO>6-99Kfs)RKk ze&P;|MXi%iAZUq>ubH9l%brANg0FGy_>8JNR5p`J5+|s!o)0oXXdiQiqP;Q4NIYbC zN&3-@U%r!?s4vcq_Fw&v`aD_FuLOv>L-A%$AFAQ>?i zlL?P48cM0TApmSK)qHgn=LO%in(6buWZp(vkt2jH)|-OgVt>Hvu(A7T6c}f+JM~S! z@1)24y>+cwvR3PMKhJoO3Ag12b4F;xqY0_ZVZ6x@Q7LOIqb{*~rQoXDsSY>xzy?&9 zXL<0~@8epeyFX6Lu^*}zU%i6ASsYv98FL%iYIyIiVbE{P(TLcoxbnJO+$N7T>s4SL z`hspZfD&r?W5c1mbGmEQ=>DGZdPMf0=4My2fP8tdq(CH#tmKMad+-kE!| z@8+h(v5U|p$KAYpF+JgIbn6FD>XjLo*a`O8p_~V+ait9qc;))5jdfy!TLh|~t*S_J zg;#_6*9+8w7OXvfm9~%`C3?J(S0I(eyA3)#3kJ>VmZLGpoR{^7e?yLxi}%2`)%UF3bT^Cy8reT>hSRcSusbgMC)D9qCS z1Ig|P^I=M|R9sA`h?T_nV2 zxN)J``CHX$yYj?->JOFdwrD4{&@`%zK(hDJZ3_pct#6KM+gUt;E4;XEG5yZ)Bx5_- zMCk)cBh=9R6eFZ4X8TL%ag9{+-w^Q1w1ZdtWW)e|##LO6R<&d*TJrAF9px@O<%iXI z{bNX#(Dv!e#_9z?@O=Q?N3-NUq^6G?O06Od168?CX|`2sxYKQ1;NUioSllOi9UDK+ zF1$4LfJl`ND}J|rV7ck`X0Sr}MfjBK2-@2qaPG4j$yB#jqmHEOo?1~+o?g-B$DI|% zMRwBf@Hd&A7Wh~~-{O;uY-5}sa;b#0dNm7vveGeD3+vZSQR_b%xV zVS>Fke3R3iW+&~|GQnw8w|vlS2s|M^^Up8~$%&vR8gGKJj%Dl7dChoW_28T|)3ImW zS1Cd=eL*}ui@81X=b<#?DjWnf=6$HIOXhs7`$dK-vF@ACo`^<*2UqZ6+_(rpT)QJ! z*{~rdIMTf}6(nD|K4(2PP{Gk^pw&o9a`1G_Wal$o+Eyw`mWb4r$tsmv@f0o1vE8KY z<52SVDTMRONmFZ;_cB?QB2twW2SUr$GFEXZwL9oTHcv6*@2k?NBWoJy#uS*;EEb&9 zO_#!#h-u0%O8J=EJ8fJHVxO0510!60;T`-MYtf-{?eIix-R%CvI>BMQ@>-fI@ECz7 zibi?fH(j!`>ql|_(MSjTzQ4tk|VER(} z*bzNVtZ!=5&zoj=x*md{sPs{QlddoM_5gA2%kM-kthONm9__J3vS0CC77x9p(E>cf zx0FC>VR;hTaJ;gj)DQad7u`0vbr|KOsCdBn+3I;C+=rnuQ&TzT2MJm=(1JIv2vsiB8R1y zPg?DZ2WM;hmZbhr`jT5QU#ZC^EaThuxiK<@1Pk;VS7~JC>RlN*bbY;PO}xu-KirxEDu z$RV<>DQmd_`J+Y=rEjR`3WdMRr|E+PxQ#N%Uxo#6Z_Md`-nTASlr`HZefuL>(z$}1 zELy7olBp2-m2?FacXGVoWtoxK*@G*`t?|X#xmS;jDO;&YPl&<$OgWE4va>QwCDHm~ zN^STbw)eC%v@4$R3IM>4C*2AFX(xZK^XazA@ZyivTvP9z^Vr>3$Den>!t6HtxOcu4CvF#CqJn8)eVsqvvKobjAL1Wxufr`&4<{@DT1 zm=x48Dh-(y>mh?43G0`HllE$AaPR?&O@=WpG%>3;XyZ**T$g&J1g0q($sc> zKsQ7U`#Y+Y&W<-Q!zjEo5i8wZ-ov0sYpIA2Gw&8spVt{2@}UkjsI^$FR^o1Uj#xpW zGJB3K!kJ~79o_{B$A3tna=JF>_B>eA4&!Rc1;{gwZ z*W+cTVZr0$t82t95rJ`}YfaJ$z`a&7#DrzkKNsgOy&a$FNQyHEo_Tz%-1|Tv!~P~7 z(J!V{UI<5=eL82R0=ENGjW<8?Z;dQ@5AywwiM>^6dLD+6diHKj`(p-G~wAOD|1U`=Mv~8c#6p3ld;?^VxhABED;9GOVh!BQ0o+!b^&dLM~;NjZtRX5$AII zp2&oZUB7K|Z=5>{F(vD<%N88qlEWU~zT*XBwBP>5Y8w!E;j3pInIn&l6WqZf%5+Vc zudOC0w;Cf!nAl#oOqPh|B+~Ikl{nCYzWo#I9oGK0PS3fKOu?u5c#r>7zvO!0_X22* z_ayPS{`N4+KaE`j6br@-li3i&8kWkP7wW!^MWzq5;mDj9LPN|+{UH6fNF3!C9-Zs2 z+Gqg`Zq5q=8taeOO;~vk&K*~DL%tKaGgW)U1`=hXc1W5$*16S281pQ73pz;_`RxH) z)e@t-e==(o`Hb#R>MUJ-^%O_!AL6FjW59X}JBLO;Jh*KjS&jfdz*dXieDzR_EjoGL z4HWsYfB8iM>&l4Z)$`X-+4h)y!jzoS-tE{D6^GWr1ESJ!?ej>&EPzVYXx8*``ZGkBv07VFfG*?aAk9K}H81Z;?X{uC`A8g{uzd z7+)7?zcf8va?RvH27cyh6*Rmg=B6_iPTCtVVmb;Q;rPAMce4# z)+MS+PA`%DR|&MS%6qRwA3W(E*E-2;44;8AF|mwi_7n5x%c|o7%aF$vX(Jhb;#KVb zHWiC%ECuKwYPb<>Y-QlixWmZIb zULM#6G;fg7X+_f(J;r?o@;rZHALx1`vQAFc%lI1I;pKHjA5?04Rcji^xHiHW`}G%K z6^>gJo2=#|t~NDKZeA28x5p;gLI600{A$gu9{PRR&3o6HLa0@8q->B|$l}!Z9&8Xz z;&#<}sufjXx^xDwJJA!XQU>ESlmFualxuJVq{g)BL(D~RseoK0Dr-s&zFLT37W_p& zbZHyi2IJ#+#N`uWc$kdQ z&q{kkh}^Oz&0r3Y3yiekxz9{5=;+Z~>1Ju+1|=YuIRP{;+}X`$+c{Yin^bzb9;L@6 zH}Ph!v&{4W{>b>8{HpIO-GUs284LYVGtu%@QFpJw4?>~30qi$ZQ;AC0%Aqf?{&xR= z@{&{Ams8DS$|w5M$=UF!-;O+FW!eNg&+jt^e{IITunCPO*AG}D{R`b@F;W&E4>Tbk zL27!B{^y#YmEos(iMlJI#IwWjAW8cC*72u}7j4EEXf9WauU|CdueN?CF0D02uDG9N zt2^y`T5vuGj}M}4~u4$ z1Ir9jZtms*U1cz0`n#ASG;O|mSxqcg-i{-HZjb~dtbblC5p4Vzx!P1B1pbW8`&qdE z90dx}wl)=OOlz=R@1LsX65icP{4>>}#N_m6Ot8Y5yHeJS-@D6W(#p(}78zaHR{Zh7 zzQSs3g$=#a{(S`bF}~dsxAnGxJ3X{P)8qJ?`-zV6i8b(!{bk z9i`(ZymattO4r9$I2U55hq>(}Bzd1hK$}ktt1h7fu04^fow{gl?c*!DerJk$P2uXDi;ZKMy!+VM^@Hd`Cig>GQlb+lxpf69Z?xV>A{j6(_m{G5ZK z3HH7BFl@Y8AHuQ0ve{z>vEXK9)b+FZF9n9aX{~$L8-Wy%r|maE+FXH-Ta#;MlRKWD8qh<{0dtw8cGWiY@NTxX)rtcd2<|5`i`FxVCfD8w3$x_` zUFm?t2n%_oq6K>w-|Dkla%)jS^?vEMBVj&r6VzT4BnbCV%(QGik3o^+PLFid^A36S)9EcFXv|? zygiSADeG5r0R(Rz?}_&Icjs2UP9M&p3xpC#4G-q0oVmR=ha+r=EZ!#jtHm+h|K>OD z^1&eer5JDBH?fh;VCVkZxRFql{(4{g1JL^X+M0)_*c)K_d(x&t89AAw3sIO4AXYH> zC(hOSCO8bQtVJMpmf50r8tL0qeRv!(HsF`quDz`3KT$bB#Fg^nS#ROdtcii2|G{Lg zN)8NE0@4s2x>1#b_IA9@X#NM3bgx@+BLtMCU_k3W+4mVcxsrhU)`P%1Q5e6xBWZOzq3ZpYu<|%j=%s&iFi?4FoQI;D^jHeW@#wx zdd0bc5Hs~7+=Z7wwX3QWdIi_%xRREYvix~)Vvx(<4BCx1W1!2td*g6v@05x=K;P@+ z@Tl>8(iHR9@8b@5PgH|L0ysUdtsTqf)SCC+9y0$>i%AZ4ytwZmSv5^|&hIc}@;?YK z_{dkyI>T znL0HbI(`XxXK`9=f!^^VLEG`d?NzY=;Q= zpSpOO1PJ+->J=iu(=^6c!baIpfa0)_{Z&1^UmeT<&3Ya{MnU)kD%} z7M7LJ&T^RVTB)xxD`2@wNvTXh8=m(`w%Srw6}Yfas1YkRBU=Q1^F4|?na;UmE**|KkCA=t`{vcy`u}3R|*I=m7g2@DyYi7LxF@5q3a2_3hEpB&0>w4`@ zT-vMJ!~KUf*fV~;5cq%lSHDep@jI97S6Y{4Tj4TC>$1#qi}IH2Mj-uW6SW^btVvet zKLZH+NsXDOnZYEV9A)C2VzYT2iPinjpLXF35Cmmv2hMfkR$9RixoJgbxJGGuN+OI1 z_$f3ehJ1zn;FdP~P=W!VpkQn@>yB3p&3uBygQ>^}5;_iY^Gw%po3^9DGU3pqn}T%4 zv~=X~`F_|13~J4}5O`WySm=H~F2qb=O$%BokcwgXaJ5tuu)6uSGQE&d_-8!al{`WaL z;-JdqoZ)~T`rYkzHG?`A1^{XOH5+UG^%3|Ah&Z8e2Ls7T)2p z{qey=aS7GZ@wdlAWnqKNLyVJnU%N|BMQYQrlBU~Xnz1`~%Y7^wI#69;UcZYcJ-upZ zkxLoS?N7iGYC)!m#+Qfms~N88BqLb)CHX*zG}`=n^><5hPRBc$He$BxM~c}=irtgZ zSq-@-q21N#&*ks3_pFh&oh|wYKV>_nK7L$X$ErDVBUP$b4UC#zouTl}ULL*Od*26OaRH zesi(de9n|au*(DD0etXS7_;jwa6ckIh0@8I4glS0uWxV7?^g-5xfA>?-Mm->f7t!&Ojf%XjXaiznvAauJc7V;* zG=xfPcF)QZ4}s$@Cbt^JgP7=|Oh&w@XJyqL>X@)<)wjy)8O06Ca5TdS*HoRMsJG3C zQM-qa$C3y$W&O(=jp!LhMC&v^6+}2O*1pq6s4#-V) zpc?a46E>F#xLAhD0<1&ofml=xm888lWDc9RL4iHkETaoEx z46=N$#xZ;Y?*UUMVj7^z3tniHvX-$moE)7T_P`LqX1{f{IRt|r1kXhSJS1PhYGha#pU%@;q7B>9Q$_#MIE*A8OJx( zRqf7Y;}1frtuyZRac3x@OQhOY5!6v^=ntvfcR;X$-P38XX*fsEGP6vyqAIC=5)wA%@ab$RU)-{#E&1@*6VY;>Oh6;ZaR^!xXK80WKCIADeSJoDl7 zYqj;n=&0>3!EP2L(qxrt4vS*Y}I`l)pu%JejaSZ=R4kDck#c+n90v(he~ENpVZs7nDpiJY1*T zN44K}IWe8JmR`r{SFYZzl~jEx@1}io-m1YG_a&6(nj!Lg38v%VnQBZtXY?}zYpJ^9 z^Lw)=XEepUb%szt>Dd8%XjvPC^bXj88raF47*I+3J?je054F1K#Hs^kvOnYm7Z0ca zn?~$mQ1^-pJP~90zOgdEt@;NCMhZ$=I*dvViRu0Tt5Vr~pN;No8$AnAR@#cmj}#%* z{PIqyOLRccPe3}A)%YxyNwPBDmfGE(O&1-MbGrBc?sHrxpGF6A!HXR)Js(`l*x!Ws zo4^6RS1Y@Q)X3+3HtqG?F^S4w1GOrmWqDlKiZ^iR-FtSvb-DRR=<4fkCK1|+0qQ*54^w0wMu&+L3&k4=IQy0tGI zOY=(=$pv;S)i-|fg=9nf;YW~l{qy!zUVNfk3YrI9pN3lNu};7R1KO?hn^dj3DPY+7 zTy9k$F1iLE*fegI5bIwKGRY`7J^_R$*V7o1QHi@oVSqxBR#8w8LSnR!tCF^=Y5B|P8~&(C#B$Mzb{&)t6V zuw~a-hS!hX{ym#Ba(gbM-gF3DC#}PtZjZ|4SG4^bT5_L9LyU9ygrysVOf4W7x!kKc zsNNEFhoDu^JKqK=_j_^V+dMKCT>Lt?2L0hVkMUb9bG98vtO9 z$LG~OE`;sZFC8>J2j(yR72x}2kc22BKJS^y2b4GFwCxdA3Og57vBz(%hxz%1q-iFU zaB}!BfuK?n+s(S4y+xe(LM=!-D-UL)LS}K(v6r!E5rKpPE^YKc|3c|8f79E}SsiHd z`T)h3{NLS*7;_i1wJd$zS#|c#eW~n@W^%7hynxsHk~#)P2pT#*eoJ2AnlyQ2=BKgo zccJe>+6dk1u_~?B6|G#YQDl;%_MEf1uU^_ozkMS?al!Dgy(=0i1r0@9==I?1L%~>+ z{+s8?dRIww7S8z_#oabpH5t=U9o>eS^8AQd__8Vcj*^%z;8ym4ZUqmbE#3~aXX-aw ziehp$EZH!{lNJdq{%VB+?$7uWVSzov(KprpEl6Upo=??XQTCXhbzwJc0ex^zgiQoD z`0ys`$CritL4{DOqmgIBb#(1cOX7R&-4`C~1VOLyxgo*rJo6ozRk8MvRFKW>GRt4+ zy`=V&M!}xMDT&hH_##u@a)uw`ODCVK2-yTKsOID27BpRotDDgn&VGESlq%HxeeYY8 z&mU?Zo&7R>lMs`z_HXh2%Cc}5W~pT%n2zbhu(+T83;E$Y+ze&qf-EfzkYNDHZ9;ps znuS2ip$pOigEWLBeS0S%J{>)w&e@vNMMXYaX}oe-EBx?GubNt_n^}VCPoCz zZ@sizW!Aa#Y^j#v6F@B@uE&)9TM|P$SybsW88b1X!Nk3CxgO<{KEm#v<_WG$@LQ0X zOl11|)n>FV7xR#r*|=C zVm{4yP1}s^BGlbX zAY*WU_aFpJaG-|rgP)El+Was@p!$#?#Jj}wxvX{M(^((J$faMscsLiH#)DC(r8iHH z3%B;)O%S6%>_6jb9@bipG%meH5SSb@xu_;u?uId`@{C~cpkl6Mm!qpd&YEG53;Ce; z5FaTvK)?X&uPi60_XQ|g7+aIlkxNd=&|ff^CbC$q_`W_Doz`ZsdjIpHgBKq-MHVLp z9$#KG!H5N>aFvxJXKzxD!F$#waP{M6?a5SijF1qKRlzB%sopgam!`YOXvix8e z=x6=fv9W-xbZx?uWs<)yF|ON2Q_1540z! z^_N0oY#_cnf

      }PAXrb)%5$PYJtVNYsXVRM|UY56_sQ**7=TvuWT}3MI=u9U^#K-ojBh3URFTASnw z^z0+?=-GQ$f-sUjm%ALVr#}M?>m*ww(%sKKqhdW=Fa7Cul}LUuL|p4A+1okXoXvVR z5Sx5J3HJHYDiM`|Hh$W-zy=8GPv6{DoQ%PFGntT5~)w((SsO65AvoF+jt^ zK^jy<33{{H0pmY8PQZ==m67?XO$?13%15y3S?XSXE?JGK!;@>Ka~q$b=Gc+={>dBO zamm5l*}`GN2k{5L;|)ssFJzx;*c?q{nx&o5lkvc)YrrN=rPuNIYGHNQC?I6Wt#y zF;BQ_N3&73BDLPsA5dub?S)$Ul3r&Fo&&kqQZ+BKN?X#GHfXCL1mTeoTzn5Vx_S2U z)_Csak7gT&qM`S+-xnE+Ctior?^f-PytFn#uRrNCXtJGP^|V4rt+gL_zyQ8g8r`Kn zt(e{HkrthdO!-Ut-ER&1?fBAFpX|xMR6Na#6pXYic!r?n9u~p_PVQAVC3UnpJkHzW zHOXv5nj4J8cmB_N+Vt%-ZFiGVARu&PY|QxspVRkQ_zN)mD@9?uySZldbd?*JzV0nn z&usU#3wKmcl-i4su^fMQKW^Kc&LyJNGb6@d6+_RvX^oZA>vpahTFCno|)%&XqxzPN+=rv;ssMxwewdi#Zt-cKi+<% zX_J!0u0AQ{&%Alt6T?UI;TFC=qeY@|0-yS-_gu51))~r zdj+|7>a_;q%hQ@_&7=hcm53Io=kFXOkmZ#Eh|?m4?*5^#_A3glhwnYPey<<^VvyC= zW1%Cy>JuSurtUAT@zkc62B!^cUXI+A$mKgrMC2G)ZEHr{m=mP7o4rx-3A>G_UJ7|sZA!WIB3mhawTx$msH2(dr62+fb+fWT#e#*@YCBUw-|u1D5X=cyi%wQ^4iF1WXt z>O6IOwEU?DA4s!5H~j-YNvGEN5#a*Eh}z?7KR>pJvI)W2Y^5Cil$>Io0v*Iz0_A0VUp>4b`9>!QpIr!MqVEq!uB^4gPsq&Vs3N7}L3 ze(sSZHX}fRM$hfyG+wK5ZKpl|lHwE<&)al-fr;gCmZf7;AOpIfOUY^*ee_EHb@4n& zA#N9u%AiO7IS{MDiAeJZ}{exwG|P8(?}-MW$n)*l8$;M8qz zfC1sqNHq5>Q9Hj`q&@M0>F>|`Q=v1+0Cr8Ut+&^cRb>^W)Byql@&uuvh&MvI3z_=y zqs*IG)gn?ZE21ukHCI3ui)yMVStBk_Yhs9#xWwc#=13Wu%JL3s)!ItA*rCXVdh%S+=vAd6KBriiS5K%ox*$q^qRr>PASJwYeK> z*#zSuxUENUI5Dg!x+ExD*-7r6ePo37ZCUPLZS9M+`JvVSe>{C-c%@C#?T#_ACY;!I zGO?|RZQIGj_QbYrJDJ$FZQEzhbDj75y?^Y!yH{7Os#?``s&UskcTGhk7D?U^>PQUT zF;K2xIUO#r^DkaO3ba&_S1gcKU=;z53P4FxqtnR6nesiNEDs+-bY`~b!dYoi*>kBa zyC^<=eKj``;g;ns8ro|8KIru<0>yTCnhPmr2T^~UhBc( zIqnkvr}NThm=#u8)MG15XK)6hNp;C!>LJv zN-fkFUP$%a`;g|_@)B}LZh?OGJ4PA@X1@bVPyAPolP)Eq1d=2Ks-=ps{Pf_6VXw;&o^BYEXB2ehJrrHU?c~n`)0+Y2{B~RkSyF52vmNMsQ;CXgKo`@^Phjj6H??5rr zcom8A;(ga7eBV%hK~HRKAJN`Ld6_Zz=WYo5x{$E$wA49QFr2&S8_q|uR_n>bmsFLE z(dCZR0W)HU%sJ(J*=giNoX}cVk+C(R07ZE}dm;h!^Gl*hv4Gn4rQZ78@Vtz5V<kq*T1xt#+4)U6VZ< z$1Wp*Z=r0-`x5{FP9#19z8>L4R5R&#hc>W}&KZAT z@G7P6%gbdVADNpbuAiJUa0GfFpDYFEc6s$+fMtAOTw6){B4#{zM4$#@Y5*3uddBbS zWmsvL-kxSHK|7Qt!2ME}sSuhy=1t&{0MwZ{9Z1BWCGvq1_Ae;Y)99UYIhSX)F1GYG z;d;Dv2uXNbJyHFkA`F4!@t#-4&oG9bHVTOY2Iy15hs7Q6%J$zwR7vLg#0-C6S-~T* zvVr%i_CvV{AOQe;o%0;3WG9ZQ>AvElMZFsR1|v5C#UNifNZnAtYtV_N!sgD}$FzF5 zNYmK+pCC~b1w$P%esnHn8vp<$Au7H4G=+O$L6qJ8r}YbE_{(ZoupI?e=L}>oT_+c} zn;~L(>U_Q(sC0a^9@|x{OE`-qA*&S zub4U3fKI!1L7|(?R$~Dv6N3>Vw*nb>ago-&yxr|ZVL+*B?zlb%E0C?zl++G4=@LD3!yQG!FgVE{7lL(0Hk0J? z0imYs`-+b=>HfPkc+=*~Wq6g)89;E_Sp=W!z&EwVVIEUqXiIkau}FMIW&g-kPe%06Jtzq?km-?6Wn{&JZNtOiFD~IYln^QNC&~6DR|Mg1j;M$rf%Ly(xbbq< z7tF9CUS`i>NRc(g(HRH0=au(_(~^JwmeQSb7n&%i&!h-Qwb#UUqqOuL8j9<<=G~%LoP^gaiZt z!bZWe8|m(GsZ8${mG)DXd@1o4)X6p_!D!BPzT~#4k36f4MYxFRC679t=~sI4MYv$_ z?_y#NPrVtDO^h)+h@CA-V1OggGJd}a%g8bkS@N_no=9C^(`m@(9ZU=I% zd%VFbfcY0VICqVWvc%KYOBGCRPUrpL{c^3twuQQ49gD&Yx3!#~Y`=FUU!5||rc*>{3xcEII$M*)f%4z-$a8TwDVC7{{({m`1Eh_s50 z@!jaq&!Zh&sRjLJBFtp11!Hd$tRNM9*E5}XJeR|NH!nXgZN5TBp*Wtc*!zA-P&IM@CnK5V5_DLiVHGc#*LrJAaQ?3k zi$I_dj35ExA2kyEA>frt1b6xrP*u zNZ}qC7O#C!e&I-DuFqjogQ~F7OU_`;My^`x#-GspJ}75(rt1&+|6lV?nfHm$6tY1F zSdAkmq&QiTLbUYSX+0u(c-gpXCs__C{>WSb|B`cTZ8-lV774h-ZL&tO471Bb<}=c4*Wo zoWM1UHH2>sd%q5QJ=O;}*_}H*l=_|!L3O;ucMSr{Wsl~d==~&r>sXxzN0T(Q?)f<> zln$olPX)2Hk+RBw@5ufW!4ROG0f$Rg8Wt)1gC!<+;fGK2($m0$2N`!W!uDPjo6zY= z#Mx$~{lt*A-eISXwgC)~-T2F!%xmdsg8t%xU`eGiF~)-YaSF&+VI&@(xHL`VYF}+t zS=%zDH{L*WL!lwSR2v8(W=>RP_R7$+D-Dc1CtpCtf35W@wQSY|42N9q7^AV@reLF; zj=71-HVM`Gx!EpRRbF3EU1o#EZ^X zJBzohDiB+Dhwb{r#tiuUxyzWDf%gh1H zfUr+Xat`1p6xR>B1rV6Ow11`ZfUFoghg9AIT+`Hlo6bZcay5hs^R0Fz=5M~n6!$#Yk_0t4|Ja5VH}s;+ zD^~HM|Jqj|y{_Mis=e^UmL5^HG^xlUDSzp1dlR44blT}d2wA7+4S*J8{3pH)v=r{> z@QDv2kznTWvic=~_ck0^Ne}AT$1dn)_;!eT-Kn|+77^|3DAg3(p2kQ!n4yrmVX2im zUCS~=3|;64PylvRjxwadwD+22{(fOnVBvP^nNRmpQsQuU8u=bt>c>U4_x26{{Vm*^c&2mktdf3khNu9%lfNH z(e062$FBKH3t-<;mq7r+BwT2v5s1MajwC0h)hd}l8K(Ioi}*j4u#H&l7SUGjGB4C~ z1<)nR#Cu@cygoV2d&uDUAM;hQ`N3RI)Glj?sM-BN;7 zJoEdNHtuo2&L#t;xb_HtS9v9sK@$)|{_>B&c9hU+F!n&u!XJe(bfLhCGpt`EQ(mx~&0>TZ^6w5*r<#`UcK zwo@2u^r8lO)Y67N?A)Yq|J?0_Zu!cj^{+DUaYyGls`q3{8?yg2{aN$ISMxk%)`c2H z@SgtPU0^qQk&5yODCigmpMt^_j2z{z?`xo?cTyi;`XK2AG4E1k7H8FvYHS+(w+<4$ zsB)RWKPGGu+3EjD%2D5FnQkkC!{Ayh^^o^Q_AiT|fIVn&RNaU@mZg+3lC0HyZVRX# zDM~70fl~EUCuTGqHm`T;Z5}$1QD3C0rJlrwZ5Y-SS&DN=*02cB3`NS_n^A&x*mEY~HcT`Z2RFPnmOA;WsxcN*C#Ev{CO6>{PV zOlLeB0cpB2%k!jzADTH4^LjmHN{f^O`v=dGV`j-yniItIpclN}-as@PP1oiP9CYj= zE7R#_Ty9a@D_T(s{0ruXbCJW-gU*%4hH6Be8B0omB%-UY(faQX8~Evj3~W; zY6FoYD?UtfDff6a9^hO*3DpBn@rhb;f1DSm?-&Bl%_#WVKr%+j*EPNW-g$K81(QPw zIKO1aTu>g?b;{^+mo7HPq1HKjSf0ETEC7d{M|OR>2(6aWJL{PM(6y|RjL9YM+JWyR z{SwIpHl4wiwvt>mz)6DuN3Iwk#m~FyviGrC59w^K=e0@Rw-txbQ^f6ft?TLUR{4p$ zk4A4Y__?;fDv53rLh(-5O^P;5#y++DHgaO9s0S?YxTF^V(^kB{?*%BCMpbJ^jW0O0 zIbDzRU>-ZObSTFSDsES1O4w+<(1EJ&%Kr>ix(Qo++j*i#cOq#kedsSbk9hlT$=lgK zb8P8c-mUo-5=*D*XRX@Jb5`)osmi{cE+#t|eM^YZl$AICf)7D+DK#S=>2Y0#UiEF9 zn6Tr61iHcJ-AO4Ha%?meKEjyV94TX%L%6%N$aE|@Vju0r9HifT31+3`Q_7}$^;QoX z+H4_gtZlHTR!Z`ByhJq~?dlK?>vZALs|Dp+Q>wY3j(;=_nAtk$Yn?0G<4L@_(AZc= z&vVKD`-G@}p8%fyPYeYG`uEB`IBd|L+tQ|Y8sr$f-B4o4TvOCJqwSz-x5}}7Vvzw8 zP71_fQczz!d{i#+(Cr`9%xzduGg?Db>DG6ctcd}1YKwk(b-w3UyG%lmno(e0lA?}3 zKgPXO({^FXh03ak0Hh_a&RG+Nw1nlic=x?Kv1*C&|V|xE1$U5SF zdi-|VB3)sqzqV&TYlQv?AM~EJOXZOg!y9KzcXWGCpc#TkXYIsbou7}WOhC285x*HP z@D=7XI<8&s9(*gN7-r8lT<*O|R-w5DjwOXCzub?K98?h#O7o6G#=V-mFb2jf{QqKr z>HenxY!jL*pRHop5jm6@K{x9!SO7tpWJOmJy`lTiiRK|Uli^uJwDd=L)7izEbyF}+ ze6cSUVSk*-jd_rxKnotSR9*?t91oP$a`;qAKCdj02~uFe+u}YW`fGU|OiYX-@8C_T zTltYh`MO7eVY{u${d`a0Lu5nwy0|2n&90j}%Pyb>qbr*>M`jnCnDSXq;-;IAeS_GR z;8@PJY>-g3pC$7eSRKgp;W3z7toSy}_tEtU(l0%+Bpcu_6Uc)^(H&wC(0R+&(N<}|N z9w#b~x29p&*(`hdS^@ybkI}#`ft6Y8v2GEE#U^o;#GJV3j=PJWgu1mwZ-Pw^;ayTm z)X~&`@@gil#0P=Dv3by1a;cwxUjz8cGG(@K?Z-|@{TwPW#F5Ym^6w0UJiaxmqY8Ta zaQf*HlWhe7@WFHRj7)Qk7y1rc;=Xb^X@nmwS^%4EcSC@iduc38)n}OjE^^>I2011@K5OhnmBOE8 z--@XGteZYut7sEA>YfYWFQ~`n*q^Wb0fu}_5L*w(Eu#|t)pf+f3MD+r`rfZX8u-J#GG(g#ZzK_ zs#KEO4+_>`Sn$CPcnY`JbWu+J1_pxCUCJA~HR0oQv2`}T1QU#%_^EAmziB;d1X<=C z^6hZ89w?e?629@$w%|2yO*Rzsve{K)!dwb0E1F1{3t0&EOqIL6Vp~u^vIHR=#F!5FyH#em z)FjV38z~*|$*K6D_xH6Vb-x%LUaiC)Ju0$Y0~53WivDdT1~}-QkbR`kKG18SzrF<3 z2{aJGSb!A4S0@ZIfcS{MKNct;S2M+USyNr8KMo1WyE--{&2+-7)&{w!6hM&5cJZ#i z>;?Z~i&lGLl)QtzwH_an#?p|6-x5@XEWg*sYFW`&^5UoYw+6Zj0RZ5)ND~<@LHyLi z5q=rH?-!;iY4f4X%(>NX2Up`b)d6o2IM@nAUZzW}z`#?1w=yOYd!Q|dc<$edq>3u1 z48)d!G2e$+Mv^8ZEXWT1D+~=olno#fLa}gIqhIO$ ze0JN|BKz@~G{Uq#%~~!m6qb09EM%K#p5D*z3gD>FoZFO?ZNHA{9|wix?|-u@Y+>~{ zT;yQ1EKTC-{R>W@)O%~Niu8XBPn7>e|6z|R#;gvXhbQ z0R1rGWk`TDb}Dkdh0!l?yW#LsvGM6tRvZ9k(Fr7gat9!g3`fmOLomA>7y#3co}a2# z_idf~yOe2O4VioyOajRH0))G>U};sp($cVHvp9V^#W>YWJ-7l)kXIr8zPHM3isA#B z@d@q74cB_pLECS$Wp?M?NL|C%y&w{MmYl*fRvb!TeoU7{IZA{oBg1u27~% zz=zC~sKL6Z)N2Cteb&r{O3E4CKG;+P>-)nk7Z3f;`{GLy0%HBNhAJxx5nKInq3p{T zUsW`30&~oNhNeg`D!$(AD=!IJY?CM^F*S&<#OrBmA=8x6e1yc92u3pD7a2-yVy_Lu z8GsXHIdmA7GE-WRye3`1U%vSPfklc!88x?IbV;To4XspCy^wr^eO2>o0oOpg zI0w=k;5$9sV6lMz9*>un-B1G#2)PXH=PctpcO8d**j(FNuk>0O$Ky&{C8HoPoLb*3#*@O#vXn1@>GOk9kO&e=?W5)*#RTca zPQ{3j2>*~!FoQV>x{~gahgVQNr8%JgASWFg-f+d(HyTV0&LW9A*WtZ_l$plK{0^Cn z|AjE5vIMj|hwf2#O+nW=5()AvWB?zoZ&_IQ)s>Z&QDVxBcmq;NTs?VIN;7(gjp1(D z#{oiIr}^njrft+~3#Q>DQuo;8(?-{QkFDjpO<{46EAFD4QKj-i3JGRZ^BnHBMicG$ zku!49E9?_a{(=Goqs@dh7G6<*&1s> z(*k}`$l?e2w%x5_>2)c9`~(PyE7vq8L5SsC5~$`AQHG1v;QaMoK4y#-B&6tG#-U6 zo>HBO>kP>vqXZg^R5)R1I{-8Ram3x11DXv%k~yyXyi4j%`P$xOprHry2Hao*)*eAch3?PX=8+R zydD>`d5rf5UY(yj;Y`y<+BAzBTI>FNmo8G!ptp3nkn1Q&o=WrPBevMF74N40b#2w2 zr)+tek9Yu=BM2{|kXI_dH&3(5=*j}q)_vPZ!p+(?mm*SIaIbJIjmI7 z81W@WS56mdM6@@EAjQY61L-&Ir(Wu>k{cCKh)azx~(2k8cRz6%PmiLGix zio2M9$=vX?AyFpp?AnGB?3fzAQdH420bQdhPWUiwL;i)=ghBw6;01*4HgnQGq58@M~~nd_J2(o0>phA4uhBWX4=$m5h` zjwpU}SQ*0nu;K*(aY)Bods|nO6bhOiC{hYd0F+G93es@!{&@>A6awu{q}la_ZQ^VE ztN7N4Z%g4VD=IJ5^I968a@Xe1*_mwdKcqmFJ#)AW*6+MG6tpZWUHE@jV@SZJb=H*E z$aht>2^r8F{B$YN*qNk<3IEvpCDl3M9*B zWy?OyOVgIQyqtQz!A(otawP6`pPx|#B*qkyEa(;)Z6fN99>{a&qf5eWSBJ8OpBNDu z+?w1fwhAk2dPXWNc;RFAU#rZ2^EX3P<#R>v@&%&~t8<&2@VeY0Sk;sg%pp%b763g4)G!HRu8mh^8Vh&52QVRZpaqW& z#A1e$*2Rp_NFzeGVBrIz;1e5Yq>=k{R*w_NOw$BSphLs21DI2dAqkjLrsGm9H$I>C z?dW`Y;A%C+9i!1+vqEz=vj1Eaem1ey&48W{+zW=e5A;HlNtSJnh%+R+EDS`hp$@RaFW8DNHBL=? z2kNSciqcs;1f%%F zNWcReNBv6f+*Q1CYX-o*QCXUCO@%p=P5zno^~8#gdw~LJwnnkW(R+-w@b0x#FGL>) zMc$z7Y6zsY*M3`8^=v(eSUGHo*5Cww$KCOB{oLv91`k=`=uK>$w}tJ8yIC~E_Gqb& znYC9uz+S)XqZrnSHu|n74x#0$FdOneMumYce5pEZ2lCo)^0LJL*ga_)EbHlIaYQiF z4R!v{s7$X4OYG4EWkouo&=okkY;rhH#=Y4SMFRyX#eYaIHYv%q^>|E^03N+b+V2v3 znt-F~2r(>;K4DAf2FQF?=t>wf_`HVE6L|6{h0#DB&}Ho(zx6_F!mNCrsz5gPbSrRW zMs;6#goV4SJY{IMCOw=s_@Z4mZpU()#~U`jDcKf|_LooUpk?_GeXyyNfB?8Y1cvfr z4w}8g{AMm(t`E;PUhj3-&{&nW_(t#VFCG)1;EJ#{Cr@dXbggi`n^?oo4vt*qPSI5% zDD^#~PAJ9&+7-Cl4QFnr&VYV^<$r!4|1w3rqt5d~VpFsYsOw{iyvyq|U-ffA^q(tE)2<0yP99qsGuPmDtUTao;=$;GZUIqyC11B{6 z6XJYVF+xfyCQb%J-*r{`wUML2?6tC!8S#vWpNUP&}h8<-J@JMSm?$v-Nq)TNko*Yf>KX#fpFpaH#KQ$M^CU;4CBOh&gf z>Gr5=gWwolaDn~JyRScG*Qa8|mFa24kqf1d@C~2p%Z15LKiu7v9-)GF(YY3y6|i0D zdw!o8jn4#)1w?mJ>CdS*YobnT)6QOR(Zv(%NiOlKH&S6q=kh?jLyx8F+$F1r8dA$p z?If?0#s8)64fPG*DyJ^JVVqAV%|tD#RZp_qEKV;g?dy1zUiQG7Z}ZfOkmxW# z_y7bAEKY5b_iSQVL5#2epTXB=+SQULx`Y?kLfNn(w`yA~oH$0pz=faoQluT-{XmtF6sxI6xo_hJyitlT6GAO%C z8~=eqCh&i;(rdljm_fPuw+Z4LQ~*Q0MC6*73m#6qEoxCk+AB*B7?rM+1maZ3`AD=O z&=>#>U(s20ImUX7qJ~{G3^Qk2CYDQ%rz%GNro#YcxV^U<(5+umN>&Z;`t zJ)Yx8y(WHL!9BIQbn38GG1EjB+dPF!;|kSPAU6;ZAdi4wxw< z$cdd8&1HAZML}+0JScYVp${0P4=)fK^N;(XVY%tYthd+kz7D%O$xOOtJ9m?ez06$n z$5!-TUt-ZpHsNxtHm>~&StlR)tv)u5*eyY`v7kp7Jv;n=aH<|?Kgu*_nkr2T7HrUT zYS_e%*pUD6e%qTA=T4~V{Y_kniU{*#KZpG6U@iU-=x1b-qu*Bp@IQ}QV~|h9a)=m$ z0Q~;(DXpHCqJA-hy9@v%ffOr~Q^Bo|2s*Gq_>);?`rrfVA>bA(DjLFmb7Uv_iNha) zs*{nR2WW`*m5I5>LwbJ=kVwu_!9V_mfAaL**IQwM;Q7vTYLyRAa@P=X!LIq6Aq+-| z^U6=&#E-Xfk7#Sk1=vZI3kjg1iOOgsr2$SVxd%eiF;Dg@bNjD9xHi{eLJWlQ`UEUn zaQnby{Dnt-(uxZdsca(2sz|e@vC#m4mw{RYGGM69J8|)nhzRS49`3T|e7tz^#tm2% z{Bqo7c$x)xP2_TmmHt_V+}D&zX)D-xSD+N#{R-0$C<@u5o-^&cq|Y~_Y#H;s|J%%N zc9#hp#O=#6$lVuWt|+gc7>(=Qx4qP1`>4wBk@&mPPqy3v+@|YUS3r-mnzi+;6D`x) zUd-%RC%Q`jNExS$GbREcDacowCC^Gjz!3K(-tQVFM{A>vwIv!V=8Ar_z6TxHkZWb; z+BcWw1eEghkl*{I2|$6ghJ`l8QFgx(T;*R}yJ1`5Oa~|Ip7>Bpymz$)xh{9MQ2)!U zc|Fux2YMmF{J>fe>ze*6=cMk7jbD%^Spot?nYtPg*@u%W8nxRJe@Kc;qT>8(;b3%} z_BYrAW|z$7FH!}*!dP3Keoa+1CYx`6nP}Ryee2iqpGP8yI6W-dZL+gs8vHbPP5oNW z28R)*ZeBSvmg}`^3n$PdG~Td3Qg&<=!8EgF9!${z{L8WX%LiTO5E6Oheu2L0@rN4@ zVitNK8lF#1|L4&@X?44__-22;@#WlJ>|l-qK5UeZ7%dGHrhpFp3+_4!7(|~eV1Z?O zGGa9L#{oTB*OnK{8$B;Ehcv)gIIp5fUP!WuVMIEj$Tn^EsR$+$RTJ+Hho7_wNcC&z zeDqs^oywV0aZ^y!V3C&`HxLq104x6>GLqIMO@tQK9tUt?UliO${~8AJb40a z8Uz5{KYlwU2k&{BKUhVY1l*w~-hV%_w0uWX62pza=74nhK3#_?I+D z{i2=<`0(kZ8YHD2$`y;WU_n_{h#XngF z{^f(O)2$aF-O4~L@HZ|4wHVoc)URsN2msug<~vUHFntonv4pS5V7w2aN0NThI&=vY z6n*3rN;BqWqHfseI||Y74Kr6NoJ06Vm+a9?(mrlUh*E)oK#f53{awrAnenbe{hfW$ z*wm3NVI{Pq8(Zg&Ze{!|vFFs)^m6r1p=2Tu+-;Z=~YWbfN-S zP*{Uun3v6&$bZr{O=YzmR)tj5u$3ZejZT%y6F>e}S0E$$4xMzwJPk(E4qAZsB$&s| zP))8^NouD3HM##S0w;GpU-Cg~Hjd;g#P1d&2nKGq`@mzdYb)mC*3N7#=;8;Fk{AE? z{_-{&*eR$q8z2XDuh7(?gW0%bRWOtcMVP!ao-1BqC2sf|azv^?4vL=?iGf{XX~h)H zDW>-Be8N?5wrXm|_gCyyTsW$TfKqC9Cp|S#{F5#A9yi`hY<66KRs(4SjED2;Q8xA+ z6#;KFgEkWik7qD7Z4X#C^(85x1?ME>OzwdI^zZ}wO`|@(IJsWSh%FR(=AWfiI4u^%73*&(Wn7w8}QyPC$j%o=j=*jC(s)rIg$|OGMu`s$xfUPSD)KWq+zSGPSfg<50jekjHEgS=~xLN^2OhkOwn ze+$lrQdl@a5tG`A^0tBK#u$d!p|T{!qFA; zGKiwh_i2`eI=#eE(;97m?TW$1uJiye$%>^-(kJ0BgdSBGw*y! z=rGI8u|HmQ<}~inD;qE>tY$DYKd=P-`IB}MD6cvSix%Mt|CK({>GKh`VepcKg)uVQ zi;^~iTMc7xCtl2J(TplmDkdfBgh-z`ZMruL<7GmhzI;R%)j%zt|CZv;>szr}MQDfX zORc_ZOX%^uM_9kq&E)o|YFO=IZ~gY0cG9s`M@#;lga5k{JFttKc*keKl8=1*udDnx zO%|~~KJbO?G$ccW?l1G=!Kwo#Envcs66W5nE=NTATrZR)sR9{+Hr9b0e^lP0qd6cqp+}6X@4g6RN89Z6<)#fy61=a zb`UfF1N}1SqfiR*Z4^L^)$i05bLg`Nh$fqpp^n_V3}9Y_BHTfvt#A&HE9^Ntu^MK7 zp5<)M5pl|y^*1B(1ROUAIzAkmDW%)GNW|`!p!Uhi+)P$i(G*l)LVk#S~ zZ0@f*myHMm?d-ga$xWQCv9I2iP0J*i)3^KCFfSW6J$z7)SByYC$bO6X8ME@-> z$jxHR%GsCgaKst8E}w@Nq8oSd=jY}gvN_W`W(r-@sZ}w?cXkMRA3V;3x5eHS+h;^` z6nZ9QnTWZuCetX++k>|8J*`y|lH)Y@#>^yG7(TF{AdsV~WV58iiM_)8BGTd<bfv)rSwya8O`fPa$D$c_MR=4q`uD8GanE()j+_Ku3$dk4rAt zG-e1|eI3!?TvM6&W@S-)P5^FE4Lpy* zRg8k|R51nmykKrP3YbOi^kBW`i^GR_`uTSdEwze*8R@ z)hms@&x8xr%&VFVLh2rQs^C@Xma{u;+O%rdK?;Tm*^mJzDnGD0)7AN?YqW0HtFYus zD-Ivm-A{YxA|rv$3+R`Qql^uc0SU(r>O+8$bnx4Ju?%;s;C=lRKYNe(HSx*?LjpZ0 z008t(j0+RkE`))9155omhR!b1B*VMuCB!5!C5ivc^3Bo*k_KFuKL%WUt!uaRW@wVsmhv)4;I;Wf1N>|a zw8I^4ohIrm-|&-o9Nw7|4{esEa595g-cT5jBK-((o%iv+gZ438y5czlF(I*KxlsmG$j${67YnU9?IbD&%ppB zHyB;*gADpj4E=PK+dTja`2BZ6+Rir+2kA0A$Ql9_9K;_B8vqgmP-76{M}ip^!Wvi` zEDUTqTs(M5!2Ca+@eHgSZE1YJb!H$1ik(uieDF7n&pm2OOlNN;Y(g$QF?wETv+dktPg13?NLS-xo>1#>oHyFtUJ0@V^;+q?W}U=$+qh7UgIvO|WzB zuXAkyoWv^WbJOPtsBKaf zD&*;Q5)qdyg?6!IxHKc?=zi5)`;}_WWmCod;*PMaHeMzJ#Bu45T~pz+>ss@aFO`&i zljX0FIziaAwPr^d-vsVK{VD)G{g7aYk(VrwV`}rv?h{5(sjIrBhwsKnHPe~r-kWn9 zsJyFqgF^d8);#fx&YXqD=;NVz6xh0i_Kb92y*2aKI;7SkO0gJd{uWt4cX3r~14F zkJ1!;VrO~rGi&XL?Lb~A+8HD~k0Q!gDS53+yTx*IE9}~p0i5v!oV&|y$lpWMsq>(H zu*%frD;0#{lf(ESp%Ua_zIkubT8UR;L5l8ib2y zMR1Q8^?$0)h=UjK2piBLbgPaW{xHh*nxjvx3QnL3&+C^TSjEBtSosd!^~W?29@WbV ziH}->v;YWbA~e%*rR|PS?2c7AX7K`MohDwBgbFyf#OTY`JM$>(8b_f?5zqOW%?3_k ztT4j>0LnR#3upjy(?X(Spudh7MaxI=MR3tcaMc=I?g~+w4ZG8X3G9T)aoPldesY=# zbD#-zq?B2@j+WZlW7kkV)Q30E@s{=)<08w%bft@$m5Sn$^{?jT0+ZU*G!sMZ=DO(% zzrX~Qq?{|$MrujLLQx9}Nn&|oU=22i>nI8-5Gp^d_uZ|WAae%IGczf_u*{DkJ`G={%$@2Txv#G*HAR$uP7+!K#Leu~A$h3|@HX=D>* z$kP<2O@|D>go3_@=VjQ7x?!>J_hjKd?^}p>1^Ch?TEmes zY@sD%ehq$<7wPbM-du}rg*U~~9s3|r7zOJc;vzkQHlX(CfWq=agVmrYFojNnFwjiy zw9M+)yXaFcq}M?zbvW3*t&?j0PO#x#W?F0%zOx;X8Pl#S6zd&Q*Oona-9`7{+NWEY z&A&ejpgnD86X8^>r0-aGblwT*URJoL`cQj*p9DT%;NUMR5UWjcRSwGn@SO?fk9RV= zf=})AUVWgiI)P^xsJYiD)N;_bk*vO~hDkTRJ3%u8_`>OD=#nq}JYqx)i9#YJ*wx{wIAA!c9%_jE}1v4#NeK zR0VLjjTQRD&rlY~cRe()VF-?NXb*q^WbzAW?}WZknSum)&iPu#_{ZFmR=dw@nq|~( z&c(B8!kzV)?ZpS%QO5RV-hFVzl@Y{aGKoj`1m{pQY4b;^mhOkvfXrztT4Af?q*X9?7vW0VLZQOyK1`h5c39Z+*GLSH%?>bqGCBn)uVIpCWw zG=L#SbR4CBj2)ljIyS&c=&YTruqc6=>r>B7sGWwAPPf7`48v7n46F&`5@n}>Elk@J z?La#5^{9&-DT0rQ@HcrGJX#LlzRcSwj@KpZ6aiSz5r7x}aduG2JWVL|*~B+bOqw&y z4pnHA<$2&CJ=AP+7Up}k#pt&Ps&I$jivN-arX4fdHtCIaOSm%p>nbxwe$ziZ9G^P+ z)4BerjYJ`8 z>9s?x>AfE*E$R)(VRN*$dz2j+sIAInTXag^O1lg{0c{R<5XEtgC1ss+!S_|bMQ4x6 zX};4-4K}C#!)d(NdDD3dGTwSz81;==rb{}mBMka`fI?#vBnVFrx8ZOEj!TSMcTe)( zR|yfO0-A_9%Rh{YfH1V(Sx?a}vsMfHUXddC5vJU1wWc!}kOf2Yp} z@IUL7u3d{&{PyQ@Ye4FyfLZOpL2Uek2BjsqB<;~2==tQH+BzK?pdJ+VtFETm&Le0I zqqMDv#Rwjs((#*i$|HhAV^svv2eQ<)o;faZZN8&}LKN>eutz(;Ey{{CecNQUGm8@@ zBa6*y#6~zgIw^2~Wm`GR=Pt&|UlWCI`;?M+1-zc--JCd(b_ z=tf_mgIrVk%2j7~Rz-}kWP}C-tfGHbQcJy0q@HAO7%jdAd53&mpu57sE>6u+gy-R= z|EnY^P_56pkFP_l9UXql#3wAe-HMK6v^ANydOvMa#qT;hZ|@jt6$!YF5d(dO?h!+* z@FvJisbcP3LY05(F!4vD+f4`9!(;Ly!6AWT zRzfEbLwtA*`kFJYVLwSHJpDhCt|}~!t=Ts27Th5u5Fog_LvVL@cXvo|O>lP!?(V_e z-CYKE=g#@>Lp{xW(>>j_YgesRdsR;i(ogTm)jr+dEo{DhEt_w*9#_dPtJr?EAfuR} zQb(4rpgP57A9ppf>%Gw|v? zKf2G`Z-c_;$gF!-d8Y%rTO4W2o>liF3sXy8+MDR3bC&t|NbB0m8-lMp&q~aHFIEof**pKLKLj|(#~$&UGENBYf`e8>f&F@ zGgzMRGoa)fR@~#~@NGJ%4H6C=iSyNVY9mUkJ61Xv&}Ze%06CNBRa^c>PG#Sof^s}G zJDr);(aZ0?pkMVVxcT!{8`jD${h6%b8&xit(z^=-mk-?(`8!rXJNRBiBzX1DE2}y; zQhf}W0=RnlB5|Lz>)X=sn*z(A+>E|3k2=b2w|gE*>vxnK=Zalyu#pw%BZKjk=l}J! zjmSrxJFTw3wBbfg7jQx4Tn7Y9ZJ3Pt8!u+~N1ytv*5V~=^eQLwHlTI$0~e6pduUWt zz2Ot0Uae#k1_}g$EGd5=Ka-CB%_Rte#|xFbB)5zp>K>|DJqvxGKh%ej05MEpKNxCG zfpretDS$D?)TcU+-ZvK!fikC0pNqcfG?sCs3~zAr7tgQbRs@NaWr#OScI6vvZhNLz z8Yx>v>uSA!H0pj6DUx;8^r@h_f7g(AQ$bOdZ!dqVJYCk;C8oZm;&9WAn9(WxFcplY zn0dtv^J8|3O>PZ7%l77@B`~2G`ZO8F7=X5Q^_?(|%LKr42YmGAs1d&Jb5a=Lb3OK> zM7ogUv~zSOYgtPuCU_P82ihfQt<78|`QErsbcx`;a^iIaUS}!-UM}FK`#09~GkuDc zDEPkCiIuT-J2UbC6ckr~d4^d3kr8UrPl|BjPycde?D_XvCh~DYt%bpEFgJ56kwLao zukXHz4u&a#3|(c!^+R);2fuV@IpYOWEZEb)j(%H!?D!gWQw)v($e~&h8CG|FrMx(+ zNM%=GScW+gP2+mDn4?eDqie`e5^~0f{1dOAZi7Q4|gr zCr;?{TUSM_5~!ICew8fq9Tvl3=T_!l#1v1&^3k|d!Qq_V?##)$E`TH~udNgP`Z@O6dsqvuj zSL%=7QJ{62wnpb22Ae-3ICM&@Ok#>7h5Sy#WCv59(4$4?yuB!GLeTS__^gd;>7Hgb z@89i~`!?dqjyYuNPpCpMQylCyg_b{1d=1ZJNzk(U%rS~`8OqPps`|nEt=9jF=n1SCMS7aZI{48a~K(rw&(>yEE#HP$h5cIGy4wu@>C=eNggNuYd5uuyu= z4@ELm;5I0~O4e{R%=*@q_Vd#_Cx9*&ssCzn`vY6H`k?Wdpn*}$k}{6ZSF89PJfi{- zKqxv9<3@mBocxw!eLez)WUzWaL8t@~VtUC}!gF-S@QVw=B3)fRM^)h<`+ACeV76>d z;V!(zv0Y7WN488Ck5Na=)c=>iV(mjm9WmY`<)-GRdMcX|Vpu{)x!^s&a=1-^@JFAG zdKl~B=Ktl$CL>D|11`yTf1QtmS3i;KvYynFLI2w)7ykS)m$wf!<2G->M)THsfWF;owC@%xQ!S%NU+O9X!9e~VM)f< z`QbGWOs>CR1XUQc%ws*r@*JM?Zdn>_BGT-$HjSfs7$ya0Nbpd_fp|`sW`dvr)byl$ zJ^ihZW4Q9&#YBr6sDR^0qK1p>UBkuU4Q)j^s?2O+8`@!p&K_D3cMMUh@q8QR%NS}K z2AmIHF-IF3UhF+OGUaw)LK=X=!-U)Wc6tV1{!DSw%^ zRuAHP>1h2Gm;D-g3J=G&EfaNAY0?1MI8**#yH{K4(*%e6Bq>a|BbkaHP={&ZBOGVk z_b>D2Fz9wj+ufx(f7vgSwP5u36k*#zrOCf_1H17kX9#Ga&p9>7S-#fAuVPIT>%yV} zKP_lSFBcRuFL=>Gt=Qcgl>D1r6kW!TVGOFUpIaR?{Mg3}P6sLIV%$1#%#k1h!29KK ztVYo6bzK*6kB$Av@WTF4Mn+b@)om!`cUuD0UCx6@8==ErQ2;b=Yo4H4+`e*UU0 z)I~qRKmws)MAw_k4lgOc&)-N{c2!nJO3V8T8Hlv^xEnS76SnVW6a}k5lEX}exjiYu z42yPnSeXKoq}-j*BMKMxrQ4!oGnuip&%rk}=VdH~{|CjY^5$aav;G6u(l0ElW54;E`b z`d>{xO$?)r}FB#S~*eMGH;XU?tfd-eNj+X z0tJzUEKUgfDeN~qwJVPBr%^Jnj@i>Ei?-EdRvN6Ds(Q_zR)__88QT-h3i+Q9WLK0{ zKWv7qzZ$x-w;iJ|B)EwcXv<0qi^ng+PNuCDX@vNySsT&XgK3q75ca(F3IWJw@9C@- z-ybs`j1yJ7;$&0^QPq%LeiYUl;)3+9TyX-V3r-sG`tHWi(ePa@-W!KXc}Prcg6KdC zzK%E<13YDl58(528`^;4-#Z$6g?@sz($Z|6W=t#PFQqm?HNzKU;>EQEW?&GR4IneM zShN+loKkJ%YAU-JY^U!ey(ty;HJty4-`iHjTWc~}=#%gObDJroIGL)2mlwq zCAdTEj~Oz-M>*6D6Z6qoQunCs_K(N za;cUvxU@)NAS}6dLdSD^Pk)nHt#4at|8aRsvF{_juK5N3qel6t++@3hQI?^Cm&!o! zl=_dHeM$v@o>cy(L1tZkHODLmjY(^@q5PQ`0!k|lbDK33KK;|}69k2+dJR7AAN1Zf zt=dT8>VQCGDq(6=$GMVc41^WUFS@`Kr5yB5IcI*6Ae*YW&0q5J7=^a!$qcnFXl+#A zzr!dJW6ef8YJhgEcV1qGxVS4`8%g)GSlhuJ+@l+$s{Ml&KVKmSnb*r}KUznP^*Q2a zJq)Mmm6}xJbQv;yTX1>T_#K1%Gi^691RelIh9an9FsueYk`M*;Y7&~YxRAyp7WAiPG3l7TzDb_u@7Y?E;-UZ9iQkvi7g@QNAC6>l zbygVCW;%vD0gakq+=W!Sk*I-`Zyw*mTfZw7QDAeHtG^cczIu^h?W^8`UsZ>(k>T*ksobBn+Art^l5PnDcb1v^ zrx{8rt@nac3p2U~_Sp&kpFb!gX66dLyxdKd+d@)cS-=(HgT;6}JcL<0L$HR*-czk- z^hp`jf4u@|SsmmkV-NudIU|V_$mrfZ0c2QdQ8=2W2>BuyFQq9sYog_x1_f(PYwlkG z8oS@h*8{uyJ?;5zZ*3(VHVrX($dX}jotOHL(;GiCD&X6xdEE>?9Y3{OKlK{T;v-x7{FUMG3JKfi{0^DL}+ zR=Sb`GOuGC2I@63#IB8ZFVfnYP9LoUn;ZBo(}!90Eq1Slbp7m)&?Z5Y|{ zR^vE^nHM@IE$%CdiysP4___qlrpNwjr%Q}#9NzGH6{MD)_?3N?b@v6eAL?ST47@v< z`<=ZvE4wS#fsPjKZ#s02c}cl6Y@Q=+TL@8L-fmxh3czbg2}etJn-W^JYjP(uH)OJm z8Jt6&OAwrM<8A^(+W&sNDJ^v-me{FNxW4+;? zJ1CItsYM|vZ*6k1OoH25RQTfZ0==++0=CRqrQVT48r98?dK*DoHfZMg3oSjjvCcwO z$IY42#}bm&*-w&Q=g|o$dm`yt1>5B*i&l+mL{s1FzKkzIEkVmRhzh2bA_G1NJpx8M zA7TFY`z9@X^tkS?qtfm_pGbg^pN;|H6l1M1Vb49g?)?bgsB;u%td8|hS3G*{_4b(b zt@v+r?n{fgrKFQY=ceNRV#p_Nt?=0_4&I!;ToXRs(Fu*LwT+#m`mWjYCw7=w+n1mK zYHIjz>T`G^VsKX0RqNONnNQJ+Y^~fAgC0oib5$Q->RLD|dP(A?)ECp&qy40yx($+i zLowybX$$j*^Vq@jdnFRt7YGM=l!@?%jufWyUL#TnGTu|@gj{E$^J18&ULSLJXv7Mt zDmhwzCehrQy8OnvER!zp&GzO}e^Amdas5{8zTly{T>3VMhP?`5;9D`h{z>Jg5#v=m zI*7nLmvd#8*l(MVmSx?Z^;mcS3NT5DDQ@*;Y`ju`fLY;4>_`Xu$-?I z!tIEA;@jo&!`$KGf!D(#%*ulM{Kl*H%b}Bu@EGnxi{gp=MkDK&8yzIJw*+rq`HliUy;#4Jer*FAA{W+)XQ2_drLXWMr#>LKE!=4##f(6Yyit6UxmqG25n@wwJh#m1_DHrcTCkvI}i73YM zhWn=qyW4O52g8E9m>}L&{|}mnxdurgV{mUZ*uPf$?py9jB_dEdEQ#F+RlN2pyJOYW zO5zEkx|j_@wMBN7)zk)5p0|0Rw5ikt5E??}j(Xi;8?(+m^-i6&a3$uZM4Dc*v-!k| za&p13gg=|6_K?t9%67k06E()_qmsNB0`RjCYep zknO*S6pgygQ1q;I2Zm&QJcB|?QMy`h3LHLTHgR{|lxUy1@Pg||sublc!K|~Nqr;RP zPr1eoZj{^Uei;*mV-ukQZ*DwnSOfx;zm>BLvd;33_Xd1|w_^x+*oZQSt(JxZ4XCFH zU77PYT6iCJG^&b0H3Hu0nFNSX0ku9by_iGGsndew8>)PdkyR?@-0lk;T_AtkP-e3= z|LXYOccnZIt77fZBrzmMuBYx&xE+85_VRK!b5l=+=9mX!16cud>Wi=kQ%w?d2Q6q# zRw91u9_v$=&4vcSS`Ze>dh=~)==Z|c6dKu63&4R$43W2UCO!`cGcKnV4uWS{44BG8 zf*}Ra@pt7%_60nk02Ut6c1#73kOAWz5TFD-zJ}}&Ar$N5a3%5nB=UII;701F7eMef#BBLSO{cSlA z|Ih~qR#;W$n#?grS&&DqwDd$E^|;Mb-_n!P(DeT&Gm53b(j$Q!Yi0pSL}~GPzk8Y> zrFY-lyr5FtMq1PIGJWD-nOm<|ny&t7iO5qsFUBq8q zzV9dj8rsIUa%ikTcSTN@L*&JLI;rGBaU}2IsI7bP5*#24K|qUZ0dx;=JD-m8$Cl)L zJe|E)?0fk&W8a=tR8qte(^NihPaAo+DD3902a6#qL?q6dAvecX5MuP12xBa}Lvp3(pQ#Da^pfEmf8ysu_oXrl zMkzAJF@8fBrw)kQBZI+>YwZ)ctK6H)qVqn`#k}LXN(bq>MsMJ(F4#)tCL)YNls7Jy zKo#xxVEa8|JaV!$QbVl@*9^tHx+y3dQ= zjMt;=PW@Ge0^AvDV-k7Tje0ibEZpAe^IcX{zf7t*|E>k5G8d+c+fGlkwa0E|q%Aea z@XF_MumBPb5dUjOZ+{}6C2=ZWOdKqj3MwH6&UN;&limdCGUKkSzZ!xMz`BC{G4}8G6@_~SU*4~K z%S1-)UYGaoU#DvD0O({Le;2nL2q5t5A{tDRj({@xy{9c_dL)Np?qcehQ|fQ{{5&f z9QnjQINXmWdSDacGE?Fa18OjG)F!=(ESeU}umqN4HeB4&IVRlJf{4l>TdjW6Wv+AD z1Lj@)HqkMduI?C?%}L ztaiT0c~fSX=MhVRDq?z8ceM4gT8;TVN_**@SBTf_aOy7Hb;JW~h*h=#78n2;p9q=) zegOg&1~N%^kO0CKk3SScsn3pQ{H|y-fW#a{}EfYKP$q8`g$+Va$ynsH}}rf?Bg!Fvd6tXO@y9}LqLGQ zx0vK(r+P$B(fIb1$R&+*L)|8u#ERFedMV*s^`gSmhi${lkxrDvSSHwm02Z$0=@IFE zuEG+eFqgp?9N?0@;y8=MLPm+cDMrunA+YDL%TE@(rRWl!-OIs#9@(dd5M<&)Px00H z8b7#HlFPz>;3G-wQ3(T#8Mx9o^{<f6s3wkLAm3hR2@ops>4B?z~> z%CN$%^IU;=fXksQiSK8_4S`YYA$Ep@ss(>TG}HsXgJ9P(foatSDtOHtI{ah zor$ytHXf>45^ydIL8T()!1s}9v&eQM?g0!>0&-KqgUHALNl_t{=@h(sk3<|xbe^dx zfD2$HEbnn3S|FfbU;~F3bAzaG2?#0ln{R@~0djG9OaXDwUu+dVRmUTm{oIm5we@T~ z4PHL}{{D|=U8I9L+me&N8U0JOJlAEdkdPZXlmZeI6XOXU7KOO37Ow9uRn>s}A4<7I zs!q;3>%~#gwlL48o+UnmFKAm%6;_^@e%IZloB=Fp!vDPAEgz;tSQ*LeLS&camcBfI#L?xaoZYCqS4o(UJ#A3P1@l-FNyw|Dg#AT7O`mHsOxAX z+y2e{uAh5cDd1N*%@h2t|^Bb>?#LJ+V*qAN6G8BI=zKvn>B`f3EPcyIT+36+#*0T@3k&rc$?~ zTL~Q!mtn;cb+0rCG7mA4Y{cdfKRjIX0ejD;)DY06ApL_U=CT%4mRYnCp$MCZGfVd! zbg7vG8`Or+6(nQK5O6Pb4T1+ zTxH9MdHDPqA*X+Jb?#R7anTg39xcO;%*R^l+ZH-V7_`x*LlC4FLBFc-D`BQ{p-f!9 zDSLua$3Pa?LY!BVp{lTO#t}s}b8^a8-p^E3|5&Nf+3YEm8N3gE3jBrgpZ%KjMKPKLV}CBJvE{#lk| zlnb-9gyO_Uu?_K(2+;{IdA9Omc!+PBqyvop^K+#fX zFJ$FCX(ccHcd@DT9v9b}HyJUrZhV`RxSa%88_%WU4IF~;^!F~4w((?#APZCu%H0;| zBtKzpNlF22OVc zj+>QyWLDRX*`+f(wB3eS>8_IM476Ou%}4GlN*YHx{qKt!s%DH+taxe0RuZciUTS?- ztkM#h67}$%Nuk%^qzP^_!G%%RX4Ym(-SYE4(39#Sdxl?PJV&p>77uO<>c?uh#yHWUlrlF3|3Zh1cRw!5utRY% z&XBRQDMEZOl@W3+78#F?SGXtG z?^4UT0?I5uV)WULKhT81u_HqGzQzd&+-r21pHAJ}8Mpbh*R!&tOSWI-v%M!Z^wtrE zJg-znynqeLqZeG4D8uRhC0)OZ|5_+2Z(}n#OY0+B7Ait(f0n+hoF$~WkryxTDSiAW z;t&;xf0In$A#)xx+rC1xF7`2|{0U=bZS-z;x7WU3(x&XP6Tk8J51ZhmkCO2?9EK4K zj~xp$hgBxM8+PluRdMkR@3K4JKpaC<(uiI#SAkj(fWi7qM8O@IX zrzekhHsheM^OD}7uIWLNC(wH+fAxb=tR%c6iLa@Ir9u1P{<16^IIF`ahsJV(sHKJv z&dD|4PH9~w4CsxJF|Ap!n`PBm5l5kR;?a^o?j97iTUa5gLJfp7K*NB+JB8aK|6NE$ z!*9|4Nd&5Z%HO=Y$WlMsZfMuOLj@+sYCuaaepa0lBpP*9MQqUxqaxrz419qg;V+{s zJ#UH~`qWlu@iuHl)2aVf1!_e0vs?YDit?y---x3=h=z)*{(5O)dF-zb;$LH~DES7w z9{w>}2cwzl$B(M>;;-SxUy1N%=e;Fd4DM&jV~M`AlgJ&VISt;M*0-%Om&H33URkS2 zPe)OUM+aV!koIb#auS$~DT++PcG2i4U!1J0Xj`q;(s|qFb?Ye$`P($KosKZ>?8GbV zvL=jHj2p<#$f1TH^%DP)dNK9Bm-!mH5wc&L0Wu8%-KY|7Y+~p-n=ej>k~Gf_7q_QY z>Mx9;vY8QKmeYwYen^>noayRHka}%p%DK&DAN%DW_=FNvS}5lw5Fz7Ac>hbhr;Z_d zI9A$#1mtC3xF(&w%hELBPL0rv5i!08lu;o@DliGAF8P%LFvu2oxLkr<8A)hCxHuRs z5OaVJAtBh^10_DzRj&Nc-$sVZ3gOA=jkU8HFn5&=CP3!D`t?1EdDfFrYtnxaa0h)7 zwoyReLZ?Rjw~Y=@jt++pk74}ku5d?$_7z&;sQe%L8`fhFC<35D_yJC6MXkbmdJ}um zjc@6+h6RB6cG{>H>3jjL07bo1R zm!IkB5!faIx=d{^ma>X_!LO}x$@r~plZTV^@q4#vI1d#Qb z!X!- z$z*`h3-vR(hd$sHKsJKTH30UE%{XNBi!MGn8A2wgZo!cZqxV95>xYKR88h*KRO5n7 z&iM^1^6R&eS-PevRWGL51dZvEK|#0_D$`7(?aE4iot-W2HNI{XgXM_P=t0vC+)$l3 z8HWh1*%wJiq?%_wZ3%Ei`MB#p`_S;9YSZmggXJ9;xMM&Gh*)ms4gE!Ip0uWr%A{|p zCBA}}T5*_vW;tA0&0k8s#)Yc|ACWIFCHXm;a+SM5GU0XeRzeoB!kE8NZoaK~o9Do~ z&-2O9yL>CS(1!M8TvIkzxzl~QSJU3{3urbqu5c~n%rcsCqOqiyo{Pr+JH~WL-fH=s z886+Rcr`32Ab}{6FDdNEW!g4q-P2y172?;#5voqE^>+<|iD#jR3U2)sD|oXBt0Mt=3A!3@ zK~9K#5cyS&w5MrO8Xd<=ZX}MiTj1YJL4U=5`SsJ+WmoM_{v8!JMzI$a{)9b$45OPUq9v=LmKE8>e}UTi+W{%ywef z7kfzE6O!yebPcv(leK%9joz@0>|NmcNN;KAC$d8*ovxgFOi2E((8&fFhu_ExN3)=> zJ_d@E{9>pFDQ%oQzbApxH*U5Th7*6dl;k{TKMSbu{SVNvd8;~2^|M*r{Qzm{-;DGe zwR*?Ux;qSnrq`?sSbnGUG6uG6b=a_RT>L+JqO)2HDQaBZN!2%oqR^s-eFe%GqKK+s z0sG$Tc*u|z98G5ld7r_DPvDHU;GM>_rh9_RpMf+mt>W?TPU}#y?)(%bw)g+?dMyXl#Doz@cU?=_27 zWS=fqj8qx(VGi@_e&IU*7;5cr+E1M< z%lD49YRAxDS2Gk{!Sgy=1`F5azjZRBV0J=ZdsiYWP;K?52@IW+Rua5l<4&zuT@Hl)bZ47jKdrsPt<$Nvb2d~fnP@z_i zxPD2?P;oq9-W5HyL~&niH}AKOH%_O2dlp>prf9Px7xS7nxA!!8lz>w!&;x1bM#jJZ z8)DNF18@uW>Aq`6EE21j+Obvhp57;RIonOlHLI&lq3o=xI=Zx1|E?DLZiubTV`rnh zFjbrASMZx_w+p8D-n{hRx+%Qb{&=^sj?X|2Z}y>V{z00-(Z58{=7G%s2G3wk+DJ7%d{!@g;dCk5&CO^qqN zA9v^7vHTxee*1(Xa=Jx*YJDQhvM6R3=IkC1q=a?87n(L_t{5Zl#JtrjCpzdV%c1vs z$;5=SiV`Ah&??uJVwJ{SH3REcvvO^edfgk`n`4EVAD31S8?@HZ+qf@htrG>9B(&Y} zbT!!Zf2RnTKRtYB=HaiNqj|ackZyW(vjH{4c5-j^!Pc&*y9~(tnO^OiCy!0? zYx|X2j4~nnSmJF)t-r4TL5JgLxP0}sb-uTyouey_M(`PWiYi{OLRyt%#<%J3*4l|m zy%1nl2OJgNYCDJ0c)a9@W-*6d+81#A?`m8t9oAEhBh6BYYiB9mm7E-WJeSkNpr*?< zSn{Dk?Fy6}8&?AQC+|Jx_HNhI_KUmzIBSRCy=KGaO;jdfQ5;9<22cf#&(G)rN|vL4dVI3%AP|I;+LP? z6wN9Sb%(vElyA}A2H(@Sj&Ow+>s==K?H=J?)T2ArI&kpN%*#Wz$WltC;>(*Poc{z4 z-f!p-(6$qGv{dZ)9D(C$x$N1IwkdQ)LNOEPmWecp_ZLFvxL|`1cXwO6_cIiEEfkhA zO|P!^6_nsC6)5=AN+e_gLwN!qL#0PO;xI4x-KAmzTlcrZF5RI{nFx5eNUA2Wu;_eR zvl%n8qNt(Sn5OG_Y7lw%@I1NdAwfuUHfc}NHEvH`jdZ9a;eaTZ2gk^1PB-Ox{3Wgo7{k#Cy(S3TnESZ6QMVynK8 zGE8edrc5HhKOnfww6S4@x~^yTisGmGcqCN@%BQWUROWO0y2zH64>oM|hS#^UHSFGZ zDMa?U1wC&FV69`w^)c?5kw(sGIhY`XLxa(0I%@kqdtNCmH?iqHwP(dVMDKB6<#lVj z70h6ih;x}$bK`42RQgWebvY@8D|$=g#MS zj~_vlwdWj+F~+m|&{S9QAW;8;yY_-6KV>&_#!U1%?xDid&uS&87n7MpVC}KSbuyEaqp0WN zLN|V8x{0RE-r{O$VHaw)><5tZplz>X4_?kAV6o~8%}%!JN<(or*&2rZ$y3s_Y3PZ| z)WRVYBt0bkuAE-v$#%v`;&2H#l6BvX`0ucxel8BOEo3l&MxE5fi9SxJT@PsfLZ{uo z6mfvdv!VR9vd6U3bY6mhzuxR+&xJ6PHq{sHtet-|(}u|N8ho_(IxY9uc=#N@9N)Xp z8wGewQY9^UnMym0_vhf&cDj38od8|y4i8M5$LO7DeN@KV_;DGV6rzZKd$PI zou*5BW4ABi20vu15;YZ`Uf7xK-Wf%t^v-n)jtM&qU`4)kXkiqMw}PoB?Bjh8=mWk& zm_W>7Iwa3boPhk>-`eEcjn5u>P5HeMnQ%MX%c>bwO=1TNX6(xwW3t}i9hr39a>du_ zvX`{oN2w-Cl)I`-ZS(GaW&6t=eyV)^k*uHW6oPFzqBUKlQ)paj-~6F)hw?x=Bd54L zEY!ruel%Zh7;JT;HvhAB+`5!w-MzqT)>k6OmL>+p<8&`T!dhFiC#_wzqk5-bX!Pad zzJPf{vV!z^P(NdRdBOxtW{zLHjjFp)x8-xrZ8srVCLdSPfHymNF1WUdd&XBCw>~#JJ*B&Hon#v&qAR9)oH@VC*DaNte2OS+VUKBN(CSRuYPBitW`2t z_;7ufdeF~ZO6BEfQq7ltDmhFw@@Fq<9g3&2>e$apcj30Ww8fzW!)JWa@w2K{8y!BY zr-D#Gd5FP)6+B7iQ-?xpDY=SUi@d$JP5txz*Hy5e*KxUXZXkv>sh@an>k@%d_$y3( z#;D}4n1t1=yuhsQ2&fjs@6#Wto4x54OV54YcQc49>t8;7$gLhAWHy&>@p!qSUMx^~ z-6DlT+Tx^rc-XX2anne3WivR_`m&JJ0fn!j?C$X2Pn{|l3YfEv7^(T%J>DF6v^5ltcTo!Vr&aN0KJ>MpUAB69}wCN55-!8 zQmk`#ZX=5(3VctqDrKWZR*b=%5ro1cBS4#gIM0S>rz~Z+7@k%+k0*S09vs-zn7;gY z-yR8`nUoz1H#S~LuQ5C&s?OJ6*VTXnE^M5MORs5C_58!zPKBdea@zmIRdG3~Wws|8 zTGFm$)a8w1L;a3NV_uG6-o;?;>J-wkft_Z5N1jxI07~pBq zH+xV(V&tbQ(y%SWth@I6eqbLSmNfAu`vrxb9 zb^x=E?HHKKCSblScteE`fUf*2phN#n5kh^qslJs09PO`l%=0h=mlY`5b8AlLur~h< zfnPFOh6@uAYRTNpB(gheo8dzK`$8&+hMf<4=W`mo$b=u4-dH(m&34oSGM6ppJjXIe z&=9~97B)ER!YzEyCD6INgxZv+$;Z-&E8#1ld==Qie~Nu>a*?ecO_ zfE2Gsh5JKE3`R060$ULJ&gYc*kG=MY^@obzn4f!1k|*m8sV(G(0~b~7;!Cg$x`A&) zyq$S5pU+_bq_ee)G78~shI0Loq5LrqNo1ga(H9Z0Ow0QSF^3*sk`T{4ZWFtj&gqj2 z30|2-oe{J#c>FBpROoJq6Ozg?!s-j8F(0Q(^T!>(B1<Gn~5nWo`wxUwCsRef4gxp65H6{rk&=*|+4a!!{`A_V0JDvwAaLhU)#+ z@2p(qUc-Z(VKa4XhpfW8piBCrU=sj8{+!vb>Mg3;d%eeQVMla;qR6_*kkt{#HiZX9J!dE5Y358x_^V&WY_!1Mf(gBpTg3N;atE zpr(RT$v1Y2*dR0G(R><6{ZFaLg5Z6iXU`*9hENWyAa%$H zg8p!yU*8?9ozK8ju~WpB83hQJUY9a&gK%78_!nCyh7(?o7hgb7Ai`(Bz(!l0c6Ft2 zO`P0Cb~Z}fjGLoV2^N2ZTAi4A7+%Yima&LM1pD4GrJ41e*KAJt>gRHX+I}ueVM$?D zi$NPiH?oHLox9SWN26!$r(i70+Niv54SRF|fNb(#FMt!F7&9^<;KEA?1=#ZJ zUrcN`jN1@Keyg?@bn-0QH$B)aDHTA{hz&-^fFRxFn!dPPAn0hz0mSkqT4GT za;p}dU)bO9lO6ZeC>SyE$dcbkJcq4{w zclKl6sl5&!?_8w6$LnkP^WXFCTPF7i&nbo>z+tfpTQV|$4#Fi8)1S%J|E^MWs2c!^ zv;LEY6?PL>b#wgq$Hj-^+L;!D%!^WDB%HGG6%j z7@-7_!BS=BcuSjGt^zm5Y)GUZNB`0kx4w`32tv1){A2}B9>hrt?UC9;#tcyj+l!Wm z5#kq^aJ3)k@4Gn*pnG4Y%~sw!Qb*`5I(-8tl#cI@8u7%Fo~P3p#jFVxkO7xP@!n>5 zJ>ka)X^DJkH!1U-wYb%8rH@4f7u2zT7P(fn320S(GIj*btkRjdY#{@#Tdw6=@xDc4 zznVY$fV01Sp20MTod34r(Yu}MU9QOz$mlv%qVX4+%#6&T7l`i56y-xxIUWg~tee~h zAN@!rULL;<(ej^JEt#;U-%!gd36a5;fmh4}28zUnlUo9Wjw(MgqI(?0#dO4zK84Ta5+EJma&8ZU@tTfT{w)TDH!_~T>zbh9gH%G z%%t!Y6>R#$`-({pQ?}=dF#@=l#!FM(37!x$W{_otuRucf8qr~W!4VUuqWxYgAzo@` z4+n6jMTn$cuTK0{-HnA3tl`kqwai}o^XCfIT=Y~MD?QC_&k`9GLNJ$QTEmWd-YJ3t zpCJVS;H}tCH!gNZn@fIqZ=rFaqUjV5-f+PNno9@u;S79C@%Pygf!`NDRQz;X2TCEj zqr5)V(aIjA;a_2uUg)(>c9kBW16Z&uHM7JNK`DY*&;|j`h%&aA%AJ0aTaz@kcBJoR zxF6&#`~8p9q$2Q+%m2R~@U2hZa^Zk5Cgfms;Jvpesq_KOZ~sl+aPEV{ zBL*s*aCE3CPoUB_ld1o%ASo26#`U58j-Id^FX? zDa}5giYwUpqG;FI6;FSTUlu~^#{NSf#_9K{>J9<<)LP5gNF1z7kjz6x!C0?8bcCiO)MwXRX_!H$eg-X)Us;b6 zzm)_X`p|o!tYulN7FEX+PP*9~blbGvoX7&-vt_ruYQ4g}5c!&->{N&C#HD8QW@`Dx z*Z?|IbMC7!yV1HM^cPkBV6=c)rn?YHxWD6VzYgT~b3AWA$*yJg9)BXG*vOY^Z{Kod zJb?S&?29d9m~7d$bQp3UhQ^-aSemO{n>x9VGKw2QGe`yrXe(Pw_e{UfKPS(2^^pyk zsDHI=oMgtxSr(o{{a{gbE=t_cp4bubFm6;LUSG)W`VvOZTjGr-35%ZrpYA?fPCVr#fCk?Bbu1eebh!ri-pRzZ-N7taS6D6i7E+U~z8!}fU zIO5o{TJmc^Cdh>QOzQI5nA@hz`b?npteyp3zwBdVx1pgX; zT!Vz&8M0qG%F#mneaN?myVT^B@CtT}1Z;(UJX!+hy(ew1c{ay>*|MI zO<*I4jmO`koM8qSLTzYa9n;|0Y2eYLiHODXbZKYQtshSjK0Z@?>26y{o0lB_1C?RV!?9B~9L0cwS1QxEb?aSS%(vm(o;w9OF1sZ+2^eq5CZ8?xfKKSuw%b z?=l`SUDbiI=CmIBP8nzuX(}RR!Q2@TaVnm`B}p8*dfj}pn(H~XlEKSMevCw6RJvv(M{nqTES?24>BJbG#Mb{jB>#@L0W$7D|a_}Nr0nPbXV()L3{Fy{0Z@eTkCb6b7 z1!>qS3)bk@Xl~*Lx9!#Q$PSH8nngU_1*?|^5>QI}b{O8cfYpPf)yCLh-IZf0CY58a zL`4F+hK>G-fmx>SpL_EE@no}YU`+VxT@|>3IRQv`d7XERlxTrP>iMHd(Kp)VDPRQx z!{S5ErY4mJF%$MbICA$g(XD2En;deC9?le>2CwR+HN}DGL;wacgE;}sGg5`FS=aku zL48rVI%qyn3;4Uj09lT2ZzCMqUO%R|irvD%l5~9$# z+6KD~c?uK?K*(pDWDzB$guu9Oqo`-HR#abEqZO0L^-mJ zyfvYM{KNgdVPEjR^p(=A&4Pm27%bj9EJ{!+GfKQ7rR0|G7= MNB7e-_=VK}01GPtg#Z8m literal 184449 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

      0%(LicO)^oAWPTd{r)sDB5688t{YnBJ8eB3d* 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

      uSaU{395X9nRS{6w3yndcA^bZ%zG8 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%0DklG|@l_V;v>?oc2x|eH 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 Qg?i*CYX?fP)zLG50drCtJ^%m! diff --git a/graphics/multisector_figure.svg b/graphics/multisector_figure.svg index 65fcad07..ece433df 100644 --- a/graphics/multisector_figure.svg +++ b/graphics/multisector_figure.svg @@ -15,7 +15,7 @@ id="svg7114" version="1.1" inkscape:version="0.92.4 (5da689c313, 2019-01-14)" - sodipodi:docname="20200223_multisector_figure.svg"> + sodipodi:docname="multisector_figure.svg"> + + + image/svg+xml - + @@ -1630,14 +1645,6 @@ inkscape:groupmode="layer" id="layer1" transform="translate(-27.752361,-374.2016)"> -       - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Wind & Solar PV - - - - Hydroelectricity - - - - Biogas - - - - Fossil gas - - - - Other biomass - - - - Atmosphere - - - - Fossil oil - - - - Electricity - - - - Hydrogen - - - - Methane - - - - Carbon Dioxide - - - - Liquid hydrocarbons - - - - - Electric devices - - - - - Resistive heaters - - - - Heat pumps - - - - - Gas boilers - - - - - CHP - - - - Electric - - - - Fuel cell - - - - - Internalcombustion - - - - - Industry - - Heating Transport - - - - S O U R C E S G R I D S & S T O R A G E D E M A N D Electrolysis Fuel cell Methanation Steam reforming Direct air capture Carbon capture Fischer-Tropsch     - + +     + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Wind & Solar PV + + + + Hydroelectricity + + + + Biogas + + + + Fossil gas + + + + Other biomass + + + + Atmosphere + + + + Fossil oil + + + + Electricity + + + + Hydrogen + + + + Methane + + + + Carbon Dioxide + + + + Liquid hydrocarbons + + + + + Electric devices + + + + + Resistive heaters + + + + Heat pumps + + + + + Gas boilers + + + + + CHP + + + + Electric + + + + Fuel cell + + + + + Internalcombustion + + + + + Industry + + Heating Transport + + + + S O U R C E S G R I D S & S T O R A G E D E M A N D Electrolysis Fuel cell Methanation Steam reforming Direct air capture Carbon capture Fischer-Tropsch   - + x="30.698057" + style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:0%;font-family:Calibri;-inkscape-font-specification:Calibri;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" + xml:space="preserve">  + + + From ad3da281176589958202ccd6240b9aefe106cd3d Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Sat, 3 Jul 2021 13:03:47 +0200 Subject: [PATCH 021/132] small follow-up to merge --- config.default.yaml | 3 --- scripts/prepare_sector_network.py | 2 +- 2 files changed, 1 insertion(+), 4 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index 715f4ce3..15b727aa 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -235,7 +235,6 @@ sector: industry: - # St_primary_fraction: 0.3 St_primary_fraction: # fraction of steel produced via primary route versus secondary route (scrap+EAF); today fraction is 0.6 2020: 0.6 2025: 0.55 @@ -254,7 +253,6 @@ industry: 2050: 1 H2_DRI: 1.7 #H2 consumption in Direct Reduced Iron (DRI), MWh_H2,LHV/ton_Steel from 51kgH2/tSt in Vogl et al (2018) doi:10.1016/j.jclepro.2018.08.279 elec_DRI: 0.322 #electricity consumption in Direct Reduced Iron (DRI) shaft, MWh/tSt HYBRIT brochure https://ssabwebsitecdn.azureedge.net/-/media/hybrit/files/hybrit_brochure.pdf - # Al_primary_fraction: 0.2 # fraction of aluminium produced via the primary route versus scrap; today fraction is 0.4 Al_primary_fraction: # fraction of aluminium produced via the primary route versus scrap; today fraction is 0.4 2020: 0.4 2025: 0.375 @@ -272,7 +270,6 @@ industry: HVC_primary_fraction: 1.0 #fraction of current non-ammonia basic chemicals produced via primary route hotmaps_locate_missing: false reference_year: 2015 - industry: costs: diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 86d74656..a9482d6b 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1716,7 +1716,7 @@ def add_industry(n, costs): all_navigation = ["total international navigation", "total domestic navigation"] efficiency = options['shipping_average_efficiency'] / costs.at["fuel cell", "efficiency"] - shipping_hydrogen_share = get_parameter(options['shipping_hydrogen_share']) + shipping_hydrogen_share = get(options['shipping_hydrogen_share'], investment_year) p_set = shipping_hydrogen_share * nodal_energy_totals.loc[nodes, all_navigation].sum(axis=1) * 1e6 * efficiency / 8760 n.madd("Load", From 82e9a48b74a181aaf0659e0d363f5bd17367e171 Mon Sep 17 00:00:00 2001 From: martavp Date: Mon, 5 Jul 2021 11:29:02 +0200 Subject: [PATCH 022/132] Add oil consumed in shipping as a load to EU oil bus --- config.default.yaml | 1 + scripts/prepare_sector_network.py | 9 +++++++++ 2 files changed, 10 insertions(+) diff --git a/config.default.yaml b/config.default.yaml index 15b727aa..3026a2f7 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -500,6 +500,7 @@ plotting: solid biomass: '#DAA520' today: '#D2691E' shipping: '#6495ED' + shipping oil: "#6495ED" shipping oil emissions: "#6495ED" electricity distribution grid: '#333333' H2 for industry: "#222222" diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index a9482d6b..17a2262f 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1730,6 +1730,15 @@ def add_industry(n, costs): if shipping_hydrogen_share < 1: shipping_oil_share = 1 - shipping_hydrogen_share + + n.madd("Load", + nodes, + suffix=" shipping oil", + bus="EU oil", + carrier="shipping oil", + p_set=shipping_oil_share*nodal_energy_totals.loc[nodes,["total international navigation","total domestic navigation"]].sum(axis=1)*1e6/8760. + ) + co2 = shipping_oil_share * nodal_energy_totals.loc[nodes, all_navigation].sum().sum() * 1e6 / 8760 * costs.at["oil", "CO2 intensity"] n.add("Load", From 103ad496715661c2a603fa0b8275859c90e6ed4d Mon Sep 17 00:00:00 2001 From: martavp Date: Mon, 5 Jul 2021 12:19:43 +0200 Subject: [PATCH 023/132] Enable use of lower generators clustering than network clustering --- scripts/add_existing_baseyear.py | 66 ++++++++++++++++++++++++++++++++ scripts/solve_network.py | 35 +++++++++++++++++ 2 files changed, 101 insertions(+) diff --git a/scripts/add_existing_baseyear.py b/scripts/add_existing_baseyear.py index 47c31c0e..bb9e4ff1 100644 --- a/scripts/add_existing_baseyear.py +++ b/scripts/add_existing_baseyear.py @@ -152,9 +152,20 @@ def add_power_capacities_installed_before_baseyear(n, grouping_years, costs, bas df_agg.drop(df_agg.index[df_agg.Technology.isin(technology_to_drop)], inplace=True) df_agg.Fueltype = df_agg.Fueltype.map(rename_fuel) +<<<<<<< Updated upstream # assign clustered bus busmap_s = pd.read_csv(snakemake.input.busmap_s, index_col=0, squeeze=True) busmap = pd.read_csv(snakemake.input.busmap, index_col=0, squeeze=True) +======= + #assign clustered bus + busmap_s = pd.read_csv(snakemake.input.busmap_s, index_col=0).squeeze() + busmap = pd.read_csv(snakemake.input.busmap, index_col=0).squeeze() + + inv_busmap={} + for k,v in busmap.iteritems(): + inv_busmap[v]=inv_busmap.get(v,[]) + [k] + +>>>>>>> Stashed changes clustermaps = busmap_s.map(busmap) clustermaps.index = clustermaps.index.astype(int) @@ -192,6 +203,7 @@ def add_power_capacities_installed_before_baseyear(n, grouping_years, costs, bas capacity = capacity[capacity > snakemake.config['existing_capacities']['threshold_capacity']] if generator in ['solar', 'onwind', 'offwind']: +<<<<<<< Updated upstream rename = {"offwind": "offwind-ac"} p_max_pu=n.generators_t.p_max_pu[capacity.index + ' ' + rename.get(generator, generator) + '-' + str(baseyear)] @@ -210,6 +222,43 @@ def add_power_capacities_installed_before_baseyear(n, grouping_years, costs, bas lifetime=costs.at[generator, 'lifetime'] ) +======= + suffix='-ac' if generator=='offwind' else '' + if 'm' in snakemake.wildcards.clusters: + for ind in capacity.index: + # existing capacities are split evenly among regions in every country + inv_ind = [i for i in inv_busmap[ind]] + # for offshore the spliting only inludes coastal regions + inv_ind=[i for i in inv_ind if (i + ' ' + generator + suffix + '-' + str(baseyear)) in n.generators.index] + p_max_pu = n.generators_t.p_max_pu[[i + ' ' + generator + suffix + '-' + str(baseyear) for i in inv_ind ]] + p_max_pu.columns=[i + ' ' + generator + suffix + '-' + str(grouping_year) for i in inv_ind ] + + n.madd("Generator", + [i + ' ' + generator + suffix + '-' + str(grouping_year) for i in inv_ind ], + bus=ind, + carrier=generator, + p_nom=capacity[ind]/len(inv_ind), #split among regions in a country + marginal_cost=costs.at[generator,'VOM'], + capital_cost=costs.at[generator,'fixed'], + efficiency=costs.at[generator, 'efficiency'], + p_max_pu=p_max_pu, + build_year=grouping_year, + lifetime=costs.at[generator,'lifetime']) + else: + p_max_pu=n.generators_t.p_max_pu[capacity.index + ' ' + generator + suffix + '-' + str(baseyear)] + n.madd("Generator", + capacity.index, + suffix = ' ' + generator +"-"+ str(grouping_year), + bus=capacity.index, + carrier=generator, + p_nom=capacity, + marginal_cost=costs.at[generator,'VOM'], + capital_cost=costs.at[generator,'fixed'], + efficiency=costs.at[generator, 'efficiency'], + p_max_pu=p_max_pu.rename(columns=n.generators.bus), + build_year=grouping_year, + lifetime=costs.at[generator,'lifetime']) +>>>>>>> Stashed changes else: n.madd("Link", @@ -404,6 +453,7 @@ def add_heating_capacities_installed_before_baseyear(n, baseyear, grouping_years if __name__ == "__main__": if 'snakemake' not in globals(): +<<<<<<< Updated upstream from helper import mock_snakemake snakemake = mock_snakemake( 'add_existing_baseyear', @@ -412,6 +462,22 @@ if __name__ == "__main__": lv=1.0, sector_opts='Co2L0-168H-T-H-B-I-solar3-dist1', planning_horizons=2020, +======= + from vresutils.snakemake import MockSnakemake + snakemake = MockSnakemake( + wildcards=dict(network='elec', simpl='148', clusters='37m', lv='1.0', + sector_opts='168H-T-H-B-I-solar+p3-dist1-cb36.7ex0', + planning_horizons='2020'), + input=dict(network='pypsa-eur-sec/results/version-36.7ex0-168H/prenetworks/elec_s{simpl}_{clusters}_lv{lv}__{sector_opts}_{planning_horizons}.nc', + powerplants='pypsa-eur/resources/powerplants.csv', + busmap_s='pypsa-eur/resources/busmap_elec_s{simpl}.csv', + busmap='pypsa-eur/resources/busmap_elec_s{simpl}_{clusters}.csv', + costs='technology-data/outputs/costs_{planning_horizons}.csv', + cop_air_total="pypsa-eur-sec/resources/cop_air_total_elec_s{simpl}_{clusters}.nc", + cop_soil_total="pypsa-eur-sec/resources/cop_soil_total_elec_s{simpl}_{clusters}.nc", + clustered_pop_layout="pypsa-eur-sec/resources/pop_layout_elec_s{simpl}_{clusters}.csv",), + output=['pypsa-eur-sec/results/version-36.7ex0-168H/prenetworks_brownfield/elec_s{simpl}_{clusters}_lv{lv}__{sector_opts}_{planning_horizons}.nc'], +>>>>>>> Stashed changes ) logging.basicConfig(level=snakemake.config['logging_level']) diff --git a/scripts/solve_network.py b/scripts/solve_network.py index 8c0313f1..ce8b65f9 100644 --- a/scripts/solve_network.py +++ b/scripts/solve_network.py @@ -136,6 +136,7 @@ def add_chp_constraints(n): rhs = n.links.loc[electric_fix, "p_nom"].values +<<<<<<< Updated upstream define_constraints(n, lhs, "<=", rhs, 'chplink', 'top_iso_fuel_line_fix') if not electric.empty: @@ -148,6 +149,28 @@ def add_chp_constraints(n): link_p[electric].values)) define_constraints(n, lhs, "<=", 0, 'chplink', 'backpressure') +======= +def add_land_use_constraint(n): + if 'm' in snakemake.wildcards.clusters: + # if generators clustering is lower than network clustering, land_use + # accounting is at generators clusters + for carrier in ['solar', 'onwind', 'offwind-ac', 'offwind-dc']: + existing_capacities = n.generators.loc[n.generators.carrier==carrier,"p_nom"] + ind=list(set([i.split(sep=" ")[0] + ' ' + i.split(sep=" ")[1] for i in existing_capacities.index])) + previous_years= [str(y) for y in + snakemake.config["scenario"]["planning_horizons"] + + snakemake.config["existing_capacities"]["grouping_years"] + if y < int(snakemake.wildcards.planning_horizons)] + for p_year in previous_years: + ind2 = [i for i in ind if i + " " + carrier + "-" + p_year in existing_capacities.index] + n.generators.loc[[i + " " + carrier + "-" + snakemake.wildcards.planning_horizons for i in ind2], "p_nom_max"] -= existing_capacities.loc[[i + " " + carrier + "-" + p_year for i in ind2]].rename(lambda x: x[:-4]+snakemake.wildcards.planning_horizons) + else: + #warning: this will miss existing offwind which is not classed AC-DC and has carrier 'offwind' + for carrier in ['solar', 'onwind', 'offwind-ac', 'offwind-dc']: + existing_capacities = n.generators.loc[n.generators.carrier==carrier,"p_nom"].groupby(n.generators.bus.map(n.buses.location)).sum() + existing_capacities.index += " " + carrier + "-" + snakemake.wildcards.planning_horizons + n.generators.loc[existing_capacities.index,"p_nom_max"] -= existing_capacities +>>>>>>> Stashed changes def extra_functionality(n, snapshots): @@ -181,6 +204,7 @@ def solve_network(n, config, opts='', **kwargs): if __name__ == "__main__": if 'snakemake' not in globals(): +<<<<<<< Updated upstream from helper import mock_snakemake snakemake = mock_snakemake( 'solve_network', @@ -189,6 +213,17 @@ if __name__ == "__main__": lv=1.0, sector_opts='Co2L0-168H-T-H-B-I-solar3-dist1', planning_horizons=2050, +======= + from vresutils.snakemake import MockSnakemake, Dict + snakemake = MockSnakemake( + wildcards=dict(network='elec', simpl='148', clusters='37m', lv='1.0', + sector_opts='168H-T-H-B-I-solar+p3-dist1-cb36.7ex0', + co2_budget_name='', planning_horizons='2020'), + input=dict(network="pypsa-eur-sec/results/version-36.7ex0-168H/prenetworks_brownfield/elec_s{simpl}_{clusters}_lv{lv}__{sector_opts}_{planning_horizons}.nc"), + output=["results/networks/s{simpl}_{clusters}_lv{lv}_{sector_opts}_{co2_budget_name}_{planning_horizons}-test.nc"], + log=dict(gurobi="logs/elec_s{simpl}_{clusters}_lv{lv}_{sector_opts}_{co2_budget_name}_{planning_horizons}_gurobi-test.log", + python="logs/elec_s{simpl}_{clusters}_lv{lv}_{sector_opts}_{co2_budget_name}_{planning_horizons}_python-test.log") +>>>>>>> Stashed changes ) logging.basicConfig(filename=snakemake.log.python, From cc24859d7845e84da70b7dc011be0c424eec6c71 Mon Sep 17 00:00:00 2001 From: martavp Date: Mon, 5 Jul 2021 12:26:11 +0200 Subject: [PATCH 024/132] Update release_notes.rst --- doc/release_notes.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/release_notes.rst b/doc/release_notes.rst index bd99ce16..bac9c0c9 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -7,7 +7,7 @@ Future release .. note:: This unreleased version currently requires the master branches of PyPSA, PyPSA-Eur, and the technology-data repository. - +* The myopic option can now be used together with different clustering for the generators and the network. The existing renewable capacities are split evenly among the regions in every country. * Extended use of ``multiprocessing`` for much better performance (from up to 20 minutes to less than one minute). * Compatibility with ``atlite>=0.2``. Older versions of ``atlite`` will no longer work. From 195cabba0cb4b6a78890811452b57ba29f4e87bc Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Tue, 6 Jul 2021 09:55:41 +0200 Subject: [PATCH 025/132] merge master --- scripts/add_existing_baseyear.py | 113 +++++++++++-------------------- scripts/solve_network.py | 73 +++++++++----------- 2 files changed, 74 insertions(+), 112 deletions(-) diff --git a/scripts/add_existing_baseyear.py b/scripts/add_existing_baseyear.py index bb9e4ff1..4d838f60 100644 --- a/scripts/add_existing_baseyear.py +++ b/scripts/add_existing_baseyear.py @@ -152,20 +152,14 @@ def add_power_capacities_installed_before_baseyear(n, grouping_years, costs, bas df_agg.drop(df_agg.index[df_agg.Technology.isin(technology_to_drop)], inplace=True) df_agg.Fueltype = df_agg.Fueltype.map(rename_fuel) -<<<<<<< Updated upstream # assign clustered bus busmap_s = pd.read_csv(snakemake.input.busmap_s, index_col=0, squeeze=True) busmap = pd.read_csv(snakemake.input.busmap, index_col=0, squeeze=True) -======= - #assign clustered bus - busmap_s = pd.read_csv(snakemake.input.busmap_s, index_col=0).squeeze() - busmap = pd.read_csv(snakemake.input.busmap, index_col=0).squeeze() - inv_busmap={} - for k,v in busmap.iteritems(): - inv_busmap[v]=inv_busmap.get(v,[]) + [k] + inv_busmap = {} + for k, v in busmap.iteritems(): + inv_busmap[v] = inv_busmap.get(v, []) + [k] ->>>>>>> Stashed changes clustermaps = busmap_s.map(busmap) clustermaps.index = clustermaps.index.astype(int) @@ -203,62 +197,54 @@ def add_power_capacities_installed_before_baseyear(n, grouping_years, costs, bas capacity = capacity[capacity > snakemake.config['existing_capacities']['threshold_capacity']] if generator in ['solar', 'onwind', 'offwind']: -<<<<<<< Updated upstream - - rename = {"offwind": "offwind-ac"} - p_max_pu=n.generators_t.p_max_pu[capacity.index + ' ' + rename.get(generator, generator) + '-' + str(baseyear)] - - n.madd("Generator", - capacity.index, - suffix=' ' + generator +"-"+ str(grouping_year), - bus=capacity.index, - carrier=generator, - p_nom=capacity, - marginal_cost=costs.at[generator, 'VOM'], - capital_cost=costs.at[generator, 'fixed'], - efficiency=costs.at[generator, 'efficiency'], - p_max_pu=p_max_pu.rename(columns=n.generators.bus), - build_year=grouping_year, - lifetime=costs.at[generator, 'lifetime'] - ) -======= - suffix='-ac' if generator=='offwind' else '' + suffix = '-ac' if generator == 'offwind' else '' + name_suffix = f' {generator}{suffix}-{baseyear}' + if 'm' in snakemake.wildcards.clusters: + for ind in capacity.index: + # existing capacities are split evenly among regions in every country inv_ind = [i for i in inv_busmap[ind]] + # for offshore the spliting only inludes coastal regions - inv_ind=[i for i in inv_ind if (i + ' ' + generator + suffix + '-' + str(baseyear)) in n.generators.index] - p_max_pu = n.generators_t.p_max_pu[[i + ' ' + generator + suffix + '-' + str(baseyear) for i in inv_ind ]] - p_max_pu.columns=[i + ' ' + generator + suffix + '-' + str(grouping_year) for i in inv_ind ] + inv_ind = [i for i in inv_ind if (i + name_suffix) in n.generators.index] + + p_max_pu = n.generators_t.p_max_pu[[i + name_suffix for i in inv_ind]] + p_max_pu.columns=[i + name_suffix for i in inv_ind ] n.madd("Generator", - [i + ' ' + generator + suffix + '-' + str(grouping_year) for i in inv_ind ], - bus=ind, - carrier=generator, - p_nom=capacity[ind]/len(inv_ind), #split among regions in a country - marginal_cost=costs.at[generator,'VOM'], - capital_cost=costs.at[generator,'fixed'], - efficiency=costs.at[generator, 'efficiency'], - p_max_pu=p_max_pu, - build_year=grouping_year, - lifetime=costs.at[generator,'lifetime']) + [i + name_suffix for i in inv_ind], + bus=ind, + carrier=generator, + p_nom=capacity[ind] / len(inv_ind), # split among regions in a country + marginal_cost=costs.at[generator,'VOM'], + capital_cost=costs.at[generator,'fixed'], + efficiency=costs.at[generator, 'efficiency'], + p_max_pu=p_max_pu, + build_year=grouping_year, + lifetime=costs.at[generator,'lifetime'] + ) + else: - p_max_pu=n.generators_t.p_max_pu[capacity.index + ' ' + generator + suffix + '-' + str(baseyear)] + + p_max_pu = n.generators_t.p_max_pu[capacity.index + name_suffix] + n.madd("Generator", - capacity.index, - suffix = ' ' + generator +"-"+ str(grouping_year), - bus=capacity.index, - carrier=generator, - p_nom=capacity, - marginal_cost=costs.at[generator,'VOM'], - capital_cost=costs.at[generator,'fixed'], - efficiency=costs.at[generator, 'efficiency'], - p_max_pu=p_max_pu.rename(columns=n.generators.bus), - build_year=grouping_year, - lifetime=costs.at[generator,'lifetime']) ->>>>>>> Stashed changes + capacity.index, + suffix=' ' + generator +"-"+ str(grouping_year), + bus=capacity.index, + carrier=generator, + p_nom=capacity, + marginal_cost=costs.at[generator, 'VOM'], + capital_cost=costs.at[generator, 'fixed'], + efficiency=costs.at[generator, 'efficiency'], + p_max_pu=p_max_pu.rename(columns=n.generators.bus), + build_year=grouping_year, + lifetime=costs.at[generator, 'lifetime'] + ) + else: n.madd("Link", @@ -453,7 +439,6 @@ def add_heating_capacities_installed_before_baseyear(n, baseyear, grouping_years if __name__ == "__main__": if 'snakemake' not in globals(): -<<<<<<< Updated upstream from helper import mock_snakemake snakemake = mock_snakemake( 'add_existing_baseyear', @@ -462,22 +447,6 @@ if __name__ == "__main__": lv=1.0, sector_opts='Co2L0-168H-T-H-B-I-solar3-dist1', planning_horizons=2020, -======= - from vresutils.snakemake import MockSnakemake - snakemake = MockSnakemake( - wildcards=dict(network='elec', simpl='148', clusters='37m', lv='1.0', - sector_opts='168H-T-H-B-I-solar+p3-dist1-cb36.7ex0', - planning_horizons='2020'), - input=dict(network='pypsa-eur-sec/results/version-36.7ex0-168H/prenetworks/elec_s{simpl}_{clusters}_lv{lv}__{sector_opts}_{planning_horizons}.nc', - powerplants='pypsa-eur/resources/powerplants.csv', - busmap_s='pypsa-eur/resources/busmap_elec_s{simpl}.csv', - busmap='pypsa-eur/resources/busmap_elec_s{simpl}_{clusters}.csv', - costs='technology-data/outputs/costs_{planning_horizons}.csv', - cop_air_total="pypsa-eur-sec/resources/cop_air_total_elec_s{simpl}_{clusters}.nc", - cop_soil_total="pypsa-eur-sec/resources/cop_soil_total_elec_s{simpl}_{clusters}.nc", - clustered_pop_layout="pypsa-eur-sec/resources/pop_layout_elec_s{simpl}_{clusters}.csv",), - output=['pypsa-eur-sec/results/version-36.7ex0-168H/prenetworks_brownfield/elec_s{simpl}_{clusters}_lv{lv}__{sector_opts}_{planning_horizons}.nc'], ->>>>>>> Stashed changes ) logging.basicConfig(level=snakemake.config['logging_level']) diff --git a/scripts/solve_network.py b/scripts/solve_network.py index ce8b65f9..2b916471 100644 --- a/scripts/solve_network.py +++ b/scripts/solve_network.py @@ -19,15 +19,43 @@ pypsa.pf.logger.setLevel(logging.WARNING) def add_land_use_constraint(n): - #warning: this will miss existing offwind which is not classed AC-DC and has carrier 'offwind' - for carrier in ['solar', 'onwind', 'offwind-ac', 'offwind-dc']: - existing = n.generators.loc[n.generators.carrier == carrier, "p_nom"].groupby(n.generators.bus.map(n.buses.location)).sum() - existing.index += " " + carrier + "-" + snakemake.wildcards.planning_horizons - n.generators.loc[existing.index, "p_nom_max"] -= existing + if 'm' in snakemake.wildcards.clusters: + add_land_use_constraint_m(n) + else: + #warning: this will miss existing offwind which is not classed AC-DC and has carrier 'offwind' + for carrier in ['solar', 'onwind', 'offwind-ac', 'offwind-dc']: + existing = n.generators.loc[n.generators.carrier==carrier,"p_nom"].groupby(n.generators.bus.map(n.buses.location)).sum() + existing.index += " " + carrier + "-" + snakemake.wildcards.planning_horizons + n.generators.loc[existing.index,"p_nom_max"] -= existing n.generators.p_nom_max.clip(lower=0, inplace=True) +def add_land_use_constraint_m(n): + # if generators clustering is lower than network clustering, land_use accounting is at generators clusters + + planning_horizons = snakemake.config["scenario"]["planning_horizons"] + grouping_years = snakemake.config["existing_capacities"]["grouping_years"] + current_horizon = snakemake.wildcards.planning_horizons + + for carrier in ['solar', 'onwind', 'offwind-ac', 'offwind-dc']: + + existing = n.generators.loc[n.generators.carrier==carrier,"p_nom"] + ind = list(set([i.split(sep=" ")[0] + ' ' + i.split(sep=" ")[1] for i in existing.index])) + + previous_years = [ + str(y) for y in + planning_horizons + grouping_years + if y < int(snakemake.wildcards.planning_horizons) + ] + + for p_year in previous_years: + ind2 = [i for i in ind if i + " " + carrier + "-" + p_year in existing.index] + sel_current = [i + " " + carrier + "-" + current_horizon for i in ind2] + sel_p_year = [i + " " + carrier + "-" + p_year for i in ind2] + n.generators.loc[sel_current, "p_nom_max"] -= existing.loc[sel_p_year].rename(lambda x: x[:-4] + current_horizon) + + def prepare_network(n, solve_opts=None): if 'clip_p_max_pu' in solve_opts: @@ -136,7 +164,6 @@ def add_chp_constraints(n): rhs = n.links.loc[electric_fix, "p_nom"].values -<<<<<<< Updated upstream define_constraints(n, lhs, "<=", rhs, 'chplink', 'top_iso_fuel_line_fix') if not electric.empty: @@ -149,28 +176,6 @@ def add_chp_constraints(n): link_p[electric].values)) define_constraints(n, lhs, "<=", 0, 'chplink', 'backpressure') -======= -def add_land_use_constraint(n): - if 'm' in snakemake.wildcards.clusters: - # if generators clustering is lower than network clustering, land_use - # accounting is at generators clusters - for carrier in ['solar', 'onwind', 'offwind-ac', 'offwind-dc']: - existing_capacities = n.generators.loc[n.generators.carrier==carrier,"p_nom"] - ind=list(set([i.split(sep=" ")[0] + ' ' + i.split(sep=" ")[1] for i in existing_capacities.index])) - previous_years= [str(y) for y in - snakemake.config["scenario"]["planning_horizons"] - + snakemake.config["existing_capacities"]["grouping_years"] - if y < int(snakemake.wildcards.planning_horizons)] - for p_year in previous_years: - ind2 = [i for i in ind if i + " " + carrier + "-" + p_year in existing_capacities.index] - n.generators.loc[[i + " " + carrier + "-" + snakemake.wildcards.planning_horizons for i in ind2], "p_nom_max"] -= existing_capacities.loc[[i + " " + carrier + "-" + p_year for i in ind2]].rename(lambda x: x[:-4]+snakemake.wildcards.planning_horizons) - else: - #warning: this will miss existing offwind which is not classed AC-DC and has carrier 'offwind' - for carrier in ['solar', 'onwind', 'offwind-ac', 'offwind-dc']: - existing_capacities = n.generators.loc[n.generators.carrier==carrier,"p_nom"].groupby(n.generators.bus.map(n.buses.location)).sum() - existing_capacities.index += " " + carrier + "-" + snakemake.wildcards.planning_horizons - n.generators.loc[existing_capacities.index,"p_nom_max"] -= existing_capacities ->>>>>>> Stashed changes def extra_functionality(n, snapshots): @@ -204,7 +209,6 @@ def solve_network(n, config, opts='', **kwargs): if __name__ == "__main__": if 'snakemake' not in globals(): -<<<<<<< Updated upstream from helper import mock_snakemake snakemake = mock_snakemake( 'solve_network', @@ -213,17 +217,6 @@ if __name__ == "__main__": lv=1.0, sector_opts='Co2L0-168H-T-H-B-I-solar3-dist1', planning_horizons=2050, -======= - from vresutils.snakemake import MockSnakemake, Dict - snakemake = MockSnakemake( - wildcards=dict(network='elec', simpl='148', clusters='37m', lv='1.0', - sector_opts='168H-T-H-B-I-solar+p3-dist1-cb36.7ex0', - co2_budget_name='', planning_horizons='2020'), - input=dict(network="pypsa-eur-sec/results/version-36.7ex0-168H/prenetworks_brownfield/elec_s{simpl}_{clusters}_lv{lv}__{sector_opts}_{planning_horizons}.nc"), - output=["results/networks/s{simpl}_{clusters}_lv{lv}_{sector_opts}_{co2_budget_name}_{planning_horizons}-test.nc"], - log=dict(gurobi="logs/elec_s{simpl}_{clusters}_lv{lv}_{sector_opts}_{co2_budget_name}_{planning_horizons}_gurobi-test.log", - python="logs/elec_s{simpl}_{clusters}_lv{lv}_{sector_opts}_{co2_budget_name}_{planning_horizons}_python-test.log") ->>>>>>> Stashed changes ) logging.basicConfig(filename=snakemake.log.python, From c3f554e442d8bb44e62d01a2b08631ac74625ebd Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Tue, 6 Jul 2021 10:54:34 +0200 Subject: [PATCH 026/132] Update scripts/prepare_sector_network.py --- scripts/prepare_sector_network.py | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 17a2262f..3eafe8aa 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1731,13 +1731,15 @@ def add_industry(n, costs): shipping_oil_share = 1 - shipping_hydrogen_share + p_set = shipping_oil_share * nodal_energy_totals.loc[nodes, all_navigation].sum(axis=1) * 1e6 / 8760. + n.madd("Load", - nodes, - suffix=" shipping oil", - bus="EU oil", - carrier="shipping oil", - p_set=shipping_oil_share*nodal_energy_totals.loc[nodes,["total international navigation","total domestic navigation"]].sum(axis=1)*1e6/8760. - ) + nodes, + suffix=" shipping oil", + bus="EU oil", + carrier="shipping oil", + p_set=p_set + ) co2 = shipping_oil_share * nodal_energy_totals.loc[nodes, all_navigation].sum().sum() * 1e6 / 8760 * costs.at["oil", "CO2 intensity"] From 3a6a1f90abb049f393e90af4e623d095d80c8e12 Mon Sep 17 00:00:00 2001 From: martavp <30744159+martavp@users.noreply.github.com> Date: Tue, 6 Jul 2021 17:12:39 +0200 Subject: [PATCH 027/132] Sensitivity e nom max (#143) * Update .gitignore * include e_nom_max sensitivity * remove change in gitignore * Update doc/release_notes.rst Co-authored-by: Fabian Neumann --- config.default.yaml | 1 + doc/release_notes.rst | 2 ++ scripts/prepare_sector_network.py | 9 +++++++-- 3 files changed, 10 insertions(+), 2 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index 5f1fa1b8..457c3660 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -30,6 +30,7 @@ scenario: # B for biomass supply, I for industry, shipping and aviation # solar+c0.5 reduces the capital cost of solar to 50\% of reference value # solar+p3 multiplies the available installable potential by factor 3 + # co2 stored+e2 multiplies the potential of CO2 sequestration by a factor 2 # dist{n} includes distribution grids with investment cost of n times cost in data/costs.csv # for myopic/perfect foresight cb states the carbon budget in GtCO2 (cumulative # emissions throughout the transition path in the timeframe determined by the diff --git a/doc/release_notes.rst b/doc/release_notes.rst index bd99ce16..88d09bcb 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -62,6 +62,8 @@ Future release * Distinguish costs for home battery storage and inverter from utility-scale battery costs. +* Include the option to alter the maximum energy capacity of a store via the ``carrier+factor`` in the ``{sector_opts}`` wildcard. This can be useful for sensitivity analyses. Example: ``co2 stored+e2`` multiplies the ``e_nom_max`` by factor 2. In this example, ``e_nom_max`` represents the CO2 sequestration potential in Europe. + PyPSA-Eur-Sec 0.5.0 (21st May 2021) =================================== diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index fa485e6a..82e15e60 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1925,14 +1925,19 @@ def maybe_adjust_costs_and_potentials(n, opts): suptechs = map(lambda c: c.split("-", 2)[0], carrier_list) if oo[0].startswith(tuple(suptechs)): carrier = oo[0] - attr_lookup = {"p": "p_nom_max", "c": "capital_cost"} + attr_lookup = {"p": "p_nom_max", "e": "e_nom_max", "c": "capital_cost"} attr = attr_lookup[oo[1][0]] factor = float(oo[1][1:]) #beware if factor is 0 and p_nom_max is np.inf, 0*np.inf is nan if carrier == "AC": # lines do not have carrier n.lines[attr] *= factor else: - comps = {"Generator", "Link", "StorageUnit"} if attr == 'p_nom_max' else {"Generator", "Link", "StorageUnit", "Store"} + if attr == 'p_nom_max': + comps = {"Generator", "Link", "StorageUnit"} + elif attr = 'e_nom_max': + comps = {"Store"} + else: + comps = {"Generator", "Link", "StorageUnit", "Store"} for c in n.iterate_components(comps): if carrier=='solar': sel = c.df.carrier.str.contains(carrier) & ~c.df.carrier.str.contains("solar rooftop") From 67ee6cb86e316d62ae66385a3f643986ed8cd7ba Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Tue, 6 Jul 2021 18:32:35 +0200 Subject: [PATCH 028/132] first step towards agriculture, forestry and fishing --- config.default.yaml | 3 ++ scripts/build_energy_totals.py | 42 ++++++++++++++-- scripts/prepare_sector_network.py | 79 +++++++++++++++++++++++++++++-- 3 files changed, 115 insertions(+), 9 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index 5f1fa1b8..bb60509a 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -173,6 +173,9 @@ sector: 2050: 0.85 transport_fuel_cell_efficiency: 0.5 transport_internal_combustion_efficiency: 0.3 + agriculture_machinery_electric_share: 0.12 # approximately as today + agriculture_machinery_fuel_efficiency: 0.7 # for conversion of fuel oil to use + agriculture_machinery_electric_efficiency: 0.3 # for conversion of electricity to use shipping_average_efficiency: 0.4 #For conversion of fuel oil to propulsion in 2011 time_dep_hp_cop: true #time dependent heat pump coefficient of performance heat_pump_sink_T: 55. # Celsius, based on DTU / large area radiators; used in build_cop_profiles.py diff --git a/scripts/build_energy_totals.py b/scripts/build_energy_totals.py index aec1c61b..7fdd305a 100644 --- a/scripts/build_energy_totals.py +++ b/scripts/build_energy_totals.py @@ -117,6 +117,7 @@ to_ipcc = { "total energy": "1 - Energy", "industrial processes": "2 - Industrial Processes and Product Use", "agriculture": "3 - Agriculture", + "agriculture, forestry and fishing": '1.A.4.c - Agriculture/Forestry/Fishing', "LULUCF": "4 - Land Use, Land-Use Change and Forestry", "waste management": "5 - Waste management", "other": "6 - Other Sector", @@ -182,7 +183,7 @@ def idees_per_country(ct, year): ct_idees = idees_rename.get(ct, ct) fn_residential = f"{base_dir}/JRC-IDEES-2015_Residential_{ct_idees}.xlsx" - fn_services = f"{base_dir}/JRC-IDEES-2015_Tertiary_{ct_idees}.xlsx" + fn_tertiary = f"{base_dir}/JRC-IDEES-2015_Tertiary_{ct_idees}.xlsx" fn_transport = f"{base_dir}/JRC-IDEES-2015_Transport_{ct_idees}.xlsx" # residential @@ -214,7 +215,7 @@ def idees_per_country(ct, year): # services - df = pd.read_excel(fn_services, "SER_hh_fec", index_col=0)[year] + df = pd.read_excel(fn_tertiary, "SER_hh_fec", index_col=0)[year] ct_totals["total services space"] = df["Space heating"] @@ -231,7 +232,7 @@ def idees_per_country(ct, year): assert df.index[31] == "Electricity" ct_totals["electricity services cooking"] = df[31] - df = pd.read_excel(fn_services, "SER_summary", index_col=0)[year] + df = pd.read_excel(fn_tertiary, "SER_summary", index_col=0)[year] row = "Energy consumption by fuel - Eurostat structure (ktoe)" ct_totals["total services"] = df[row] @@ -239,6 +240,34 @@ def idees_per_country(ct, year): assert df.index[50] == "Electricity" ct_totals["electricity services"] = df[50] + # agriculture, forestry and fishing + + start = "Detailed split of energy consumption (ktoe)" + end = "Market shares of energy uses (%)" + + df = pd.read_excel(fn_tertiary, "AGR_fec", index_col=0).loc[start:end, year] + + rows = [ + "Lighting", + "Ventilation", + "Specific electricity uses", + "Pumping devices (electric)" + ] + ct_totals["total agriculture electricity"] = df[rows].sum() + + rows = ["Specific heat uses", "Low enthalpy heat"] + ct_totals["total agriculture heat"] = df[rows].sum() + + rows = [ + "Motor drives", + "Farming machine drives (diesel oil incl. biofuels)", + "Pumping devices (diesel oil incl. biofuels)", + ] + ct_totals["total agriculture machinery"] = df[rows].sum() + + row = ["Agriculture, forestry and fishing"] + ct_totals["total agriculture"] = df[row] + # transport df = pd.read_excel(fn_transport, "TrRoad_ene", index_col=0)[year] @@ -540,10 +569,13 @@ def build_eea_co2(year=1990): "international aviation", "domestic navigation", "international navigation", + "agriculture, forstry and fishing" ] emissions["industrial non-elec"] = emissions["total energy"] - emissions[to_subtract].sum(axis=1) - to_drop = ["total energy", "total wL", "total woL"] + emissions["agriculture"] += emissions["agriculture, forestry and fishing"] + + to_drop = ["total energy", "total wL", "total woL", "agriculture, forestry and fishing"] emissions.drop(columns=to_drop, inplace=True) # convert from Gg to Mt @@ -588,7 +620,7 @@ def build_co2_totals(countries, eea_co2, eurostat_co2): # does not include industrial process emissions or fuel processing/refining "industrial non-elec": (ct, "+", "Industry"), # does not include non-energy emissions - "agriculture": (ct, "+", "+", "Agriculture / Forestry"), + "agriculture": (eurostat_co2.index.get_level_values(0) == 'NL') & eurostat_co2.index.isin(["Agriculture / Forestry", "Fishing"], level=3), } for i, mi in mappings.items(): diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index fa485e6a..315b9980 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -42,6 +42,10 @@ def emission_sectors_from_opts(opts): "domestic navigation", "international navigation" ] + if "A" in opts: + sectors += [ + "agriulture" + ] return sectors @@ -728,8 +732,9 @@ def insert_electricity_distribution_grid(n, costs): capital_cost=costs.at['electricity distribution grid', 'fixed'] * cost_factor ) - # this catches regular electricity load and "industry electricity" - loads = n.loads.index[n.loads.carrier.str.contains("electricity")] + # this catches regular electricity load and "industry electricity" and + # "agriculture machinery electric" and "agriculture electricity" + loads = n.loads.index[n.loads.carrier.str.contains("electric")] n.loads.loc[loads, "bus"] += " low voltage" bevs = n.links.index[n.links.carrier == "BEV charger"] @@ -1163,8 +1168,8 @@ def add_land_transport(n, costs): co2 = ice_share / ice_efficiency * transport[nodes].sum().sum() / 8760 * costs.at["oil", 'CO2 intensity'] - n.madd("Load", - ["land transport oil emissions"], + n.add("Load", + "land transport oil emissions", bus="co2 atmosphere", carrier="land transport oil emissions", p_set=-co2 @@ -1901,6 +1906,69 @@ def add_waste_heat(n): n.links.loc[urban_central + " H2 Fuel Cell", "efficiency2"] = 0.95 - n.links.loc[urban_central + " H2 Fuel Cell", "efficiency"] +def add_agriculture(n, costs): + + nodes = pop_layout.index + + # electricity + + n.madd("Load", + nodes, + suffix=" agriculture electricity", + bus=nodes, + carrier='agriculture electricity', + p_set=nodal_energy_totals.loc[nodes, "total agriculture electricity"] / 8760 + ) + + # heat + + n.madd("Load", + nodes, + suffix=" agriculture heat", + bus=nodes + " services rural heat", + carrier="agriculture heat", + p_set=nodal_energy_totals.loc[nodes, "total agriculture heat"] / 8760 + ) + + # machinery + + electric_share = get(options["agriculture_machinery_electric_share"], investment_year) + assert electric_share <= 1. + ice_share = 1 - electric_share + + machinery_nodal_energy = nodal_energy_totals.loc[nodes, "total agriculture machinery"] + + if electric_share > 0: + + efficiency_gain = options["agriculture_machinery_fuel_efficiency"] / options["agriculture_machinery_electric_efficiency"] + + n.add("Load", + nodes, + suffix=" agriculture machinery electric", + bus=nodes, + carrier="agriculture machinery electric", + p_set=electric_share * efficiency_gain * machinery_nodal_energy / 8760, + ) + + if ice_share > 0: + + n.add("Load", + "agriculture machinery oil", + bus="EU oil", + carrier="agriculture machinery oil", + p_set=ice_share * machinery_nodal_energy / 8760 + ) + + co2 = ice_share * machinery_nodal_energy / 8760 * costs.at["oil", 'CO2 intensity'] + + n.add("Load", + "agriculture machinery oil emissions", + bus="co2 atmosphere", + carrier="agriculture machinery oil emissions", + p_set=-co2 + ) + + def decentral(n): """Removes the electricity transmission system.""" n.lines.drop(n.lines.index, inplace=True) @@ -2027,6 +2095,9 @@ if __name__ == "__main__": if "I" in opts and "H" in opts: add_waste_heat(n) + if "A" in opts: # requires H and I + add_agriculture(n, costs) + if options['dac']: add_dac(n, costs) From 2bd9a3993b99b0ed50ec6d21af070b10ba1b90e8 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Tue, 6 Jul 2021 18:36:04 +0200 Subject: [PATCH 029/132] fix typo --- scripts/prepare_sector_network.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 315b9980..e90a0e91 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -44,7 +44,7 @@ def emission_sectors_from_opts(opts): ] if "A" in opts: sectors += [ - "agriulture" + "agriculture" ] return sectors From d976a8faf7af42e97ac3b35badccbd02fc269cd5 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Wed, 7 Jul 2021 17:58:47 +0200 Subject: [PATCH 030/132] add CO2 network [first draft] --- config.default.yaml | 1 + scripts/prepare_sector_network.py | 58 +++++++++++++++++++++++++------ 2 files changed, 49 insertions(+), 10 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index 5f1fa1b8..ecadc3c0 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -214,6 +214,7 @@ sector: SMR: true co2_sequestration_potential: 200 #MtCO2/a sequestration potential for Europe co2_sequestration_cost: 20 #EUR/tCO2 for transport and sequestration of CO2 + co2_network: false cc_fraction: 0.9 # default fraction of CO2 captured with post-combustion capture hydrogen_underground_storage: true use_fischer_tropsch_waste_heat: true diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index fa485e6a..aca8d76f 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -277,6 +277,18 @@ def patch_electricity_network(n): def add_co2_tracking(n, options): + if options["co2_network"]: + nodes = pop_layout.index + co2_nodes = nodes + " co2 stored" + co2_locations = nodes + co2_vents = nodes + " co2 vent" + co2_max_sequestration = np.inf + else: + co2_nodes = "co2 stored" + co2_locations = "EU" + co2_vents = "co2 vent" + co2_max_sequestration = np.inf # TODO should be nodal sequestration potentials + # minus sign because opposite to how fossil fuels used: # CH4 burning puts CH4 down, atmosphere up n.add("Carrier", "co2", @@ -299,26 +311,33 @@ def add_co2_tracking(n, options): ) # this tracks CO2 stored, e.g. underground - n.add("Bus", - "co2 stored", - location="EU", + n.madd("Bus", + co2_nodes, + location=co2_locations, carrier="co2 stored" ) - n.add("Store", - "co2 stored", + n.madd("Store", + co2_nodes, e_nom_extendable=True, - e_nom_max=options['co2_sequestration_potential'] * 1e6, + e_nom_max=co2_max_sequestration, capital_cost=options['co2_sequestration_cost'], carrier="co2 stored", - bus="co2 stored" + bus=co2_nodes ) + # TODO if nodally resolved total allowed sequestration needs to + # be an extra_functionality constraint + # (best to implement it this way for either case) + # let e_nom_max represent geological potential + # don't forget to log duals of extra functionality! + # options['co2_sequestration_potential'] * 1e6 + if options['co2_vent']: - n.add("Link", - "co2 vent", - bus0="co2 stored", + n.madd("Link", + co2_vents, + bus0=co2_nodes, bus1="co2 atmosphere", carrier="co2 vent", efficiency=1., @@ -326,6 +345,25 @@ def add_co2_tracking(n, options): ) +def add_co2_network(n, costs): + + # TODO create co2 network topology from electricity + co2_links = pd.DataFrame() + + # assumed to be bidirectional + n.madd("Link", + co2_links.index, + bus0=co2_links.bus0.values + " co2 stored", + bus1=co2_links.bus1.values + " co2 stored", + p_min_pu=-1, + p_nom_extendable=True, + length=co2_links.length.values, + capital_cost=costs.at['CO2 pipeline', 'fixed'] * co2_links.length.values, + carrier="CO2 pipeline", + lifetime=costs.at['CO2 pipeline', 'lifetime'] + ) + + def add_dac(n, costs): heat_carriers = ["urban central heat", "services urban decentral heat"] From a98870e1597cc5cd25daa1d11cae14125960edec Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Wed, 7 Jul 2021 18:07:57 +0200 Subject: [PATCH 031/132] correction for .madd() and call co2_network --- scripts/prepare_sector_network.py | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index aca8d76f..c5a99fcc 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -284,9 +284,9 @@ def add_co2_tracking(n, options): co2_vents = nodes + " co2 vent" co2_max_sequestration = np.inf else: - co2_nodes = "co2 stored" + co2_nodes = ["co2 stored"] co2_locations = "EU" - co2_vents = "co2 vent" + co2_vents = ["co2 vent"] co2_max_sequestration = np.inf # TODO should be nodal sequestration potentials # minus sign because opposite to how fossil fuels used: @@ -2074,6 +2074,9 @@ if __name__ == "__main__": if "noH2network" in opts: remove_h2_network(n) + if options["co2_network"]: + add_co2_network(n, costs) + for o in opts: m = re.match(r'^\d+h$', o, re.IGNORECASE) if m is not None: From 2e336e5e7043976c97580471cbd6075d837bf742 Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Thu, 8 Jul 2021 14:41:13 +0200 Subject: [PATCH 032/132] add missing wildcards for benchmarks, add new input data for district heating share --- Snakefile | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/Snakefile b/Snakefile index f52045cb..6ff7555f 100644 --- a/Snakefile +++ b/Snakefile @@ -223,7 +223,7 @@ rule build_industrial_production_per_country_tomorrow: industrial_production_per_country_tomorrow="resources/industrial_production_per_country_tomorrow_{planning_horizons}.csv" threads: 1 resources: mem_mb=1000 - benchmark: "benchmarks/build_industrial_production_per_country_tomorrow" + benchmark: "benchmarks/build_industrial_production_per_country_tomorrow_{planning_horizons}" script: 'scripts/build_industrial_production_per_country_tomorrow.py' @@ -248,7 +248,7 @@ rule build_industrial_production_per_node: industrial_production_per_node="resources/industrial_production_elec_s{simpl}_{clusters}_{planning_horizons}.csv" threads: 1 resources: mem_mb=1000 - benchmark: "benchmarks/build_industrial_production_per_node/s{simpl}_{clusters}" + benchmark: "benchmarks/build_industrial_production_per_node/s{simpl}_{clusters}_{planning_horizons}" script: 'scripts/build_industrial_production_per_node.py' @@ -261,7 +261,7 @@ rule build_industrial_energy_demand_per_node: industrial_energy_demand_per_node="resources/industrial_energy_demand_elec_s{simpl}_{clusters}_{planning_horizons}.csv" threads: 1 resources: mem_mb=1000 - benchmark: "benchmarks/build_industrial_energy_demand_per_node/s{simpl}_{clusters}" + benchmark: "benchmarks/build_industrial_energy_demand_per_node/s{simpl}_{clusters}_{planning_horizons}" script: 'scripts/build_industrial_energy_demand_per_node.py' @@ -323,6 +323,7 @@ rule prepare_sector_network: transport_name='resources/transport_data.csv', traffic_data_KFZ = "data/emobility/KFZ__count", traffic_data_Pkw = "data/emobility/Pkw__count", + dh_share = "data/district_heat_share.csv", biomass_potentials='resources/biomass_potentials.csv', heat_profile="data/heat_load_profile_BDEW.csv", costs=CDIR + "costs_{planning_horizons}.csv", From 76f36d0a1a2706f9bf2cf7fce0551f9676b133be Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Thu, 8 Jul 2021 14:41:34 +0200 Subject: [PATCH 033/132] add option to take today's district heating share --- config.default.yaml | 8 +- scripts/prepare_sector_network.py | 124 +++++++++++++++++++----------- 2 files changed, 88 insertions(+), 44 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index 3026a2f7..d23cc033 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -141,6 +141,12 @@ existing_capacities: sector: central: true central_fraction: 0.6 + district_heating_increase: true + dh_strength: + 2020: 0 # starting at today's share + 2030: 0.2 + 2040: 0.5 + 2050: 1 # maximum possible share defined in central fraction bev_dsm_restriction_value: 0.75 #Set to 0 for no restriction on BEV DSM bev_dsm_restriction_time: 7 #Time at which SOC of BEV has to be dsm_restriction_value transport_heating_deadband_upper: 20. @@ -332,7 +338,7 @@ solving: plotting: map: - boundaries: [-11, 30, 34, 71] + boundaries: [-11, 30, 34, 71] color_geomap: ocean: white land: whitesmoke diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 3eafe8aa..92fce889 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -75,7 +75,7 @@ def co2_emissions_year(countries, opts, year): co2_emissions = co2_totals.loc[countries, sectors].sum().sum() # convert MtCO2 to GtCO2 - co2_emissions *= 0.001 + co2_emissions *= 0.001 return co2_emissions @@ -102,17 +102,17 @@ def build_carbon_budget(o, fn): #emissions at the beginning of the path (last year available 2018) e_0 = co2_emissions_year(countries, opts, year=2018) - + #emissions in 2019 and 2020 assumed equal to 2018 and substracted carbon_budget -= 2 * e_0 - + planning_horizons = snakemake.config['scenario']['planning_horizons'] t_0 = planning_horizons[0] if "be" in o: # final year in the path - t_f = t_0 + (2 * carbon_budget / e_0).round(0) + t_f = t_0 + (2 * carbon_budget / e_0).round(0) def beta_decay(t): cdf_term = (t - t_0) / (t_f - t_0) @@ -818,7 +818,7 @@ def insert_gas_distribution_costs(n, costs): # TODO options? f_costs = options['gas_distribution_grid_cost_factor'] - + print("Inserting gas distribution grid with investment cost factor of", f_costs) capital_cost = costs.loc['electricity distribution grid']["fixed"] * f_costs @@ -827,7 +827,7 @@ def insert_gas_distribution_costs(n, costs): gas_b = n.links.index[n.links.carrier.str.contains("gas boiler") & (~n.links.carrier.str.contains("urban central"))] n.links.loc[gas_b, "capital_cost"] += capital_cost - + # micro CHPs mchp = n.links.index[n.links.carrier.str.contains("micro gas")] n.links.loc[mchp, "capital_cost"] += capital_cost @@ -1075,7 +1075,7 @@ def add_land_transport(n, costs): suffix=" EV battery", carrier="Li ion" ) - + p_set = electric_share * (transport[nodes] + cycling_shift(transport[nodes], 1) + cycling_shift(transport[nodes], 2)) / 3 n.madd("Load", @@ -1086,8 +1086,8 @@ def add_land_transport(n, costs): p_set=p_set ) - - p_nom = nodal_transport_data["number cars"] * options.get("bev_charge_rate", 0.011) * electric_share + + p_nom = nodal_transport_data["number cars"] * options.get("bev_charge_rate", 0.011) * electric_share n.madd("Link", nodes, @@ -1119,7 +1119,7 @@ def add_land_transport(n, costs): if electric_share > 0 and options["bev_dsm"]: - e_nom = nodal_transport_data["number cars"] * options.get("bev_energy", 0.05) * options["bev_availability"] * electric_share + e_nom = nodal_transport_data["number cars"] * options.get("bev_energy", 0.05) * options["bev_availability"] * electric_share n.madd("Store", nodes, @@ -1179,12 +1179,11 @@ def add_heat(n, costs): sectors = ["residential", "services"] - nodes = create_nodes_for_heat_sector() + + nodes, dist_fraction, urban_fraction = create_nodes_for_heat_sector() #NB: must add costs of central heating afterwards (EUR 400 / kWpeak, 50a, 1% FOM from Fraunhofer ISE) - urban_fraction = options['central_fraction'] * pop_layout["urban"] / pop_layout[["urban", "rural"]].sum(axis=1) - # exogenously reduce space heat demand if options["reduce_space_heat_exogenously"]: dE = get(options["reduce_space_heat_exogenously_factor"], investment_year) @@ -1199,7 +1198,7 @@ def add_heat(n, costs): "services urban decentral", "urban central" ] - + for name in heat_systems: name_type = "central" if name == "urban central" else "decentral" @@ -1215,10 +1214,17 @@ def add_heat(n, costs): ## Add heat load for sector in sectors: + # heat demand weighting if "rural" in name: factor = 1 - urban_fraction[nodes[name]] - elif "urban" in name: - factor = urban_fraction[nodes[name]] + elif "urban central" in name: + factor = dist_fraction[nodes[name]] + elif "urban decentral" in name: + factor = urban_fraction[nodes[name]] - \ + dist_fraction[nodes[name]] + else: + factor = None + if sector in name: heat_load = heat_demand[[sector + " water",sector + " space"]].groupby(level=1,axis=1).sum()[nodes[name]].multiply(factor) @@ -1281,16 +1287,16 @@ def add_heat(n, costs): p_nom_extendable=True ) - + if isinstance(options["tes_tau"], dict): tes_time_constant_days = options["tes_tau"][name_type] else: logger.warning("Deprecated: a future version will require you to specify 'tes_tau' ", "for 'decentral' and 'central' separately.") tes_time_constant_days = options["tes_tau"] if name_type == "decentral" else 180. - + # conversion from EUR/m^3 to EUR/MWh for 40 K diff and 1.17 kWh/m^3/K - capital_cost = costs.at[name_type + ' water tank storage', 'fixed'] / 0.00117 / 40 + capital_cost = costs.at[name_type + ' water tank storage', 'fixed'] / 0.00117 / 40 n.madd("Store", nodes[name] + f" {name} water tanks", @@ -1503,24 +1509,55 @@ def create_nodes_for_heat_sector(): # rural are areas with low heating density and individual heating # urban are areas with high heating density # urban can be split into district heating (central) and individual heating (decentral) - + + ct_urban = pop_layout.urban.groupby(pop_layout["ct"]).sum() + pop_layout["urban_ct_fraction"] = pop_layout["urban"] / \ + pop_layout["ct"].map(ct_urban.get) + # todays district heating share per country + dist_heat_share_ct = pd.read_csv(snakemake.input.dh_share, index_col=0, + usecols=[0,1]).dropna()/100 + dist_heat_share = pop_layout.ct.map(dist_heat_share_ct["district heating share"]) + + sectors = ["residential", "services"] - + nodes = {} + urban_fraction = pop_layout["urban"] / \ + (pop_layout[["urban", "rural"]].sum(axis=1)) + for sector in sectors: nodes[sector + " rural"] = pop_layout.index + nodes[sector + " urban decentral"] = pop_layout.index - if options["central"]: - # TODO: this looks hardcoded, move to config - urban_decentral_ct = pd.Index(["ES", "GR", "PT", "IT", "BG"]) - nodes[sector + " urban decentral"] = pop_layout.index[pop_layout.ct.isin(urban_decentral_ct)] - else: - nodes[sector + " urban decentral"] = pop_layout.index - - # for central nodes, residential and services are aggregated - nodes["urban central"] = pop_layout.index.symmetric_difference(nodes["residential urban decentral"]) - - return nodes + if options["central"] and not options['district_heating_increase']: + central_fraction = options['central_fraction'] + dist_fraction = central_fraction * urban_fraction + nodes["urban central"] = dist_fraction.index + + if options['district_heating_increase']: # take current district heating share + dist_fraction = dist_heat_share * \ + pop_layout["urban_ct_fraction"] / pop_layout["fraction"] + nodes["urban central"] = dist_fraction.index + # if district heating share larger than urban fraction -> set urban + # fraction to district heating share + urban_fraction = pd.concat([urban_fraction, dist_fraction], + axis=1).max(axis=1) + diff = urban_fraction - dist_fraction + dist_fraction += diff * get(options["dh_strength"], investment_year) + print("************************************") + print( + "the current DH share compared to the maximum possible is increased \ + \n by a factor of ", + get(options["dh_strength"], investment_year), + "resulting DH share: ", + dist_fraction) + print("**********************************") + + else: + dist_fraction = urban_fraction * 0 + nodes["urban central"] = dist_fraction.index + + return nodes, dist_fraction, urban_fraction def add_biomass(n, costs): @@ -1730,9 +1767,9 @@ def add_industry(n, costs): if shipping_hydrogen_share < 1: shipping_oil_share = 1 - shipping_hydrogen_share - + p_set = shipping_oil_share * nodal_energy_totals.loc[nodes, all_navigation].sum(axis=1) * 1e6 / 8760. - + n.madd("Load", nodes, suffix=" shipping oil", @@ -1740,7 +1777,7 @@ def add_industry(n, costs): carrier="shipping oil", p_set=p_set ) - + co2 = shipping_oil_share * nodal_energy_totals.loc[nodes, all_navigation].sum().sum() * 1e6 / 8760 * costs.at["oil", "CO2 intensity"] n.add("Load", @@ -1759,7 +1796,7 @@ def add_industry(n, costs): ) if "EU oil Store" not in n.stores.index: - + #could correct to e.g. 0.001 EUR/kWh * annuity and O&M n.add("Store", "EU oil Store", @@ -1781,7 +1818,7 @@ def add_industry(n, costs): if options["oil_boilers"]: - nodes_heat = create_nodes_for_heat_sector() + nodes_heat = create_nodes_for_heat_sector()[0] for name in ["residential rural", "services rural", "residential urban decentral", "services urban decentral"]: @@ -1926,7 +1963,7 @@ def add_waste_heat(n): def decentral(n): - """Removes the electricity transmission system.""" + """Removes the electricity transmission system.""" n.lines.drop(n.lines.index, inplace=True) n.links.drop(n.links.index[n.links.carrier.isin(["DC", "B2B"])], inplace=True) @@ -1973,17 +2010,18 @@ def limit_individual_line_extension(n, maxext): hvdc = n.links.index[n.links.carrier == 'DC'] n.links.loc[hvdc, 'p_nom_max'] = n.links.loc[hvdc, 'p_nom'] + maxext - +#%% if __name__ == "__main__": if 'snakemake' not in globals(): from helper import mock_snakemake snakemake = mock_snakemake( 'prepare_sector_network', simpl='', - clusters=48, + opts="", + clusters="37", lv=1.0, sector_opts='Co2L0-168H-T-H-B-I-solar3-dist1', - planning_horizons=2020, + planning_horizons="2020", ) logging.basicConfig(level=snakemake.config['logging_level']) @@ -1998,7 +2036,7 @@ if __name__ == "__main__": n = pypsa.Network(snakemake.input.network, override_component_attrs=overrides) pop_layout = pd.read_csv(snakemake.input.clustered_pop_layout, index_col=0) - Nyears = n.snapshot_weightings.generators.sum() / 8760 + Nyears = n.snapshot_weightings.sum() / 8760 costs = prepare_costs(snakemake.input.costs, snakemake.config['costs']['USD2013_to_EUR2013'], @@ -2009,7 +2047,7 @@ if __name__ == "__main__": patch_electricity_network(n) if snakemake.config["foresight"] == 'myopic': - + add_lifetime_wind_solar(n, costs) conventional = snakemake.config['existing_capacities']['conventional_carriers'] From 56bdeafacbff5c731aa4859cec96917f3ed38ed1 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Fri, 9 Jul 2021 10:42:16 +0200 Subject: [PATCH 034/132] add co2 network topology --- scripts/prepare_sector_network.py | 37 ++++++++++++++++++++++++++++--- 1 file changed, 34 insertions(+), 3 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index c5a99fcc..bff2d840 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -54,6 +54,39 @@ def get(item, investment_year=None): return item +def create_network_topology(n, prefix, connector=" -> "): + """ + Create a network topology like the power transmission network. + + Parameters + ---------- + n : pypsa.Network + prefix : str + connector : str + + Returns + ------- + pd.DataFrame with columns bus0, bus1 and length + """ + + attrs = ["bus0", "bus1", "length"] + + candidates = pd.concat([ + n.lines[attrs], + n.links.loc[n.links.carrier == "DC", attrs] + ]) + + positive_order = candidates.bus0 < candidates.bus1 + candidates_p = candidates[positive_order] + swap_buses = {"bus0": "bus1", "bus1": "bus0"} + candidates_n = candidates[~positive_order].rename(columns=swap_buses) + candidates = pd.concat([candidates_p, candidates_n]) + + topo = candidates.groupby(["bus0", "bus1"], as_index=False).mean() + topo.index = topo.apply(lambda c: prefix + c.bus0 + connector + c.bus1, axis=1) + return topo + + def co2_emissions_year(countries, opts, year): """ Calculate CO2 emissions in one specific year (e.g. 1990 or 2018). @@ -347,10 +380,8 @@ def add_co2_tracking(n, options): def add_co2_network(n, costs): - # TODO create co2 network topology from electricity - co2_links = pd.DataFrame() + co2_links = create_network_topology(n, "CO2 pipeline ") - # assumed to be bidirectional n.madd("Link", co2_links.index, bus0=co2_links.bus0.values + " co2 stored", From 62bba87cda517f253dce0ab6bb41d76b4831271a Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Fri, 9 Jul 2021 10:42:16 +0200 Subject: [PATCH 035/132] add co2 network topology Co-authored-by: lisazeyen --- scripts/prepare_sector_network.py | 37 ++++++++++++++++++++++++++++--- 1 file changed, 34 insertions(+), 3 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index c5a99fcc..bff2d840 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -54,6 +54,39 @@ def get(item, investment_year=None): return item +def create_network_topology(n, prefix, connector=" -> "): + """ + Create a network topology like the power transmission network. + + Parameters + ---------- + n : pypsa.Network + prefix : str + connector : str + + Returns + ------- + pd.DataFrame with columns bus0, bus1 and length + """ + + attrs = ["bus0", "bus1", "length"] + + candidates = pd.concat([ + n.lines[attrs], + n.links.loc[n.links.carrier == "DC", attrs] + ]) + + positive_order = candidates.bus0 < candidates.bus1 + candidates_p = candidates[positive_order] + swap_buses = {"bus0": "bus1", "bus1": "bus0"} + candidates_n = candidates[~positive_order].rename(columns=swap_buses) + candidates = pd.concat([candidates_p, candidates_n]) + + topo = candidates.groupby(["bus0", "bus1"], as_index=False).mean() + topo.index = topo.apply(lambda c: prefix + c.bus0 + connector + c.bus1, axis=1) + return topo + + def co2_emissions_year(countries, opts, year): """ Calculate CO2 emissions in one specific year (e.g. 1990 or 2018). @@ -347,10 +380,8 @@ def add_co2_tracking(n, options): def add_co2_network(n, costs): - # TODO create co2 network topology from electricity - co2_links = pd.DataFrame() + co2_links = create_network_topology(n, "CO2 pipeline ") - # assumed to be bidirectional n.madd("Link", co2_links.index, bus0=co2_links.bus0.values + " co2 stored", From 4f9d2f9d5f91286e334168a9ec8638d1d2141cd0 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Fri, 9 Jul 2021 12:50:40 +0200 Subject: [PATCH 036/132] add concept for management of spatial resolutions --- scripts/prepare_sector_network.py | 86 +++++++++++++++++++------------ 1 file changed, 54 insertions(+), 32 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index bff2d840..0ef06a00 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -19,6 +19,37 @@ from helper import override_component_attrs import logging logger = logging.getLogger(__name__) +from types import SimpleNamespace +spatial = SimpleNamespace() + + +def define_spatial(nodes): + """ + Namespace for spatial + + Parameters + ---------- + nodes : list-like + """ + + global spatial + global options + + spatial.nodes = nodes + + spatial.co2 = SimpleNamespace() + + if options["co2_network"]: + spatial.co2.nodes = nodes + " co2 stored" + spatial.co2.locations = nodes + spatial.co2.vents = nodes + " co2 vent" + else: + spatial.co2.nodes = ["co2 stored"] + spatial.co2.locations = "EU" + spatial.co2.vents = ["co2 vent"] + + spatial.co2.df = pd.DataFrame(vars(spatial.co2), index=nodes) + def emission_sectors_from_opts(opts): @@ -310,18 +341,6 @@ def patch_electricity_network(n): def add_co2_tracking(n, options): - if options["co2_network"]: - nodes = pop_layout.index - co2_nodes = nodes + " co2 stored" - co2_locations = nodes - co2_vents = nodes + " co2 vent" - co2_max_sequestration = np.inf - else: - co2_nodes = ["co2 stored"] - co2_locations = "EU" - co2_vents = ["co2 vent"] - co2_max_sequestration = np.inf # TODO should be nodal sequestration potentials - # minus sign because opposite to how fossil fuels used: # CH4 burning puts CH4 down, atmosphere up n.add("Carrier", "co2", @@ -345,18 +364,18 @@ def add_co2_tracking(n, options): # this tracks CO2 stored, e.g. underground n.madd("Bus", - co2_nodes, - location=co2_locations, + spatial.co2.nodes, + location=spatial.co2.locations, carrier="co2 stored" ) n.madd("Store", - co2_nodes, + spatial.co2.nodes, e_nom_extendable=True, - e_nom_max=co2_max_sequestration, + e_nom_max=np.inf, capital_cost=options['co2_sequestration_cost'], carrier="co2 stored", - bus=co2_nodes + bus=spatial.co2.nodes ) # TODO if nodally resolved total allowed sequestration needs to @@ -369,8 +388,8 @@ def add_co2_tracking(n, options): if options['co2_vent']: n.madd("Link", - co2_vents, - bus0=co2_nodes, + spatial.co2.vents, + bus0=spatial.co2.nodes, bus1="co2 atmosphere", carrier="co2 vent", efficiency=1., @@ -408,7 +427,7 @@ def add_dac(n, costs): locations, suffix=" DAC", bus0="co2 atmosphere", - bus1="co2 stored", + bus1=spatial.co2.df.loc[locations, "nodes"].values, bus2=locations.values, bus3=heat_buses, carrier="DAC", @@ -1058,10 +1077,11 @@ def add_storage(n, costs): if options['methanation']: n.madd("Link", - nodes + " Sabatier", + spatial.nodes, + suffix=" Sabatier", bus0=nodes + " H2", bus1="EU gas", - bus2="co2 stored", + bus2=spatial.co2.nodes, p_nom_extendable=True, carrier="Sabatier", efficiency=costs.at["methanation", "efficiency"], @@ -1073,10 +1093,11 @@ def add_storage(n, costs): if options['helmeth']: n.madd("Link", - nodes + " helmeth", + spatial.nodes, + suffix=" helmeth", bus0=nodes, bus1="EU gas", - bus2="co2 stored", + bus2=spatial.co2.nodes, carrier="helmeth", p_nom_extendable=True, efficiency=costs.at["helmeth", "efficiency"], @@ -1089,11 +1110,12 @@ def add_storage(n, costs): if options['SMR']: n.madd("Link", - nodes + " SMR CC", + spatial.nodes, + suffix=" SMR CC", bus0="EU gas", bus1=nodes + " H2", bus2="co2 atmosphere", - bus3="co2 stored", + bus3=spatial.co2.nodes, p_nom_extendable=True, carrier="SMR CC", efficiency=costs.at["SMR CC", "efficiency"], @@ -1442,7 +1464,7 @@ def add_heat(n, costs): bus1=nodes[name], bus2=nodes[name] + " urban central heat", bus3="co2 atmosphere", - bus4="co2 stored", + bus4=spatial.co2.df.loc[nodes[name], "nodes"].values, carrier="urban central gas CHP CC", p_nom_extendable=True, capital_cost=costs.at['central gas CHP', 'fixed']*costs.at['central gas CHP', 'efficiency'] + costs.at['biomass CHP capture', 'fixed']*costs.at['gas', 'CO2 intensity'], @@ -1675,7 +1697,7 @@ def add_biomass(n, costs): bus1=urban_central, bus2=urban_central + " urban central heat", bus3="co2 atmosphere", - bus4="co2 stored", + bus4=spatial.co2.df.loc[urban_central, "nodes"].values, carrier="urban central solid biomass CHP CC", p_nom_extendable=True, capital_cost=costs.at[key, 'fixed'] * costs.at[key, 'efficiency'] + costs.at['biomass CHP capture', 'fixed'] * costs.at['solid biomass', 'CO2 intensity'], @@ -1726,7 +1748,7 @@ def add_industry(n, costs): bus0="EU solid biomass", bus1="solid biomass for industry", bus2="co2 atmosphere", - bus3="co2 stored", + bus3="co2 stored", # TODO co2: where to allocate if co2 is spatially resolved? carrier="solid biomass for industry CC", p_nom_extendable=True, capital_cost=costs.at["cement capture", "fixed"] * costs.at['solid biomass', 'CO2 intensity'], @@ -1764,7 +1786,7 @@ def add_industry(n, costs): bus0="EU gas", bus1="gas for industry", bus2="co2 atmosphere", - bus3="co2 stored", + bus3="co2 stored", # TODO co2: where to allocate if co2 is spatially resolved? carrier="gas for industry CC", p_nom_extendable=True, capital_cost=costs.at["cement capture", "fixed"] * costs.at['gas', 'CO2 intensity'], @@ -1847,7 +1869,7 @@ def add_industry(n, costs): nodes + " Fischer-Tropsch", bus0=nodes + " H2", bus1="EU oil", - bus2="co2 stored", + bus2=spatial.co2.nodes, carrier="Fischer-Tropsch", efficiency=costs.at["Fischer-Tropsch", 'efficiency'], capital_cost=costs.at["Fischer-Tropsch", 'fixed'], @@ -1940,7 +1962,7 @@ def add_industry(n, costs): "process emissions CC", bus0="process emissions", bus1="co2 atmosphere", - bus2="co2 stored", + bus2="co2 stored", # TODO co2: where to allocate if co2 is spatially resolved? carrier="process emissions CC", p_nom_extendable=True, capital_cost=costs.at["cement capture", "fixed"], From 2b204c45e421b8459371a46f79e0bb4e24c50851 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Fri, 9 Jul 2021 12:51:48 +0200 Subject: [PATCH 037/132] run define_spatial in __main__ --- scripts/prepare_sector_network.py | 2 ++ 1 file changed, 2 insertions(+) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 0ef06a00..0552790a 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -2075,6 +2075,8 @@ if __name__ == "__main__": patch_electricity_network(n) + define_spatial(pop_layout.index) + if snakemake.config["foresight"] == 'myopic': add_lifetime_wind_solar(n, costs) From cd99089628ea3c54925ddef7fa190a2d9e3bb729 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Fri, 9 Jul 2021 13:10:43 +0200 Subject: [PATCH 038/132] account for underwater fraction --- scripts/prepare_sector_network.py | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 0552790a..aced4719 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -100,12 +100,13 @@ def create_network_topology(n, prefix, connector=" -> "): pd.DataFrame with columns bus0, bus1 and length """ - attrs = ["bus0", "bus1", "length"] + ln_attrs = ["bus0", "bus1", "length"] + lk_attrs = ["bus0", "bus1", "length", "underwater_fraction"] candidates = pd.concat([ - n.lines[attrs], - n.links.loc[n.links.carrier == "DC", attrs] - ]) + n.lines[ln_attrs], + n.links.loc[n.links.carrier == "DC", lk_attrs] + ]).fillna(0) positive_order = candidates.bus0 < candidates.bus1 candidates_p = candidates[positive_order] @@ -400,6 +401,10 @@ def add_co2_tracking(n, options): def add_co2_network(n, costs): co2_links = create_network_topology(n, "CO2 pipeline ") + + cost_onshore = (1 - co2_links.underwater_fraction) * costs.at['CO2 pipeline', 'fixed'] * co2_links.length + cost_submarine = co2_links.underwater_fraction * costs.at['CO2 pipeline submarine', 'fixed'] * co2_links.length + capital_cost = cost_onshore + cost_submarine n.madd("Link", co2_links.index, @@ -408,7 +413,7 @@ def add_co2_network(n, costs): p_min_pu=-1, p_nom_extendable=True, length=co2_links.length.values, - capital_cost=costs.at['CO2 pipeline', 'fixed'] * co2_links.length.values, + capital_cost=capital_cost.values, carrier="CO2 pipeline", lifetime=costs.at['CO2 pipeline', 'lifetime'] ) From d58a7f86a45c4825c843d1a35f64715f7cd7c376 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Fri, 9 Jul 2021 13:22:00 +0200 Subject: [PATCH 039/132] allow copperplated carbon capture to be distributed freely to co2 stores --- scripts/prepare_sector_network.py | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index aced4719..16eb12f6 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1748,12 +1748,13 @@ def add_industry(n, costs): efficiency=1. ) - n.add("Link", - "solid biomass for industry CC", + n.madd("Link", + spatial.co2.locations, + suffix=" solid biomass for industry CC", bus0="EU solid biomass", bus1="solid biomass for industry", bus2="co2 atmosphere", - bus3="co2 stored", # TODO co2: where to allocate if co2 is spatially resolved? + bus3=spatial.co2.nodes, carrier="solid biomass for industry CC", p_nom_extendable=True, capital_cost=costs.at["cement capture", "fixed"] * costs.at['solid biomass', 'CO2 intensity'], @@ -1786,12 +1787,13 @@ def add_industry(n, costs): efficiency2=costs.at['gas', 'CO2 intensity'] ) - n.add("Link", - "gas for industry CC", + n.madd("Link", + spatial.co2.locations, + suffix=" gas for industry CC", bus0="EU gas", bus1="gas for industry", bus2="co2 atmosphere", - bus3="co2 stored", # TODO co2: where to allocate if co2 is spatially resolved? + bus3=spatial.co2.nodes, carrier="gas for industry CC", p_nom_extendable=True, capital_cost=costs.at["cement capture", "fixed"] * costs.at['gas', 'CO2 intensity'], @@ -1963,11 +1965,12 @@ def add_industry(n, costs): ) #assume enough local waste heat for CC - n.add("Link", - "process emissions CC", + n.madd("Link", + spatial.co2.locations, + suffix=" process emissions CC", bus0="process emissions", bus1="co2 atmosphere", - bus2="co2 stored", # TODO co2: where to allocate if co2 is spatially resolved? + bus2=spatial.co2.nodes, carrier="process emissions CC", p_nom_extendable=True, capital_cost=costs.at["cement capture", "fixed"], From 0127c47035e6b80133dcb1f210dc0316dc942e4a Mon Sep 17 00:00:00 2001 From: lisazeyen <35347358+lisazeyen@users.noreply.github.com> Date: Fri, 9 Jul 2021 13:56:44 +0200 Subject: [PATCH 040/132] Update prepare_sector_network.py bug fix when calculating urban central heat demand --- scripts/prepare_sector_network.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 92fce889..61a5c896 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1229,7 +1229,7 @@ def add_heat(n, costs): heat_load = heat_demand[[sector + " water",sector + " space"]].groupby(level=1,axis=1).sum()[nodes[name]].multiply(factor) if name == "urban central": - heat_load = heat_demand.groupby(level=1,axis=1).sum()[nodes[name]].multiply(urban_fraction[nodes[name]] * (1 + options['district_heating_loss'])) + heat_load = heat_demand.groupby(level=1,axis=1).sum()[nodes[name]].multiply(factor * (1 + options['district_heating_loss'])) n.madd("Load", nodes[name], From 36fdde788760e0f7fc943975ff57b64cfb10d83e Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Fri, 9 Jul 2021 14:36:13 +0200 Subject: [PATCH 041/132] correctly name co2 submarine pipeline! --- scripts/prepare_sector_network.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 16eb12f6..ca956e44 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -403,7 +403,7 @@ def add_co2_network(n, costs): co2_links = create_network_topology(n, "CO2 pipeline ") cost_onshore = (1 - co2_links.underwater_fraction) * costs.at['CO2 pipeline', 'fixed'] * co2_links.length - cost_submarine = co2_links.underwater_fraction * costs.at['CO2 pipeline submarine', 'fixed'] * co2_links.length + cost_submarine = co2_links.underwater_fraction * costs.at['CO2 submarine pipeline', 'fixed'] * co2_links.length capital_cost = cost_onshore + cost_submarine n.madd("Link", From 9039b130fa1dde78898fd4ceee9a5489d57c165c Mon Sep 17 00:00:00 2001 From: lisazeyen <35347358+lisazeyen@users.noreply.github.com> Date: Fri, 9 Jul 2021 15:30:21 +0200 Subject: [PATCH 042/132] bug fix to avoid same link names for DAX --- scripts/prepare_sector_network.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 61a5c896..54f1bab9 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -328,7 +328,7 @@ def add_co2_tracking(n, options): def add_dac(n, costs): - heat_carriers = ["urban central heat", "services urban decentral heat"] + heat_carriers = ["urban central heat"] heat_buses = n.buses.index[n.buses.carrier.isin(heat_carriers)] locations = n.buses.location[heat_buses] From 2563d1277a5daff685b50df9f1a7957f8f78f9e7 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Sun, 11 Jul 2021 17:52:32 +0200 Subject: [PATCH 043/132] spatially-explicit biomass potentials from ENSPRESO (NUTS2) --- Snakefile | 19 ++- config.default.yaml | 34 ++--- scripts/build_biomass_potentials.py | 193 ++++++++++++++++++++++------ scripts/prepare_sector_network.py | 11 +- 4 files changed, 186 insertions(+), 71 deletions(-) diff --git a/Snakefile b/Snakefile index b91785d9..286df421 100644 --- a/Snakefile +++ b/Snakefile @@ -1,4 +1,7 @@ +from snakemake.remote.HTTP import RemoteProvider as HTTPRemoteProvider +HTTP = HTTPRemoteProvider() + configfile: "config.yaml" @@ -170,13 +173,19 @@ rule build_energy_totals: rule build_biomass_potentials: input: - jrc_potentials="data/biomass/JRC Biomass Potentials.xlsx" + enspreso_biomass=HTTP.remote("https://cidportal.jrc.ec.europa.eu/ftp/jrc-opendata/ENSPRESO/ENSPRESO_BIOMASS.xlsx", keep_local=True), + nuts2="data/nuts/NUTS_RG_10M_2013_4326_LEVL_2.geojson", # https://gisco-services.ec.europa.eu/distribution/v2/nuts/download/#nuts21 + regions_onshore=pypsaeur("resources/regions_onshore_elec_s{simpl}_{clusters}.geojson"), + nuts3_population=pypsaeur("data/bundle/nama_10r_3popgdp.tsv.gz"), + swiss_cantons=pypsaeur("data/bundle/ch_cantons.csv"), + swiss_population=pypsaeur("data/bundle/je-e-21.03.02.xls"), + country_shapes=pypsaeur('resources/country_shapes.geojson') output: - biomass_potentials_all='resources/biomass_potentials_all.csv', - biomass_potentials='resources/biomass_potentials.csv' + biomass_potentials_all='resources/biomass_potentials_all_s{simpl}_{clusters}.csv', + biomass_potentials='resources/biomass_potentials_s{simpl}_{clusters}.csv' threads: 1 resources: mem_mb=1000 - benchmark: "benchmarks/build_biomass_potentials" + benchmark: "benchmarks/build_biomass_potentials_s{simpl}_{clusters}" script: 'scripts/build_biomass_potentials.py' @@ -323,7 +332,7 @@ rule prepare_sector_network: transport_name='resources/transport_data.csv', traffic_data_KFZ = "data/emobility/KFZ__count", traffic_data_Pkw = "data/emobility/Pkw__count", - biomass_potentials='resources/biomass_potentials.csv', + biomass_potentials='resources/biomass_potentials_s{simpl}_{clusters}.csv', heat_profile="data/heat_load_profile_BDEW.csv", costs=CDIR + "costs_{planning_horizons}.csv", profile_offwind_ac=pypsaeur("resources/profile_offwind-ac.nc"), diff --git a/config.default.yaml b/config.default.yaml index 457c3660..4161470e 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -99,28 +99,28 @@ energy: biomass: year: 2030 - scenario: Med + scenario: ENS_Med classes: solid biomass: - - Primary agricultural residues - - Forestry energy residue - - Secondary forestry residues - - Secondary Forestry residues sawdust - - Forestry residues from landscape care biomass + - Argicultural waste - Municipal waste + - Residues from landscape care + - Sawdust + - Secondary Forestry residues - woodchips not included: - - Bioethanol sugar beet biomass - - Rapeseeds for biodiesel - - sunflower and soya for Biodiesel - - Starchy crops biomass - - Grassy crops biomass - - Willow biomass - - Poplar biomass potential - - Roundwood fuelwood - - Roundwood Chips & Pellets + - Bioethanol barley, wheat, grain maize, oats, other cereals and rye + - Fuelwood residues + - C&P_RW + - FuelwoodRW + - Rape seed + - Sugar from sugar beet + - Miscanthus, switchgrass, RCG + - "Sunflower, soya seed " + - Poplar + - Willow biogas: - - Manure biomass potential - - Sludge biomass + - Manure solid, liquid + - Sludge solar_thermal: diff --git a/scripts/build_biomass_potentials.py b/scripts/build_biomass_potentials.py index f02c9093..59eb0051 100644 --- a/scripts/build_biomass_potentials.py +++ b/scripts/build_biomass_potentials.py @@ -1,55 +1,148 @@ import pandas as pd - -rename = {"UK" : "GB", "BH" : "BA"} +import geopandas as gpd -def build_biomass_potentials(): +def build_nuts_population_data(year=2013): - config = snakemake.config['biomass'] - year = config["year"] - scenario = config["scenario"] + pop = pd.read_csv( + snakemake.input.nuts3_population, + sep=r'\,| \t|\t', + engine='python', + na_values=[":"], + index_col=1 + )[str(year)] + + # only countries + pop.drop("EU28", inplace=True) - df = pd.read_excel(snakemake.input.jrc_potentials, - "Potentials (PJ)", - index_col=[0,1]) + # mapping from Cantons to NUTS3 + cantons = pd.read_csv(snakemake.input.swiss_cantons) + cantons = cantons.set_index(cantons.HASC.str[3:]).NUTS + cantons = cantons.str.pad(5, side='right', fillchar='0') - df.rename(columns={"Unnamed: 18": "Municipal waste"}, inplace=True) - df.drop(columns="Total", inplace=True) - df.replace("-", 0., inplace=True) + # get population by NUTS3 + swiss = pd.read_excel(snakemake.input.swiss_population, skiprows=3, index_col=0).loc["Residents in 1000"] + swiss = swiss.rename(cantons).filter(like="CH") - column = df.iloc[:,0] - countries = column.where(column.str.isalpha()).pad() - countries = [rename.get(ct, ct) for ct in countries] - countries_i = pd.Index(countries, name='country') - df.set_index(countries_i, append=True, inplace=True) + # aggregate also to higher order NUTS levels + swiss = [swiss.groupby(swiss.index.str[:i]).sum() for i in range(2, 6)] - df.drop(index='MS', level=0, inplace=True) + # merge Europe + Switzerland + pop = pd.DataFrame(pop.append(swiss), columns=["total"]) + + # add missing manually + pop["AL"] = 2893 + pop["BA"] = 3871 + pop["RS"] = 7210 + + pop["ct"] = pop.index.str[:2] + + return pop - # convert from PJ to MWh - df = df / 3.6 * 1e6 - df.to_csv(snakemake.output.biomass_potentials_all) +def enspreso_biomass_potentials(year=2020, scenario="ENS_Low"): + + glossary = pd.read_excel( + snakemake.input.enspreso_biomass, + sheet_name="Glossary", + usecols="B:D", + skiprows=1, + index_col=0 + ) + + df = pd.read_excel( + snakemake.input.enspreso_biomass, + sheet_name="ENER - NUTS2 BioCom E", + usecols="A:H" + ) - # solid biomass includes: - # Primary agricultural residues (MINBIOAGRW1), - # Forestry energy residue (MINBIOFRSF1), - # Secondary forestry residues (MINBIOWOOW1), - # Secondary Forestry residues – sawdust (MINBIOWOO1a)', - # Forestry residues from landscape care biomass (MINBIOFRSF1a), - # Municipal waste (MINBIOMUN1)', + df["group"] = df["E-Comm"].map(glossary.group) + df["commodity"] = df["E-Comm"].map(glossary.description) - # biogas includes: - # Manure biomass potential (MINBIOGAS1), - # Sludge biomass (MINBIOSLU1), + to_rename = { + "NUTS2 Potential available by Bio Commodity": "potential", + "NUST2": "NUTS2", + } + df.rename(columns=to_rename, inplace=True) + + # fill up with NUTS0 if NUTS2 is not given + df.NUTS2 = df.apply(lambda x: x.NUTS0 if x.NUTS2 == '-' else x.NUTS2, axis=1) - df = df.loc[year, scenario, :] + # convert PJ to TWh + df.potential /= 3.6 + df.Unit = "TWh/a" - grouper = {v: k for k, vv in config["classes"].items() for v in vv} - df = df.groupby(grouper, axis=1).sum() + dff = df.query("Year == @year and Scenario == @scenario") - df.index.name = "MWh/a" + bio = dff.groupby(["NUTS2", "commodity"]).potential.sum().unstack() + + # currently Serbia and Kosovo not split, so aggregate + bio.loc["RS"] += bio.loc["XK"] + bio.drop("XK", inplace=True) + + return bio - df.to_csv(snakemake.output.biomass_potentials) + +def disaggregate_nuts0(bio): + + pop = build_nuts_population_data() + + # get population in nuts2 + pop_nuts2 = pop.loc[pop.index.str.len() == 4] + by_country = pop_nuts2.total.groupby(pop_nuts2.ct).sum() + pop_nuts2["fraction"] = pop_nuts2.total / pop_nuts2.ct.map(by_country) + + # distribute nuts0 data to nuts2 by population + bio_nodal = bio.loc[pop_nuts2.ct] + bio_nodal.index = pop_nuts2.index + bio_nodal = bio_nodal.mul(pop_nuts2.fraction, axis=0) + + # update inplace + bio.update(bio_nodal) + + return bio + + +def build_nuts2_shapes(): + """ + - load NUTS2 geometries + - add RS, AL, BA country shapes (not covered in NUTS 2013) + - consistently name ME, MK + """ + + nuts2 = gpd.GeoDataFrame(gpd.read_file(snakemake.input.nuts2).set_index('id').geometry) + + countries = gpd.read_file(snakemake.input.country_shapes).set_index('name') + missing = countries.loc[["AL", "RS", "BA"]] + nuts2.rename(index={"ME00": "ME", "MK00": "MK"}, inplace=True) + + return nuts2.append(missing) + + +def area(gdf): + """Returns area of GeoDataFrame geometries in square kilometers.""" + return gdf.to_crs(epsg=3035).area.div(1e6) + + +def convert_nuts2_to_regions(bio_nuts2, regions): + + # calculate area of nuts2 regions + bio_nuts2["area_nuts2"] = area(bio_nuts2) + + overlay = gpd.overlay(regions, bio_nuts2) + + # calculate share of nuts2 area inside region + overlay["share"] = area(overlay) / overlay["area_nuts2"] + + # multiply all nuts2-level values with share of nuts2 inside region + adjust_cols = overlay.columns.difference({"name", "area_nuts2", "geometry", "share"}) + overlay[adjust_cols] = overlay[adjust_cols].multiply(overlay["share"], axis=0) + + bio_regions = overlay.groupby("name").sum() + + bio_regions.drop(["area_nuts2", "share"], axis=1, inplace=True) + + return bio_regions if __name__ == "__main__": @@ -57,12 +150,28 @@ if __name__ == "__main__": from helper import mock_snakemake snakemake = mock_snakemake('build_biomass_potentials') + config = snakemake.config['biomass'] + year = config["year"] + scenario = config["scenario"] - # This is a hack, to be replaced once snakemake is unicode-conform + enspreso = enspreso_biomass_potentials(year, scenario) - solid_biomass = snakemake.config['biomass']['classes']['solid biomass'] - if 'Secondary Forestry residues sawdust' in solid_biomass: - solid_biomass.remove('Secondary Forestry residues sawdust') - solid_biomass.append('Secondary Forestry residues – sawdust') + enspreso = disaggregate_nuts0(enspreso) - build_biomass_potentials() + nuts2 = build_nuts2_shapes() + + df_nuts2 = gpd.GeoDataFrame(nuts2.geometry).join(enspreso) + + regions = gpd.read_file(snakemake.input.regions_onshore) + + df = convert_nuts2_to_regions(df_nuts2, regions) + + df.to_csv(snakemake.output.biomass_potentials_all) + + grouper = {v: k for k, vv in config["classes"].items() for v in vv} + df = df.groupby(grouper, axis=1).sum() + + df *= 1e6 # TWh/a to MWh/a + df.index.name = "MWh/a" + + df.to_csv(snakemake.output.biomass_potentials) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 82e15e60..ebf2ee71 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1527,9 +1527,6 @@ def add_biomass(n, costs): print("adding biomass") - # biomass distributed at country level - i.e. transport within country allowed - countries = n.buses.country.dropna().unique() - biomass_potentials = pd.read_csv(snakemake.input.biomass_potentials, index_col=0) n.add("Carrier", "biogas") @@ -1552,18 +1549,18 @@ def add_biomass(n, costs): "EU biogas", bus="EU biogas", carrier="biogas", - e_nom=biomass_potentials.loc[countries, "biogas"].sum(), + e_nom=biomass_potentials["biogas"].sum(), marginal_cost=costs.at['biogas', 'fuel'], - e_initial=biomass_potentials.loc[countries, "biogas"].sum() + e_initial=biomass_potentials["biogas"].sum() ) n.add("Store", "EU solid biomass", bus="EU solid biomass", carrier="solid biomass", - e_nom=biomass_potentials.loc[countries, "solid biomass"].sum(), + e_nom=biomass_potentials["solid biomass"].sum(), marginal_cost=costs.at['solid biomass', 'fuel'], - e_initial=biomass_potentials.loc[countries, "solid biomass"].sum() + e_initial=biomass_potentials["solid biomass"].sum() ) n.add("Link", From d1298fa93d20f103de3c8a0d81d45f8e149d4df6 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 12 Jul 2021 12:31:18 +0200 Subject: [PATCH 044/132] use spatial namespace to manage biomass transport resolution --- scripts/build_biomass_transport_costs.py | 2 +- scripts/prepare_sector_network.py | 254 ++++++++++------------- 2 files changed, 109 insertions(+), 147 deletions(-) diff --git a/scripts/build_biomass_transport_costs.py b/scripts/build_biomass_transport_costs.py index ee681566..703d81ae 100644 --- a/scripts/build_biomass_transport_costs.py +++ b/scripts/build_biomass_transport_costs.py @@ -67,4 +67,4 @@ def build_biomass_transport_costs(): if __name__ == "__main__": - prepare_biomass_transport_costs() + build_biomass_transport_costs() diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index e77dac56..91bcc2e9 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -19,10 +19,43 @@ from helper import override_component_attrs import logging logger = logging.getLogger(__name__) +from types import SimpleNamespace +spatial = SimpleNamespace() + + +def define_spatial(nodes): + """ + Namespace for spatial + + Parameters + ---------- + nodes : list-like + """ + + global spatial + global options + + spatial.nodes = nodes + + spatial.biomass = SimpleNamespace() + + if options["biomass_transport"]: + spatial.biomass.nodes = nodes + " solid biomass" + spatial.biomass.locations = nodes + spatial.biomass.industry = nodes + " solid biomass for industry" + spatial.biomass.industry_cc = nodes + " solid biomass for industry CC" + else: + spatial.biomass.nodes = ["EU solid biomass"] + spatial.biomass.locations = "EU" + spatial.biomass.industry = ["solid biomass for industry"] + spatial.biomass.industry_cc = ["solid biomass for industry CC"] + + spatial.biomass.df = pd.DataFrame(vars(spatial.biomass), index=nodes) + def emission_sectors_from_opts(opts): - sectors = ["electricity"] + sectors = ["electricity"] if "T" in opts: sectors += [ "rail non-elec", @@ -144,25 +177,50 @@ def add_lifetime_wind_solar(n, costs): n.generators.loc[gen_i, "lifetime"] = costs.at[carrier, 'lifetime'] -def create_network_topology(n, prefix, connector=" -> "): +def create_network_topology(n, prefix, connector=" -> ", bidirectional=True): """ - create a network topology as the electric network, - returns a pandas dataframe with bus0, bus1 and length + Create a network topology like the power transmission network. + + Parameters + ---------- + n : pypsa.Network + prefix : str + connector : str + bidirectional : bool, default True + True: one link for each connection + False: one link for each connection and direction (back and forth) + + Returns + ------- + pd.DataFrame with columns bus0, bus1 and length """ - attrs = ["bus0", "bus1", "length"] + ln_attrs = ["bus0", "bus1", "length"] + lk_attrs = ["bus0", "bus1", "length", "underwater_fraction"] - candidates = pd.concat([n.lines[attrs], - n.links.loc[n.links.carrier == "DC", attrs]]) + candidates = pd.concat([ + n.lines[ln_attrs], + n.links.loc[n.links.carrier == "DC", lk_attrs] + ]).fillna(0) positive_order = candidates.bus0 < candidates.bus1 candidates_p = candidates[positive_order] - candidates_n = (candidates[~ positive_order] - .rename(columns={"bus0": "bus1", "bus1": "bus0"})) - candidates = pd.concat((candidates_p, candidates_n), sort=False) + swap_buses = {"bus0": "bus1", "bus1": "bus0"} + candidates_n = candidates[~positive_order].rename(columns=swap_buses) + candidates = pd.concat([candidates_p, candidates_n]) + + def make_index(c): + return prefix + c.bus0 + connector + c.bus1 topo = candidates.groupby(["bus0", "bus1"], as_index=False).mean() - topo.index = topo.apply(lambda x: prefix + x.bus0 + connector + x.bus1, axis=1) + topo.index = topo.apply(make_index, axis=1) + + if not bidirectional: + topo_reverse = topo.copy() + topo_reverse.rename(columns=swap_buses, inplace=True) + topo_reverse.index = topo_reverse.apply(make_index, axis=1) + topo = topo.append(topo_reverse) + return topo @@ -1554,8 +1612,11 @@ def add_biomass(n, costs): biomass_potentials = pd.read_csv(snakemake.input.biomass_potentials, index_col=0) - transport_costs = pd.read_csv(snakemake.input.biomass_transport, - index_col=0) + transport_costs = pd.read_csv( + snakemake.input.biomass_transport, + index_col=0, + squeeze=True + ) # potential per node distributed within country by population biomass_pot_node = (biomass_potentials.loc[pop_layout.ct] @@ -1572,7 +1633,8 @@ def add_biomass(n, costs): ) n.madd("Bus", - biomass_pot_node.index + " solid biomass", + spatial.biomass.nodes, + location=spatial.biomass.locations, carrier="solid biomass" ) @@ -1586,8 +1648,8 @@ def add_biomass(n, costs): ) n.madd("Store", - biomass_pot_node.index + " solid biomass", - bus=biomass_pot_node.index + " solid biomass", + spatial.biomass.nodes, + bus=spatial.biomass.nodes, carrier="solid biomass", e_nom=biomass_pot_node["solid biomass"].values, marginal_cost=costs.at['solid biomass', 'fuel'], @@ -1606,34 +1668,26 @@ def add_biomass(n, costs): p_nom_extendable=True ) - # add biomass transport - biomass_transport = create_network_topology(n, "Biomass transport ") + if options["biomass_transport"]: + + # add biomass transport + biomass_transport = create_network_topology(n, "biomass transport ", bidirectional=False) - # make transport in both directions - df = biomass_transport.copy() - df["bus1"] = biomass_transport.bus0 - df["bus0"] = biomass_transport.bus1 - df.rename(index=lambda x: "Biomass transport " + df.at[x, "bus0"] - + " -> " + df.at[x, "bus1"], inplace=True) - biomass_transport = pd.concat([biomass_transport, df]) - - # costs - bus0_costs = biomass_transport.bus0.apply(lambda x: transport_costs.loc[x[:2]]) - bus1_costs = biomass_transport.bus1.apply(lambda x: transport_costs.loc[x[:2]]) - biomass_transport["costs"] = pd.concat([bus0_costs, bus1_costs], - axis=1).mean(axis=1) - - n.madd("Link", - biomass_transport.index, - bus0=biomass_transport.bus0 + " solid biomass", - bus1=biomass_transport.bus1 + " solid biomass", - p_nom_extendable=True, - length=biomass_transport.length.values, - marginal_cost=biomass_transport.costs * biomass_transport.length.values, - capital_cost=1, - carrier="solid biomass transport" - ) + # costs + bus0_costs = biomass_transport.bus0.apply(lambda x: transport_costs[x[:2]]) + bus1_costs = biomass_transport.bus1.apply(lambda x: transport_costs[x[:2]]) + biomass_transport["costs"] = pd.concat([bus0_costs, bus1_costs], axis=1).mean(axis=1) + n.madd("Link", + biomass_transport.index, + bus0=biomass_transport.bus0 + " solid biomass", + bus1=biomass_transport.bus1 + " solid biomass", + p_nom_extendable=True, + length=biomass_transport.length.values, + marginal_cost=biomass_transport.costs * biomass_transport.length.values, + capital_cost=1, + carrier="solid biomass transport" + ) #AC buses with district heating urban_central = n.buses.index[n.buses.carrier == "urban central heat"] @@ -1644,7 +1698,7 @@ def add_biomass(n, costs): n.madd("Link", urban_central + " urban central solid biomass CHP", - bus0=urban_central + " solid biomass", + bus0=spatial.biomass.df.loc[urban_central, "nodes"].values, bus1=urban_central, bus2=urban_central + " urban central heat", carrier="urban central solid biomass CHP", @@ -1658,7 +1712,7 @@ def add_biomass(n, costs): n.madd("Link", urban_central + " urban central solid biomass CHP CC", - bus0=urban_central + " solid biomass", + bus0=spatial.biomass.df.loc[urban_central, "nodes"].values, bus1=urban_central, bus2=urban_central + " urban central heat", bus3="co2 atmosphere", @@ -1684,36 +1738,34 @@ def add_industry(n, costs): # 1e6 to convert TWh to MWh industrial_demand = pd.read_csv(snakemake.input.industrial_demand, index_col=0) * 1e6 - solid_biomass_by_country = industrial_demand["solid biomass"] - n.madd("Bus", - industrial_demand.index + " solid biomass for industry", - location="EU", + spatial.biomass.df.loc[industrial_demand.index, "industry"].values, + location=spatial.biomass.df.loc[industrial_demand.index, "locations"].values, carrier="solid biomass for industry" ) p_set = industrial_demand["solid biomass"].rename(index=lambda x: x + " solid biomass for industry") / 8760 n.madd("Load", - industrial_demand.index + " solid biomass for industry", - bus=industrial_demand.index + " solid biomass for industry", + spatial.biomass.df.loc[industrial_demand.index, "industry"].values, + bus=spatial.biomass.df.loc[industrial_demand.index, "industry"].values, carrier="solid biomass for industry", p_set=p_set ) n.madd("Link", - industrial_demand.index + " solid biomass for industry", - bus0=industrial_demand.index + " solid biomass", - bus1=industrial_demand.index + " solid biomass for industry", + spatial.biomass.df.loc[industrial_demand.index, "industry"].values, + bus0=spatial.biomass.df.loc[industrial_demand.index, "nodes"].values, + bus1=spatial.biomass.df.loc[industrial_demand.index, "industry"].values, carrier="solid biomass for industry", p_nom_extendable=True, efficiency=1. ) n.madd("Link", - industrial_demand.index + " solid biomass for industry CC", - bus0=industrial_demand.index + " solid biomass", - bus1=industrial_demand.index + " solid biomass for industry", + spatial.biomass.df.loc[industrial_demand.index, "industry_cc"].values, + bus0=spatial.biomass.df.loc[industrial_demand.index, "nodes"].values, + bus1=spatial.biomass.df.loc[industrial_demand.index, "industry_cc"].values, bus2="co2 atmosphere", bus3="co2 stored", carrier="solid biomass for industry CC", @@ -2000,93 +2052,6 @@ def maybe_adjust_costs_and_potentials(n, opts): print("changing", attr , "for", carrier, "by factor", factor) -def remove_biomass_transport(n): - - print("no transport of solid biomass considered") - - # remove country specific biomass buses - n.buses = n.buses[~n.buses.carrier.str.contains("biomass")] - - # biomass potential - biomass_pot = n.stores[n.stores.carrier=="solid biomass"].e_nom.sum() - - # remove biomass store per country - n.stores = n.stores[n.stores.carrier!="solid biomass"] - - # remove biomass transport links - n.links = n.links[n.links.carrier!="solid biomass transport"] - - # total industry demand for biomass - biomass_demand = n.loads[n.loads.carrier=="solid biomass for industry"].p_set.sum() - - # remove industry demand - n.loads = n.loads[n.loads.carrier!="solid biomass for industry"] - - # drop transport and industry links - sel = [ - 'solid biomass transport', - 'solid biomass for industry', - 'solid biomass for industry CC' - ] - n.links = n.links[~n.links.carrier.isin(sel)] - - # add back EU bus + load + store + industry links - n.add("Bus", - "EU solid biomass", - location="EU", - carrier="solid biomass" - ) - - n.add("Bus", - "solid biomass for industry", - location="EU", - carrier="solid biomass for industry" - ) - - n.add("Load", - "solid biomass for industry", - bus="solid biomass for industry", - carrier="solid biomass for industry", - p_set=biomass_demand - ) - - n.add("Store", - "EU solid biomass", - bus="EU solid biomass", - carrier="solid biomass", - e_nom=biomass_pot, - marginal_cost=costs.at['solid biomass','fuel'], - e_initial=biomass_pot - ) - - n.add("Link", - "solid biomass for industry", - bus0="EU solid biomass", - bus1="solid biomass for industry", - carrier="solid biomass for industry", - p_nom_extendable=True, - efficiency=1. - ) - - n.add("Link", - "solid biomass for industry CC", - bus0="EU solid biomass", - bus1="solid biomass for industry", - bus2="co2 atmosphere", - bus3="co2 stored", - carrier="solid biomass for industry CC", - p_nom_extendable=True, - capital_cost=costs.at["cement capture", "fixed"] * costs.at['solid biomass', 'CO2 intensity'], - efficiency=0.9, - efficiency2=-costs.at['solid biomass', 'CO2 intensity'] * costs.at["cement capture", "capture_rate"], - efficiency3=costs.at['solid biomass', 'CO2 intensity'] * costs.at["cement capture", "capture_rate"], - lifetime=costs.at['cement capture', 'lifetime'] - ) - - # set CHP buses from country to single EU bus - n.links.loc[n.links.carrier.str.contains("biomass CHP"), "bus0"] = "EU solid biomass" - - # TODO this should rather be a config no wildcard def limit_individual_line_extension(n, maxext): print(f"limiting new HVAC and HVDC extensions to {maxext} MW") @@ -2183,9 +2148,6 @@ if __name__ == "__main__": if "noH2network" in opts: remove_h2_network(n) - if not options["biomass_transport"]: - remove_biomass_transport(n) - for o in opts: m = re.match(r'^\d+h$', o, re.IGNORECASE) if m is not None: From 3f43656a92c64d2ad0887c80943ad9480252e564 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 12 Jul 2021 12:37:37 +0200 Subject: [PATCH 045/132] call define_spatial --- scripts/prepare_sector_network.py | 2 ++ 1 file changed, 2 insertions(+) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 91bcc2e9..0ddafb37 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -2094,6 +2094,8 @@ if __name__ == "__main__": patch_electricity_network(n) + define_spatial(pop_layout.index) + if snakemake.config["foresight"] == 'myopic': add_lifetime_wind_solar(n, costs) From 85111e2ae3368446076e284ccc56d1cc6b89b39b Mon Sep 17 00:00:00 2001 From: Leon <5868911+leonsn@users.noreply.github.com> Date: Wed, 4 Aug 2021 09:20:09 +0200 Subject: [PATCH 046/132] Omitting unnecessary constraints on the CHP units (#155) * Omitting unnecessary constraints on the CHP units All CHPs in pypsa-eur-sec are operating on the backpressure line and this set of extra constraints to ensure working in the operational space of the CHPs is hence not necessary at the moment. * remove chp constraints function call --- scripts/solve_network.py | 1 - 1 file changed, 1 deletion(-) diff --git a/scripts/solve_network.py b/scripts/solve_network.py index 8c0313f1..a46acc30 100644 --- a/scripts/solve_network.py +++ b/scripts/solve_network.py @@ -151,7 +151,6 @@ def add_chp_constraints(n): def extra_functionality(n, snapshots): - add_chp_constraints(n) add_battery_constraints(n) From ba9be74265d758b963382bd000dca1e50ae9088c Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Wed, 4 Aug 2021 15:05:37 +0200 Subject: [PATCH 047/132] make build_biomass_transport_costs fully optional --- Snakefile | 27 ++++++++++++++---------- scripts/build_biomass_transport_costs.py | 2 +- 2 files changed, 17 insertions(+), 12 deletions(-) diff --git a/Snakefile b/Snakefile index 45c33da9..caed1f42 100644 --- a/Snakefile +++ b/Snakefile @@ -180,16 +180,21 @@ rule build_biomass_potentials: script: 'scripts/build_biomass_potentials.py' -rule build_biomass_transport_costs: - input: "data/biomass/biomass potentials in europe_web rev.pdf" - output: - supply_chain1="resources/biomass_transport_costs_supply_chain1.csv", - supply_chain2="resources/biomass_transport_costs_supply_chain2.csv", - transport_costs="resources/biomass_transport_costs.csv", - threads: 1 - resources: mem_mb=1000 - benchmark: "benchmarks/build_biomass_transport_costs" - script: 'scripts/build_biomass_transport_costs.py' +if config["sector"]["biomass_transport"]: + rule build_biomass_transport_costs: + input: + transport_cost_data="data/biomass/biomass potentials in europe_web rev.pdf" + output: + supply_chain1="resources/biomass_transport_costs_supply_chain1.csv", + supply_chain2="resources/biomass_transport_costs_supply_chain2.csv", + transport_costs="resources/biomass_transport_costs.csv", + threads: 1 + resources: mem_mb=1000 + benchmark: "benchmarks/build_biomass_transport_costs" + script: 'scripts/build_biomass_transport_costs.py' + build_biomass_transport_costs_output = rules.build_biomass_transport_costs.output +else: + build_biomass_transport_costs_output = {} rule build_ammonia_production: @@ -336,7 +341,6 @@ rule prepare_sector_network: traffic_data_KFZ="data/emobility/KFZ__count", traffic_data_Pkw="data/emobility/Pkw__count", biomass_potentials='resources/biomass_potentials.csv', - biomass_transport="resources/biomass_transport_costs.csv", heat_profile="data/heat_load_profile_BDEW.csv", costs=CDIR + "costs_{planning_horizons}.csv", profile_offwind_ac=pypsaeur("resources/profile_offwind-ac.nc"), @@ -366,6 +370,7 @@ rule prepare_sector_network: solar_thermal_urban="resources/solar_thermal_urban_elec_s{simpl}_{clusters}.nc", solar_thermal_rural="resources/solar_thermal_rural_elec_s{simpl}_{clusters}.nc", **build_retro_cost_output + **build_biomass_transport_costs_output output: RDIR + '/prenetworks/elec_s{simpl}_{clusters}_lv{lv}_{opts}_{sector_opts}_{planning_horizons}.nc' threads: 1 resources: mem_mb=2000 diff --git a/scripts/build_biomass_transport_costs.py b/scripts/build_biomass_transport_costs.py index 703d81ae..b17c97fd 100644 --- a/scripts/build_biomass_transport_costs.py +++ b/scripts/build_biomass_transport_costs.py @@ -22,7 +22,7 @@ ENERGY_CONTENT = 4.8 # unit MWh/tonne (assuming wood pellets) def build_biomass_transport_costs(): df_list = tbl.read_pdf( - snakemake.input[0], + snakemake.input.transport_cost_data, pages="145-147", multiple_tables=True, ) From 50dd4ce28520dbf9837ec7f2614980dd6095b34a Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Wed, 4 Aug 2021 18:13:01 +0200 Subject: [PATCH 048/132] prepare: fix syntax error --- scripts/prepare_sector_network.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 82e15e60..068a121a 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1934,7 +1934,7 @@ def maybe_adjust_costs_and_potentials(n, opts): else: if attr == 'p_nom_max': comps = {"Generator", "Link", "StorageUnit"} - elif attr = 'e_nom_max': + elif attr == 'e_nom_max': comps = {"Store"} else: comps = {"Generator", "Link", "StorageUnit", "Store"} From fab31e65243a708de5811b5490241c204c4d669a Mon Sep 17 00:00:00 2001 From: martavp <30744159+martavp@users.noreply.github.com> Date: Wed, 4 Aug 2021 18:19:02 +0200 Subject: [PATCH 049/132] Exogenous transition path for shipping, Steel, and Aluminum production (#136) * Update .gitignore * Add fictitious load to account for non-transformed shipping emissions The share of shipping demand that is transformed is defined now for different years to be used with the myopic code. The carbon emission from the remaining share is treated as a negative load on the atmospheric carbon dioxide bus, just like aviation and land transport emissions. * Split colours for H2 in Industry and H2 in shipping when plotting balances. When plotting the balance for H2, the rename dictionary merges all the demands containing H2. This commit disables such merging and keeps different colours for H2 in shipping and H2 in industry. This is useful when one wants to look at the H2 balance and have an overview of where the H2 is consumed in the model. * Make transformation of Steel and Aluminum production depends on year Previously, the transformation of the Steel and Aluminum production was assumed to occur overnight. This commit enables the definition of a transformation path via the config.yaml file. This requires adding the {planning_horizon} to the input and output file name of the following rules: build_industrial_production_per_country_tomorrow build_industrial_production_per_node build_industry_energy_demand_per_node prepare_sector_network * small follow-up to merge * Add oil consumed in shipping as a load to EU oil bus * Update scripts/prepare_sector_network.py * add planning_horizons wildcard to benchmark paths * fixup: double fraction_primary for steel Co-authored-by: Fabian Neumann --- .gitignore | 2 +- Snakefile | 18 ++++----- config.default.yaml | 38 ++++++++++++++++++- doc/release_notes.rst | 5 +-- ...ustrial_production_per_country_tomorrow.py | 20 +++++++--- scripts/plot_summary.py | 4 +- scripts/prepare_sector_network.py | 26 ++++++++++++- 7 files changed, 91 insertions(+), 22 deletions(-) diff --git a/.gitignore b/.gitignore index 1401c0ad..ac252a84 100644 --- a/.gitignore +++ b/.gitignore @@ -28,7 +28,7 @@ gurobi.log /data/.nfs* /data/Industrial_Database.csv /data/retro/tabula-calculator-calcsetbuilding.csv - +/data *.org *.nc diff --git a/Snakefile b/Snakefile index b91785d9..de34f386 100644 --- a/Snakefile +++ b/Snakefile @@ -220,10 +220,10 @@ rule build_industrial_production_per_country_tomorrow: input: industrial_production_per_country="resources/industrial_production_per_country.csv" output: - industrial_production_per_country_tomorrow="resources/industrial_production_per_country_tomorrow.csv" + industrial_production_per_country_tomorrow="resources/industrial_production_per_country_tomorrow_{planning_horizons}.csv" threads: 1 resources: mem_mb=1000 - benchmark: "benchmarks/build_industrial_production_per_country_tomorrow" + benchmark: "benchmarks/build_industrial_production_per_country_tomorrow_{planning_horizons}" script: 'scripts/build_industrial_production_per_country_tomorrow.py' @@ -243,25 +243,25 @@ rule build_industrial_distribution_key: rule build_industrial_production_per_node: input: industrial_distribution_key="resources/industrial_distribution_key_elec_s{simpl}_{clusters}.csv", - industrial_production_per_country_tomorrow="resources/industrial_production_per_country_tomorrow.csv" + industrial_production_per_country_tomorrow="resources/industrial_production_per_country_tomorrow_{planning_horizons}.csv" output: - industrial_production_per_node="resources/industrial_production_elec_s{simpl}_{clusters}.csv" + industrial_production_per_node="resources/industrial_production_elec_s{simpl}_{clusters}_{planning_horizons}.csv" threads: 1 resources: mem_mb=1000 - benchmark: "benchmarks/build_industrial_production_per_node/s{simpl}_{clusters}" + benchmark: "benchmarks/build_industrial_production_per_node/s{simpl}_{clusters}_{planning_horizons}" script: 'scripts/build_industrial_production_per_node.py' rule build_industrial_energy_demand_per_node: input: industry_sector_ratios="resources/industry_sector_ratios.csv", - industrial_production_per_node="resources/industrial_production_elec_s{simpl}_{clusters}.csv", + industrial_production_per_node="resources/industrial_production_elec_s{simpl}_{clusters}_{planning_horizons}.csv", industrial_energy_demand_per_node_today="resources/industrial_energy_demand_today_elec_s{simpl}_{clusters}.csv" output: - industrial_energy_demand_per_node="resources/industrial_energy_demand_elec_s{simpl}_{clusters}.csv" + industrial_energy_demand_per_node="resources/industrial_energy_demand_elec_s{simpl}_{clusters}_{planning_horizons}.csv" threads: 1 resources: mem_mb=1000 - benchmark: "benchmarks/build_industrial_energy_demand_per_node/s{simpl}_{clusters}" + benchmark: "benchmarks/build_industrial_energy_demand_per_node/s{simpl}_{clusters}_{planning_horizons}" script: 'scripts/build_industrial_energy_demand_per_node.py' @@ -333,7 +333,7 @@ rule prepare_sector_network: busmap=pypsaeur("resources/busmap_elec_s{simpl}_{clusters}.csv"), clustered_pop_layout="resources/pop_layout_elec_s{simpl}_{clusters}.csv", simplified_pop_layout="resources/pop_layout_elec_s{simpl}.csv", - industrial_demand="resources/industrial_energy_demand_elec_s{simpl}_{clusters}.csv", + industrial_demand="resources/industrial_energy_demand_elec_s{simpl}_{clusters}_{planning_horizons}.csv", heat_demand_urban="resources/heat_demand_urban_elec_s{simpl}_{clusters}.nc", heat_demand_rural="resources/heat_demand_rural_elec_s{simpl}_{clusters}.nc", heat_demand_total="resources/heat_demand_total_elec_s{simpl}_{clusters}.nc", diff --git a/config.default.yaml b/config.default.yaml index 457c3660..5b311ffc 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -175,6 +175,14 @@ sector: transport_fuel_cell_efficiency: 0.5 transport_internal_combustion_efficiency: 0.3 shipping_average_efficiency: 0.4 #For conversion of fuel oil to propulsion in 2011 + shipping_hydrogen_share: # 1 means all hydrogen FC + 2020: 0 + 2025: 0 + 2030: 0.05 + 2035: 0.15 + 2040: 0.3 + 2045: 0.6 + 2050: 1 time_dep_hp_cop: true #time dependent heat pump coefficient of performance heat_pump_sink_T: 55. # Celsius, based on DTU / large area radiators; used in build_cop_profiles.py # conservatively high to cover hot water and space heating in poorly-insulated buildings @@ -229,10 +237,32 @@ sector: industry: - St_primary_fraction: 0.3 # fraction of steel produced via primary route (DRI + EAF) versus secondary route (EAF); today fraction is 0.6 + St_primary_fraction: # fraction of steel produced via primary route versus secondary route (scrap+EAF); today fraction is 0.6 + 2020: 0.6 + 2025: 0.55 + 2030: 0.5 + 2035: 0.45 + 2040: 0.4 + 2045: 0.35 + 2050: 0.3 + DRI_fraction: # fraction of the primary route converted to DRI + EAF + 2020: 0 + 2025: 0 + 2030: 0.05 + 2035: 0.2 + 2040: 0.4 + 2045: 0.7 + 2050: 1 H2_DRI: 1.7 #H2 consumption in Direct Reduced Iron (DRI), MWh_H2,LHV/ton_Steel from 51kgH2/tSt in Vogl et al (2018) doi:10.1016/j.jclepro.2018.08.279 elec_DRI: 0.322 #electricity consumption in Direct Reduced Iron (DRI) shaft, MWh/tSt HYBRIT brochure https://ssabwebsitecdn.azureedge.net/-/media/hybrit/files/hybrit_brochure.pdf - Al_primary_fraction: 0.2 # fraction of aluminium produced via the primary route versus scrap; today fraction is 0.4 + Al_primary_fraction: # fraction of aluminium produced via the primary route versus scrap; today fraction is 0.4 + 2020: 0.4 + 2025: 0.375 + 2030: 0.35 + 2035: 0.325 + 2040: 0.3 + 2045: 0.25 + 2050: 0.2 MWh_CH4_per_tNH3_SMR: 10.8 # 2012's demand from https://ec.europa.eu/docsroom/documents/4165/attachments/1/translations/en/renditions/pdf MWh_elec_per_tNH3_SMR: 0.7 # same source, assuming 94-6% split methane-elec of total energy demand 11.5 MWh/tNH3 MWh_H2_per_tNH3_electrolysis: 6.5 # from https://doi.org/10.1016/j.joule.2018.04.017, around 0.197 tH2/tHN3 (>3/17 since some H2 lost and used for energy) @@ -472,4 +502,8 @@ plotting: solid biomass: '#DAA520' today: '#D2691E' shipping: '#6495ED' + shipping oil: "#6495ED" + shipping oil emissions: "#6495ED" electricity distribution grid: '#333333' + H2 for industry: "#222222" + H2 for shipping: "#6495ED" diff --git a/doc/release_notes.rst b/doc/release_notes.rst index 88d09bcb..aaa4d0cd 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -60,11 +60,10 @@ Future release These are included in the environment specifications of PyPSA-Eur. * Consistent use of ``__main__`` block and further unspecific code cleaning. * Distinguish costs for home battery storage and inverter from utility-scale battery costs. - - +* The share of shipping transformed into hydrogen fuel cell can be now defined for different years in the ``config.yaml`` file. The carbon emission from the remaining share is treated as a negative load on the atmospheric carbon dioxide bus, just like aviation and land transport emissions. +* The transformation of the Steel and Aluminium production can be now defined for different years in the ``config.yaml`` file. * Include the option to alter the maximum energy capacity of a store via the ``carrier+factor`` in the ``{sector_opts}`` wildcard. This can be useful for sensitivity analyses. Example: ``co2 stored+e2`` multiplies the ``e_nom_max`` by factor 2. In this example, ``e_nom_max`` represents the CO2 sequestration potential in Europe. - PyPSA-Eur-Sec 0.5.0 (21st May 2021) =================================== diff --git a/scripts/build_industrial_production_per_country_tomorrow.py b/scripts/build_industrial_production_per_country_tomorrow.py index 767779f8..ba69e0a6 100644 --- a/scripts/build_industrial_production_per_country_tomorrow.py +++ b/scripts/build_industrial_production_per_country_tomorrow.py @@ -2,6 +2,8 @@ import pandas as pd +from prepare_sector_network import get + if __name__ == '__main__': if 'snakemake' not in globals(): from helper import mock_snakemake @@ -9,27 +11,35 @@ if __name__ == '__main__': config = snakemake.config["industry"] + investment_year = int(snakemake.wildcards.planning_horizons) + fn = snakemake.input.industrial_production_per_country production = pd.read_csv(fn, index_col=0) keys = ["Integrated steelworks", "Electric arc"] total_steel = production[keys].sum(axis=1) + st_primary_fraction = get(config["St_primary_fraction"], investment_year) + dri_fraction = get(config["DRI_fraction"], investment_year) int_steel = production["Integrated steelworks"].sum() - fraction_persistent_primary = config["St_primary_fraction"] * total_steel.sum() / int_steel + fraction_persistent_primary = st_primary_fraction * total_steel.sum() / int_steel - dri = fraction_persistent_primary * production["Integrated steelworks"] + dri = dri_fraction * fraction_persistent_primary * production["Integrated steelworks"] production.insert(2, "DRI + Electric arc", dri) - production["Electric arc"] = total_steel - production["DRI + Electric arc"] - production["Integrated steelworks"] = 0. + not_dri = (1 - dri_fraction) + production["Integrated steelworks"] = not_dri * fraction_persistent_primary * production["Integrated steelworks"] + production["Electric arc"] = total_steel - production["DRI + Electric arc"] - production["Integrated steelworks"] keys = ["Aluminium - primary production", "Aluminium - secondary production"] total_aluminium = production[keys].sum(axis=1) key_pri = "Aluminium - primary production" key_sec = "Aluminium - secondary production" - fraction_persistent_primary = config["Al_primary_fraction"] * total_aluminium.sum() / production[key_pri].sum() + + al_primary_fraction = get(config["Al_primary_fraction"], investment_year) + fraction_persistent_primary = al_primary_fraction * total_aluminium.sum() / production[key_pri].sum() + production[key_pri] = fraction_persistent_primary * production[key_pri] production[key_sec] = total_aluminium - production[key_pri] diff --git a/scripts/plot_summary.py b/scripts/plot_summary.py index 45a442a1..5b045688 100644 --- a/scripts/plot_summary.py +++ b/scripts/plot_summary.py @@ -34,7 +34,9 @@ def rename_techs(label): rename_if_contains_dict = { "water tanks": "hot water storage", "retrofitting": "building retrofitting", - "H2": "hydrogen storage", + "H2 Electrolysis": "hydrogen storage", + "H2 Fuel Cell": "hydrogen storage", + "H2 pipeline": "hydrogen storage", "battery": "battery storage", "CC": "CC" } diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 068a121a..934efc2f 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1716,7 +1716,8 @@ def add_industry(n, costs): all_navigation = ["total international navigation", "total domestic navigation"] efficiency = options['shipping_average_efficiency'] / costs.at["fuel cell", "efficiency"] - p_set = nodal_energy_totals.loc[nodes, all_navigation].sum(axis=1) * 1e6 * efficiency / 8760 + shipping_hydrogen_share = get(options['shipping_hydrogen_share'], investment_year) + p_set = shipping_hydrogen_share * nodal_energy_totals.loc[nodes, all_navigation].sum(axis=1) * 1e6 * efficiency / 8760 n.madd("Load", nodes, @@ -1726,6 +1727,29 @@ def add_industry(n, costs): p_set=p_set ) + if shipping_hydrogen_share < 1: + + shipping_oil_share = 1 - shipping_hydrogen_share + + p_set = shipping_oil_share * nodal_energy_totals.loc[nodes, all_navigation].sum(axis=1) * 1e6 / 8760. + + n.madd("Load", + nodes, + suffix=" shipping oil", + bus="EU oil", + carrier="shipping oil", + p_set=p_set + ) + + co2 = shipping_oil_share * nodal_energy_totals.loc[nodes, all_navigation].sum().sum() * 1e6 / 8760 * costs.at["oil", "CO2 intensity"] + + n.add("Load", + "shipping oil emissions", + bus="co2 atmosphere", + carrier="shipping oil emissions", + p_set=-co2 + ) + if "EU oil" not in n.buses.index: n.add("Bus", From 96afff0487d0859bc360a1a4c9a39a4bb59af496 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Wed, 4 Aug 2021 18:19:42 +0200 Subject: [PATCH 050/132] Adapt to technology-data changes (#146) * adapt to technology-data changes from https://github.com/PyPSA/technology-data/pull/35 * switch to new H2 (g) pipeline cost --- scripts/prepare_sector_network.py | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 934efc2f..1e8a77e5 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -906,7 +906,7 @@ def add_storage(n, costs): ) # hydrogen stored overground (where not already underground) - h2_capital_cost = costs.at["hydrogen storage tank", "fixed"] + h2_capital_cost = costs.at["hydrogen storage tank incl. compressor", "fixed"] nodes_overground = cavern_nodes.index.symmetric_difference(nodes) n.madd("Store", @@ -941,9 +941,9 @@ def add_storage(n, costs): p_min_pu=-1, p_nom_extendable=True, length=h2_links.length.values, - capital_cost=costs.at['H2 pipeline', 'fixed'] * h2_links.length.values, + capital_cost=costs.at['H2 (g) pipeline', 'fixed'] * h2_links.length.values, carrier="H2 pipeline", - lifetime=costs.at['H2 pipeline', 'lifetime'] + lifetime=costs.at['H2 (g) pipeline', 'lifetime'] ) n.add("Carrier", "battery") @@ -997,7 +997,7 @@ def add_storage(n, costs): carrier="Sabatier", efficiency=costs.at["methanation", "efficiency"], efficiency2=-costs.at["methanation", "efficiency"] * costs.at['gas', 'CO2 intensity'], - capital_cost=costs.at["methanation", "fixed"], + capital_cost=costs.at["methanation", "fixed"] * costs.at["methanation", "efficiency"], # costs given per kW_gas lifetime=costs.at['methanation', 'lifetime'] ) From 87596dd015ab8f2fff8ef77881a1bd82a7255b14 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Wed, 4 Aug 2021 18:28:18 +0200 Subject: [PATCH 051/132] add H2 liquefaction cost to H2 shipping demand (#145) * add H2 liquefaction cost to H2 shipping demand * rename bus to 'H2 liquid' * add release note * make consideration of liquefaction costs for shipping optional * update release notes --- config.default.yaml | 1 + doc/release_notes.rst | 3 +++ scripts/prepare_sector_network.py | 26 +++++++++++++++++++++++++- 3 files changed, 29 insertions(+), 1 deletion(-) diff --git a/config.default.yaml b/config.default.yaml index 5b311ffc..dfc888c4 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -175,6 +175,7 @@ sector: transport_fuel_cell_efficiency: 0.5 transport_internal_combustion_efficiency: 0.3 shipping_average_efficiency: 0.4 #For conversion of fuel oil to propulsion in 2011 + shipping_hydrogen_liquefaction: true # whether to consider liquefaction costs for shipping H2 demands shipping_hydrogen_share: # 1 means all hydrogen FC 2020: 0 2025: 0 diff --git a/doc/release_notes.rst b/doc/release_notes.rst index aaa4d0cd..15419438 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -60,6 +60,9 @@ Future release These are included in the environment specifications of PyPSA-Eur. * Consistent use of ``__main__`` block and further unspecific code cleaning. * Distinguish costs for home battery storage and inverter from utility-scale battery costs. +* Added option for hydrogen liquefaction costs for hydrogen demand in shipping. + This introduces a new ``H2 liquid`` bus at each location. + It is activated via ``sector: shipping_hydrogen_liquefaction: true``. * The share of shipping transformed into hydrogen fuel cell can be now defined for different years in the ``config.yaml`` file. The carbon emission from the remaining share is treated as a negative load on the atmospheric carbon dioxide bus, just like aviation and land transport emissions. * The transformation of the Steel and Aluminium production can be now defined for different years in the ``config.yaml`` file. * Include the option to alter the maximum energy capacity of a store via the ``carrier+factor`` in the ``{sector_opts}`` wildcard. This can be useful for sensitivity analyses. Example: ``co2 stored+e2`` multiplies the ``e_nom_max`` by factor 2. In this example, ``e_nom_max`` represents the CO2 sequestration potential in Europe. diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 1e8a77e5..a5bc0d14 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1714,6 +1714,30 @@ def add_industry(n, costs): p_set=industrial_demand.loc[nodes, "hydrogen"] / 8760 ) + if options["shipping_hydrogen_liquefaction"]: + + n.madd("Bus", + nodes, + suffix=" H2 liquid", + carrier="H2 liquid", + location=nodes + ) + + n.madd("Link", + nodes + " H2 liquefaction", + bus0=nodes + " H2", + bus1=nodes + " H2 liquid", + carrier="H2 liquefaction", + efficiency=costs.at["H2 liquefaction", 'efficiency'], + capital_cost=costs.at["H2 liquefaction", 'fixed'], + p_nom_extendable=True, + lifetime=costs.at['H2 liquefaction', 'lifetime'] + ) + + shipping_bus = nodes + " H2 liquid" + else: + shipping_bus = nodes + " H2" + all_navigation = ["total international navigation", "total domestic navigation"] efficiency = options['shipping_average_efficiency'] / costs.at["fuel cell", "efficiency"] shipping_hydrogen_share = get(options['shipping_hydrogen_share'], investment_year) @@ -1722,7 +1746,7 @@ def add_industry(n, costs): n.madd("Load", nodes, suffix=" H2 for shipping", - bus=nodes + " H2", + bus=shipping_bus, carrier="H2 for shipping", p_set=p_set ) From 3754643e8192c57452c84d7a8a3639abd17a49a3 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Fri, 6 Aug 2021 12:46:03 +0200 Subject: [PATCH 052/132] add co2 sequestration potential global constraint --- scripts/prepare_sector_network.py | 9 +-------- scripts/solve_network.py | 19 +++++++++++++++++++ 2 files changed, 20 insertions(+), 8 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index ca956e44..659fbf37 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -45,7 +45,7 @@ def define_spatial(nodes): spatial.co2.vents = nodes + " co2 vent" else: spatial.co2.nodes = ["co2 stored"] - spatial.co2.locations = "EU" + spatial.co2.locations = ["EU"] spatial.co2.vents = ["co2 vent"] spatial.co2.df = pd.DataFrame(vars(spatial.co2), index=nodes) @@ -379,13 +379,6 @@ def add_co2_tracking(n, options): bus=spatial.co2.nodes ) - # TODO if nodally resolved total allowed sequestration needs to - # be an extra_functionality constraint - # (best to implement it this way for either case) - # let e_nom_max represent geological potential - # don't forget to log duals of extra functionality! - # options['co2_sequestration_potential'] * 1e6 - if options['co2_vent']: n.madd("Link", diff --git a/scripts/solve_network.py b/scripts/solve_network.py index 8c0313f1..3796bc4d 100644 --- a/scripts/solve_network.py +++ b/scripts/solve_network.py @@ -3,6 +3,7 @@ import pypsa import numpy as np +import pandas as pd from pypsa.linopt import get_var, linexpr, define_constraints @@ -150,9 +151,27 @@ def add_chp_constraints(n): define_constraints(n, lhs, "<=", 0, 'chplink', 'backpressure') +def add_co2_sequestration_limit(n, sns): + + co2_stores = n.stores.loc[n.stores.carrier=='co2 stored'].index + + if co2_stores.empty or ('Store', 'e') not in n.variables.index: + return + + vars_final_co2_stored = get_var(n, 'Store', 'e').loc[sns[-1], co2_stores] + + lhs = linexpr((1, vars_final_co2_stored)).sum() + rhs = n.config["sector"].get("co2_sequestration_potential", 200) * 1e6 + + name = 'co2_sequestration_limit' + define_constraints(n, lhs, "<=", rhs, 'GlobalConstraint', + 'mu', axes=pd.Index([name]), spec=name) + + def extra_functionality(n, snapshots): add_chp_constraints(n) add_battery_constraints(n) + add_co2_sequestration_limit(n, snapshots) def solve_network(n, config, opts='', **kwargs): From d7a290df31737f3127e05868c83ff7cb36ddd7f2 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Fri, 6 Aug 2021 15:51:07 +0200 Subject: [PATCH 053/132] add release note --- doc/release_notes.rst | 8 ++++++++ doc/spatial_resolution.rst | 2 +- 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/doc/release_notes.rst b/doc/release_notes.rst index bd99ce16..a24ccb7c 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -60,6 +60,14 @@ Future release These are included in the environment specifications of PyPSA-Eur. * Consistent use of ``__main__`` block and further unspecific code cleaning. * Distinguish costs for home battery storage and inverter from utility-scale battery costs. +* Add option to regionally resolve CO2 storage and add CO2 pipeline transport because geological storage potential, + CO2 utilisation sites and CO2 capture sites may be separated. + The CO2 network is built from zero based on the topology of the electricity grid (greenfield). + Pipelines are assumed to be bidirectional and lossless. + Furthermore, neither retrofitting of natural gas pipelines (required pressures are too high, 80-160 bar vs <80 bar) + nor other modes of CO2 transport (by ship, road or rail) are considered. + The regional representation of CO2 is activated with the config setting ``sector: co2_network: true`` but is deactivated by default. + The global limit for CO2 sequestration now applies to the sum of all CO2 stores via an ``extra_functionality`` constraint. diff --git a/doc/spatial_resolution.rst b/doc/spatial_resolution.rst index 1be9f3ad..13e94543 100644 --- a/doc/spatial_resolution.rst +++ b/doc/spatial_resolution.rst @@ -48,7 +48,7 @@ Solid biomass: single node for Europe, until transport costs can be incorporated. CO2: single node for Europe, but a transport and storage cost is added for -sequestered CO2. +sequestered CO2. Optionally: nodal, with CO2 transport via pipelines. Liquid hydrocarbons: single node for Europe, since transport costs for liquids are low. From d428c1b77d7e8cd420f7caf5da2e77f73bb3ae26 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 9 Aug 2021 14:43:51 +0200 Subject: [PATCH 054/132] fix syntax and auto-retrieve biomass transport cost --- Snakefile | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/Snakefile b/Snakefile index d100c22a..e768bc90 100644 --- a/Snakefile +++ b/Snakefile @@ -1,4 +1,7 @@ +from snakemake.remote.HTTP import RemoteProvider as HTTPRemoteProvider +HTTP = HTTPRemoteProvider() + configfile: "config.yaml" @@ -183,7 +186,7 @@ rule build_biomass_potentials: if config["sector"]["biomass_transport"]: rule build_biomass_transport_costs: input: - transport_cost_data="data/biomass/biomass potentials in europe_web rev.pdf" + transport_cost_data=HTTP.remote("https://publications.jrc.ec.europa.eu/repository/bitstream/JRC98626/biomass%20potentials%20in%20europe_web%20rev.pdf", keep_local=True) output: supply_chain1="resources/biomass_transport_costs_supply_chain1.csv", supply_chain2="resources/biomass_transport_costs_supply_chain2.csv", @@ -369,7 +372,7 @@ rule prepare_sector_network: solar_thermal_total="resources/solar_thermal_total_elec_s{simpl}_{clusters}.nc", solar_thermal_urban="resources/solar_thermal_urban_elec_s{simpl}_{clusters}.nc", solar_thermal_rural="resources/solar_thermal_rural_elec_s{simpl}_{clusters}.nc", - **build_retro_cost_output + **build_retro_cost_output, **build_biomass_transport_costs_output output: RDIR + '/prenetworks/elec_s{simpl}_{clusters}_lv{lv}_{opts}_{sector_opts}_{planning_horizons}.nc' threads: 1 From 6711d721b9f83719e8871ddf66b2627c25b45ef4 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 9 Aug 2021 16:30:38 +0200 Subject: [PATCH 055/132] biomass_transport: fix cost calculation and get from remote --- Snakefile | 4 +- scripts/build_biomass_transport_costs.py | 93 +++++++++++++++--------- scripts/prepare_sector_network.py | 2 +- 3 files changed, 61 insertions(+), 38 deletions(-) diff --git a/Snakefile b/Snakefile index e768bc90..1ef55c86 100644 --- a/Snakefile +++ b/Snakefile @@ -186,11 +186,11 @@ rule build_biomass_potentials: if config["sector"]["biomass_transport"]: rule build_biomass_transport_costs: input: - transport_cost_data=HTTP.remote("https://publications.jrc.ec.europa.eu/repository/bitstream/JRC98626/biomass%20potentials%20in%20europe_web%20rev.pdf", keep_local=True) + transport_cost_data=HTTP.remote("publications.jrc.ec.europa.eu/repository/bitstream/JRC98626/biomass potentials in europe_web rev.pdf", keep_local=True) output: supply_chain1="resources/biomass_transport_costs_supply_chain1.csv", supply_chain2="resources/biomass_transport_costs_supply_chain2.csv", - transport_costs="resources/biomass_transport_costs.csv", + biomass_transport_costs="resources/biomass_transport_costs.csv", threads: 1 resources: mem_mb=1000 benchmark: "benchmarks/build_biomass_transport_costs" diff --git a/scripts/build_biomass_transport_costs.py b/scripts/build_biomass_transport_costs.py index b17c97fd..dc1137ca 100644 --- a/scripts/build_biomass_transport_costs.py +++ b/scripts/build_biomass_transport_costs.py @@ -16,52 +16,75 @@ assuming as an approximation energy content of wood pellets import pandas as pd import tabula as tbl -ENERGY_CONTENT = 4.8 # unit MWh/tonne (assuming wood pellets) +ENERGY_CONTENT = 4.8 # unit MWh/t (wood pellets) + +def get_countries(): + + pandas_options = dict( + skiprows=list(range(6)), + header=None, + index_col=0 + ) + + return tbl.read_pdf( + str(snakemake.input.transport_cost_data), + pages="145", + multiple_tables=False, + pandas_options=pandas_options + )[0].index + + +def get_cost_per_tkm(page, countries): + + pandas_options = dict( + skiprows=range(6), + header=0, + sep=' |,', + engine='python', + index_col=False, + ) + + sc = tbl.read_pdf( + str(snakemake.input.transport_cost_data), + pages=page, + multiple_tables=False, + pandas_options=pandas_options + )[0] + sc.index = countries + sc.columns = sc.columns.str.replace("€", "EUR") + + return sc def build_biomass_transport_costs(): - df_list = tbl.read_pdf( - snakemake.input.transport_cost_data, - pages="145-147", - multiple_tables=True, - ) - - countries = df_list[0][0].iloc[6:].rename(index=lambda x: x + 1) + countries = get_countries() - # supply chain 1 - df = df_list[1].copy().rename(index=countries.to_dict()) - df.rename( - columns=df.iloc[:6].apply(lambda col: col.str.cat(sep=" "), axis=0).to_dict(), - inplace=True, - ) - df = df.iloc[6:] - df.loc[6] = df.loc[6].str.replace("€", "EUR") + sc1 = get_cost_per_tkm(146, countries) + sc2 = get_cost_per_tkm(147, countries) - # supply chain 2 - df2 = df_list[2].copy().rename(index=countries.to_dict()) - df2.rename( - columns=df2.iloc[:6].apply(lambda col: col.str.cat(sep=" "), axis=0).to_dict(), - inplace=True, - ) - df2 = df2.iloc[6:] - df2.loc[6] = df2.loc[6].str.replace("€", "EUR") + sc1.to_csv(snakemake.output.supply_chain1) + sc2.to_csv(snakemake.output.supply_chain2) - df.to_csv(snakemake.output.supply_chain1) - df2.to_csv(snakemake.output.supply_chain1) + # take mean of both supply chains + to_concat = [sc1["EUR/km/ton"], sc2["EUR/km/ton"]] + transport_costs = pd.concat(to_concat, axis=1).mean(axis=1) - transport_costs = pd.concat([df["per km/ton"], df2["per km/ton"]], axis=1).drop(6) - transport_costs = transport_costs.astype(float, errors="ignore").mean(axis=1) - - # convert unit to EUR/MWh + # convert tonnes to MWh transport_costs /= ENERGY_CONTENT - transport_costs = pd.DataFrame(transport_costs, columns=["cost [EUR/(km MWh)]"]) + transport_costs.name = "EUR/km/MWh" - # rename - transport_costs.rename({"UK": "GB", "XK": "KO", "EL": "GR"}, inplace=True) + # rename country names + to_rename = { + "UK": "GB", + "XK": "KO", + "EL": "GR" + } + transport_costs.rename(to_rename, inplace=True) + + # add missing Norway with data from Sweden + transport_costs["NO"] = transport_costs["SE"] - # add missing Norway - transport_costs.loc["NO"] = transport_costs.loc["SE"] transport_costs.to_csv(snakemake.output.transport_costs) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 0749a8c3..1dd92b28 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1613,7 +1613,7 @@ def add_biomass(n, costs): biomass_potentials = pd.read_csv(snakemake.input.biomass_potentials, index_col=0) transport_costs = pd.read_csv( - snakemake.input.biomass_transport, + snakemake.input.biomass_transport_costs, index_col=0, squeeze=True ) From 3eb404ff680706537727a2c2689c0a12e07be50a Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 9 Aug 2021 17:51:37 +0200 Subject: [PATCH 056/132] biomass_transport: correct and simplify spatial management --- scripts/prepare_sector_network.py | 54 +++++++++++++++++-------------- 1 file changed, 30 insertions(+), 24 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 1dd92b28..baddcc81 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -46,7 +46,7 @@ def define_spatial(nodes): spatial.biomass.industry_cc = nodes + " solid biomass for industry CC" else: spatial.biomass.nodes = ["EU solid biomass"] - spatial.biomass.locations = "EU" + spatial.biomass.locations = ["EU"] spatial.biomass.industry = ["solid biomass for industry"] spatial.biomass.industry_cc = ["solid biomass for industry CC"] @@ -1612,16 +1612,13 @@ def add_biomass(n, costs): biomass_potentials = pd.read_csv(snakemake.input.biomass_potentials, index_col=0) - transport_costs = pd.read_csv( - snakemake.input.biomass_transport_costs, - index_col=0, - squeeze=True - ) - - # potential per node distributed within country by population - biomass_pot_node = (biomass_potentials.loc[pop_layout.ct] - .set_index(pop_layout.index) - .mul(pop_layout.fraction, axis="index")) + if options["biomass_transport"]: + # potential per node distributed within country by population + biomass_potentials_spatial = (biomass_potentials.loc[pop_layout.ct] + .set_index(pop_layout.index) + .mul(pop_layout.fraction, axis="index")) + else: + biomass_potentials_spatial = pd.DataFrame(biomass_potentials.sum()).T n.add("Carrier", "biogas") n.add("Carrier", "solid biomass") @@ -1651,9 +1648,9 @@ def add_biomass(n, costs): spatial.biomass.nodes, bus=spatial.biomass.nodes, carrier="solid biomass", - e_nom=biomass_pot_node["solid biomass"].values, + e_nom=biomass_potentials_spatial["solid biomass"].values, marginal_cost=costs.at['solid biomass', 'fuel'], - e_initial=biomass_pot_node["solid biomass"].values + e_initial=biomass_potentials_spatial["solid biomass"].values ) n.add("Link", @@ -1669,6 +1666,12 @@ def add_biomass(n, costs): ) if options["biomass_transport"]: + + transport_costs = pd.read_csv( + snakemake.input.biomass_transport_costs, + index_col=0, + squeeze=True + ) # add biomass transport biomass_transport = create_network_topology(n, "biomass transport ", bidirectional=False) @@ -1739,33 +1742,36 @@ def add_industry(n, costs): industrial_demand = pd.read_csv(snakemake.input.industrial_demand, index_col=0) * 1e6 n.madd("Bus", - spatial.biomass.df.loc[industrial_demand.index, "industry"].values, - location=spatial.biomass.df.loc[industrial_demand.index, "locations"].values, + spatial.biomass.industry, + location=spatial.biomass.locations, carrier="solid biomass for industry" ) - p_set = industrial_demand["solid biomass"].rename(index=lambda x: x + " solid biomass for industry") / 8760 + if options["biomass_transport"]: + p_set = industrial_demand.loc[spatial.biomass.locations, "solid biomass"].rename(index=lambda x: x + " solid biomass for industry") / 8760 + else: + p_set = industrial_demand["solid biomass"].sum() / 8760 n.madd("Load", - spatial.biomass.df.loc[industrial_demand.index, "industry"].values, - bus=spatial.biomass.df.loc[industrial_demand.index, "industry"].values, + spatial.biomass.industry, + bus=spatial.biomass.industry, carrier="solid biomass for industry", p_set=p_set ) n.madd("Link", - spatial.biomass.df.loc[industrial_demand.index, "industry"].values, - bus0=spatial.biomass.df.loc[industrial_demand.index, "nodes"].values, - bus1=spatial.biomass.df.loc[industrial_demand.index, "industry"].values, + spatial.biomass.industry, + bus0=spatial.biomass.nodes, + bus1=spatial.biomass.industry, carrier="solid biomass for industry", p_nom_extendable=True, efficiency=1. ) n.madd("Link", - spatial.biomass.df.loc[industrial_demand.index, "industry_cc"].values, - bus0=spatial.biomass.df.loc[industrial_demand.index, "nodes"].values, - bus1=spatial.biomass.df.loc[industrial_demand.index, "industry_cc"].values, + spatial.biomass.industry_cc, + bus0=spatial.biomass.nodes, + bus1=spatial.biomass.industry, bus2="co2 atmosphere", bus3="co2 stored", carrier="solid biomass for industry CC", From 7ca4f04611c23e63d49cc42505df8af4cdbadaed Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 9 Aug 2021 17:53:14 +0200 Subject: [PATCH 057/132] biomass_transport: reduce output files --- Snakefile | 2 -- scripts/build_biomass_transport_costs.py | 3 --- 2 files changed, 5 deletions(-) diff --git a/Snakefile b/Snakefile index 1ef55c86..d747b8fe 100644 --- a/Snakefile +++ b/Snakefile @@ -188,8 +188,6 @@ if config["sector"]["biomass_transport"]: input: transport_cost_data=HTTP.remote("publications.jrc.ec.europa.eu/repository/bitstream/JRC98626/biomass potentials in europe_web rev.pdf", keep_local=True) output: - supply_chain1="resources/biomass_transport_costs_supply_chain1.csv", - supply_chain2="resources/biomass_transport_costs_supply_chain2.csv", biomass_transport_costs="resources/biomass_transport_costs.csv", threads: 1 resources: mem_mb=1000 diff --git a/scripts/build_biomass_transport_costs.py b/scripts/build_biomass_transport_costs.py index dc1137ca..972ff9f8 100644 --- a/scripts/build_biomass_transport_costs.py +++ b/scripts/build_biomass_transport_costs.py @@ -63,9 +63,6 @@ def build_biomass_transport_costs(): sc1 = get_cost_per_tkm(146, countries) sc2 = get_cost_per_tkm(147, countries) - sc1.to_csv(snakemake.output.supply_chain1) - sc2.to_csv(snakemake.output.supply_chain2) - # take mean of both supply chains to_concat = [sc1["EUR/km/ton"], sc2["EUR/km/ton"]] transport_costs = pd.concat(to_concat, axis=1).mean(axis=1) From edf3a5f5fed6ff15f846910e98dbd9993c3f2d69 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 9 Aug 2021 17:55:43 +0200 Subject: [PATCH 058/132] biomass_transport: clarify meaning in config --- config.default.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/config.default.yaml b/config.default.yaml index 73e7f964..6671bbe9 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -233,7 +233,7 @@ sector: electricity_grid_connection: true # only applies to onshore wind and utility PV gas_distribution_grid: true gas_distribution_grid_cost_factor: 1.0 #multiplies cost in data/costs.csv - biomass_transport: false # biomass potential per country + transport between countries + biomass_transport: false # biomass transport between nodes conventional_generation: # generator : carrier OCGT: gas From 928d1f23edf3d21a9ee943188fd00ee06ad862b1 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 9 Aug 2021 18:03:20 +0200 Subject: [PATCH 059/132] biomass_transport: improve spatial biomass potential handling --- scripts/prepare_sector_network.py | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index baddcc81..c2fec14f 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1616,9 +1616,10 @@ def add_biomass(n, costs): # potential per node distributed within country by population biomass_potentials_spatial = (biomass_potentials.loc[pop_layout.ct] .set_index(pop_layout.index) - .mul(pop_layout.fraction, axis="index")) + .mul(pop_layout.fraction, axis="index") + .rename(index=lambda x: x + " solid biomass")) else: - biomass_potentials_spatial = pd.DataFrame(biomass_potentials.sum()).T + biomass_potentials_spatial = biomass_potentials.sum() n.add("Carrier", "biogas") n.add("Carrier", "solid biomass") @@ -1648,9 +1649,9 @@ def add_biomass(n, costs): spatial.biomass.nodes, bus=spatial.biomass.nodes, carrier="solid biomass", - e_nom=biomass_potentials_spatial["solid biomass"].values, + e_nom=biomass_potentials_spatial["solid biomass"], marginal_cost=costs.at['solid biomass', 'fuel'], - e_initial=biomass_potentials_spatial["solid biomass"].values + e_initial=biomass_potentials_spatial["solid biomass"] ) n.add("Link", From 12f385ef3f58aa76dc4606b1a6de7e46135a2ab1 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 9 Aug 2021 18:06:24 +0200 Subject: [PATCH 060/132] biomass_transport: simplify read-in --- scripts/build_biomass_transport_costs.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/build_biomass_transport_costs.py b/scripts/build_biomass_transport_costs.py index 972ff9f8..fc29853b 100644 --- a/scripts/build_biomass_transport_costs.py +++ b/scripts/build_biomass_transport_costs.py @@ -21,7 +21,7 @@ ENERGY_CONTENT = 4.8 # unit MWh/t (wood pellets) def get_countries(): pandas_options = dict( - skiprows=list(range(6)), + skiprows=range(6), header=None, index_col=0 ) From 2e2a66ef3ce2bc5253249c2110c938e9faad86ec Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 9 Aug 2021 18:20:07 +0200 Subject: [PATCH 061/132] biomass_transport: add release notes and documentation --- doc/release_notes.rst | 6 ++++++ doc/spatial_resolution.rst | 6 ++++-- 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/doc/release_notes.rst b/doc/release_notes.rst index 15419438..5e92c897 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -66,6 +66,12 @@ Future release * The share of shipping transformed into hydrogen fuel cell can be now defined for different years in the ``config.yaml`` file. The carbon emission from the remaining share is treated as a negative load on the atmospheric carbon dioxide bus, just like aviation and land transport emissions. * The transformation of the Steel and Aluminium production can be now defined for different years in the ``config.yaml`` file. * Include the option to alter the maximum energy capacity of a store via the ``carrier+factor`` in the ``{sector_opts}`` wildcard. This can be useful for sensitivity analyses. Example: ``co2 stored+e2`` multiplies the ``e_nom_max`` by factor 2. In this example, ``e_nom_max`` represents the CO2 sequestration potential in Europe. +* Add option to regionally disaggregate biomass potential to individual nodes + (currently given per country, then distributed by population density within) + and allow the transport of solid biomass. + The transport costs are determined based on the `JRC-EU-Times Bioenergy report `_ + in the new optional rule ``build_biomass_transport_costs``. + Biomass transport can be activated with the setting ``sector: biomass_transport: true``. PyPSA-Eur-Sec 0.5.0 (21st May 2021) =================================== diff --git a/doc/spatial_resolution.rst b/doc/spatial_resolution.rst index 1be9f3ad..b4e65417 100644 --- a/doc/spatial_resolution.rst +++ b/doc/spatial_resolution.rst @@ -44,8 +44,10 @@ Hydrogen network: nodal. Methane network: single node for Europe, since future demand is so low and no bottlenecks are expected. -Solid biomass: single node for Europe, until transport costs can be -incorporated. +Solid biomass: choice between single node for Europe and nodal where biomass +potential is regionally disaggregated (currently given per country, +then distributed by population density within) +and transport of solid biomass is possible. CO2: single node for Europe, but a transport and storage cost is added for sequestered CO2. From ed3fec46641f2b4253bf1c40785321fda45c6cf8 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Tue, 10 Aug 2021 10:27:40 +0200 Subject: [PATCH 062/132] add data/nuts to .gitignore --- .gitignore | 1 + 1 file changed, 1 insertion(+) diff --git a/.gitignore b/.gitignore index 1401c0ad..10243def 100644 --- a/.gitignore +++ b/.gitignore @@ -28,6 +28,7 @@ gurobi.log /data/.nfs* /data/Industrial_Database.csv /data/retro/tabula-calculator-calcsetbuilding.csv +/data/nuts* *.org From 05c233242025971d7bc57a49c49d5296d6097da6 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Tue, 10 Aug 2021 10:27:54 +0200 Subject: [PATCH 063/132] fix syntax error in master --- scripts/prepare_sector_network.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index ebf2ee71..2a92b670 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1931,7 +1931,7 @@ def maybe_adjust_costs_and_potentials(n, opts): else: if attr == 'p_nom_max': comps = {"Generator", "Link", "StorageUnit"} - elif attr = 'e_nom_max': + elif attr == 'e_nom_max': comps = {"Store"} else: comps = {"Generator", "Link", "StorageUnit", "Store"} From bab51b0f54697c22c973ab0c5ee22b9edb05c63a Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Tue, 10 Aug 2021 10:28:22 +0200 Subject: [PATCH 064/132] fix read-in of pypsa-eur data --- Snakefile | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/Snakefile b/Snakefile index 286df421..498cc7c9 100644 --- a/Snakefile +++ b/Snakefile @@ -24,7 +24,6 @@ subworkflow pypsaeur: snakefile: "../pypsa-eur/Snakefile" configfile: "../pypsa-eur/config.yaml" - rule all: input: SDIR + '/graphs/costs.pdf' @@ -176,9 +175,9 @@ rule build_biomass_potentials: enspreso_biomass=HTTP.remote("https://cidportal.jrc.ec.europa.eu/ftp/jrc-opendata/ENSPRESO/ENSPRESO_BIOMASS.xlsx", keep_local=True), nuts2="data/nuts/NUTS_RG_10M_2013_4326_LEVL_2.geojson", # https://gisco-services.ec.europa.eu/distribution/v2/nuts/download/#nuts21 regions_onshore=pypsaeur("resources/regions_onshore_elec_s{simpl}_{clusters}.geojson"), - nuts3_population=pypsaeur("data/bundle/nama_10r_3popgdp.tsv.gz"), - swiss_cantons=pypsaeur("data/bundle/ch_cantons.csv"), - swiss_population=pypsaeur("data/bundle/je-e-21.03.02.xls"), + nuts3_population="../pypsa-eur/data/bundle/nama_10r_3popgdp.tsv.gz", + swiss_cantons="../pypsa-eur/data/bundle/ch_cantons.csv", + swiss_population="../pypsa-eur/data/bundle/je-e-21.03.02.xls", country_shapes=pypsaeur('resources/country_shapes.geojson') output: biomass_potentials_all='resources/biomass_potentials_all_s{simpl}_{clusters}.csv', From 782323bee447338ef94053cd65f5aee3f9131aa6 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Tue, 10 Aug 2021 10:28:50 +0200 Subject: [PATCH 065/132] handle spaces in remote files --- scripts/build_biomass_potentials.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/scripts/build_biomass_potentials.py b/scripts/build_biomass_potentials.py index 59eb0051..cf5b0e6d 100644 --- a/scripts/build_biomass_potentials.py +++ b/scripts/build_biomass_potentials.py @@ -43,7 +43,7 @@ def build_nuts_population_data(year=2013): def enspreso_biomass_potentials(year=2020, scenario="ENS_Low"): glossary = pd.read_excel( - snakemake.input.enspreso_biomass, + str(snakemake.input.enspreso_biomass), sheet_name="Glossary", usecols="B:D", skiprows=1, @@ -51,7 +51,7 @@ def enspreso_biomass_potentials(year=2020, scenario="ENS_Low"): ) df = pd.read_excel( - snakemake.input.enspreso_biomass, + str(snakemake.input.enspreso_biomass), sheet_name="ENER - NUTS2 BioCom E", usecols="A:H" ) From e1a0a7d5fd45c83a2f4eeee371e47952f1c3972c Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Tue, 10 Aug 2021 10:31:06 +0200 Subject: [PATCH 066/132] set co2 sequestration cost to 10 EUR/t excl. transport --- config.default.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/config.default.yaml b/config.default.yaml index b2de9bf9..66a9f299 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -223,7 +223,7 @@ sector: co2_vent: true SMR: true co2_sequestration_potential: 200 #MtCO2/a sequestration potential for Europe - co2_sequestration_cost: 20 #EUR/tCO2 for transport and sequestration of CO2 + co2_sequestration_cost: 10 #EUR/tCO2 for sequestration of CO2 co2_network: false cc_fraction: 0.9 # default fraction of CO2 captured with post-combustion capture hydrogen_underground_storage: true From e40461b1c046f1722fff4df81454c54c38d936a1 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 16 Aug 2021 13:19:20 +0200 Subject: [PATCH 067/132] fix typo in biomass config --- config.default.yaml | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index 71613d9c..71c6b1e2 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -102,22 +102,22 @@ biomass: scenario: ENS_Med classes: solid biomass: - - Argicultural waste - - Municipal waste - - Residues from landscape care - - Sawdust - - Secondary Forestry residues - woodchips - not included: - - Bioethanol barley, wheat, grain maize, oats, other cereals and rye + - Agricultural waste - Fuelwood residues - - C&P_RW - - FuelwoodRW - - Rape seed + - Secondary Forestry residues - woodchips + - Sawdust + - Residues from landscape care + - Municipal waste + not included: - Sugar from sugar beet - - Miscanthus, switchgrass, RCG + - Rape seed - "Sunflower, soya seed " - - Poplar + - Bioethanol barley, wheat, grain maize, oats, other cereals and rye + - Miscanthus, switchgrass, RCG - Willow + - Poplar + - FuelwoodRW + - C&P_RW biogas: - Manure solid, liquid - Sludge From 99e602f7b25ea667b76ab0560c68c544840871de Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 16 Aug 2021 14:00:30 +0200 Subject: [PATCH 068/132] add ENSPRESO release notes and doc --- doc/data.csv | 1 + doc/release_notes.rst | 3 +++ doc/supply_demand.rst | 2 +- 3 files changed, 5 insertions(+), 1 deletion(-) diff --git a/doc/data.csv b/doc/data.csv index 8e316281..26a5bea0 100644 --- a/doc/data.csv +++ b/doc/data.csv @@ -2,6 +2,7 @@ description,file/folder,licence,source JRC IDEES database,jrc-idees-2015/,CC BY 4.0,https://ec.europa.eu/jrc/en/potencia/jrc-idees urban/rural fraction,urban_percent.csv,unknown,unknown JRC biomass potentials,biomass/,unknown,https://doi.org/10.2790/39014 +JRC ENSPRESO biomass potentials,remote,CC BY 4.0,https://data.jrc.ec.europa.eu/dataset/74ed5a04-7d74-4807-9eab-b94774309d9f EEA emission statistics,eea/UNFCCC_v23.csv,EEA standard re-use policy,https://www.eea.europa.eu/data-and-maps/data/national-emissions-reported-to-the-unfccc-and-to-the-eu-greenhouse-gas-monitoring-mechanism-16 Eurostat Energy Balances,eurostat-energy_balances-*/,Eurostat,https://ec.europa.eu/eurostat/web/energy/data/energy-balances Swiss energy statistics from Swiss Federal Office of Energy,switzerland-sfoe/,unknown,http://www.bfe.admin.ch/themen/00526/00541/00542/02167/index.html?dossier_id=02169 diff --git a/doc/release_notes.rst b/doc/release_notes.rst index 15419438..eb57dce9 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -66,6 +66,9 @@ Future release * The share of shipping transformed into hydrogen fuel cell can be now defined for different years in the ``config.yaml`` file. The carbon emission from the remaining share is treated as a negative load on the atmospheric carbon dioxide bus, just like aviation and land transport emissions. * The transformation of the Steel and Aluminium production can be now defined for different years in the ``config.yaml`` file. * Include the option to alter the maximum energy capacity of a store via the ``carrier+factor`` in the ``{sector_opts}`` wildcard. This can be useful for sensitivity analyses. Example: ``co2 stored+e2`` multiplies the ``e_nom_max`` by factor 2. In this example, ``e_nom_max`` represents the CO2 sequestration potential in Europe. +* Use `JRC ENSPRESO database `_ to + spatially disaggregate biomass potentials to PyPSA-Eur regions based on overlaps with NUTS2 regions from ENSPRESO + (proportional to area) (`#151 `_). PyPSA-Eur-Sec 0.5.0 (21st May 2021) =================================== diff --git a/doc/supply_demand.rst b/doc/supply_demand.rst index 77317094..8e4f2130 100644 --- a/doc/supply_demand.rst +++ b/doc/supply_demand.rst @@ -183,7 +183,7 @@ Solid biomass provides process heat up to 500 Celsius in industry, as well as fe Solid biomass supply ===================== -Only wastes and residues from the JRC biomass dataset. +Only wastes and residues from the JRC ENSPRESO biomass dataset. Oil product demand From 0a16ca3b35435afa4cca4daa59fe481da6f54b32 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 16 Aug 2021 14:14:05 +0200 Subject: [PATCH 069/132] add biomass potentials docstrings --- scripts/build_biomass_potentials.py | 46 +++++++++++++++++++++++++++++ 1 file changed, 46 insertions(+) diff --git a/scripts/build_biomass_potentials.py b/scripts/build_biomass_potentials.py index cf5b0e6d..68d87808 100644 --- a/scripts/build_biomass_potentials.py +++ b/scripts/build_biomass_potentials.py @@ -41,7 +41,24 @@ def build_nuts_population_data(year=2013): def enspreso_biomass_potentials(year=2020, scenario="ENS_Low"): + """ + Loads the JRC ENSPRESO biomass potentials. + Parameters + ---------- + year : int + The year for which potentials are to be taken. + Can be {2010, 2020, 2030, 2040, 2050}. + scenario : str + The scenario. Can be {"ENS_Low", "ENS_Med", "ENS_High"}. + + Returns + ------- + pd.DataFrame + Biomass potentials for given year and scenario + in TWh/a by commodity and NUTS2 region. + """ + glossary = pd.read_excel( str(snakemake.input.enspreso_biomass), sheet_name="Glossary", @@ -84,6 +101,20 @@ def enspreso_biomass_potentials(year=2020, scenario="ENS_Low"): def disaggregate_nuts0(bio): + """ + Some commodities are only given on NUTS0 level. + These are disaggregated here using the NUTS2 + population as distribution key. + + Parameters + ---------- + bio : pd.DataFrame + from enspreso_biomass_potentials() + + Returns + ------- + pd.DataFrame + """ pop = build_nuts_population_data() @@ -125,6 +156,21 @@ def area(gdf): def convert_nuts2_to_regions(bio_nuts2, regions): + """ + Converts biomass potentials given in NUTS2 to PyPSA-Eur regions based on the + overlay of both GeoDataFrames in proportion to the area. + + Parameters + ---------- + bio_nuts2 : gpd.GeoDataFrame + JRC ENSPRESO biomass potentials indexed by NUTS2 shapes. + regions : gpd.GeoDataFrame + PyPSA-Eur clustered onshore regions + + Returns + ------- + gpd.GeoDataFrame + """ # calculate area of nuts2 regions bio_nuts2["area_nuts2"] = area(bio_nuts2) From dd177df19fd2dad912d9822c936e70c903d556eb Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 16 Aug 2021 16:26:20 +0200 Subject: [PATCH 070/132] fix NL hardcode typo --- scripts/build_energy_totals.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/build_energy_totals.py b/scripts/build_energy_totals.py index 7fdd305a..84e599e7 100644 --- a/scripts/build_energy_totals.py +++ b/scripts/build_energy_totals.py @@ -620,7 +620,7 @@ def build_co2_totals(countries, eea_co2, eurostat_co2): # does not include industrial process emissions or fuel processing/refining "industrial non-elec": (ct, "+", "Industry"), # does not include non-energy emissions - "agriculture": (eurostat_co2.index.get_level_values(0) == 'NL') & eurostat_co2.index.isin(["Agriculture / Forestry", "Fishing"], level=3), + "agriculture": (eurostat_co2.index.get_level_values(0) == ct) & eurostat_co2.index.isin(["Agriculture / Forestry", "Fishing"], level=3), } for i, mi in mappings.items(): From 538c7ce0ff4da68acd8caf3862bcf4d13156d079 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 16 Aug 2021 16:26:50 +0200 Subject: [PATCH 071/132] clarify agriculture machinery fuel efficiency --- config.default.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index 35e6ad81..cc7653fc 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -175,8 +175,8 @@ sector: transport_fuel_cell_efficiency: 0.5 transport_internal_combustion_efficiency: 0.3 agriculture_machinery_electric_share: 0.12 # approximately as today - agriculture_machinery_fuel_efficiency: 0.7 # for conversion of fuel oil to use - agriculture_machinery_electric_efficiency: 0.3 # for conversion of electricity to use + agriculture_machinery_fuel_efficiency: 0.7 # fuel oil per use + agriculture_machinery_electric_efficiency: 0.3 # electricity per use shipping_average_efficiency: 0.4 #For conversion of fuel oil to propulsion in 2011 shipping_hydrogen_liquefaction: true # whether to consider liquefaction costs for shipping H2 demands shipping_hydrogen_share: # 1 means all hydrogen FC From 17c96edf7239429d7c27deafe88ce47dd65c048d Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 16 Aug 2021 16:27:25 +0200 Subject: [PATCH 072/132] agriculture: correctly convert units, fix efficiency gain, ICE aggregation for oil --- scripts/prepare_sector_network.py | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 374da7de..9cac9f38 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1965,7 +1965,7 @@ def add_agriculture(n, costs): suffix=" agriculture electricity", bus=nodes, carrier='agriculture electricity', - p_set=nodal_energy_totals.loc[nodes, "total agriculture electricity"] / 8760 + p_set=nodal_energy_totals.loc[nodes, "total agriculture electricity"] * 1e6 / 8760 ) # heat @@ -1975,7 +1975,7 @@ def add_agriculture(n, costs): suffix=" agriculture heat", bus=nodes + " services rural heat", carrier="agriculture heat", - p_set=nodal_energy_totals.loc[nodes, "total agriculture heat"] / 8760 + p_set=nodal_energy_totals.loc[nodes, "total agriculture heat"] * 1e6 / 8760 ) # machinery @@ -1995,7 +1995,7 @@ def add_agriculture(n, costs): suffix=" agriculture machinery electric", bus=nodes, carrier="agriculture machinery electric", - p_set=electric_share * efficiency_gain * machinery_nodal_energy / 8760, + p_set=electric_share / efficiency_gain * machinery_nodal_energy * 1e6 / 8760, ) if ice_share > 0: @@ -2004,10 +2004,10 @@ def add_agriculture(n, costs): "agriculture machinery oil", bus="EU oil", carrier="agriculture machinery oil", - p_set=ice_share * machinery_nodal_energy / 8760 + p_set=ice_share * machinery_nodal_energy.sum() * 1e6 / 8760 ) - co2 = ice_share * machinery_nodal_energy / 8760 * costs.at["oil", 'CO2 intensity'] + co2 = ice_share * machinery_nodal_energy.sum() * 1e6 / 8760 * costs.at["oil", 'CO2 intensity'] n.add("Load", "agriculture machinery oil emissions", From 8e3ef7f86b0ada0d3fd7a43d468e361f475eb7b8 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 16 Aug 2021 16:29:05 +0200 Subject: [PATCH 073/132] remove unused sector wildcard constraints --- Snakefile | 1 - 1 file changed, 1 deletion(-) diff --git a/Snakefile b/Snakefile index de34f386..db53f7c8 100644 --- a/Snakefile +++ b/Snakefile @@ -6,7 +6,6 @@ wildcard_constraints: lv="[a-z0-9\.]+", simpl="[a-zA-Z0-9]*", clusters="[0-9]+m?", - sectors="[+a-zA-Z0-9]+", opts="[-+a-zA-Z0-9]*", sector_opts="[-+a-zA-Z0-9\.\s]*" From 48e30bacadd8297f7df10dfab9e31f8a2ece0992 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 16 Aug 2021 16:34:15 +0200 Subject: [PATCH 074/132] add doc for A sector_opts setting --- config.default.yaml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/config.default.yaml b/config.default.yaml index cc7653fc..da86682a 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -27,7 +27,8 @@ scenario: # Co2L0p25 will give 25% CO2 emissions; Co2Lm0p05 will give 5% negative emissions # xH is the temporal resolution; 3H is 3-hourly, i.e. one snapshot every 3 hours # single letters are sectors: T for land transport, H for building heating, - # B for biomass supply, I for industry, shipping and aviation + # B for biomass supply, I for industry, shipping and aviation, + # A for agriculture, forestry and fishing # solar+c0.5 reduces the capital cost of solar to 50\% of reference value # solar+p3 multiplies the available installable potential by factor 3 # co2 stored+e2 multiplies the potential of CO2 sequestration by a factor 2 From 351964b1e776a6155de337bcc04ad5da1e5a6e07 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Wed, 18 Aug 2021 09:42:05 +0200 Subject: [PATCH 075/132] add logger.info for agriculture --- scripts/prepare_sector_network.py | 2 ++ 1 file changed, 2 insertions(+) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 9cac9f38..7961c213 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1956,6 +1956,8 @@ def add_waste_heat(n): def add_agriculture(n, costs): + logger.info('Add agriculture, forestry and fishing sector.') + nodes = pop_layout.index # electricity From 5b9f64354fb8cb6a8d9bfca361b5397347309ab3 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Wed, 18 Aug 2021 12:17:31 +0200 Subject: [PATCH 076/132] xarray 0.19 compatibility (#158) --- doc/release_notes.rst | 1 + scripts/build_population_layouts.py | 4 ++-- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/doc/release_notes.rst b/doc/release_notes.rst index 15419438..016e19dc 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -66,6 +66,7 @@ Future release * The share of shipping transformed into hydrogen fuel cell can be now defined for different years in the ``config.yaml`` file. The carbon emission from the remaining share is treated as a negative load on the atmospheric carbon dioxide bus, just like aviation and land transport emissions. * The transformation of the Steel and Aluminium production can be now defined for different years in the ``config.yaml`` file. * Include the option to alter the maximum energy capacity of a store via the ``carrier+factor`` in the ``{sector_opts}`` wildcard. This can be useful for sensitivity analyses. Example: ``co2 stored+e2`` multiplies the ``e_nom_max`` by factor 2. In this example, ``e_nom_max`` represents the CO2 sequestration potential in Europe. +* Compatibility with ``xarray`` version 0.19. PyPSA-Eur-Sec 0.5.0 (21st May 2021) =================================== diff --git a/scripts/build_population_layouts.py b/scripts/build_population_layouts.py index 57934fb2..6c229797 100644 --- a/scripts/build_population_layouts.py +++ b/scripts/build_population_layouts.py @@ -90,8 +90,8 @@ if __name__ == '__main__': for key, pop in pop_cells.items(): - ycoords = ('y', cutout.coords['y']) - xcoords = ('x', cutout.coords['x']) + ycoords = ('y', cutout.coords['y'].data) + xcoords = ('x', cutout.coords['x'].data) values = pop.values.reshape(cutout.shape) layout = xr.DataArray(values, [ycoords, xcoords]) From a9196f001b986ef1dc7582f86d78aa423bbfa752 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Wed, 18 Aug 2021 14:17:21 +0200 Subject: [PATCH 077/132] fix 2 typos --- scripts/build_energy_totals.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/scripts/build_energy_totals.py b/scripts/build_energy_totals.py index 84e599e7..4b4dc2bc 100644 --- a/scripts/build_energy_totals.py +++ b/scripts/build_energy_totals.py @@ -265,7 +265,7 @@ def idees_per_country(ct, year): ] ct_totals["total agriculture machinery"] = df[rows].sum() - row = ["Agriculture, forestry and fishing"] + row = "Agriculture, forestry and fishing" ct_totals["total agriculture"] = df[row] # transport @@ -569,7 +569,7 @@ def build_eea_co2(year=1990): "international aviation", "domestic navigation", "international navigation", - "agriculture, forstry and fishing" + "agriculture, forestry and fishing" ] emissions["industrial non-elec"] = emissions["total energy"] - emissions[to_subtract].sum(axis=1) From 13251d33cc4c6ca6e97d191ba314667e836b899b Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Wed, 18 Aug 2021 16:17:59 +0200 Subject: [PATCH 078/132] no machinery electric share, fix add to madd --- config.default.yaml | 2 +- scripts/prepare_sector_network.py | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index da86682a..05a4a751 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -175,7 +175,7 @@ sector: 2050: 0.85 transport_fuel_cell_efficiency: 0.5 transport_internal_combustion_efficiency: 0.3 - agriculture_machinery_electric_share: 0.12 # approximately as today + agriculture_machinery_electric_share: 0 agriculture_machinery_fuel_efficiency: 0.7 # fuel oil per use agriculture_machinery_electric_efficiency: 0.3 # electricity per use shipping_average_efficiency: 0.4 #For conversion of fuel oil to propulsion in 2011 diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 7961c213..c256c251 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1992,7 +1992,7 @@ def add_agriculture(n, costs): efficiency_gain = options["agriculture_machinery_fuel_efficiency"] / options["agriculture_machinery_electric_efficiency"] - n.add("Load", + n.madd("Load", nodes, suffix=" agriculture machinery electric", bus=nodes, From 148450e496669139232325b3522c059fcda88865 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Wed, 18 Aug 2021 16:38:34 +0200 Subject: [PATCH 079/132] adjust documentation and add release notes --- README.md | 6 +++--- doc/release_notes.rst | 4 ++++ doc/supply_demand.rst | 4 ++-- 3 files changed, 9 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index fe81519b..31aaa0ef 100644 --- a/README.md +++ b/README.md @@ -21,9 +21,9 @@ it. PyPSA-Eur-Sec builds on the electricity generation and transmission model [PyPSA-Eur](https://github.com/PyPSA/pypsa-eur) to add demand and supply for the following sectors: transport, space and water -heating, biomass, industry and industrial feedstocks. This completes -the energy system and includes all greenhouse gas emitters except -waste management, agriculture, forestry and land use. +heating, biomass, industry and industrial feedstocks, agriculture, +forestry and fishing. This completes the energy system and includes +all greenhouse gas emitters except waste management and land use. Please see the [documentation](https://pypsa-eur-sec.readthedocs.io/) for installation instructions and other useful information about the snakemake workflow. diff --git a/doc/release_notes.rst b/doc/release_notes.rst index 016e19dc..0c65c8c2 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -67,6 +67,10 @@ Future release * The transformation of the Steel and Aluminium production can be now defined for different years in the ``config.yaml`` file. * Include the option to alter the maximum energy capacity of a store via the ``carrier+factor`` in the ``{sector_opts}`` wildcard. This can be useful for sensitivity analyses. Example: ``co2 stored+e2`` multiplies the ``e_nom_max`` by factor 2. In this example, ``e_nom_max`` represents the CO2 sequestration potential in Europe. * Compatibility with ``xarray`` version 0.19. +* Added option to include emissions and energy demands of agriculture, forestry and fishing sector via the letter ``A`` in the ``{sector_opts}`` wildcard. + Demands are separated into electricity, heat and oil for machinery. + Fuel-switching for machinery from oil to electricity can be set exogenously in the ``config.yaml`` + `#147 `_. PyPSA-Eur-Sec 0.5.0 (21st May 2021) =================================== diff --git a/doc/supply_demand.rst b/doc/supply_demand.rst index 77317094..31563c43 100644 --- a/doc/supply_demand.rst +++ b/doc/supply_demand.rst @@ -43,7 +43,7 @@ Heat demand is split into: * ``urban central``: large-scale district heating networks in urban areas with dense heat demand * ``residential/services urban decentral``: heating for individual buildings in urban areas -* ``residential/services rural``: heating for individual buildings in rural areas +* ``residential/services rural``: heating for individual buildings in rural areas, agriculture heat uses Heat supply @@ -189,7 +189,7 @@ Only wastes and residues from the JRC biomass dataset. Oil product demand ===================== -Transport fuels and naphtha as a feedstock for the chemicals industry. +Transport fuels, agriculture machinery and naphtha as a feedstock for the chemicals industry. Oil product supply ====================== From aa8cefeb5b1b18da3317e28cdb608eeac4935d9f Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Thu, 19 Aug 2021 10:07:51 +0200 Subject: [PATCH 080/132] add district_heat_share.csv --- .gitignore | 2 +- data/district_heat_share.csv | 34 ++++++++++++++++++++++++++++++++++ 2 files changed, 35 insertions(+), 1 deletion(-) create mode 100644 data/district_heat_share.csv diff --git a/.gitignore b/.gitignore index ac252a84..4677557b 100644 --- a/.gitignore +++ b/.gitignore @@ -28,7 +28,7 @@ gurobi.log /data/.nfs* /data/Industrial_Database.csv /data/retro/tabula-calculator-calcsetbuilding.csv -/data +/data/nuts* *.org *.nc diff --git a/data/district_heat_share.csv b/data/district_heat_share.csv new file mode 100644 index 00000000..5afd65c8 --- /dev/null +++ b/data/district_heat_share.csv @@ -0,0 +1,34 @@ +country,share to satisfy heat demand (residential) in percent,capacity[MWth] +AT,14,11200 +BG,16,6162 +BA,8, +HR,6.3,2221 +CZ,40, +DK,65, +FI,38,23390 +FR,5, +DE,13.8, +HU,7.92875588637399,8549 +IS,90,8079000 +IE,0.8, +IT,3,8727 +LV,73,2254 +LT,56, +MK,23.7745607009008,636 +NO,4,3400 +PL,42,54912 +PT,0.070754716981132,34 +RS,25,5821 +SI,8.86,1739 +ES,0.251589260787732,1273 +SE,50.4, +UK,2, +BY,70, +EE,52,5406 +KO,3,207 +RO,23,9962 +SK,54,15000 +NL,4,9800 +CH,4,2792 +AL,0, +ME,0, From 8d22df6482593275e02829ab368e93589c025f37 Mon Sep 17 00:00:00 2001 From: martavp <30744159+martavp@users.noreply.github.com> Date: Tue, 24 Aug 2021 18:38:24 +0200 Subject: [PATCH 081/132] Update plot_network.py Some links producing heat have more than 2 ports (e.g. Fischer-Tropsch). This enables capturing them when plotting heat time series. --- scripts/plot_network.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/scripts/plot_network.py b/scripts/plot_network.py index cd74d3ea..c97956a0 100644 --- a/scripts/plot_network.py +++ b/scripts/plot_network.py @@ -398,7 +398,8 @@ def plot_series(network, carrier="AC", name="test"): supply = pd.DataFrame(index=n.snapshots) for c in n.iterate_components(n.branch_components): - for i in range(2): + n_port = 4 if c.name=='Link' else 2 + for i in range(n_port): supply = pd.concat((supply, (-1) * c.pnl["p" + str(i)].loc[:, c.df.index[c.df["bus" + str(i)].isin(buses)]].groupby(c.df.carrier, From 919c9d8b8dfa6f19ca4db19d30435f29e2c4d0ff Mon Sep 17 00:00:00 2001 From: martavp <30744159+martavp@users.noreply.github.com> Date: Tue, 24 Aug 2021 18:48:20 +0200 Subject: [PATCH 082/132] Update prepare_sector_network.py update build_carbon_budget to use budget estimation from 2020 onwards --- scripts/prepare_sector_network.py | 3 --- 1 file changed, 3 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index a5bc0d14..3de7154f 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -103,9 +103,6 @@ def build_carbon_budget(o, fn): #emissions at the beginning of the path (last year available 2018) e_0 = co2_emissions_year(countries, opts, year=2018) - #emissions in 2019 and 2020 assumed equal to 2018 and substracted - carbon_budget -= 2 * e_0 - planning_horizons = snakemake.config['scenario']['planning_horizons'] t_0 = planning_horizons[0] From 203a7f3df212ef7bb6a536c4f05d6830cd7e8807 Mon Sep 17 00:00:00 2001 From: martavp <30744159+martavp@users.noreply.github.com> Date: Tue, 24 Aug 2021 18:58:42 +0200 Subject: [PATCH 083/132] Add lifetime to solar-rooftop Rooftop-solar generators are missing the lifetime attribute when they are added. This avoids that they are saved as brownfield capacities installed in a previous timestep when running myopic optimization. I.e, they are not captured in the following line https://github.com/PyPSA/pypsa-eur-sec/blob/5b9f64354fb8cb6a8d9bfca361b5397347309ab3/scripts/add_existing_baseyear.py#L31 --- scripts/prepare_sector_network.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index a5bc0d14..b93a0fc3 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -770,7 +770,8 @@ def insert_electricity_distribution_grid(n, costs): marginal_cost=n.generators.loc[solar, 'marginal_cost'], capital_cost=costs.at['solar-rooftop', 'fixed'], efficiency=n.generators.loc[solar, 'efficiency'], - p_max_pu=n.generators_t.p_max_pu[solar] + p_max_pu=n.generators_t.p_max_pu[solar], + lifetime=costs.at['solar-rooftop', 'lifetime'] ) n.add("Carrier", "home battery") From b4af3f3fa3dbd36f13ff1cd4dd0f2a90fc5075f2 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Wed, 22 Sep 2021 18:03:25 +0200 Subject: [PATCH 084/132] change license --- LICENSE.txt | 694 ++---------------------------------------- README.md | 2 +- doc/index.rst | 4 +- doc/release_notes.rst | 2 + 4 files changed, 25 insertions(+), 677 deletions(-) diff --git a/LICENSE.txt b/LICENSE.txt index 9cecc1d4..dc10fd32 100644 --- a/LICENSE.txt +++ b/LICENSE.txt @@ -1,674 +1,20 @@ - GNU GENERAL PUBLIC LICENSE - Version 3, 29 June 2007 - - Copyright (C) 2007 Free Software Foundation, Inc. - Everyone is permitted to copy and distribute verbatim copies - of this license document, but changing it is not allowed. - - Preamble - - The GNU General Public License is a free, copyleft license for -software and other kinds of works. - - The licenses for most software and other practical works are designed -to take away your freedom to share and change the works. By contrast, -the GNU General Public License is intended to guarantee your freedom to -share and change all versions of a program--to make sure it remains free -software for all its users. We, the Free Software Foundation, use the -GNU General Public License for most of our software; it applies also to -any other work released this way by its authors. You can apply it to -your programs, too. - - When we speak of free software, we are referring to freedom, not -price. Our General Public Licenses are designed to make sure that you -have the freedom to distribute copies of free software (and charge for -them if you wish), that you receive source code or can get it if you -want it, that you can change the software or use pieces of it in new -free programs, and that you know you can do these things. - - To protect your rights, we need to prevent others from denying you -these rights or asking you to surrender the rights. Therefore, you have -certain responsibilities if you distribute copies of the software, or if -you modify it: responsibilities to respect the freedom of others. - - For example, if you distribute copies of such a program, whether -gratis or for a fee, you must pass on to the recipients the same -freedoms that you received. You must make sure that they, too, receive -or can get the source code. And you must show them these terms so they -know their rights. - - Developers that use the GNU GPL protect your rights with two steps: -(1) assert copyright on the software, and (2) offer you this License -giving you legal permission to copy, distribute and/or modify it. - - For the developers' and authors' protection, the GPL clearly explains -that there is no warranty for this free software. For both users' and -authors' sake, the GPL requires that modified versions be marked as -changed, so that their problems will not be attributed erroneously to -authors of previous versions. - - Some devices are designed to deny users access to install or run -modified versions of the software inside them, although the manufacturer -can do so. This is fundamentally incompatible with the aim of -protecting users' freedom to change the software. The systematic -pattern of such abuse occurs in the area of products for individuals to -use, which is precisely where it is most unacceptable. Therefore, we -have designed this version of the GPL to prohibit the practice for those -products. If such problems arise substantially in other domains, we -stand ready to extend this provision to those domains in future versions -of the GPL, as needed to protect the freedom of users. - - Finally, every program is threatened constantly by software patents. -States should not allow patents to restrict development and use of -software on general-purpose computers, but in those that do, we wish to -avoid the special danger that patents applied to a free program could -make it effectively proprietary. To prevent this, the GPL assures that -patents cannot be used to render the program non-free. - - The precise terms and conditions for copying, distribution and -modification follow. - - TERMS AND CONDITIONS - - 0. Definitions. - - "This License" refers to version 3 of the GNU General Public License. - - "Copyright" also means copyright-like laws that apply to other kinds of -works, such as semiconductor masks. - - "The Program" refers to any copyrightable work licensed under this -License. Each licensee is addressed as "you". "Licensees" and -"recipients" may be individuals or organizations. - - To "modify" a work means to copy from or adapt all or part of the work -in a fashion requiring copyright permission, other than the making of an -exact copy. The resulting work is called a "modified version" of the -earlier work or a work "based on" the earlier work. - - A "covered work" means either the unmodified Program or a work based -on the Program. - - To "propagate" a work means to do anything with it that, without -permission, would make you directly or secondarily liable for -infringement under applicable copyright law, except executing it on a -computer or modifying a private copy. Propagation includes copying, -distribution (with or without modification), making available to the -public, and in some countries other activities as well. - - To "convey" a work means any kind of propagation that enables other -parties to make or receive copies. Mere interaction with a user through -a computer network, with no transfer of a copy, is not conveying. - - An interactive user interface displays "Appropriate Legal Notices" -to the extent that it includes a convenient and prominently visible -feature that (1) displays an appropriate copyright notice, and (2) -tells the user that there is no warranty for the work (except to the -extent that warranties are provided), that licensees may convey the -work under this License, and how to view a copy of this License. If -the interface presents a list of user commands or options, such as a -menu, a prominent item in the list meets this criterion. - - 1. Source Code. - - The "source code" for a work means the preferred form of the work -for making modifications to it. "Object code" means any non-source -form of a work. - - A "Standard Interface" means an interface that either is an official -standard defined by a recognized standards body, or, in the case of -interfaces specified for a particular programming language, one that -is widely used among developers working in that language. - - The "System Libraries" of an executable work include anything, other -than the work as a whole, that (a) is included in the normal form of -packaging a Major Component, but which is not part of that Major -Component, and (b) serves only to enable use of the work with that -Major Component, or to implement a Standard Interface for which an -implementation is available to the public in source code form. A -"Major Component", in this context, means a major essential component -(kernel, window system, and so on) of the specific operating system -(if any) on which the executable work runs, or a compiler used to -produce the work, or an object code interpreter used to run it. - - The "Corresponding Source" for a work in object code form means all -the source code needed to generate, install, and (for an executable -work) run the object code and to modify the work, including scripts to -control those activities. However, it does not include the work's -System Libraries, or general-purpose tools or generally available free -programs which are used unmodified in performing those activities but -which are not part of the work. For example, Corresponding Source -includes interface definition files associated with source files for -the work, and the source code for shared libraries and dynamically -linked subprograms that the work is specifically designed to require, -such as by intimate data communication or control flow between those -subprograms and other parts of the work. - - The Corresponding Source need not include anything that users -can regenerate automatically from other parts of the Corresponding -Source. - - The Corresponding Source for a work in source code form is that -same work. - - 2. Basic Permissions. - - All rights granted under this License are granted for the term of -copyright on the Program, and are irrevocable provided the stated -conditions are met. This License explicitly affirms your unlimited -permission to run the unmodified Program. The output from running a -covered work is covered by this License only if the output, given its -content, constitutes a covered work. This License acknowledges your -rights of fair use or other equivalent, as provided by copyright law. - - You may make, run and propagate covered works that you do not -convey, without conditions so long as your license otherwise remains -in force. You may convey covered works to others for the sole purpose -of having them make modifications exclusively for you, or provide you -with facilities for running those works, provided that you comply with -the terms of this License in conveying all material for which you do -not control copyright. Those thus making or running the covered works -for you must do so exclusively on your behalf, under your direction -and control, on terms that prohibit them from making any copies of -your copyrighted material outside their relationship with you. - - Conveying under any other circumstances is permitted solely under -the conditions stated below. Sublicensing is not allowed; section 10 -makes it unnecessary. - - 3. Protecting Users' Legal Rights From Anti-Circumvention Law. - - No covered work shall be deemed part of an effective technological -measure under any applicable law fulfilling obligations under article -11 of the WIPO copyright treaty adopted on 20 December 1996, or -similar laws prohibiting or restricting circumvention of such -measures. - - When you convey a covered work, you waive any legal power to forbid -circumvention of technological measures to the extent such circumvention -is effected by exercising rights under this License with respect to -the covered work, and you disclaim any intention to limit operation or -modification of the work as a means of enforcing, against the work's -users, your or third parties' legal rights to forbid circumvention of -technological measures. - - 4. Conveying Verbatim Copies. - - You may convey verbatim copies of the Program's source code as you -receive it, in any medium, provided that you conspicuously and -appropriately publish on each copy an appropriate copyright notice; -keep intact all notices stating that this License and any -non-permissive terms added in accord with section 7 apply to the code; -keep intact all notices of the absence of any warranty; and give all -recipients a copy of this License along with the Program. - - You may charge any price or no price for each copy that you convey, -and you may offer support or warranty protection for a fee. - - 5. Conveying Modified Source Versions. - - You may convey a work based on the Program, or the modifications to -produce it from the Program, in the form of source code under the -terms of section 4, provided that you also meet all of these conditions: - - a) The work must carry prominent notices stating that you modified - it, and giving a relevant date. - - b) The work must carry prominent notices stating that it is - released under this License and any conditions added under section - 7. This requirement modifies the requirement in section 4 to - "keep intact all notices". - - c) You must license the entire work, as a whole, under this - License to anyone who comes into possession of a copy. This - License will therefore apply, along with any applicable section 7 - additional terms, to the whole of the work, and all its parts, - regardless of how they are packaged. This License gives no - permission to license the work in any other way, but it does not - invalidate such permission if you have separately received it. - - d) If the work has interactive user interfaces, each must display - Appropriate Legal Notices; however, if the Program has interactive - interfaces that do not display Appropriate Legal Notices, your - work need not make them do so. - - A compilation of a covered work with other separate and independent -works, which are not by their nature extensions of the covered work, -and which are not combined with it such as to form a larger program, -in or on a volume of a storage or distribution medium, is called an -"aggregate" if the compilation and its resulting copyright are not -used to limit the access or legal rights of the compilation's users -beyond what the individual works permit. Inclusion of a covered work -in an aggregate does not cause this License to apply to the other -parts of the aggregate. - - 6. Conveying Non-Source Forms. - - You may convey a covered work in object code form under the terms -of sections 4 and 5, provided that you also convey the -machine-readable Corresponding Source under the terms of this License, -in one of these ways: - - a) Convey the object code in, or embodied in, a physical product - (including a physical distribution medium), accompanied by the - Corresponding Source fixed on a durable physical medium - customarily used for software interchange. - - b) Convey the object code in, or embodied in, a physical product - (including a physical distribution medium), accompanied by a - written offer, valid for at least three years and valid for as - long as you offer spare parts or customer support for that product - model, to give anyone who possesses the object code either (1) a - copy of the Corresponding Source for all the software in the - product that is covered by this License, on a durable physical - medium customarily used for software interchange, for a price no - more than your reasonable cost of physically performing this - conveying of source, or (2) access to copy the - Corresponding Source from a network server at no charge. - - c) Convey individual copies of the object code with a copy of the - written offer to provide the Corresponding Source. This - alternative is allowed only occasionally and noncommercially, and - only if you received the object code with such an offer, in accord - with subsection 6b. - - d) Convey the object code by offering access from a designated - place (gratis or for a charge), and offer equivalent access to the - Corresponding Source in the same way through the same place at no - further charge. You need not require recipients to copy the - Corresponding Source along with the object code. If the place to - copy the object code is a network server, the Corresponding Source - may be on a different server (operated by you or a third party) - that supports equivalent copying facilities, provided you maintain - clear directions next to the object code saying where to find the - Corresponding Source. Regardless of what server hosts the - Corresponding Source, you remain obligated to ensure that it is - available for as long as needed to satisfy these requirements. - - e) Convey the object code using peer-to-peer transmission, provided - you inform other peers where the object code and Corresponding - Source of the work are being offered to the general public at no - charge under subsection 6d. - - A separable portion of the object code, whose source code is excluded -from the Corresponding Source as a System Library, need not be -included in conveying the object code work. - - A "User Product" is either (1) a "consumer product", which means any -tangible personal property which is normally used for personal, family, -or household purposes, or (2) anything designed or sold for incorporation -into a dwelling. In determining whether a product is a consumer product, -doubtful cases shall be resolved in favor of coverage. For a particular -product received by a particular user, "normally used" refers to a -typical or common use of that class of product, regardless of the status -of the particular user or of the way in which the particular user -actually uses, or expects or is expected to use, the product. A product -is a consumer product regardless of whether the product has substantial -commercial, industrial or non-consumer uses, unless such uses represent -the only significant mode of use of the product. - - "Installation Information" for a User Product means any methods, -procedures, authorization keys, or other information required to install -and execute modified versions of a covered work in that User Product from -a modified version of its Corresponding Source. The information must -suffice to ensure that the continued functioning of the modified object -code is in no case prevented or interfered with solely because -modification has been made. - - If you convey an object code work under this section in, or with, or -specifically for use in, a User Product, and the conveying occurs as -part of a transaction in which the right of possession and use of the -User Product is transferred to the recipient in perpetuity or for a -fixed term (regardless of how the transaction is characterized), the -Corresponding Source conveyed under this section must be accompanied -by the Installation Information. But this requirement does not apply -if neither you nor any third party retains the ability to install -modified object code on the User Product (for example, the work has -been installed in ROM). - - The requirement to provide Installation Information does not include a -requirement to continue to provide support service, warranty, or updates -for a work that has been modified or installed by the recipient, or for -the User Product in which it has been modified or installed. Access to a -network may be denied when the modification itself materially and -adversely affects the operation of the network or violates the rules and -protocols for communication across the network. - - Corresponding Source conveyed, and Installation Information provided, -in accord with this section must be in a format that is publicly -documented (and with an implementation available to the public in -source code form), and must require no special password or key for -unpacking, reading or copying. - - 7. Additional Terms. - - "Additional permissions" are terms that supplement the terms of this -License by making exceptions from one or more of its conditions. -Additional permissions that are applicable to the entire Program shall -be treated as though they were included in this License, to the extent -that they are valid under applicable law. If additional permissions -apply only to part of the Program, that part may be used separately -under those permissions, but the entire Program remains governed by -this License without regard to the additional permissions. - - When you convey a copy of a covered work, you may at your option -remove any additional permissions from that copy, or from any part of -it. (Additional permissions may be written to require their own -removal in certain cases when you modify the work.) You may place -additional permissions on material, added by you to a covered work, -for which you have or can give appropriate copyright permission. - - Notwithstanding any other provision of this License, for material you -add to a covered work, you may (if authorized by the copyright holders of -that material) supplement the terms of this License with terms: - - a) Disclaiming warranty or limiting liability differently from the - terms of sections 15 and 16 of this License; or - - b) Requiring preservation of specified reasonable legal notices or - author attributions in that material or in the Appropriate Legal - Notices displayed by works containing it; or - - c) Prohibiting misrepresentation of the origin of that material, or - requiring that modified versions of such material be marked in - reasonable ways as different from the original version; or - - d) Limiting the use for publicity purposes of names of licensors or - authors of the material; or - - e) Declining to grant rights under trademark law for use of some - trade names, trademarks, or service marks; or - - f) Requiring indemnification of licensors and authors of that - material by anyone who conveys the material (or modified versions of - it) with contractual assumptions of liability to the recipient, for - any liability that these contractual assumptions directly impose on - those licensors and authors. - - All other non-permissive additional terms are considered "further -restrictions" within the meaning of section 10. If the Program as you -received it, or any part of it, contains a notice stating that it is -governed by this License along with a term that is a further -restriction, you may remove that term. If a license document contains -a further restriction but permits relicensing or conveying under this -License, you may add to a covered work material governed by the terms -of that license document, provided that the further restriction does -not survive such relicensing or conveying. - - If you add terms to a covered work in accord with this section, you -must place, in the relevant source files, a statement of the -additional terms that apply to those files, or a notice indicating -where to find the applicable terms. - - Additional terms, permissive or non-permissive, may be stated in the -form of a separately written license, or stated as exceptions; -the above requirements apply either way. - - 8. Termination. - - You may not propagate or modify a covered work except as expressly -provided under this License. Any attempt otherwise to propagate or -modify it is void, and will automatically terminate your rights under -this License (including any patent licenses granted under the third -paragraph of section 11). - - However, if you cease all violation of this License, then your -license from a particular copyright holder is reinstated (a) -provisionally, unless and until the copyright holder explicitly and -finally terminates your license, and (b) permanently, if the copyright -holder fails to notify you of the violation by some reasonable means -prior to 60 days after the cessation. - - Moreover, your license from a particular copyright holder is -reinstated permanently if the copyright holder notifies you of the -violation by some reasonable means, this is the first time you have -received notice of violation of this License (for any work) from that -copyright holder, and you cure the violation prior to 30 days after -your receipt of the notice. - - Termination of your rights under this section does not terminate the -licenses of parties who have received copies or rights from you under -this License. If your rights have been terminated and not permanently -reinstated, you do not qualify to receive new licenses for the same -material under section 10. - - 9. Acceptance Not Required for Having Copies. - - You are not required to accept this License in order to receive or -run a copy of the Program. Ancillary propagation of a covered work -occurring solely as a consequence of using peer-to-peer transmission -to receive a copy likewise does not require acceptance. However, -nothing other than this License grants you permission to propagate or -modify any covered work. These actions infringe copyright if you do -not accept this License. Therefore, by modifying or propagating a -covered work, you indicate your acceptance of this License to do so. - - 10. Automatic Licensing of Downstream Recipients. - - Each time you convey a covered work, the recipient automatically -receives a license from the original licensors, to run, modify and -propagate that work, subject to this License. You are not responsible -for enforcing compliance by third parties with this License. - - An "entity transaction" is a transaction transferring control of an -organization, or substantially all assets of one, or subdividing an -organization, or merging organizations. If propagation of a covered -work results from an entity transaction, each party to that -transaction who receives a copy of the work also receives whatever -licenses to the work the party's predecessor in interest had or could -give under the previous paragraph, plus a right to possession of the -Corresponding Source of the work from the predecessor in interest, if -the predecessor has it or can get it with reasonable efforts. - - You may not impose any further restrictions on the exercise of the -rights granted or affirmed under this License. For example, you may -not impose a license fee, royalty, or other charge for exercise of -rights granted under this License, and you may not initiate litigation -(including a cross-claim or counterclaim in a lawsuit) alleging that -any patent claim is infringed by making, using, selling, offering for -sale, or importing the Program or any portion of it. - - 11. Patents. - - A "contributor" is a copyright holder who authorizes use under this -License of the Program or a work on which the Program is based. The -work thus licensed is called the contributor's "contributor version". - - A contributor's "essential patent claims" are all patent claims -owned or controlled by the contributor, whether already acquired or -hereafter acquired, that would be infringed by some manner, permitted -by this License, of making, using, or selling its contributor version, -but do not include claims that would be infringed only as a -consequence of further modification of the contributor version. For -purposes of this definition, "control" includes the right to grant -patent sublicenses in a manner consistent with the requirements of -this License. - - Each contributor grants you a non-exclusive, worldwide, royalty-free -patent license under the contributor's essential patent claims, to -make, use, sell, offer for sale, import and otherwise run, modify and -propagate the contents of its contributor version. - - In the following three paragraphs, a "patent license" is any express -agreement or commitment, however denominated, not to enforce a patent -(such as an express permission to practice a patent or covenant not to -sue for patent infringement). To "grant" such a patent license to a -party means to make such an agreement or commitment not to enforce a -patent against the party. - - If you convey a covered work, knowingly relying on a patent license, -and the Corresponding Source of the work is not available for anyone -to copy, free of charge and under the terms of this License, through a -publicly available network server or other readily accessible means, -then you must either (1) cause the Corresponding Source to be so -available, or (2) arrange to deprive yourself of the benefit of the -patent license for this particular work, or (3) arrange, in a manner -consistent with the requirements of this License, to extend the patent -license to downstream recipients. "Knowingly relying" means you have -actual knowledge that, but for the patent license, your conveying the -covered work in a country, or your recipient's use of the covered work -in a country, would infringe one or more identifiable patents in that -country that you have reason to believe are valid. - - If, pursuant to or in connection with a single transaction or -arrangement, you convey, or propagate by procuring conveyance of, a -covered work, and grant a patent license to some of the parties -receiving the covered work authorizing them to use, propagate, modify -or convey a specific copy of the covered work, then the patent license -you grant is automatically extended to all recipients of the covered -work and works based on it. - - A patent license is "discriminatory" if it does not include within -the scope of its coverage, prohibits the exercise of, or is -conditioned on the non-exercise of one or more of the rights that are -specifically granted under this License. You may not convey a covered -work if you are a party to an arrangement with a third party that is -in the business of distributing software, under which you make payment -to the third party based on the extent of your activity of conveying -the work, and under which the third party grants, to any of the -parties who would receive the covered work from you, a discriminatory -patent license (a) in connection with copies of the covered work -conveyed by you (or copies made from those copies), or (b) primarily -for and in connection with specific products or compilations that -contain the covered work, unless you entered into that arrangement, -or that patent license was granted, prior to 28 March 2007. - - Nothing in this License shall be construed as excluding or limiting -any implied license or other defenses to infringement that may -otherwise be available to you under applicable patent law. - - 12. No Surrender of Others' Freedom. - - If conditions are imposed on you (whether by court order, agreement or -otherwise) that contradict the conditions of this License, they do not -excuse you from the conditions of this License. If you cannot convey a -covered work so as to satisfy simultaneously your obligations under this -License and any other pertinent obligations, then as a consequence you may -not convey it at all. For example, if you agree to terms that obligate you -to collect a royalty for further conveying from those to whom you convey -the Program, the only way you could satisfy both those terms and this -License would be to refrain entirely from conveying the Program. - - 13. Use with the GNU Affero General Public License. - - Notwithstanding any other provision of this License, you have -permission to link or combine any covered work with a work licensed -under version 3 of the GNU Affero General Public License into a single -combined work, and to convey the resulting work. The terms of this -License will continue to apply to the part which is the covered work, -but the special requirements of the GNU Affero General Public License, -section 13, concerning interaction through a network will apply to the -combination as such. - - 14. Revised Versions of this License. - - The Free Software Foundation may publish revised and/or new versions of -the GNU General Public License from time to time. Such new versions will -be similar in spirit to the present version, but may differ in detail to -address new problems or concerns. - - Each version is given a distinguishing version number. If the -Program specifies that a certain numbered version of the GNU General -Public License "or any later version" applies to it, you have the -option of following the terms and conditions either of that numbered -version or of any later version published by the Free Software -Foundation. If the Program does not specify a version number of the -GNU General Public License, you may choose any version ever published -by the Free Software Foundation. - - If the Program specifies that a proxy can decide which future -versions of the GNU General Public License can be used, that proxy's -public statement of acceptance of a version permanently authorizes you -to choose that version for the Program. - - Later license versions may give you additional or different -permissions. However, no additional obligations are imposed on any -author or copyright holder as a result of your choosing to follow a -later version. - - 15. Disclaimer of Warranty. - - THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY -APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT -HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY -OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, -THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM -IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF -ALL NECESSARY SERVICING, REPAIR OR CORRECTION. - - 16. Limitation of Liability. - - IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING -WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS -THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY -GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE -USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF -DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD -PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), -EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF -SUCH DAMAGES. - - 17. Interpretation of Sections 15 and 16. - - If the disclaimer of warranty and limitation of liability provided -above cannot be given local legal effect according to their terms, -reviewing courts shall apply local law that most closely approximates -an absolute waiver of all civil liability in connection with the -Program, unless a warranty or assumption of liability accompanies a -copy of the Program in return for a fee. - - END OF TERMS AND CONDITIONS - - How to Apply These Terms to Your New Programs - - If you develop a new program, and you want it to be of the greatest -possible use to the public, the best way to achieve this is to make it -free software which everyone can redistribute and change under these terms. - - To do so, attach the following notices to the program. It is safest -to attach them to the start of each source file to most effectively -state the exclusion of warranty; and each file should have at least -the "copyright" line and a pointer to where the full notice is found. - - {one line to give the program's name and a brief idea of what it does.} - Copyright (C) {year} {name of author} - - This program is free software: you can redistribute it and/or modify - it under the terms of the GNU General Public License as published by - the Free Software Foundation, either version 3 of the License, or - (at your option) any later version. - - This program is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. - - You should have received a copy of the GNU General Public License - along with this program. If not, see . - -Also add information on how to contact you by electronic and paper mail. - - If the program does terminal interaction, make it output a short -notice like this when it starts in an interactive mode: - - {project} Copyright (C) {year} {fullname} - This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. - This is free software, and you are welcome to redistribute it - under certain conditions; type `show c' for details. - -The hypothetical commands `show w' and `show c' should show the appropriate -parts of the General Public License. Of course, your program's commands -might be different; for a GUI interface, you would use an "about box". - - You should also get your employer (if you work as a programmer) or school, -if any, to sign a "copyright disclaimer" for the program, if necessary. -For more information on this, and how to apply and follow the GNU GPL, see -. - - The GNU General Public License does not permit incorporating your program -into proprietary programs. If your program is a subroutine library, you -may consider it more useful to permit linking proprietary applications with -the library. If this is what you want to do, use the GNU Lesser General -Public License instead of this License. But first, please read -. +MIT License + +Copyright 2017-2021 The PyPSA-Eur Authors + +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of +the Software, and to permit persons to whom the Software is furnished to do so, +subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS +FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR +COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER +IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN +CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. \ No newline at end of file diff --git a/README.md b/README.md index fe81519b..83ebbbe7 100644 --- a/README.md +++ b/README.md @@ -65,6 +65,6 @@ the additional sectors. # Licence The code in PyPSA-Eur-Sec is released as free software under the -[GPLv3](http://www.gnu.org/licenses/gpl-3.0.en.html), see LICENSE.txt. +[MIT License](https://opensource.org/licenses/MIT), see `LICENSE.txt`. However, different licenses and terms of use may apply to the various input data. diff --git a/doc/index.rst b/doc/index.rst index 1bf307f5..0c6f929d 100644 --- a/doc/index.rst +++ b/doc/index.rst @@ -134,7 +134,7 @@ it. Licence ======= -The code in PyPSA-Eur-Sec is released as free software under the `GPLv3 -`_, see +The code in PyPSA-Eur-Sec is released as free software under the +`MIT license `_, see `LICENSE `_. However, different licenses and terms of use may apply to the various input data. diff --git a/doc/release_notes.rst b/doc/release_notes.rst index 016e19dc..4de40f06 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -8,6 +8,8 @@ Future release .. note:: This unreleased version currently requires the master branches of PyPSA, PyPSA-Eur, and the technology-data repository. +* With this release, we change the license from copyleft GPLv3 to the more + liberal MIT license with the consent of all contributors. * Extended use of ``multiprocessing`` for much better performance (from up to 20 minutes to less than one minute). * Compatibility with ``atlite>=0.2``. Older versions of ``atlite`` will no longer work. From fbccd5fbc085017c4326d04032fb3f636a929173 Mon Sep 17 00:00:00 2001 From: Tom Brown Date: Fri, 24 Sep 2021 13:00:58 +0200 Subject: [PATCH 085/132] industry: separate HVC, methanol and chlorine from basic chemicals --- config.default.yaml | 16 ++++-- ...ustrial_energy_demand_per_country_today.py | 5 ++ ...build_industrial_production_per_country.py | 19 +++++-- ...ustrial_production_per_country_tomorrow.py | 4 +- .../build_industrial_production_per_node.py | 8 +-- scripts/build_industry_sector_ratios.py | 52 +++++++++++++------ 6 files changed, 74 insertions(+), 30 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index dfc888c4..e13fdc85 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -72,7 +72,7 @@ electricity: # regulate what components with which carriers are kept from PyPSA-Eur; # some technologies are removed because they are implemented differently -# (e.g. battery or H2 storage) or have different year-dependent costs +# (e.g. battery or H2 storage) or have different year-dependent costs # in PyPSA-Eur-Sec pypsa_eur: Bus: @@ -270,10 +270,18 @@ industry: MWh_elec_per_tNH3_electrolysis: 1.17 # from https://doi.org/10.1016/j.joule.2018.04.017 Table 13 (air separation and HB) NH3_process_emissions: 24.5 # in MtCO2/a from SMR for H2 production for NH3 from UNFCCC for 2015 for EU28 petrochemical_process_emissions: 25.5 # in MtCO2/a for petrochemical and other from UNFCCC for 2015 for EU28 - HVC_primary_fraction: 1.0 #fraction of current non-ammonia basic chemicals produced via primary route + HVC_primary_fraction: 1. # fraction of today's HVC produced via primary route + HVC_production_today: 52. # MtHVC/a from DECHEMA (2017), Figure 16, page 107; includes ethylene, propylene and BTX + chlorine_production_today: 9.58 # MtCl/a from DECHEMA (2017), Table 7, page 43 + MWh_elec_per_tCl: 3.6 # DECHEMA (2017), Table 6, page 43 + MWh_H2_per_tCl: -0.9372 # DECHEMA (2017), page 43; negative since hydrogen produced in chloralkali process + methanol_production_today: 1.5 # MtMeOH/a from DECHEMA (2017), page 62 + MWh_elec_per_tMeOH: 0.167 # DECHEMA (2017), Table 14, page 65 + MWh_CH4_per_tMeOH: 10.25 # DECHEMA (2017), Table 14, page 65 hotmaps_locate_missing: false reference_year: 2015 - + # references: + # DECHEMA (2017): https://dechema.de/dechema_media/Downloads/Positionspapiere/Technology_study_Low_carbon_energy_and_feedstock_for_the_European_chemical_industry-p-20002750.pdf costs: lifetime: 25 #default lifetime @@ -335,7 +343,7 @@ solving: plotting: map: - boundaries: [-11, 30, 34, 71] + boundaries: [-11, 30, 34, 71] color_geomap: ocean: white land: whitesmoke diff --git a/scripts/build_industrial_energy_demand_per_country_today.py b/scripts/build_industrial_energy_demand_per_country_today.py index 1d906b24..af30553e 100644 --- a/scripts/build_industrial_energy_demand_per_country_today.py +++ b/scripts/build_industrial_energy_demand_per_country_today.py @@ -114,6 +114,11 @@ def add_non_eu28_industrial_energy_demand(demand): fn = snakemake.input.industrial_production_per_country production = pd.read_csv(fn, index_col=0) / 1e3 + #recombine HVC, Chlorine and Methanol to Basic chemicals (without ammonia) + chemicals = ["HVC", "Chlorine", "Methanol"] + production["Basic chemicals (without ammonia)"] = production[chemicals].sum(axis=1) + production.drop(columns=chemicals, inplace=True) + eu28_production = production.loc[eu28].sum() eu28_energy = demand.groupby(level=1).sum() eu28_averages = eu28_energy / eu28_production diff --git a/scripts/build_industrial_production_per_country.py b/scripts/build_industrial_production_per_country.py index 1754752a..c7973751 100644 --- a/scripts/build_industrial_production_per_country.py +++ b/scripts/build_industrial_production_per_country.py @@ -179,8 +179,8 @@ def industry_production(countries): return demand -def add_ammonia_demand_separately(demand): - """Include ammonia demand separately and remove ammonia from basic chemicals.""" +def separate_basic_chemicals(demand): + """Remove ammonia, chlorine and methanol from basic chemicals to get HVC.""" ammonia = pd.read_csv(snakemake.input.ammonia_production, index_col=0) @@ -198,9 +198,16 @@ def add_ammonia_demand_separately(demand): # EE, HR and LT got negative demand through subtraction - poor data demand['Basic chemicals'].clip(lower=0., inplace=True) - to_rename = {"Basic chemicals": "Basic chemicals (without ammonia)"} - demand.rename(columns=to_rename, inplace=True) + demand.insert(2, "HVC", 0.) + demand.insert(3, "Chlorine", 0.) + demand.insert(4, "Methanol", 0.) + # assume HVC, methanol, chlorine production proportional to non-ammonia basic chemicals + demand["HVC"] = config["HVC_production_today"]*1e3/demand["Basic chemicals"].sum()*demand["Basic chemicals"] + demand["Chlorine"] = config["chlorine_production_today"]*1e3/demand["Basic chemicals"].sum()*demand["Basic chemicals"] + demand["Methanol"] = config["methanol_production_today"]*1e3/demand["Basic chemicals"].sum()*demand["Basic chemicals"] + + demand.drop(columns=["Basic chemicals"], inplace=True) if __name__ == '__main__': if 'snakemake' not in globals(): @@ -211,12 +218,14 @@ if __name__ == '__main__': year = snakemake.config['industry']['reference_year'] + config = snakemake.config["industry"] + jrc_dir = snakemake.input.jrc eurostat_dir = snakemake.input.eurostat demand = industry_production(countries) - add_ammonia_demand_separately(demand) + separate_basic_chemicals(demand) fn = snakemake.output.industrial_production_per_country demand.to_csv(fn, float_format='%.2f') diff --git a/scripts/build_industrial_production_per_country_tomorrow.py b/scripts/build_industrial_production_per_country_tomorrow.py index ba69e0a6..3372a88a 100644 --- a/scripts/build_industrial_production_per_country_tomorrow.py +++ b/scripts/build_industrial_production_per_country_tomorrow.py @@ -39,11 +39,11 @@ if __name__ == '__main__': al_primary_fraction = get(config["Al_primary_fraction"], investment_year) fraction_persistent_primary = al_primary_fraction * total_aluminium.sum() / production[key_pri].sum() - + production[key_pri] = fraction_persistent_primary * production[key_pri] production[key_sec] = total_aluminium - production[key_pri] - production["Basic chemicals (without ammonia)"] *= config['HVC_primary_fraction'] + production["HVC"] *= config['HVC_primary_fraction'] fn = snakemake.output.industrial_production_per_country_tomorrow production.to_csv(fn, float_format='%.2f') diff --git a/scripts/build_industrial_production_per_node.py b/scripts/build_industrial_production_per_node.py index b5361e6b..88f36eec 100644 --- a/scripts/build_industrial_production_per_node.py +++ b/scripts/build_industrial_production_per_node.py @@ -9,7 +9,9 @@ sector_mapping = { 'Integrated steelworks': 'Iron and steel', 'DRI + Electric arc': 'Iron and steel', 'Ammonia': 'Chemical industry', - 'Basic chemicals (without ammonia)': 'Chemical industry', + 'HVC': 'Chemical industry', + 'Methanol': 'Chemical industry', + 'Chlorine': 'Chemical industry', 'Other chemicals': 'Chemical industry', 'Pharmaceutical products etc.': 'Chemical industry', 'Cement': 'Cement', @@ -40,12 +42,12 @@ def build_nodal_industrial_production(): countries = keys.country.unique() sectors = industrial_production.columns - + for country, sector in product(countries, sectors): buses = keys.index[keys.country == country] mapping = sector_mapping.get(sector, "population") - + key = keys.loc[buses, mapping] nodal_production.loc[buses, sector] = industrial_production.at[country, sector] * key diff --git a/scripts/build_industry_sector_ratios.py b/scripts/build_industry_sector_ratios.py index adfb1d3c..738b500e 100644 --- a/scripts/build_industry_sector_ratios.py +++ b/scripts/build_industry_sector_ratios.py @@ -279,7 +279,7 @@ def chemicals_industry(): df = pd.DataFrame(index=index) - # Basid chemicals + # Basic chemicals sector = "Basic chemicals" @@ -374,52 +374,72 @@ def chemicals_industry(): # putting in ammonia demand for H2 and electricity separately s_emi = idees["emi"][3:57] - s_out = idees["out"][8:9] assert s_emi.index[0] == sector - assert sector in str(s_out.index) - ammonia = pd.read_csv(snakemake.input.ammonia_production, index_col=0) - - # ktNH3/a - ammonia_total = ammonia.loc[ammonia.index.intersection(eu28), str(year)].sum() - - s_out -= ammonia_total + # convert from MtHVC/a to ktHVC/a + s_out = config["HVC_production_today"]*1e3 # tCO2/t material df.loc["process emission", sector] += ( s_emi["Process emissions"] - config["petrochemical_process_emissions"] * 1e3 - config["NH3_process_emissions"] * 1e3 - ) / s_out.values + ) / s_out # emissions originating from feedstock, could be non-fossil origin # tCO2/t material df.loc["process emission from feedstock", sector] += ( config["petrochemical_process_emissions"] * 1e3 - ) / s_out.values + ) / s_out # convert from ktoe/a to GWh/a sources = ["elec", "biomass", "methane", "hydrogen", "heat", "naphtha"] df.loc[sources, sector] *= toe_to_MWh + # subtract ammonia energy demand + ammonia = pd.read_csv(snakemake.input.ammonia_production, index_col=0) + # ktNH3/a + ammonia_total = ammonia.loc[ammonia.index.intersection(eu28), str(year)].sum() df.loc["methane", sector] -= ammonia_total * config["MWh_CH4_per_tNH3_SMR"] df.loc["elec", sector] -= ammonia_total * config["MWh_elec_per_tNH3_SMR"] - # MWh/t material - df.loc[sources, sector] = df.loc[sources, sector] / s_out.values + # subtract chlorine demand + chlorine_total = config["chlorine_production_today"] + df.loc["hydrogen", sector] -= chlorine_total * config["MWh_H2_per_tCl"] + df.loc["elec", sector] -= chlorine_total * config["MWh_elec_per_tCl"] - to_rename = {sector: f"{sector} (without ammonia)"} + # subtract methanol demand + methanol_total = config["methanol_production_today"] + df.loc["methane", sector] -= methanol_total * config["MWh_CH4_per_tMeOH"] + df.loc["elec", sector] -= methanol_total * config["MWh_elec_per_tMeOH"] + + # MWh/t material + df.loc[sources, sector] = df.loc[sources, sector] / s_out + + to_rename = {sector: "HVC"} df.rename(columns=to_rename, inplace=True) # Ammonia sector = "Ammonia" - df[sector] = 0.0 - df.loc["hydrogen", sector] = config["MWh_H2_per_tNH3_electrolysis"] df.loc["elec", sector] = config["MWh_elec_per_tNH3_electrolysis"] + # Chlorine + + sector = "Chlorine" + df[sector] = 0.0 + df.loc["hydrogen", sector] = config["MWh_H2_per_tCl"] + df.loc["elec", sector] = config["MWh_elec_per_tCl"] + + # Methanol + + sector = "Methanol" + df[sector] = 0.0 + df.loc["methane", sector] = config["MWh_CH4_per_tMeOH"] + df.loc["elec", sector] = config["MWh_elec_per_tMeOH"] + # Other chemicals sector = "Other chemicals" From 93d4eae1ea74d696088fc99a2d6494625e3b0332 Mon Sep 17 00:00:00 2001 From: Tom Brown Date: Fri, 24 Sep 2021 13:19:48 +0200 Subject: [PATCH 086/132] industry: for HVC, add mechanical and chemical recycling --- config.default.yaml | 5 +++++ ...ild_industrial_production_per_country_tomorrow.py | 3 +++ scripts/build_industrial_production_per_node.py | 2 ++ scripts/build_industry_sector_ratios.py | 12 ++++++++++++ 4 files changed, 22 insertions(+) diff --git a/config.default.yaml b/config.default.yaml index e13fdc85..0ed52c0d 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -271,7 +271,11 @@ industry: NH3_process_emissions: 24.5 # in MtCO2/a from SMR for H2 production for NH3 from UNFCCC for 2015 for EU28 petrochemical_process_emissions: 25.5 # in MtCO2/a for petrochemical and other from UNFCCC for 2015 for EU28 HVC_primary_fraction: 1. # fraction of today's HVC produced via primary route + HVC_mechanical_recycling_fraction: 0. # fraction of today's HVC produced via mechanical recycling + HVC_chemical_recycling_fraction: 0. # fraction of today's HVC produced via chemical recycling HVC_production_today: 52. # MtHVC/a from DECHEMA (2017), Figure 16, page 107; includes ethylene, propylene and BTX + MWh_elec_per_tHVC_mechanical_recycling: 3. # estimate + MWh_elec_per_tHVC_chemical_recycling: 6.9 # Material Economics (2019), page 125; based on pyrolysis and steam cracking chlorine_production_today: 9.58 # MtCl/a from DECHEMA (2017), Table 7, page 43 MWh_elec_per_tCl: 3.6 # DECHEMA (2017), Table 6, page 43 MWh_H2_per_tCl: -0.9372 # DECHEMA (2017), page 43; negative since hydrogen produced in chloralkali process @@ -282,6 +286,7 @@ industry: reference_year: 2015 # references: # DECHEMA (2017): https://dechema.de/dechema_media/Downloads/Positionspapiere/Technology_study_Low_carbon_energy_and_feedstock_for_the_European_chemical_industry-p-20002750.pdf + # Material Economics (2019): https://materialeconomics.com/latest-updates/industrial-transformation-2050 costs: lifetime: 25 #default lifetime diff --git a/scripts/build_industrial_production_per_country_tomorrow.py b/scripts/build_industrial_production_per_country_tomorrow.py index 3372a88a..17367bbc 100644 --- a/scripts/build_industrial_production_per_country_tomorrow.py +++ b/scripts/build_industrial_production_per_country_tomorrow.py @@ -43,6 +43,9 @@ if __name__ == '__main__': production[key_pri] = fraction_persistent_primary * production[key_pri] production[key_sec] = total_aluminium - production[key_pri] + production.insert(4, "HVC (mechanical recycling)", config["HVC_mechanical_recycling_fraction"]*production["HVC"]) + production.insert(5, "HVC (chemical recycling)", config["HVC_chemical_recycling_fraction"]*production["HVC"]) + production["HVC"] *= config['HVC_primary_fraction'] fn = snakemake.output.industrial_production_per_country_tomorrow diff --git a/scripts/build_industrial_production_per_node.py b/scripts/build_industrial_production_per_node.py index 88f36eec..4ceffee9 100644 --- a/scripts/build_industrial_production_per_node.py +++ b/scripts/build_industrial_production_per_node.py @@ -10,6 +10,8 @@ sector_mapping = { 'DRI + Electric arc': 'Iron and steel', 'Ammonia': 'Chemical industry', 'HVC': 'Chemical industry', + 'HVC (mechanical recycling)': 'Chemical industry', + 'HVC (chemical recycling)': 'Chemical industry', 'Methanol': 'Chemical industry', 'Chlorine': 'Chemical industry', 'Other chemicals': 'Chemical industry', diff --git a/scripts/build_industry_sector_ratios.py b/scripts/build_industry_sector_ratios.py index 738b500e..a6c53720 100644 --- a/scripts/build_industry_sector_ratios.py +++ b/scripts/build_industry_sector_ratios.py @@ -419,6 +419,18 @@ def chemicals_industry(): to_rename = {sector: "HVC"} df.rename(columns=to_rename, inplace=True) + # HVC mechanical recycling + + sector = "HVC (mechanical recycling)" + df[sector] = 0.0 + df.loc["elec", sector] = config["MWh_elec_per_tHVC_mechanical_recycling"] + + # HVC chemical recycling + + sector = "HVC (chemical recycling)" + df[sector] = 0.0 + df.loc["elec", sector] = config["MWh_elec_per_tHVC_chemical_recycling"] + # Ammonia sector = "Ammonia" From b391aa6475c9be664efe47b5c60828698af4f782 Mon Sep 17 00:00:00 2001 From: lisazeyen <35347358+lisazeyen@users.noreply.github.com> Date: Fri, 24 Sep 2021 14:59:53 +0200 Subject: [PATCH 087/132] Update build_biomass_transport_costs.py change snakemake output file format --- scripts/build_biomass_transport_costs.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/build_biomass_transport_costs.py b/scripts/build_biomass_transport_costs.py index fc29853b..aaec215b 100644 --- a/scripts/build_biomass_transport_costs.py +++ b/scripts/build_biomass_transport_costs.py @@ -82,7 +82,7 @@ def build_biomass_transport_costs(): # add missing Norway with data from Sweden transport_costs["NO"] = transport_costs["SE"] - transport_costs.to_csv(snakemake.output.transport_costs) + transport_costs.to_csv(snakemake.output[0]) if __name__ == "__main__": From 960d857d0bdf5d290878f7530e60902ed2909ca5 Mon Sep 17 00:00:00 2001 From: lisazeyen <35347358+lisazeyen@users.noreply.github.com> Date: Fri, 24 Sep 2021 15:29:04 +0200 Subject: [PATCH 088/132] Update config.default.yaml add color for CO2 pipelines --- config.default.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/config.default.yaml b/config.default.yaml index 66a9f299..14a6cc0a 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -467,6 +467,7 @@ plotting: hot water storage: '#BBBBBB' hot water charging: '#BBBBBB' hot water discharging: '#999999' + CO2 pipeline: '#999999' CHP: r CHP heat: r CHP electric: r From 7ed20aba7a06d02f5a3895b24857b6f3841f715d Mon Sep 17 00:00:00 2001 From: lisazeyen <35347358+lisazeyen@users.noreply.github.com> Date: Fri, 24 Sep 2021 15:30:43 +0200 Subject: [PATCH 089/132] Update prepare_sector_network.py add logger info if CO2 network is added --- scripts/prepare_sector_network.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 33f9c4b6..b3fb0426 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -392,7 +392,8 @@ def add_co2_tracking(n, options): def add_co2_network(n, costs): - + + logger.info("Adding CO2 network.") co2_links = create_network_topology(n, "CO2 pipeline ") cost_onshore = (1 - co2_links.underwater_fraction) * costs.at['CO2 pipeline', 'fixed'] * co2_links.length From 28264aa1140e5b6d834d2866a6217d42cd885784 Mon Sep 17 00:00:00 2001 From: lisazeyen <35347358+lisazeyen@users.noreply.github.com> Date: Mon, 27 Sep 2021 11:16:12 +0200 Subject: [PATCH 090/132] Small fixes (#167) * update mocksnakemake for testing * remove trailing whitespace in n.loads index * add missing color for H2 liquification * adjust to default lifetime 0 instead of NaN --- config.default.yaml | 5 +-- scripts/add_existing_baseyear.py | 19 +++++----- scripts/plot_network.py | 11 +++--- scripts/prepare_sector_network.py | 58 +++++++++++++++++-------------- 4 files changed, 50 insertions(+), 43 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index dfc888c4..ec7dc399 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -72,7 +72,7 @@ electricity: # regulate what components with which carriers are kept from PyPSA-Eur; # some technologies are removed because they are implemented differently -# (e.g. battery or H2 storage) or have different year-dependent costs +# (e.g. battery or H2 storage) or have different year-dependent costs # in PyPSA-Eur-Sec pypsa_eur: Bus: @@ -335,7 +335,7 @@ solving: plotting: map: - boundaries: [-11, 30, 34, 71] + boundaries: [-11, 30, 34, 71] color_geomap: ocean: white land: whitesmoke @@ -420,6 +420,7 @@ plotting: lines: k transmission lines: k H2: m + H2 liquefaction: m hydrogen storage: m battery: slategray battery storage: slategray diff --git a/scripts/add_existing_baseyear.py b/scripts/add_existing_baseyear.py index 47c31c0e..2faa50f5 100644 --- a/scripts/add_existing_baseyear.py +++ b/scripts/add_existing_baseyear.py @@ -28,7 +28,7 @@ def add_build_year_to_new_assets(n, baseyear): # Give assets with lifetimes and no build year the build year baseyear for c in n.iterate_components(["Link", "Generator", "Store"]): - assets = c.df.index[~c.df.lifetime.isna() & c.df.build_year.isna()] + assets = c.df.index[~c.df.lifetime.isna() & c.df.build_year==0] c.df.loc[assets, "build_year"] = baseyear # add -baseyear to name @@ -60,7 +60,7 @@ def add_existing_renewables(df_agg): } for tech in ['solar', 'onwind', 'offwind']: - + carrier = carriers[tech] df = pd.read_csv(snakemake.input[f"existing_{tech}"], index_col=0).fillna(0.) @@ -112,9 +112,9 @@ def add_power_capacities_installed_before_baseyear(n, grouping_years, costs, bas Parameters ---------- n : pypsa.Network - grouping_years : + grouping_years : intervals to group existing capacities - costs : + costs : to read lifetime to estimate YearDecomissioning baseyear : int """ @@ -209,7 +209,7 @@ def add_power_capacities_installed_before_baseyear(n, grouping_years, costs, bas build_year=grouping_year, lifetime=costs.at[generator, 'lifetime'] ) - + else: n.madd("Link", @@ -268,7 +268,7 @@ def add_heating_capacities_installed_before_baseyear(n, baseyear, grouping_years df.fillna(0., inplace=True) # convert GW to MW - df *= 1e3 + df *= 1e3 cc = pd.read_csv(snakemake.input.country_codes, index_col=0) @@ -327,7 +327,7 @@ def add_heating_capacities_installed_before_baseyear(n, baseyear, grouping_years efficiency = cop[heat_pump_type][nodes[name]] else: efficiency = costs.at[costs_name, 'efficiency'] - + for i, grouping_year in enumerate(grouping_years): if int(grouping_year) + default_lifetime <= int(baseyear): @@ -378,7 +378,7 @@ def add_heating_capacities_installed_before_baseyear(n, baseyear, grouping_years build_year=int(grouping_year), lifetime=costs.at[name_type + ' gas boiler', 'lifetime'] ) - + n.madd("Link", nodes[name], suffix=f" {name} oil boiler-{grouping_year}", @@ -410,7 +410,8 @@ if __name__ == "__main__": simpl='', clusters=45, lv=1.0, - sector_opts='Co2L0-168H-T-H-B-I-solar3-dist1', + opts='', + sector_opts='Co2L0-168H-T-H-B-I-solar+p3-dist1', planning_horizons=2020, ) diff --git a/scripts/plot_network.py b/scripts/plot_network.py index c97956a0..5182123b 100644 --- a/scripts/plot_network.py +++ b/scripts/plot_network.py @@ -289,7 +289,7 @@ def plot_h2_map(network): title='Electrolyzer capacity', handler_map=make_handler_map_to_scale_circles_as_in(ax) ) - + ax.add_artist(l2) handles = [] @@ -523,10 +523,11 @@ if __name__ == "__main__": snakemake = mock_snakemake( 'plot_network', simpl='', - clusters=48, - lv=1.0, - sector_opts='Co2L0-168H-T-H-B-I-solar3-dist1', - planning_horizons=2050, + clusters=45, + lv=1.5, + opts='', + sector_opts='Co2L0-168H-T-H-B-I-solar+p3-dist1', + planning_horizons=2030, ) overrides = override_component_attrs(snakemake.input.overrides) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index be6bf4e7..ef6845fc 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -75,7 +75,7 @@ def co2_emissions_year(countries, opts, year): co2_emissions = co2_totals.loc[countries, sectors].sum().sum() # convert MtCO2 to GtCO2 - co2_emissions *= 0.001 + co2_emissions *= 0.001 return co2_emissions @@ -102,14 +102,14 @@ def build_carbon_budget(o, fn): #emissions at the beginning of the path (last year available 2018) e_0 = co2_emissions_year(countries, opts, year=2018) - + planning_horizons = snakemake.config['scenario']['planning_horizons'] t_0 = planning_horizons[0] if "be" in o: # final year in the path - t_f = t_0 + (2 * carbon_budget / e_0).round(0) + t_f = t_0 + (2 * carbon_budget / e_0).round(0) def beta_decay(t): cdf_term = (t - t_0) / (t_f - t_0) @@ -270,6 +270,9 @@ def patch_electricity_network(n): update_wind_solar_costs(n, costs) n.loads["carrier"] = "electricity" n.buses["location"] = n.buses.index + # remove trailing white space of load index until new PyPSA version after v0.18. + n.loads.rename(lambda x: x.strip(), inplace=True) + n.loads_t.p_set.rename(lambda x: x.strip(), axis=1, inplace=True) def add_co2_tracking(n, options): @@ -768,7 +771,7 @@ def insert_electricity_distribution_grid(n, costs): capital_cost=costs.at['solar-rooftop', 'fixed'], efficiency=n.generators.loc[solar, 'efficiency'], p_max_pu=n.generators_t.p_max_pu[solar], - lifetime=costs.at['solar-rooftop', 'lifetime'] + lifetime=costs.at['solar-rooftop', 'lifetime'] ) n.add("Carrier", "home battery") @@ -816,7 +819,7 @@ def insert_gas_distribution_costs(n, costs): # TODO options? f_costs = options['gas_distribution_grid_cost_factor'] - + print("Inserting gas distribution grid with investment cost factor of", f_costs) capital_cost = costs.loc['electricity distribution grid']["fixed"] * f_costs @@ -825,7 +828,7 @@ def insert_gas_distribution_costs(n, costs): gas_b = n.links.index[n.links.carrier.str.contains("gas boiler") & (~n.links.carrier.str.contains("urban central"))] n.links.loc[gas_b, "capital_cost"] += capital_cost - + # micro CHPs mchp = n.links.index[n.links.carrier.str.contains("micro gas")] n.links.loc[mchp, "capital_cost"] += capital_cost @@ -1073,7 +1076,7 @@ def add_land_transport(n, costs): suffix=" EV battery", carrier="Li ion" ) - + p_set = electric_share * (transport[nodes] + cycling_shift(transport[nodes], 1) + cycling_shift(transport[nodes], 2)) / 3 n.madd("Load", @@ -1084,8 +1087,8 @@ def add_land_transport(n, costs): p_set=p_set ) - - p_nom = nodal_transport_data["number cars"] * options.get("bev_charge_rate", 0.011) * electric_share + + p_nom = nodal_transport_data["number cars"] * options.get("bev_charge_rate", 0.011) * electric_share n.madd("Link", nodes, @@ -1117,7 +1120,7 @@ def add_land_transport(n, costs): if electric_share > 0 and options["bev_dsm"]: - e_nom = nodal_transport_data["number cars"] * options.get("bev_energy", 0.05) * options["bev_availability"] * electric_share + e_nom = nodal_transport_data["number cars"] * options.get("bev_energy", 0.05) * options["bev_availability"] * electric_share n.madd("Store", nodes, @@ -1197,7 +1200,7 @@ def add_heat(n, costs): "services urban decentral", "urban central" ] - + for name in heat_systems: name_type = "central" if name == "urban central" else "decentral" @@ -1279,16 +1282,16 @@ def add_heat(n, costs): p_nom_extendable=True ) - + if isinstance(options["tes_tau"], dict): tes_time_constant_days = options["tes_tau"][name_type] else: logger.warning("Deprecated: a future version will require you to specify 'tes_tau' ", "for 'decentral' and 'central' separately.") tes_time_constant_days = options["tes_tau"] if name_type == "decentral" else 180. - + # conversion from EUR/m^3 to EUR/MWh for 40 K diff and 1.17 kWh/m^3/K - capital_cost = costs.at[name_type + ' water tank storage', 'fixed'] / 0.00117 / 40 + capital_cost = costs.at[name_type + ' water tank storage', 'fixed'] / 0.00117 / 40 n.madd("Store", nodes[name] + f" {name} water tanks", @@ -1501,9 +1504,9 @@ def create_nodes_for_heat_sector(): # rural are areas with low heating density and individual heating # urban are areas with high heating density # urban can be split into district heating (central) and individual heating (decentral) - + sectors = ["residential", "services"] - + nodes = {} for sector in sectors: nodes[sector + " rural"] = pop_layout.index @@ -1514,10 +1517,10 @@ def create_nodes_for_heat_sector(): nodes[sector + " urban decentral"] = pop_layout.index[pop_layout.ct.isin(urban_decentral_ct)] else: nodes[sector + " urban decentral"] = pop_layout.index - + # for central nodes, residential and services are aggregated nodes["urban central"] = pop_layout.index.symmetric_difference(nodes["residential urban decentral"]) - + return nodes @@ -1752,9 +1755,9 @@ def add_industry(n, costs): if shipping_hydrogen_share < 1: shipping_oil_share = 1 - shipping_hydrogen_share - + p_set = shipping_oil_share * nodal_energy_totals.loc[nodes, all_navigation].sum(axis=1) * 1e6 / 8760. - + n.madd("Load", nodes, suffix=" shipping oil", @@ -1762,7 +1765,7 @@ def add_industry(n, costs): carrier="shipping oil", p_set=p_set ) - + co2 = shipping_oil_share * nodal_energy_totals.loc[nodes, all_navigation].sum().sum() * 1e6 / 8760 * costs.at["oil", "CO2 intensity"] n.add("Load", @@ -1781,7 +1784,7 @@ def add_industry(n, costs): ) if "EU oil Store" not in n.stores.index: - + #could correct to e.g. 0.001 EUR/kWh * annuity and O&M n.add("Store", "EU oil Store", @@ -1948,7 +1951,7 @@ def add_waste_heat(n): def decentral(n): - """Removes the electricity transmission system.""" + """Removes the electricity transmission system.""" n.lines.drop(n.lines.index, inplace=True) n.links.drop(n.links.index[n.links.carrier.isin(["DC", "B2B"])], inplace=True) @@ -1981,7 +1984,7 @@ def maybe_adjust_costs_and_potentials(n, opts): if attr == 'p_nom_max': comps = {"Generator", "Link", "StorageUnit"} elif attr == 'e_nom_max': - comps = {"Store"} + comps = {"Store"} else: comps = {"Generator", "Link", "StorageUnit", "Store"} for c in n.iterate_components(comps): @@ -2007,10 +2010,11 @@ if __name__ == "__main__": snakemake = mock_snakemake( 'prepare_sector_network', simpl='', - clusters=48, + clusters=45, lv=1.0, + opts='', sector_opts='Co2L0-168H-T-H-B-I-solar3-dist1', - planning_horizons=2020, + planning_horizons=2030, ) logging.basicConfig(level=snakemake.config['logging_level']) @@ -2036,7 +2040,7 @@ if __name__ == "__main__": patch_electricity_network(n) if snakemake.config["foresight"] == 'myopic': - + add_lifetime_wind_solar(n, costs) conventional = snakemake.config['existing_capacities']['conventional_carriers'] From 561d86c223a39f80881bb67c897d7f4a54a6d27b Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 27 Sep 2021 12:06:15 +0200 Subject: [PATCH 091/132] add mechanical recycling energy demand from literature Assuming energy demand for recycling of HPTE, PET, PS, PP as LDPE is more difficult to recycle. https://doi.org/10.1016/j.resconrec.2020.105010 https://www.generalkinematics.com/blog/different-types-plastics-recycled/ --- config.default.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/config.default.yaml b/config.default.yaml index 0ed52c0d..b0c8e60c 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -274,7 +274,7 @@ industry: HVC_mechanical_recycling_fraction: 0. # fraction of today's HVC produced via mechanical recycling HVC_chemical_recycling_fraction: 0. # fraction of today's HVC produced via chemical recycling HVC_production_today: 52. # MtHVC/a from DECHEMA (2017), Figure 16, page 107; includes ethylene, propylene and BTX - MWh_elec_per_tHVC_mechanical_recycling: 3. # estimate + MWh_elec_per_tHVC_mechanical_recycling: 0.547 # from SI of https://doi.org/10.1016/j.resconrec.2020.105010, Table S5, for HDPE, PP, PS, PET. LDPE would be 0.756. MWh_elec_per_tHVC_chemical_recycling: 6.9 # Material Economics (2019), page 125; based on pyrolysis and steam cracking chlorine_production_today: 9.58 # MtCl/a from DECHEMA (2017), Table 7, page 43 MWh_elec_per_tCl: 3.6 # DECHEMA (2017), Table 6, page 43 From 9f4e1f2176e87e208bf957d038df1aa7597df4cd Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Tue, 28 Sep 2021 17:08:03 +0200 Subject: [PATCH 092/132] make HVC recycling ready for pathway, minor edits --- config.default.yaml | 2 +- doc/release_notes.rst | 1 + ..._industrial_energy_demand_per_country_today.py | 1 + .../build_industrial_production_per_country.py | 15 ++++++--------- ..._industrial_production_per_country_tomorrow.py | 6 +++--- scripts/build_industry_sector_ratios.py | 8 +++----- 6 files changed, 15 insertions(+), 18 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index b0c8e60c..7e8a4664 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -275,7 +275,7 @@ industry: HVC_chemical_recycling_fraction: 0. # fraction of today's HVC produced via chemical recycling HVC_production_today: 52. # MtHVC/a from DECHEMA (2017), Figure 16, page 107; includes ethylene, propylene and BTX MWh_elec_per_tHVC_mechanical_recycling: 0.547 # from SI of https://doi.org/10.1016/j.resconrec.2020.105010, Table S5, for HDPE, PP, PS, PET. LDPE would be 0.756. - MWh_elec_per_tHVC_chemical_recycling: 6.9 # Material Economics (2019), page 125; based on pyrolysis and steam cracking + MWh_elec_per_tHVC_chemical_recycling: 6.9 # Material Economics (2019), page 125; based on pyrolysis and electric steam cracking chlorine_production_today: 9.58 # MtCl/a from DECHEMA (2017), Table 7, page 43 MWh_elec_per_tCl: 3.6 # DECHEMA (2017), Table 6, page 43 MWh_H2_per_tCl: -0.9372 # DECHEMA (2017), page 43; negative since hydrogen produced in chloralkali process diff --git a/doc/release_notes.rst b/doc/release_notes.rst index 4de40f06..c90e98f5 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -69,6 +69,7 @@ Future release * The transformation of the Steel and Aluminium production can be now defined for different years in the ``config.yaml`` file. * Include the option to alter the maximum energy capacity of a store via the ``carrier+factor`` in the ``{sector_opts}`` wildcard. This can be useful for sensitivity analyses. Example: ``co2 stored+e2`` multiplies the ``e_nom_max`` by factor 2. In this example, ``e_nom_max`` represents the CO2 sequestration potential in Europe. * Compatibility with ``xarray`` version 0.19. +* Separate basic chemicals into HVC, chlorine, methanol and ammonia [`#166 `_]. PyPSA-Eur-Sec 0.5.0 (21st May 2021) =================================== diff --git a/scripts/build_industrial_energy_demand_per_country_today.py b/scripts/build_industrial_energy_demand_per_country_today.py index af30553e..0adf84e7 100644 --- a/scripts/build_industrial_energy_demand_per_country_today.py +++ b/scripts/build_industrial_energy_demand_per_country_today.py @@ -103,6 +103,7 @@ def add_ammonia_energy_demand(demand): demand['Basic chemicals (without ammonia)'] = demand["Basic chemicals"] - demand["Ammonia"] demand['Basic chemicals (without ammonia)'].clip(lower=0, inplace=True) + demand.drop(columns='Basic chemicals', inplace=True) return demand diff --git a/scripts/build_industrial_production_per_country.py b/scripts/build_industrial_production_per_country.py index c7973751..eadfb224 100644 --- a/scripts/build_industrial_production_per_country.py +++ b/scripts/build_industrial_production_per_country.py @@ -180,7 +180,7 @@ def industry_production(countries): def separate_basic_chemicals(demand): - """Remove ammonia, chlorine and methanol from basic chemicals to get HVC.""" + """Separate basic chemicals into ammonia, chlorine, methanol and HVC.""" ammonia = pd.read_csv(snakemake.input.ammonia_production, index_col=0) @@ -189,7 +189,7 @@ def separate_basic_chemicals(demand): print("Following countries have no ammonia demand:", missing) - demand.insert(2, "Ammonia", 0.) + demand["Ammonia"] = 0. demand.loc[there, "Ammonia"] = ammonia.loc[there, str(year)] @@ -198,14 +198,11 @@ def separate_basic_chemicals(demand): # EE, HR and LT got negative demand through subtraction - poor data demand['Basic chemicals'].clip(lower=0., inplace=True) - demand.insert(2, "HVC", 0.) - demand.insert(3, "Chlorine", 0.) - demand.insert(4, "Methanol", 0.) - # assume HVC, methanol, chlorine production proportional to non-ammonia basic chemicals - demand["HVC"] = config["HVC_production_today"]*1e3/demand["Basic chemicals"].sum()*demand["Basic chemicals"] - demand["Chlorine"] = config["chlorine_production_today"]*1e3/demand["Basic chemicals"].sum()*demand["Basic chemicals"] - demand["Methanol"] = config["methanol_production_today"]*1e3/demand["Basic chemicals"].sum()*demand["Basic chemicals"] + distribution_key = demand["Basic chemicals"] / demand["Basic chemicals"].sum() + demand["HVC"] = config["HVC_production_today"] * 1e3 * distribution_key + demand["Chlorine"] = config["chlorine_production_today"] * 1e3 * distribution_key + demand["Methanol"] = config["methanol_production_today"] * 1e3 * distribution_key demand.drop(columns=["Basic chemicals"], inplace=True) diff --git a/scripts/build_industrial_production_per_country_tomorrow.py b/scripts/build_industrial_production_per_country_tomorrow.py index 17367bbc..ccf31839 100644 --- a/scripts/build_industrial_production_per_country_tomorrow.py +++ b/scripts/build_industrial_production_per_country_tomorrow.py @@ -43,10 +43,10 @@ if __name__ == '__main__': production[key_pri] = fraction_persistent_primary * production[key_pri] production[key_sec] = total_aluminium - production[key_pri] - production.insert(4, "HVC (mechanical recycling)", config["HVC_mechanical_recycling_fraction"]*production["HVC"]) - production.insert(5, "HVC (chemical recycling)", config["HVC_chemical_recycling_fraction"]*production["HVC"]) + production["HVC (mechanical recycling)"] = get(config["HVC_mechanical_recycling_fraction"], investment_year) * production["HVC"] + production["HVC (chemical recycling)"] = get(config["HVC_chemical_recycling_fraction"], investment_year) * production["HVC"] - production["HVC"] *= config['HVC_primary_fraction'] + production["HVC"] *= get(config['HVC_primary_fraction'], investment_year) fn = snakemake.output.industrial_production_per_country_tomorrow production.to_csv(fn, float_format='%.2f') diff --git a/scripts/build_industry_sector_ratios.py b/scripts/build_industry_sector_ratios.py index a6c53720..49c82138 100644 --- a/scripts/build_industry_sector_ratios.py +++ b/scripts/build_industry_sector_ratios.py @@ -377,7 +377,7 @@ def chemicals_industry(): assert s_emi.index[0] == sector # convert from MtHVC/a to ktHVC/a - s_out = config["HVC_production_today"]*1e3 + s_out = config["HVC_production_today"] * 1e3 # tCO2/t material df.loc["process emission", sector] += ( @@ -396,9 +396,8 @@ def chemicals_industry(): sources = ["elec", "biomass", "methane", "hydrogen", "heat", "naphtha"] df.loc[sources, sector] *= toe_to_MWh - # subtract ammonia energy demand + # subtract ammonia energy demand (in ktNH3/a) ammonia = pd.read_csv(snakemake.input.ammonia_production, index_col=0) - # ktNH3/a ammonia_total = ammonia.loc[ammonia.index.intersection(eu28), str(year)].sum() df.loc["methane", sector] -= ammonia_total * config["MWh_CH4_per_tNH3_SMR"] df.loc["elec", sector] -= ammonia_total * config["MWh_elec_per_tNH3_SMR"] @@ -416,8 +415,7 @@ def chemicals_industry(): # MWh/t material df.loc[sources, sector] = df.loc[sources, sector] / s_out - to_rename = {sector: "HVC"} - df.rename(columns=to_rename, inplace=True) + df.rename(columns={sector: "HVC"}, inplace=True) # HVC mechanical recycling From 488b93a079a9fe428707e67fd12f0edb34acf76b Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Tue, 28 Sep 2021 17:24:00 +0200 Subject: [PATCH 093/132] extend release notes on plastics recycling --- doc/release_notes.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/release_notes.rst b/doc/release_notes.rst index c90e98f5..da1f5c1d 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -70,6 +70,7 @@ Future release * Include the option to alter the maximum energy capacity of a store via the ``carrier+factor`` in the ``{sector_opts}`` wildcard. This can be useful for sensitivity analyses. Example: ``co2 stored+e2`` multiplies the ``e_nom_max`` by factor 2. In this example, ``e_nom_max`` represents the CO2 sequestration potential in Europe. * Compatibility with ``xarray`` version 0.19. * Separate basic chemicals into HVC, chlorine, methanol and ammonia [`#166 `_]. +* Add option to specify reuse, primary production, and mechanical and chemical recycling fraction of platics [`#166 `_]. PyPSA-Eur-Sec 0.5.0 (21st May 2021) =================================== From 53eab1ead24aac20fe0e23653b2a54fd089dd0fb Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Tue, 28 Sep 2021 17:25:04 +0200 Subject: [PATCH 094/132] slice biomass potentials with the pop_layout index instead of the country if biomass transport = True --- scripts/prepare_sector_network.py | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 0b8518d4..81a60870 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1688,8 +1688,7 @@ def add_biomass(n, costs): if options["biomass_transport"]: # potential per node distributed within country by population - biomass_potentials_spatial = (biomass_potentials.loc[pop_layout.ct] - .set_index(pop_layout.index) + biomass_potentials_spatial = (biomass_potentials.loc[pop_layout.index] .mul(pop_layout.fraction, axis="index") .rename(index=lambda x: x + " solid biomass")) else: @@ -2206,7 +2205,7 @@ if __name__ == "__main__": lv=1.0, opts='', sector_opts='Co2L0-168H-T-H-B-I-solar3-dist1', - planning_horizons=2030, + planning_horizons="2030", ) logging.basicConfig(level=snakemake.config['logging_level']) From 5c247425263054d3bda83277855395e279e7b59a Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Tue, 28 Sep 2021 17:34:47 +0200 Subject: [PATCH 095/132] temporarily disable h2 liquefaction in shipping by default --- config.default.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/config.default.yaml b/config.default.yaml index d928fb86..3c5238c5 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -175,7 +175,7 @@ sector: transport_fuel_cell_efficiency: 0.5 transport_internal_combustion_efficiency: 0.3 shipping_average_efficiency: 0.4 #For conversion of fuel oil to propulsion in 2011 - shipping_hydrogen_liquefaction: true # whether to consider liquefaction costs for shipping H2 demands + shipping_hydrogen_liquefaction: false # whether to consider liquefaction costs for shipping H2 demands shipping_hydrogen_share: # 1 means all hydrogen FC 2020: 0 2025: 0 From 234a32c504b893dc3c0c4a7af76f0f40448a834d Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Fri, 9 Jul 2021 13:33:26 +0200 Subject: [PATCH 096/132] bug fix --- scripts/prepare_sector_network.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 0282b5eb..6e992f03 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -2246,7 +2246,7 @@ if __name__ == "__main__": lv=1.0, opts='', sector_opts='Co2L0-168H-T-H-B-I-solar3-dist1', - planning_horizons="2020", + planning_horizons="2030", ) logging.basicConfig(level=snakemake.config['logging_level']) From e27ec46878f3327d43a04570e1da11d23ed0ced4 Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Thu, 23 Sep 2021 14:10:56 +0200 Subject: [PATCH 097/132] add further comments --- scripts/prepare_sector_network.py | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 6e992f03..f669e309 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1668,6 +1668,7 @@ def create_nodes_for_heat_sector(): # urban can be split into district heating (central) and individual heating (decentral) ct_urban = pop_layout.urban.groupby(pop_layout["ct"]).sum() + # distribution of urban population within a country pop_layout["urban_ct_fraction"] = pop_layout["urban"] / \ pop_layout["ct"].map(ct_urban.get) # todays district heating share per country @@ -1690,7 +1691,8 @@ def create_nodes_for_heat_sector(): dist_fraction = central_fraction * urban_fraction nodes["urban central"] = dist_fraction.index - if options['district_heating_increase']: # take current district heating share + # take current district heating share + if options['district_heating_increase']: dist_fraction = dist_heat_share * \ pop_layout["urban_ct_fraction"] / pop_layout["fraction"] nodes["urban central"] = dist_fraction.index From 8322350feea47bc5de2bfb4d65247ca3d8236540 Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Wed, 29 Sep 2021 14:36:56 +0200 Subject: [PATCH 098/132] move calculation of district heating share to build_energy_totals --- Snakefile | 2 +- scripts/build_energy_totals.py | 30 +++++++++++++++++++++++++++++- 2 files changed, 30 insertions(+), 2 deletions(-) diff --git a/Snakefile b/Snakefile index 9400d301..a16e60f0 100644 --- a/Snakefile +++ b/Snakefile @@ -160,6 +160,7 @@ rule build_energy_totals: co2="data/eea/UNFCCC_v23.csv", swiss="data/switzerland-sfoe/switzerland-new_format.csv", idees="data/jrc-idees-2015", + district_heat_share='data/district_heat_share.csv', eurostat=input_eurostat output: energy_name='resources/energy_totals.csv', @@ -339,7 +340,6 @@ rule prepare_sector_network: energy_totals_name='resources/energy_totals.csv', co2_totals_name='resources/co2_totals.csv', transport_name='resources/transport_data.csv', - dh_share = "data/district_heat_share.csv", traffic_data_KFZ="data/emobility/KFZ__count", traffic_data_Pkw="data/emobility/Pkw__count", biomass_potentials='resources/biomass_potentials.csv', diff --git a/scripts/build_energy_totals.py b/scripts/build_energy_totals.py index aec1c61b..751f23bf 100644 --- a/scripts/build_energy_totals.py +++ b/scripts/build_energy_totals.py @@ -212,6 +212,12 @@ def idees_per_country(ct, year): assert df.index[47] == "Electricity" ct_totals["electricity residential"] = df[47] + assert df.index[46] == "Derived heat" + ct_totals["Derived heat residential"] = df[46] + + assert df.index[50] == 'Thermal uses' + ct_totals["Thermal uses residential"] = df[50] + # services df = pd.read_excel(fn_services, "SER_hh_fec", index_col=0)[year] @@ -239,6 +245,12 @@ def idees_per_country(ct, year): assert df.index[50] == "Electricity" ct_totals["electricity services"] = df[50] + assert df.index[49] == "Derived heat" + ct_totals["Derived heat services"] = df[49] + + assert df.index[53] == 'Thermal uses' + ct_totals["Thermal uses services"] = df[53] + # transport df = pd.read_excel(fn_transport, "TrRoad_ene", index_col=0)[year] @@ -342,6 +354,7 @@ def build_idees(countries, year): with mp.Pool(processes=nprocesses) as pool: totals_list = list(tqdm(pool.imap(func, countries), **tqdm_kwargs)) + totals = pd.concat(totals_list, axis=1) # convert ktoe to TWh @@ -351,6 +364,13 @@ def build_idees(countries, year): # convert TWh/100km to kWh/km totals.loc["passenger car efficiency"] *= 10 + # district heating share + district_heat = totals.loc[["Derived heat residential", + "Derived heat services"]].sum() + total_heat = totals.loc[["Thermal uses residential", + "Thermal uses services"]].sum() + totals.loc["district heat share"] = district_heat.div(total_heat) + return totals.T @@ -493,7 +513,7 @@ def build_energy_totals(countries, eurostat, swiss, idees): for purpose in ["passenger", "freight"]: attrs = [f"total domestic aviation {purpose}", f"total international aviation {purpose}"] - df.loc[missing, f"total aviation {purpose}"] = df.loc[missing, attrs].sum(axis=1) + df.loc[missing, f"total aviation {purpose}"] = df.loc[missing, attrs].sum(axis=1) if "BA" in df.index: # fill missing data for BA (services and road energy data) @@ -502,6 +522,14 @@ def build_energy_totals(countries, eurostat, swiss, idees): ratio = df.at["BA", "total residential"] / df.at["RS", "total residential"] df.loc['BA', missing] = ratio * df.loc["RS", missing] + # Missing district heating share + dh_share = pd.read_csv(snakemake.input.district_heat_share, + index_col=0, usecols=[0, 1]) + # make conservative assumption and take minimum from both data sets + df["district heat share"] = (pd.concat([df["district heat share"], + dh_share.reindex(index=df.index)/100], + axis=1).min(axis=1)) + return df From 854bd80818e81b80003c661eb214be4eb19e8f25 Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Wed, 29 Sep 2021 14:37:36 +0200 Subject: [PATCH 099/132] rename central_fraction->district heating potential, restructure district heating share implementation --- scripts/prepare_sector_network.py | 99 ++++++++++++++----------------- 1 file changed, 45 insertions(+), 54 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index f669e309..fea03d69 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -26,7 +26,7 @@ spatial = SimpleNamespace() def define_spatial(nodes): """ Namespace for spatial - + Parameters ---------- nodes : list-like @@ -36,7 +36,7 @@ def define_spatial(nodes): global options spatial.nodes = nodes - + # biomass spatial.biomass = SimpleNamespace() @@ -53,11 +53,11 @@ def define_spatial(nodes): spatial.biomass.industry_cc = ["solid biomass for industry CC"] spatial.biomass.df = pd.DataFrame(vars(spatial.biomass), index=nodes) - + # co2 spatial.co2 = SimpleNamespace() - + if options["co2_network"]: spatial.co2.nodes = nodes + " co2 stored" spatial.co2.locations = nodes @@ -72,7 +72,7 @@ def define_spatial(nodes): def emission_sectors_from_opts(opts): - sectors = ["electricity"] + sectors = ["electricity"] if "T" in opts: sectors += [ "rail non-elec", @@ -107,13 +107,13 @@ def get(item, investment_year=None): def create_network_topology(n, prefix, connector=" -> "): """ Create a network topology like the power transmission network. - + Parameters ---------- n : pypsa.Network prefix : str connector : str - + Returns ------- pd.DataFrame with columns bus0, bus1 and length @@ -228,7 +228,7 @@ def add_lifetime_wind_solar(n, costs): def create_network_topology(n, prefix, connector=" -> ", bidirectional=True): """ Create a network topology like the power transmission network. - + Parameters ---------- n : pypsa.Network @@ -237,7 +237,7 @@ def create_network_topology(n, prefix, connector=" -> ", bidirectional=True): bidirectional : bool, default True True: one link for each connection False: one link for each connection and direction (back and forth) - + Returns ------- pd.DataFrame with columns bus0, bus1 and length @@ -256,19 +256,19 @@ def create_network_topology(n, prefix, connector=" -> ", bidirectional=True): swap_buses = {"bus0": "bus1", "bus1": "bus0"} candidates_n = candidates[~positive_order].rename(columns=swap_buses) candidates = pd.concat([candidates_p, candidates_n]) - + def make_index(c): return prefix + c.bus0 + connector + c.bus1 topo = candidates.groupby(["bus0", "bus1"], as_index=False).mean() topo.index = topo.apply(make_index, axis=1) - + if not bidirectional: topo_reverse = topo.copy() topo_reverse.rename(columns=swap_buses, inplace=True) topo_reverse.index = topo_reverse.apply(make_index, axis=1) topo = topo.append(topo_reverse) - + return topo @@ -439,7 +439,7 @@ def add_co2_tracking(n, options): n.madd("Store", spatial.co2.nodes, e_nom_extendable=True, - e_nom_max=np.inf, + e_nom_max=np.inf, capital_cost=options['co2_sequestration_cost'], carrier="co2 stored", bus=spatial.co2.nodes @@ -458,14 +458,14 @@ def add_co2_tracking(n, options): def add_co2_network(n, costs): - + logger.info("Adding CO2 network.") co2_links = create_network_topology(n, "CO2 pipeline ") cost_onshore = (1 - co2_links.underwater_fraction) * costs.at['CO2 pipeline', 'fixed'] * co2_links.length cost_submarine = co2_links.underwater_fraction * costs.at['CO2 submarine pipeline', 'fixed'] * co2_links.length capital_cost = cost_onshore + cost_submarine - + n.madd("Link", co2_links.index, bus0=co2_links.bus0.values + " co2 stored", @@ -636,6 +636,9 @@ def prepare_data(n): nodal_energy_totals = energy_totals.loc[pop_layout.ct].fillna(0.) nodal_energy_totals.index = pop_layout.index + # district heat share not weighted by population + district_heat_share = round(nodal_energy_totals["district heat share"], + ndigits=2) nodal_energy_totals = nodal_energy_totals.multiply(pop_layout.fraction, axis=0) # copy forward the daily average heat demand into each hour, so it can be multipled by the intraday profile @@ -758,7 +761,7 @@ def prepare_data(n): ) - return nodal_energy_totals, heat_demand, ashp_cop, gshp_cop, solar_thermal, transport, avail_profile, dsm_profile, nodal_transport_data + return nodal_energy_totals, heat_demand, ashp_cop, gshp_cop, solar_thermal, transport, avail_profile, dsm_profile, nodal_transport_data, district_heat_share # TODO checkout PyPSA-Eur script @@ -1386,7 +1389,7 @@ def add_heat(n, costs): heat_load = heat_demand[[sector + " water",sector + " space"]].groupby(level=1,axis=1).sum()[nodes[name]].multiply(factor) if name == "urban central": - heat_load = heat_demand.groupby(level=1,axis=1).sum()[nodes[name]].multiply(factor * (1 + options['district_heating_loss'])) + heat_load = heat_demand.groupby(level=1,axis=1).sum()[nodes[name]].multiply(factor * (1 + options['district_heating']['district_heating_loss'])) n.madd("Load", nodes[name], @@ -1671,10 +1674,6 @@ def create_nodes_for_heat_sector(): # distribution of urban population within a country pop_layout["urban_ct_fraction"] = pop_layout["urban"] / \ pop_layout["ct"].map(ct_urban.get) - # todays district heating share per country - dist_heat_share_ct = pd.read_csv(snakemake.input.dh_share, index_col=0, - usecols=[0,1]).dropna()/100 - dist_heat_share = pop_layout.ct.map(dist_heat_share_ct["district heating share"]) sectors = ["residential", "services"] @@ -1686,36 +1685,29 @@ def create_nodes_for_heat_sector(): nodes[sector + " rural"] = pop_layout.index nodes[sector + " urban decentral"] = pop_layout.index - if options["central"] and not options['district_heating_increase']: - central_fraction = options['central_fraction'] - dist_fraction = central_fraction * urban_fraction - nodes["urban central"] = dist_fraction.index + # maximum potential of urban demand covered by district heating + central_fraction = options['district_heating']["potential"] + # district heating share at each node + dist_fraction_node = district_heat_share * pop_layout["urban_ct_fraction"] / pop_layout["fraction"] + nodes["urban central"] = dist_fraction_node.index + # if district heating share larger than urban fraction -> set urban + # fraction to district heating share + urban_fraction = pd.concat([urban_fraction, dist_fraction_node], + axis=1).max(axis=1) + # difference of max potential and today's share of district heating + diff = (urban_fraction * central_fraction) - dist_fraction_node + progress = get(options["district_heating"]["potential"], investment_year) + dist_fraction_node += diff * progress + print("************************************") + print( + "the current DH share compared to the maximum possible is increased \ + \n by a progress factor of ", + progress, + "resulting DH share: ", + dist_fraction_node) + print("**********************************") - # take current district heating share - if options['district_heating_increase']: - dist_fraction = dist_heat_share * \ - pop_layout["urban_ct_fraction"] / pop_layout["fraction"] - nodes["urban central"] = dist_fraction.index - # if district heating share larger than urban fraction -> set urban - # fraction to district heating share - urban_fraction = pd.concat([urban_fraction, dist_fraction], - axis=1).max(axis=1) - diff = urban_fraction - dist_fraction - dist_fraction += diff * get(options["dh_strength"], investment_year) - print("************************************") - print( - "the current DH share compared to the maximum possible is increased \ - \n by a factor of ", - get(options["dh_strength"], investment_year), - "resulting DH share: ", - dist_fraction) - print("**********************************") - - else: - dist_fraction = urban_fraction * 0 - nodes["urban central"] = dist_fraction.index - - return nodes, dist_fraction, urban_fraction + return nodes, dist_fraction_node, urban_fraction def add_biomass(n, costs): @@ -1788,7 +1780,7 @@ def add_biomass(n, costs): index_col=0, squeeze=True ) - + # add biomass transport biomass_transport = create_network_topology(n, "biomass transport ", bidirectional=False) @@ -2246,7 +2238,6 @@ if __name__ == "__main__": opts="", clusters="37", lv=1.0, - opts='', sector_opts='Co2L0-168H-T-H-B-I-solar3-dist1', planning_horizons="2030", ) @@ -2300,10 +2291,10 @@ if __name__ == "__main__": if o == "biomasstransport": options["biomass_transport"] = True - nodal_energy_totals, heat_demand, ashp_cop, gshp_cop, solar_thermal, transport, avail_profile, dsm_profile, nodal_transport_data = prepare_data(n) + nodal_energy_totals, heat_demand, ashp_cop, gshp_cop, solar_thermal, transport, avail_profile, dsm_profile, nodal_transport_data, district_heat_share = prepare_data(n) if "nodistrict" in opts: - options["central"] = False + options["district_heating"]["progress"] = 0.0 if "T" in opts: add_land_transport(n, costs) From 1e248b314dcc481e4a668265e36d410704224d17 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Wed, 29 Sep 2021 15:45:14 +0200 Subject: [PATCH 100/132] compatibility with biomass transport --- scripts/prepare_sector_network.py | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 81a60870..5f4b680e 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1687,10 +1687,7 @@ def add_biomass(n, costs): biomass_potentials = pd.read_csv(snakemake.input.biomass_potentials, index_col=0) if options["biomass_transport"]: - # potential per node distributed within country by population - biomass_potentials_spatial = (biomass_potentials.loc[pop_layout.index] - .mul(pop_layout.fraction, axis="index") - .rename(index=lambda x: x + " solid biomass")) + biomass_potentials_spatial = biomass_potentials.rename(index=lambda x: x + " solid biomass") else: biomass_potentials_spatial = biomass_potentials.sum() From f6bb49873028b5c99b97621f6599504180e23af8 Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Wed, 29 Sep 2021 16:13:23 +0200 Subject: [PATCH 101/132] include PR review --- doc/data.csv | 54 ++++++++++++++++--------------- scripts/prepare_sector_network.py | 19 +++++------ 2 files changed, 36 insertions(+), 37 deletions(-) diff --git a/doc/data.csv b/doc/data.csv index 8e316281..75bdc10e 100644 --- a/doc/data.csv +++ b/doc/data.csv @@ -1,26 +1,28 @@ -description,file/folder,licence,source -JRC IDEES database,jrc-idees-2015/,CC BY 4.0,https://ec.europa.eu/jrc/en/potencia/jrc-idees -urban/rural fraction,urban_percent.csv,unknown,unknown -JRC biomass potentials,biomass/,unknown,https://doi.org/10.2790/39014 -EEA emission statistics,eea/UNFCCC_v23.csv,EEA standard re-use policy,https://www.eea.europa.eu/data-and-maps/data/national-emissions-reported-to-the-unfccc-and-to-the-eu-greenhouse-gas-monitoring-mechanism-16 -Eurostat Energy Balances,eurostat-energy_balances-*/,Eurostat,https://ec.europa.eu/eurostat/web/energy/data/energy-balances -Swiss energy statistics from Swiss Federal Office of Energy,switzerland-sfoe/,unknown,http://www.bfe.admin.ch/themen/00526/00541/00542/02167/index.html?dossier_id=02169 -BASt emobility statistics,emobility/,unknown,http://www.bast.de/DE/Verkehrstechnik/Fachthemen/v2-verkehrszaehlung/Stundenwerte.html?nn=626916 -timezone mappings,timezone_mappings.csv,CC BY 4.0,Tom Brown -BDEW heating profile,heat_load_profile_BDEW.csv,unknown,https://github.com/oemof/demandlib -heating profiles for Aarhus,heat_load_profile_DK_AdamJensen.csv,unknown,Adam Jensen MA thesis at Aarhus University -George Lavidas wind/wave costs,WindWaveWEC_GLTB.xlsx,unknown,George Lavidas -country codes,Country_codes.csv,CC BY 4.0,Marta Victoria -co2 budgets,co2_budget.csv,CC BY 4.0,https://arxiv.org/abs/2004.11009 -existing heating potentials,existing_infrastructure/existing_heating_raw.csv,unknown,https://ec.europa.eu/energy/studies/mapping-and-analyses-current-and-future-2020-2030-heatingcooling-fuel-deployment_en?redir=1 -IRENA existing VRE capacities,existing_infrastructure/{solar|onwind|offwind}_capcity_IRENA.csv,unknown,https://www.irena.org/Statistics/Download-Data -USGS ammonia production,myb1-2017-nitro.xls,unknown,https://www.usgs.gov/centers/nmic/nitrogen-statistics-and-information -hydrogen salt cavern potentials,hydrogen_salt_cavern_potentials.csv,CC BY 4.0,https://doi.org/10.1016/j.ijhydene.2019.12.161 -hotmaps industrial site database,Industrial_Database.csv,CC BY 4.0,https://gitlab.com/hotmaps/industrial_sites/industrial_sites_Industrial_Database -Hotmaps building stock data,data_building_stock.csv,CC BY 4.0,https://gitlab.com/hotmaps/building-stock -U-values Poland,u_values_poland.csv,unknown,https://data.europa.eu/euodp/de/data/dataset/building-stock-observatory -Floor area missing in hotmaps building stock data,floor_area_missing.csv,unknown,https://data.europa.eu/euodp/de/data/dataset/building-stock-observatory -Comparative level investment,comparative_level_investment.csv,Eurostat,https://ec.europa.eu/eurostat/statistics-explained/index.php?title=Comparative_price_levels_for_investment -Electricity taxes,electricity_taxes_eu.csv,Eurostat,https://appsso.eurostat.ec.europa.eu/nui/show.do?dataset=nrg_pc_204&lang=en -Building topologies and corresponding standard values,tabula-calculator-calcsetbuilding.csv,unknown,https://episcope.eu/fileadmin/tabula/public/calc/tabula-calculator.xlsx -Retrofitting thermal envelope costs for Germany,retro_cost_germany.csv,unkown,https://www.iwu.de/forschung/handlungslogiken/kosten-energierelevanter-bau-und-anlagenteile-bei-modernisierung/ +description,file/folder,licence,source,, +JRC IDEES database,jrc-idees-2015/,CC BY 4.0,https://ec.europa.eu/jrc/en/potencia/jrc-idees,, +urban/rural fraction,urban_percent.csv,unknown,unknown,, +JRC biomass potentials,biomass/,unknown,https://doi.org/10.2790/39014,, +EEA emission statistics,eea/UNFCCC_v23.csv,EEA standard re-use policy,https://www.eea.europa.eu/data-and-maps/data/national-emissions-reported-to-the-unfccc-and-to-the-eu-greenhouse-gas-monitoring-mechanism-16,, +Eurostat Energy Balances,eurostat-energy_balances-*/,Eurostat,https://ec.europa.eu/eurostat/web/energy/data/energy-balances,, +Swiss energy statistics from Swiss Federal Office of Energy,switzerland-sfoe/,unknown,http://www.bfe.admin.ch/themen/00526/00541/00542/02167/index.html?dossier_id=02169,, +BASt emobility statistics,emobility/,unknown,http://www.bast.de/DE/Verkehrstechnik/Fachthemen/v2-verkehrszaehlung/Stundenwerte.html?nn=626916,, +timezone mappings,timezone_mappings.csv,CC BY 4.0,Tom Brown,, +BDEW heating profile,heat_load_profile_BDEW.csv,unknown,https://github.com/oemof/demandlib,, +heating profiles for Aarhus,heat_load_profile_DK_AdamJensen.csv,unknown,Adam Jensen MA thesis at Aarhus University,, +George Lavidas wind/wave costs,WindWaveWEC_GLTB.xlsx,unknown,George Lavidas,, +country codes,Country_codes.csv,CC BY 4.0,Marta Victoria,, +co2 budgets,co2_budget.csv,CC BY 4.0,https://arxiv.org/abs/2004.11009,, +existing heating potentials,existing_infrastructure/existing_heating_raw.csv,unknown,https://ec.europa.eu/energy/studies/mapping-and-analyses-current-and-future-2020-2030-heatingcooling-fuel-deployment_en?redir=1,, +IRENA existing VRE capacities,existing_infrastructure/{solar,onwind,offwind}_capcity_IRENA.csv,unknown,https://www.irena.org/Statistics/Download-Data +USGS ammonia production,myb1-2017-nitro.xls,unknown,https://www.usgs.gov/centers/nmic/nitrogen-statistics-and-information,, +hydrogen salt cavern potentials,hydrogen_salt_cavern_potentials.csv,CC BY 4.0,https://doi.org/10.1016/j.ijhydene.2019.12.161,, +hotmaps industrial site database,Industrial_Database.csv,CC BY 4.0,https://gitlab.com/hotmaps/industrial_sites/industrial_sites_Industrial_Database,, +Hotmaps building stock data,data_building_stock.csv,CC BY 4.0,https://gitlab.com/hotmaps/building-stock,, +U-values Poland,u_values_poland.csv,unknown,https://data.europa.eu/euodp/de/data/dataset/building-stock-observatory,, +Floor area missing in hotmaps building stock data,floor_area_missing.csv,unknown,https://data.europa.eu/euodp/de/data/dataset/building-stock-observatory,, +Comparative level investment,comparative_level_investment.csv,Eurostat,https://ec.europa.eu/eurostat/statistics-explained/index.php?title=Comparative_price_levels_for_investment,, +Electricity taxes,electricity_taxes_eu.csv,Eurostat,https://appsso.eurostat.ec.europa.eu/nui/show.do?dataset=nrg_pc_204&lang=en,, +Building topologies and corresponding standard values,tabula-calculator-calcsetbuilding.csv,unknown,https://episcope.eu/fileadmin/tabula/public/calc/tabula-calculator.xlsx,, +Retrofitting thermal envelope costs for Germany,retro_cost_germany.csv,unkown,https://www.iwu.de/forschung/handlungslogiken/kosten-energierelevanter-bau-und-anlagenteile-bei-modernisierung/,, +District heating most countries,jrc-idees-2015/,CC BY 4.0,https://ec.europa.eu/jrc/en/potencia/jrc-idees,, +District heating missing countries,district_heat_share.csv,unkown,https://www.euroheat.org/knowledge-hub/country-profiles,, diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index fea03d69..89ccbebb 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -481,7 +481,7 @@ def add_co2_network(n, costs): def add_dac(n, costs): - heat_carriers = ["urban central heat"] + heat_carriers = ["urban central heat", "services urban decentral heat"] heat_buses = n.buses.index[n.buses.carrier.isin(heat_carriers)] locations = n.buses.location[heat_buses] @@ -489,8 +489,7 @@ def add_dac(n, costs): efficiency3 = -(costs.at['direct air capture', 'heat-input'] - costs.at['direct air capture', 'compression-heat-output']) n.madd("Link", - locations, - suffix=" DAC", + heat_buses.str.replace(" heat", " DAC"), bus0="co2 atmosphere", bus1=spatial.co2.df.loc[locations, "nodes"].values, bus2=locations.values, @@ -1383,7 +1382,7 @@ def add_heat(n, costs): factor = urban_fraction[nodes[name]] - \ dist_fraction[nodes[name]] else: - factor = None + raise NotImplementedError(f" {name} not in " f"heat systems: {heat_systems}") if sector in name: heat_load = heat_demand[[sector + " water",sector + " space"]].groupby(level=1,axis=1).sum()[nodes[name]].multiply(factor) @@ -1670,16 +1669,14 @@ def create_nodes_for_heat_sector(): # urban are areas with high heating density # urban can be split into district heating (central) and individual heating (decentral) - ct_urban = pop_layout.urban.groupby(pop_layout["ct"]).sum() + ct_urban = pop_layout.urban.groupby(pop_layout.ct).sum() # distribution of urban population within a country - pop_layout["urban_ct_fraction"] = pop_layout["urban"] / \ - pop_layout["ct"].map(ct_urban.get) + pop_layout["urban_ct_fraction"] = pop_layout.urban / pop_layout.ct.map(ct_urban.get) sectors = ["residential", "services"] nodes = {} - urban_fraction = pop_layout["urban"] / \ - (pop_layout[["urban", "rural"]].sum(axis=1)) + urban_fraction = pop_layout.urban / pop_layout[["rural", "urban"]].sum(axis=1) for sector in sectors: nodes[sector + " rural"] = pop_layout.index @@ -2239,7 +2236,7 @@ if __name__ == "__main__": clusters="37", lv=1.0, sector_opts='Co2L0-168H-T-H-B-I-solar3-dist1', - planning_horizons="2030", + planning_horizons="2020", ) logging.basicConfig(level=snakemake.config['logging_level']) @@ -2254,7 +2251,7 @@ if __name__ == "__main__": n = pypsa.Network(snakemake.input.network, override_component_attrs=overrides) pop_layout = pd.read_csv(snakemake.input.clustered_pop_layout, index_col=0) - Nyears = n.snapshot_weightings.sum() / 8760 + Nyears = n.snapshot_weightings.generators.sum() / 8760 costs = prepare_costs(snakemake.input.costs, snakemake.config['costs']['USD2013_to_EUR2013'], From 339187c1f1344a90ee5fbd13fe7d956aa39cbe74 Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Wed, 29 Sep 2021 16:23:38 +0200 Subject: [PATCH 102/132] update config --- config.default.yaml | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index f8d8082b..e1ddd60d 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -141,14 +141,16 @@ existing_capacities: sector: - central: true - central_fraction: 0.6 - district_heating_increase: true - dh_strength: - 2020: 0 # starting at today's share - 2030: 0.2 - 2040: 0.5 - 2050: 1 # maximum possible share defined in central fraction + district_heating: + potential: 0.6 # 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 = 0 means today's district heating share, progress = 1 means maximum fraction of urban demand is supplied by district heating + progress: + 2020: 0.0 + 2030: 0.3 + 2040: 0.6 + 2050: 1.0 + district_heating_loss: 0.15 bev_dsm_restriction_value: 0.75 #Set to 0 for no restriction on BEV DSM bev_dsm_restriction_time: 7 #Time at which SOC of BEV has to be dsm_restriction_value transport_heating_deadband_upper: 20. @@ -157,7 +159,6 @@ sector: ICE_upper_degree_factor: 1.6 EV_lower_degree_factor: 0.98 EV_upper_degree_factor: 0.63 - district_heating_loss: 0.15 bev_dsm: true #turns on EV battery bev_availability: 0.5 #How many cars do smart charging bev_energy: 0.05 #average battery size in MWh From 18fabd930e0b7e736a845755a0d228db5873bbc2 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Thu, 30 Sep 2021 17:46:26 +0200 Subject: [PATCH 103/132] Apply suggestions from code review --- scripts/prepare_sector_network.py | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 320c4726..727b2de8 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1695,14 +1695,13 @@ def create_nodes_for_heat_sector(): diff = (urban_fraction * central_fraction) - dist_fraction_node progress = get(options["district_heating"]["potential"], investment_year) dist_fraction_node += diff * progress - print("************************************") - print( - "the current DH share compared to the maximum possible is increased \ - \n by a progress factor of ", + logger.info( + "The current district heating share compared to the maximum", + "possible is increased by a progress factor of ", progress, - "resulting DH share: ", - dist_fraction_node) - print("**********************************") + "resulting in a district heating share of ", + dist_fraction_node + ) return nodes, dist_fraction_node, urban_fraction @@ -2230,7 +2229,6 @@ if __name__ == "__main__": lv=1.0, sector_opts='Co2L0-168H-T-H-B-I-solar3-dist1', planning_horizons="2020", - planning_horizons="2030", ) logging.basicConfig(level=snakemake.config['logging_level']) From 0d999a49912429d151fceb5735bad7d888753922 Mon Sep 17 00:00:00 2001 From: lisazeyen <35347358+lisazeyen@users.noreply.github.com> Date: Fri, 1 Oct 2021 17:10:42 +0200 Subject: [PATCH 104/132] prepare_sector_network: code formatting Co-authored-by: Fabian Neumann --- scripts/prepare_sector_network.py | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 727b2de8..1bb5caf9 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -636,8 +636,7 @@ def prepare_data(n): nodal_energy_totals = energy_totals.loc[pop_layout.ct].fillna(0.) nodal_energy_totals.index = pop_layout.index # district heat share not weighted by population - district_heat_share = round(nodal_energy_totals["district heat share"], - ndigits=2) + district_heat_share = nodal_energy_totals["district heat share"].round(2) nodal_energy_totals = nodal_energy_totals.multiply(pop_layout.fraction, axis=0) # copy forward the daily average heat demand into each hour, so it can be multipled by the intraday profile From c0adb51454622f07ee44151bd87cad101e042f2b Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Sat, 2 Oct 2021 10:03:40 +0200 Subject: [PATCH 105/132] decapitalize columns in build_energy_totals --- scripts/build_energy_totals.py | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/scripts/build_energy_totals.py b/scripts/build_energy_totals.py index 751f23bf..efb5d6da 100644 --- a/scripts/build_energy_totals.py +++ b/scripts/build_energy_totals.py @@ -216,7 +216,7 @@ def idees_per_country(ct, year): ct_totals["Derived heat residential"] = df[46] assert df.index[50] == 'Thermal uses' - ct_totals["Thermal uses residential"] = df[50] + ct_totals["thermal uses residential"] = df[50] # services @@ -246,10 +246,10 @@ def idees_per_country(ct, year): ct_totals["electricity services"] = df[50] assert df.index[49] == "Derived heat" - ct_totals["Derived heat services"] = df[49] + ct_totals["derived heat services"] = df[49] assert df.index[53] == 'Thermal uses' - ct_totals["Thermal uses services"] = df[53] + ct_totals["thermal uses services"] = df[53] # transport @@ -365,10 +365,10 @@ def build_idees(countries, year): totals.loc["passenger car efficiency"] *= 10 # district heating share - district_heat = totals.loc[["Derived heat residential", - "Derived heat services"]].sum() - total_heat = totals.loc[["Thermal uses residential", - "Thermal uses services"]].sum() + district_heat = totals.loc[["derived heat residential", + "derived heat services"]].sum() + total_heat = totals.loc[["thermal uses residential", + "thermal uses services"]].sum() totals.loc["district heat share"] = district_heat.div(total_heat) return totals.T From a60f180f613a9678b2c28c330c9075a5f451bc24 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Sat, 2 Oct 2021 10:23:27 +0200 Subject: [PATCH 106/132] fix logging --- scripts/prepare_sector_network.py | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 1bb5caf9..5fc4a6e3 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1694,12 +1694,10 @@ def create_nodes_for_heat_sector(): diff = (urban_fraction * central_fraction) - dist_fraction_node progress = get(options["district_heating"]["potential"], investment_year) dist_fraction_node += diff * progress - logger.info( + print( "The current district heating share compared to the maximum", - "possible is increased by a progress factor of ", - progress, - "resulting in a district heating share of ", - dist_fraction_node + f"possible is increased by a progress factor of\n{progress}", + f"resulting in a district heating share of\n{dist_fraction_node}" ) return nodes, dist_fraction_node, urban_fraction From 7987fd23cfa00cc5b53e46fab73c630520c7ab43 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Sat, 2 Oct 2021 10:33:56 +0200 Subject: [PATCH 107/132] add release note --- doc/release_notes.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/release_notes.rst b/doc/release_notes.rst index 16889268..eb3f7a18 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -88,6 +88,7 @@ Future release * Compatibility with ``xarray`` version 0.19. * Separate basic chemicals into HVC, chlorine, methanol and ammonia [`#166 `_]. * Add option to specify reuse, primary production, and mechanical and chemical recycling fraction of platics [`#166 `_]. +* Include today's district heating shares in myopic optimisation and add option to specify exogenous path for district heating share increase under ``sector: district_heating:`` [`#149 `_]. PyPSA-Eur-Sec 0.5.0 (21st May 2021) =================================== From 4400658099523686a240fa6505535e49077e5ecc Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Sat, 2 Oct 2021 10:40:01 +0200 Subject: [PATCH 108/132] edit release note --- doc/release_notes.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/release_notes.rst b/doc/release_notes.rst index f0bf3caa..efc6ca1a 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -7,7 +7,7 @@ Future release .. note:: This unreleased version currently requires the master branches of PyPSA, PyPSA-Eur, and the technology-data repository. -* The myopic option can now be used together with different clustering for the generators and the network. The existing renewable capacities are split evenly among the regions in every country. + * With this release, we change the license from copyleft GPLv3 to the more liberal MIT license with the consent of all contributors. * Extended use of ``multiprocessing`` for much better performance @@ -88,6 +88,7 @@ Future release * Compatibility with ``xarray`` version 0.19. * Separate basic chemicals into HVC, chlorine, methanol and ammonia [`#166 `_]. * Add option to specify reuse, primary production, and mechanical and chemical recycling fraction of platics [`#166 `_]. +* The myopic option can now be used together with different clustering for the generators and the network. The existing renewable capacities are split evenly among the regions in every country [`#144 `_]. PyPSA-Eur-Sec 0.5.0 (21st May 2021) =================================== From 437508383875bcec72fe39f102ce7673d43a7155 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Sat, 2 Oct 2021 10:40:49 +0200 Subject: [PATCH 109/132] create parallel structures for land-use constraints w/wo m --- scripts/solve_network.py | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) diff --git a/scripts/solve_network.py b/scripts/solve_network.py index 673b7797..eac1f581 100644 --- a/scripts/solve_network.py +++ b/scripts/solve_network.py @@ -21,18 +21,23 @@ pypsa.pf.logger.setLevel(logging.WARNING) def add_land_use_constraint(n): if 'm' in snakemake.wildcards.clusters: - add_land_use_constraint_m(n) + _add_land_use_constraint_m(n) else: - #warning: this will miss existing offwind which is not classed AC-DC and has carrier 'offwind' - for carrier in ['solar', 'onwind', 'offwind-ac', 'offwind-dc']: - existing = n.generators.loc[n.generators.carrier==carrier,"p_nom"].groupby(n.generators.bus.map(n.buses.location)).sum() - existing.index += " " + carrier + "-" + snakemake.wildcards.planning_horizons - n.generators.loc[existing.index,"p_nom_max"] -= existing + _add_land_use_constraint(n) + +def _add_land_use_constraint(n): + #warning: this will miss existing offwind which is not classed AC-DC and has carrier 'offwind' + + for carrier in ['solar', 'onwind', 'offwind-ac', 'offwind-dc']: + existing = n.generators.loc[n.generators.carrier==carrier,"p_nom"].groupby(n.generators.bus.map(n.buses.location)).sum() + existing.index += " " + carrier + "-" + snakemake.wildcards.planning_horizons + n.generators.loc[existing.index,"p_nom_max"] -= existing + n.generators.p_nom_max.clip(lower=0, inplace=True) -def add_land_use_constraint_m(n): +def _add_land_use_constraint_m(n): # if generators clustering is lower than network clustering, land_use accounting is at generators clusters planning_horizons = snakemake.config["scenario"]["planning_horizons"] @@ -55,6 +60,8 @@ def add_land_use_constraint_m(n): sel_current = [i + " " + carrier + "-" + current_horizon for i in ind2] sel_p_year = [i + " " + carrier + "-" + p_year for i in ind2] n.generators.loc[sel_current, "p_nom_max"] -= existing.loc[sel_p_year].rename(lambda x: x[:-4] + current_horizon) + + n.generators.p_nom_max.clip(lower=0, inplace=True) def prepare_network(n, solve_opts=None): From 2bfc091f8bd03785237ed20bf8f4541c504f6431 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Sat, 2 Oct 2021 11:12:45 +0200 Subject: [PATCH 110/132] update data bundle --- .gitignore | 3 --- data/heat_load_profile_DK_AdamJensen.csv | 25 ++++++++++++++++++++ data/urban_percent.csv | 30 ++++++++++++++++++++++++ doc/data.csv | 1 - doc/release_notes.rst | 2 +- 5 files changed, 56 insertions(+), 5 deletions(-) create mode 100644 data/heat_load_profile_DK_AdamJensen.csv create mode 100644 data/urban_percent.csv diff --git a/.gitignore b/.gitignore index 10243def..aa531c3d 100644 --- a/.gitignore +++ b/.gitignore @@ -11,11 +11,8 @@ gurobi.log /benchmarks /logs /notebooks -/data/timezone_mappings.csv -/data/urban_percent.csv /data/links_p_nom.csv /data/*totals.csv -/data/*Jensen.csv /data/biomass* /data/emobility/ /data/eea* diff --git a/data/heat_load_profile_DK_AdamJensen.csv b/data/heat_load_profile_DK_AdamJensen.csv new file mode 100644 index 00000000..cb417bde --- /dev/null +++ b/data/heat_load_profile_DK_AdamJensen.csv @@ -0,0 +1,25 @@ +hour,weekday,weekend +0,0.9181438689,0.9421512708 +1,0.9172359071,0.9400891069 +2,0.9269464481,0.9461062015 +3,0.9415047932,0.9535084941 +4,0.9656299507,0.9651094993 +5,1.0221166443,0.9834676747 +6,1.1553090493,1.0124171051 +7,1.2093411031,1.0446615927 +8,1.1470295942,1.088203419 +9,1.0877191341,1.1110334576 +10,1.0418327372,1.0926752822 +11,1.0062977133,1.055488209 +12,0.9837030359,1.0251266112 +13,0.9667570278,0.9990015154 +14,0.9548320932,0.9782897278 +15,0.9509232061,0.9698167237 +16,0.9636973319,0.974288587 +17,0.9799372563,0.9886456216 +18,1.0046501848,1.0084159643 +19,1.0079452419,1.0171243296 +20,0.9860566481,0.9994722379 +21,0.9705228074,0.982761591 +22,0.9586485819,0.9698167237 +23,0.9335023778,0.9515079292 diff --git a/data/urban_percent.csv b/data/urban_percent.csv new file mode 100644 index 00000000..d57e0728 --- /dev/null +++ b/data/urban_percent.csv @@ -0,0 +1,30 @@ +AT,66 +BA,40 +BE,98 +BG,74 +CH,74 +CZ,73 +DE,75 +DK,88 +EE,68 +ES,80 +FI,84 +FR,80 +GB,83 +GR,78 +HR,59 +HU,71 +IE,63 +IT,69 +LT,67 +LU,90 +LV,67 +NL,90 +NO,80 +PL,61 +PT,63 +RO,55 +RS,56 +SE,86 +SI,50 +SK,54 diff --git a/doc/data.csv b/doc/data.csv index 01fa04b3..cde8c559 100644 --- a/doc/data.csv +++ b/doc/data.csv @@ -7,7 +7,6 @@ EEA emission statistics,eea/UNFCCC_v23.csv,EEA standard re-use policy,https://ww Eurostat Energy Balances,eurostat-energy_balances-*/,Eurostat,https://ec.europa.eu/eurostat/web/energy/data/energy-balances Swiss energy statistics from Swiss Federal Office of Energy,switzerland-sfoe/,unknown,http://www.bfe.admin.ch/themen/00526/00541/00542/02167/index.html?dossier_id=02169 BASt emobility statistics,emobility/,unknown,http://www.bast.de/DE/Verkehrstechnik/Fachthemen/v2-verkehrszaehlung/Stundenwerte.html?nn=626916 -timezone mappings,timezone_mappings.csv,CC BY 4.0,Tom Brown BDEW heating profile,heat_load_profile_BDEW.csv,unknown,https://github.com/oemof/demandlib heating profiles for Aarhus,heat_load_profile_DK_AdamJensen.csv,unknown,Adam Jensen MA thesis at Aarhus University George Lavidas wind/wave costs,WindWaveWEC_GLTB.xlsx,unknown,George Lavidas diff --git a/doc/release_notes.rst b/doc/release_notes.rst index 01935d80..9ef5c04b 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -270,4 +270,4 @@ To make a new release of the data bundle, make an archive of the files in ``data .. code:: bash - data % tar pczf pypsa-eur-sec-data-bundle-YYMMDD.tar.gz eea/UNFCCC_v23.csv switzerland-sfoe biomass eurostat-energy_balances-* jrc-idees-2015 emobility urban_percent.csv timezone_mappings.csv heat_load_profile_DK_AdamJensen.csv WindWaveWEC_GLTB.xlsx myb1-2017-nitro.xls Industrial_Database.csv retro/tabula-calculator-calcsetbuilding.csv + data % tar pczf pypsa-eur-sec-data-bundle.tar.gz eea/UNFCCC_v23.csv switzerland-sfoe biomass eurostat-energy_balances-* jrc-idees-2015 emobility WindWaveWEC_GLTB.xlsx myb1-2017-nitro.xls Industrial_Database.csv retro/tabula-calculator-calcsetbuilding.csv nuts/NUTS_RG_10M_2013_4326_LEVL_2.geojson From aca1023c3d048b468f3bc468ae9512728e6325dd Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Sat, 2 Oct 2021 11:17:29 +0200 Subject: [PATCH 111/132] bump version to 0.6.0 --- config.default.yaml | 2 +- doc/conf.py | 4 ++-- doc/release_notes.rst | 5 ++++- 3 files changed, 7 insertions(+), 4 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index d6d4052c..eb062833 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -1,4 +1,4 @@ -version: 0.5.0 +version: 0.6.0 logging_level: INFO diff --git a/doc/conf.py b/doc/conf.py index 1961a23b..b0206ff8 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -70,9 +70,9 @@ author = u'2019-2020 Tom Brown (KIT), Marta Victoria (Aarhus University), Lisa Z # built documents. # # The short X.Y version. -version = u'0.5' +version = u'0.6' # The full version, including alpha/beta/rc tags. -release = u'0.5.0' +release = u'0.6.0' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. diff --git a/doc/release_notes.rst b/doc/release_notes.rst index 9ef5c04b..aaccc671 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -6,7 +6,10 @@ Future release ============== .. note:: - This unreleased version currently requires the master branches of PyPSA, PyPSA-Eur, and the technology-data repository. + This unreleased version currently may require the master branches of PyPSA, PyPSA-Eur, and the technology-data repository. + +PyPSA-Eur-Sec 0.6.0 (4 October 2021) +==================================== * With this release, we change the license from copyleft GPLv3 to the more liberal MIT license with the consent of all contributors. From 274eadd085a2f4b4c296d9288a69c49b92401c13 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Sun, 3 Oct 2021 12:51:03 +0200 Subject: [PATCH 112/132] correct derived heat residential capitalisation --- scripts/build_energy_totals.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/build_energy_totals.py b/scripts/build_energy_totals.py index efb5d6da..2f985e57 100644 --- a/scripts/build_energy_totals.py +++ b/scripts/build_energy_totals.py @@ -213,7 +213,7 @@ def idees_per_country(ct, year): ct_totals["electricity residential"] = df[47] assert df.index[46] == "Derived heat" - ct_totals["Derived heat residential"] = df[46] + ct_totals["derived heat residential"] = df[46] assert df.index[50] == 'Thermal uses' ct_totals["thermal uses residential"] = df[50] From 017c1885189eee308e5c451b31e3e1de87023d0e Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Mon, 4 Oct 2021 09:23:23 +0200 Subject: [PATCH 113/132] fix typo for district heating with capital D --- scripts/build_energy_totals.py | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/scripts/build_energy_totals.py b/scripts/build_energy_totals.py index b21200b5..3f376b0c 100644 --- a/scripts/build_energy_totals.py +++ b/scripts/build_energy_totals.py @@ -214,7 +214,7 @@ def idees_per_country(ct, year): ct_totals["electricity residential"] = df[47] assert df.index[46] == "Derived heat" - ct_totals["Derived heat residential"] = df[46] + ct_totals["derived heat residential"] = df[46] assert df.index[50] == 'Thermal uses' ct_totals["thermal uses residential"] = df[50] @@ -251,13 +251,13 @@ def idees_per_country(ct, year): assert df.index[53] == 'Thermal uses' ct_totals["thermal uses services"] = df[53] - - + + # agriculture, forestry and fishing start = "Detailed split of energy consumption (ktoe)" end = "Market shares of energy uses (%)" - + df = pd.read_excel(fn_tertiary, "AGR_fec", index_col=0).loc[start:end, year] rows = [ From 4135718e375b788c8bc3351e07188660e79532af Mon Sep 17 00:00:00 2001 From: lisazeyen Date: Mon, 4 Oct 2021 09:23:54 +0200 Subject: [PATCH 114/132] use agriculture sector as default, add missing colors --- config.default.yaml | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/config.default.yaml b/config.default.yaml index fc53e4a0..b5560133 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -21,7 +21,7 @@ scenario: opts: # only relevant for PyPSA-Eur - '' sector_opts: # this is where the main scenario settings are - - Co2L0-3H-T-H-B-I-solar+p3-dist1 + - Co2L0-3H-T-H-B-I-A-solar+p3-dist1 # to really understand the options here, look in scripts/prepare_sector_network.py # Co2Lx specifies the CO2 target in x% of the 1990 values; default will give default (5%); # Co2L0p25 will give 25% CO2 emissions; Co2Lm0p05 will give 5% negative emissions @@ -481,6 +481,10 @@ plotting: CC: k co2: '#123456' co2 vent: '#654321' + agriculture heat: '#D07A7A' + agriculture machinery oil: '#1e1e1e' + agriculture machinery oil emissions: '#111111' + agriculture electricity: '#222222' solid biomass for industry co2 from atmosphere: '#654321' solid biomass for industry co2 to stored: '#654321' gas for industry co2 to atmosphere: '#654321' From 7f0ed1372c304838103c3382f66037640d4720ae Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 4 Oct 2021 10:02:47 +0200 Subject: [PATCH 115/132] organise release notes --- doc/release_notes.rst | 165 +++++++++++++++++++++++++++++------------- 1 file changed, 116 insertions(+), 49 deletions(-) diff --git a/doc/release_notes.rst b/doc/release_notes.rst index aaccc671..546fafb8 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -11,88 +11,155 @@ Future release PyPSA-Eur-Sec 0.6.0 (4 October 2021) ==================================== + +**General** + * With this release, we change the license from copyleft GPLv3 to the more liberal MIT license with the consent of all contributors. + + +**New features and functionality** + +* Distinguish costs for home battery storage and inverter from utility-scale + battery costs. + +* Separate basic chemicals into HVC (high-value chemicals), chlorine, methanol and ammonia + [`#166 `_]. + +* Add option to specify reuse, primary production, and mechanical and chemical + recycling fraction of platics + [`#166 `_]. + +* Include today's district heating shares in myopic optimisation and add option + to specify exogenous path for district heating share increase under ``sector: + district_heating:`` [`#149 `_]. + +* Added option for hydrogen liquefaction costs for hydrogen demand in shipping. + This introduces a new ``H2 liquid`` bus at each location. It is activated via + ``sector: shipping_hydrogen_liquefaction: true``. + +* The share of shipping transformed into hydrogen fuel cell can be now defined + for different years in the ``config.yaml`` file. The carbon emission from the + remaining share is treated as a negative load on the atmospheric carbon dioxide + bus, just like aviation and land transport emissions. + +* The transformation of the Steel and Aluminium production can be now defined + for different years in the ``config.yaml`` file. + +* Include the option to alter the maximum energy capacity of a store via the + ``carrier+factor`` in the ``{sector_opts}`` wildcard. This can be useful for + sensitivity analyses. Example: ``co2 stored+e2`` multiplies the ``e_nom_max`` by + factor 2. In this example, ``e_nom_max`` represents the CO2 sequestration + potential in Europe. + +* Use `JRC ENSPRESO database `_ to + spatially disaggregate biomass potentials to PyPSA-Eur regions based on + overlaps with NUTS2 regions from ENSPRESO (proportional to area) (`#151 + `_). + +* Add option to regionally disaggregate biomass potential to individual nodes + (previously given per country, then distributed by population density within) + and allow the transport of solid biomass. The transport costs are determined + based on the `JRC-EU-Times Bioenergy report + `_ in the new optional rule + ``build_biomass_transport_costs``. Biomass transport can be activated with the + setting ``sector: biomass_transport: true``. + +* Add option to regionally resolve CO2 storage and add CO2 pipeline transport + because geological storage potential, + CO2 utilisation sites and CO2 capture sites may be separated. The CO2 network + is built from zero based on the topology of the electricity grid (greenfield). + Pipelines are assumed to be bidirectional and lossless. Furthermore, neither + retrofitting of natural gas pipelines (required pressures are too high, 80-160 + bar vs <80 bar) nor other modes of CO2 transport (by ship, road or rail) are + considered. The regional representation of CO2 is activated with the config + setting ``sector: co2_network: true`` but is deactivated by default. The + global limit for CO2 sequestration now applies to the sum of all CO2 stores + via an ``extra_functionality`` constraint. + +* The myopic option can now be used together with different clustering for the + generators and the network. The existing renewable capacities are split evenly + among the regions in every country [`#144 `_]. + +* Add optional function to use ``geopy`` to locate entries of the Hotmaps + database of industrial sites with missing location based on city and country, + which reduces missing entries by half. It can be activated by setting + ``industry: hotmaps_locate_missing: true``, takes a few minutes longer, and + should only be used if spatial resolution is coarser than city level. + + +**Performance and Structure** + * Extended use of ``multiprocessing`` for much better performance (from up to 20 minutes to less than one minute). -* Compatibility with ``atlite>=0.2``. Older versions of ``atlite`` will no longer work. + * Handle most input files (or base directories) via ``snakemake.input``. + * Use of ``mock_snakemake`` from PyPSA-Eur. -* Update ``solve_network`` rule to match implementation in PyPSA-Eur by using ``n.ilopf()`` and remove outdated code using ``pyomo``. - Allows the new setting to skip iterated impedance updates with ``solving: options: skip_iterations: true``. + +* Update ``solve_network`` rule to match implementation in PyPSA-Eur by using + ``n.ilopf()`` and remove outdated code using ``pyomo``. + Allows the new setting to skip iterated impedance updates with ``solving: + options: skip_iterations: true``. + * The component attributes that are to be overridden are now stored in the folder ``data/override_component_attrs`` analogous to ``pypsa/component_attrs``. This reduces verbosity and also allows circumventing the ``n.madd()`` hack for individual components with non-default attributes. This data is also tracked in the Snakefile. - A function ``helper.override_component_attrs`` was added that loads this data - and can pass the overridden component attributes into ``pypsa.Network()``: - - >>> from helper import override_component_attrs - >>> overrides = override_component_attrs(snakemake.input.overrides) - >>> n = pypsa.Network("mynetwork.nc", override_component_attrs=overrides) - + and can pass the overridden component attributes into ``pypsa.Network()``. + * Add various parameters to ``config.default.yaml`` which were previously hardcoded inside the scripts (e.g. energy reference years, BEV settings, solar thermal collector models, geomap colours). + * Removed stale industry demand rules ``build_industrial_energy_demand_per_country`` and ``build_industrial_demand``. These are superseded with more regionally resolved rules. + * Use simpler and shorter ``gdf.sjoin()`` function to allocate industrial sites - from the Hotmaps database to onshore regions. - + from the Hotmaps database to onshore regions. This change also fixes a bug: The previous version allocated sites to the closest bus, but at country borders (where Voronoi cells are distorted by the borders), this had resulted in e.g. a Spanish site close to the French border being wrongly allocated to the French bus if the bus center was closer. -* Bugfix: Corrected calculation of "gas for industry" carbon capture efficiency. + * Retrofitting rule is now only triggered if endogeneously optimised. + * Show progress in build rules with ``tqdm`` progress bars. + * Reduced verbosity of ``Snakefile`` through directory prefixes. + * Improve legibility of ``config.default.yaml`` and remove unused options. -* Add optional function to use ``geopy`` to locate entries of the Hotmaps database of industrial sites - with missing location based on city and country, which reduces missing entries by half. It can be - activated by setting ``industry: hotmaps_locate_missing: true``, takes a few minutes longer, - and should only be used if spatial resolution is coarser than city level. + * Use the country-specific time zone mappings from ``pytz`` rather than a manual mapping. + * A function ``add_carrier_buses()`` was added to the ``prepare_network`` rule to reduce code duplication. + * In the ``prepare_network`` rule the cost and potential adjustment was moved into an own function ``maybe_adjust_costs_and_potentials()``. -* Use ``matplotlibrc`` to set the default plotting style and backend``. + +* Use ``matplotlibrc`` to set the default plotting style and backend. + * Added benchmark files for each rule. -* Implements changes to ``n.snapshot_weightings`` in upcoming PyPSA version (cf. `PyPSA/#227 `_). -* New dependencies: ``tqdm``, ``atlite>=0.2.4``, ``pytz`` and ``geopy`` (optional). - These are included in the environment specifications of PyPSA-Eur. + * Consistent use of ``__main__`` block and further unspecific code cleaning. -* Distinguish costs for home battery storage and inverter from utility-scale battery costs. -* Add option to regionally resolve CO2 storage and add CO2 pipeline transport because geological storage potential, - CO2 utilisation sites and CO2 capture sites may be separated. - The CO2 network is built from zero based on the topology of the electricity grid (greenfield). - Pipelines are assumed to be bidirectional and lossless. - Furthermore, neither retrofitting of natural gas pipelines (required pressures are too high, 80-160 bar vs <80 bar) - nor other modes of CO2 transport (by ship, road or rail) are considered. - The regional representation of CO2 is activated with the config setting ``sector: co2_network: true`` but is deactivated by default. - The global limit for CO2 sequestration now applies to the sum of all CO2 stores via an ``extra_functionality`` constraint. -* Added option for hydrogen liquefaction costs for hydrogen demand in shipping. - This introduces a new ``H2 liquid`` bus at each location. - It is activated via ``sector: shipping_hydrogen_liquefaction: true``. -* The share of shipping transformed into hydrogen fuel cell can be now defined for different years in the ``config.yaml`` file. The carbon emission from the remaining share is treated as a negative load on the atmospheric carbon dioxide bus, just like aviation and land transport emissions. -* The transformation of the Steel and Aluminium production can be now defined for different years in the ``config.yaml`` file. -* Include the option to alter the maximum energy capacity of a store via the ``carrier+factor`` in the ``{sector_opts}`` wildcard. This can be useful for sensitivity analyses. Example: ``co2 stored+e2`` multiplies the ``e_nom_max`` by factor 2. In this example, ``e_nom_max`` represents the CO2 sequestration potential in Europe. -* Add option to regionally disaggregate biomass potential to individual nodes - (currently given per country, then distributed by population density within) - and allow the transport of solid biomass. - The transport costs are determined based on the `JRC-EU-Times Bioenergy report `_ - in the new optional rule ``build_biomass_transport_costs``. - Biomass transport can be activated with the setting ``sector: biomass_transport: true``. -* Use `JRC ENSPRESO database `_ to - spatially disaggregate biomass potentials to PyPSA-Eur regions based on overlaps with NUTS2 regions from ENSPRESO - (proportional to area) (`#151 `_). + + +**Bugfixes and Compatibility** + +* Compatibility with ``atlite>=0.2``. Older versions of ``atlite`` will no longer work. + +* Corrected calculation of "gas for industry" carbon capture efficiency. + +* Implemented changes to ``n.snapshot_weightings`` in PyPSA v0.18.0. + * Compatibility with ``xarray`` version 0.19. -* Separate basic chemicals into HVC, chlorine, methanol and ammonia [`#166 `_]. -* Add option to specify reuse, primary production, and mechanical and chemical recycling fraction of platics [`#166 `_]. -* Include today's district heating shares in myopic optimisation and add option to specify exogenous path for district heating share increase under ``sector: district_heating:`` [`#149 `_]. -* The myopic option can now be used together with different clustering for the generators and the network. The existing renewable capacities are split evenly among the regions in every country [`#144 `_]. +* +* New dependencies: ``tqdm``, ``atlite>=0.2.4``, ``pytz`` and ``geopy`` (optional). + These are included in the environment specifications of PyPSA-Eur v0.3.0. + + PyPSA-Eur-Sec 0.5.0 (21st May 2021) =================================== From c168fd60d337ec6d1464518fee872880947ff98e Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 4 Oct 2021 11:19:15 +0200 Subject: [PATCH 116/132] add release note for agriculture, forestry and fishing --- doc/release_notes.rst | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/doc/release_notes.rst b/doc/release_notes.rst index 546fafb8..96b8b008 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -30,6 +30,20 @@ PyPSA-Eur-Sec 0.6.0 (4 October 2021) recycling fraction of platics [`#166 `_]. +* Include energy demands and CO2 emissions for the agriculture, forestry and fishing sector. + It is included by default through the option ``A`` in the ``sector_opts`` wildcard. + Part of the emissions (1.A.4.c) was previously assigned to "industry non-elec" in the ``co2_totals.csv``. + Hence, excluding the agriculture sector will now lead to a tighter CO2 limit. + Energy demands are taken from the JRC IDEES database (missing countries filled with eurostat data) + and are split into + electricity (lighting, ventilation, specific electricity uses, pumping devices (electric)), + heat (specific heat uses, low enthalpy heat) + machinery oil (motor drives, farming machine drives, pumping devices (diesel)). + Heat demand is assigned at "services rural heat" buses. + Electricity demands are added to low-voltage buses. + Time series for demands are constant and distributed inside countries by population + [`#147 `_]. + * Include today's district heating shares in myopic optimisation and add option to specify exogenous path for district heating share increase under ``sector: district_heating:`` [`#149 `_]. From 1f8c1678b816d7eed19bc2881791f19586a3ca3d Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 4 Oct 2021 14:28:27 +0200 Subject: [PATCH 117/132] add fneum --- doc/conf.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/conf.py b/doc/conf.py index b0206ff8..0af70132 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -56,14 +56,14 @@ source_suffix = '.rst' # The encoding of source files. #source_encoding = 'utf-8-sig' - +progress # The master toctree document. master_doc = 'index' # General information about the project. project = u'PyPSA-Eur-Sec' -copyright = u'2019-2020 Tom Brown (KIT), Marta Victoria (Aarhus University), Lisa Zeyen (KIT)' -author = u'2019-2020 Tom Brown (KIT), Marta Victoria (Aarhus University), Lisa Zeyen (KIT)' +copyright = u'2019-2021 Tom Brown (KIT, TUB), Marta Victoria (Aarhus University), Lisa Zeyen (KIT, TUB), Fabian Neumann (TUB)' +author = u'2019-2021 Tom Brown (KIT, TUB), Marta Victoria (Aarhus University), Lisa Zeyen (KIT, TUB), Fabian Neumann (TUB)' # The version info for the project you're documenting, acts as replacement for # |version| and |release|, also used in various other places throughout the From 19d128aafd961ad103783005cafd12f125c88251 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 4 Oct 2021 14:28:59 +0200 Subject: [PATCH 118/132] bugfix: take district heating progress not potential --- scripts/prepare_sector_network.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/prepare_sector_network.py b/scripts/prepare_sector_network.py index 645dc9e1..6d020539 100644 --- a/scripts/prepare_sector_network.py +++ b/scripts/prepare_sector_network.py @@ -1697,7 +1697,7 @@ def create_nodes_for_heat_sector(): axis=1).max(axis=1) # difference of max potential and today's share of district heating diff = (urban_fraction * central_fraction) - dist_fraction_node - progress = get(options["district_heating"]["potential"], investment_year) + progress = get(options["district_heating"]["progress"], investment_year) dist_fraction_node += diff * progress print( "The current district heating share compared to the maximum", From 2597d980e0c25cc23ba40935cfc5ae21c51358a9 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 4 Oct 2021 14:29:53 +0200 Subject: [PATCH 119/132] config: optimise default for overnight scenario for consistency planning/cost year --- config.default.yaml | 126 ++++++++++++++++++++++---------------------- 1 file changed, 63 insertions(+), 63 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index 86da859e..4aad9eb6 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -45,14 +45,14 @@ scenario: # CO2 budget as a fraction of 1990 emissions # this is over-ridden if CO2Lx is set in sector_opts # this is also over-ridden if cb is set in sector_opts -co2_budget: - 2020: 0.7011648746 - 2025: 0.5241935484 - 2030: 0.2970430108 - 2035: 0.1500896057 - 2040: 0.0712365591 - 2045: 0.0322580645 - 2050: 0 +# co2_budget: +# 2020: 0.7011648746 +# 2025: 0.5241935484 +# 2030: 0.2970430108 +# 2035: 0.1500896057 +# 2040: 0.0712365591 +# 2045: 0.0322580645 +# 2050: 0 # snapshots are originally set in PyPSA-Eur/config.yaml but used again by PyPSA-Eur-Sec snapshots: @@ -146,11 +146,11 @@ sector: potential: 0.6 # 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 = 0 means today's district heating share, progress = 1 means maximum fraction of urban demand is supplied by district heating - progress: - 2020: 0.0 - 2030: 0.3 - 2040: 0.6 - 2050: 1.0 + progress: 1 + # 2020: 0.0 + # 2030: 0.3 + # 2040: 0.6 + # 2050: 1.0 district_heating_loss: 0.15 bev_dsm_restriction_value: 0.75 #Set to 0 for no restriction on BEV DSM bev_dsm_restriction_time: 7 #Time at which SOC of BEV has to be dsm_restriction_value @@ -170,16 +170,16 @@ sector: bev_avail_mean: 0.8 v2g: true #allows feed-in to grid from EV battery #what is not EV or FCEV is oil-fuelled ICE - land_transport_fuel_cell_share: # 1 means all FCEVs - 2020: 0 - 2030: 0.05 - 2040: 0.1 - 2050: 0.15 - land_transport_electric_share: # 1 means all EVs - 2020: 0 - 2030: 0.25 - 2040: 0.6 - 2050: 0.85 + land_transport_fuel_cell_share: 0.15 # 1 means all FCEVs + # 2020: 0 + # 2030: 0.05 + # 2040: 0.1 + # 2050: 0.15 + land_transport_electric_share: 0.85 # 1 means all EVs + # 2020: 0 + # 2030: 0.25 + # 2040: 0.6 + # 2050: 0.85 transport_fuel_cell_efficiency: 0.5 transport_internal_combustion_efficiency: 0.3 agriculture_machinery_electric_share: 0 @@ -187,29 +187,29 @@ sector: agriculture_machinery_electric_efficiency: 0.3 # electricity per use shipping_average_efficiency: 0.4 #For conversion of fuel oil to propulsion in 2011 shipping_hydrogen_liquefaction: false # whether to consider liquefaction costs for shipping H2 demands - shipping_hydrogen_share: # 1 means all hydrogen FC - 2020: 0 - 2025: 0 - 2030: 0.05 - 2035: 0.15 - 2040: 0.3 - 2045: 0.6 - 2050: 1 + shipping_hydrogen_share: 1 # 1 means all hydrogen FC + # 2020: 0 + # 2025: 0 + # 2030: 0.05 + # 2035: 0.15 + # 2040: 0.3 + # 2045: 0.6 + # 2050: 1 time_dep_hp_cop: true #time dependent heat pump coefficient of performance heat_pump_sink_T: 55. # Celsius, based on DTU / large area radiators; used in build_cop_profiles.py # conservatively high to cover hot water and space heating in poorly-insulated buildings reduce_space_heat_exogenously: true # reduces space heat demand by a given factor (applied before losses in DH) # this can represent e.g. building renovation, building demolition, or if # the factor is negative: increasing floor area, increased thermal comfort, population growth - reduce_space_heat_exogenously_factor: # per unit reduction in space heat demand + reduce_space_heat_exogenously_factor: 0.29 # per unit reduction in space heat demand # the default factors are determined by the LTS scenario from http://tool.european-calculator.eu/app/buildings/building-types-area/?levers=1ddd4444421213bdbbbddd44444ffffff11f411111221111211l212221 - 2020: 0.10 # this results in a space heat demand reduction of 10% - 2025: 0.09 # first heat demand increases compared to 2020 because of larger floor area per capita - 2030: 0.09 - 2035: 0.11 - 2040: 0.16 - 2045: 0.21 - 2050: 0.29 + # 2020: 0.10 # this results in a space heat demand reduction of 10% + # 2025: 0.09 # first heat demand increases compared to 2020 because of larger floor area per capita + # 2030: 0.09 + # 2035: 0.11 + # 2040: 0.16 + # 2045: 0.21 + # 2050: 0.29 retrofitting : # co-optimises building renovation to reduce space heat demand retro_endogen: false # co-optimise space heat savings cost_factor: 1.0 # weight costs for building renovation @@ -251,32 +251,32 @@ sector: industry: - St_primary_fraction: # fraction of steel produced via primary route versus secondary route (scrap+EAF); today fraction is 0.6 - 2020: 0.6 - 2025: 0.55 - 2030: 0.5 - 2035: 0.45 - 2040: 0.4 - 2045: 0.35 - 2050: 0.3 - DRI_fraction: # fraction of the primary route converted to DRI + EAF - 2020: 0 - 2025: 0 - 2030: 0.05 - 2035: 0.2 - 2040: 0.4 - 2045: 0.7 - 2050: 1 + St_primary_fraction: 0.3 # fraction of steel produced via primary route versus secondary route (scrap+EAF); today fraction is 0.6 + # 2020: 0.6 + # 2025: 0.55 + # 2030: 0.5 + # 2035: 0.45 + # 2040: 0.4 + # 2045: 0.35 + # 2050: 0.3 + DRI_fraction: 1 # fraction of the primary route converted to DRI + EAF + # 2020: 0 + # 2025: 0 + # 2030: 0.05 + # 2035: 0.2 + # 2040: 0.4 + # 2045: 0.7 + # 2050: 1 H2_DRI: 1.7 #H2 consumption in Direct Reduced Iron (DRI), MWh_H2,LHV/ton_Steel from 51kgH2/tSt in Vogl et al (2018) doi:10.1016/j.jclepro.2018.08.279 elec_DRI: 0.322 #electricity consumption in Direct Reduced Iron (DRI) shaft, MWh/tSt HYBRIT brochure https://ssabwebsitecdn.azureedge.net/-/media/hybrit/files/hybrit_brochure.pdf - Al_primary_fraction: # fraction of aluminium produced via the primary route versus scrap; today fraction is 0.4 - 2020: 0.4 - 2025: 0.375 - 2030: 0.35 - 2035: 0.325 - 2040: 0.3 - 2045: 0.25 - 2050: 0.2 + Al_primary_fraction: 0.2 # fraction of aluminium produced via the primary route versus scrap; today fraction is 0.4 + # 2020: 0.4 + # 2025: 0.375 + # 2030: 0.35 + # 2035: 0.325 + # 2040: 0.3 + # 2045: 0.25 + # 2050: 0.2 MWh_CH4_per_tNH3_SMR: 10.8 # 2012's demand from https://ec.europa.eu/docsroom/documents/4165/attachments/1/translations/en/renditions/pdf MWh_elec_per_tNH3_SMR: 0.7 # same source, assuming 94-6% split methane-elec of total energy demand 11.5 MWh/tNH3 MWh_H2_per_tNH3_electrolysis: 6.5 # from https://doi.org/10.1016/j.joule.2018.04.017, around 0.197 tH2/tHN3 (>3/17 since some H2 lost and used for energy) From b915f08ac26f35cc5f9753c66f7504073efa4f1e Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 4 Oct 2021 17:44:17 +0200 Subject: [PATCH 120/132] installation: update to new databundle location --- doc/installation.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/doc/installation.rst b/doc/installation.rst index cbd4c948..1252771d 100644 --- a/doc/installation.rst +++ b/doc/installation.rst @@ -66,15 +66,15 @@ Data requirements ================= Small data files are included directly in the git repository, while -larger ones are archived in a data bundle. The data bundle's size is -around 640 MB. +larger ones are archived in a data bundle on zenodo (`10.5281/zenodo.5546517 `_). +The data bundle's size is around 640 MB. To download and extract the data bundle on the command line: .. code:: bash - - projects/pypsa-eur-sec/data % wget "https://nworbmot.org/pypsa-eur-sec-data-bundle-210418.tar.gz" - projects/pypsa-eur-sec/data % tar xvzf pypsa-eur-sec-data-bundle-210418.tar.gz +` + projects/pypsa-eur-sec/data % wget "https://zenodo.org/record/5546517/files/pypsa-eur-sec-data-bundle.tar.gz" + projects/pypsa-eur-sec/data % tar xvzf pypsa-eur-sec-data-bundle.tar.gz The data licences and sources are given in the following table. From c5452d98822ee91b170563d056d983fa4a4de729 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 4 Oct 2021 17:45:54 +0200 Subject: [PATCH 121/132] release_notes: opener --- doc/release_notes.rst | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/doc/release_notes.rst b/doc/release_notes.rst index bc11cb0e..01edc4d9 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -11,6 +11,22 @@ Future release PyPSA-Eur-Sec 0.6.0 (4 October 2021) ==================================== +This release includes +improvements regarding the basic chemical production, +the addition of plastics recycling, +the addition of the agriculture, forestry and fishing sector, +more regionally resolved biomass potentials, +CO2 pipeline transport and storage, and +more options in setting exogenous transition paths, +besides many performance improvements. + +This release is known to work with `PyPSA-Eur +`_ Version 0.4.0, `Technology Data +`_ Version 0.3.0 and +`PyPSA `_ Version 0.18.0. + +Please note that the data bundle has also been updated. + **General** @@ -159,6 +175,8 @@ PyPSA-Eur-Sec 0.6.0 (4 October 2021) * Consistent use of ``__main__`` block and further unspecific code cleaning. +* Updated data bundle and moved data bundle to zenodo.org (`10.5281/zenodo.5546517 `_). + **Bugfixes and Compatibility** @@ -173,6 +191,7 @@ PyPSA-Eur-Sec 0.6.0 (4 October 2021) * New dependencies: ``tqdm``, ``atlite>=0.2.4``, ``pytz`` and ``geopy`` (optional). These are included in the environment specifications of PyPSA-Eur v0.3.0. +Many thanks to all who contributed to this release! PyPSA-Eur-Sec 0.5.0 (21st May 2021) From 47e6badd58b2585573a3d07952f9efd4d1e90011 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 4 Oct 2021 17:57:18 +0200 Subject: [PATCH 122/132] doc: fix typo in conf.py --- doc/conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/conf.py b/doc/conf.py index 0af70132..d647e953 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -56,7 +56,7 @@ source_suffix = '.rst' # The encoding of source files. #source_encoding = 'utf-8-sig' -progress + # The master toctree document. master_doc = 'index' From e872595c79f9db31d325665222596e71cd6f6ee7 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 4 Oct 2021 18:02:05 +0200 Subject: [PATCH 123/132] release_notes: correct version --- doc/release_notes.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/release_notes.rst b/doc/release_notes.rst index 01edc4d9..593c420a 100644 --- a/doc/release_notes.rst +++ b/doc/release_notes.rst @@ -189,7 +189,7 @@ Please note that the data bundle has also been updated. * Compatibility with ``xarray`` version 0.19. * New dependencies: ``tqdm``, ``atlite>=0.2.4``, ``pytz`` and ``geopy`` (optional). - These are included in the environment specifications of PyPSA-Eur v0.3.0. + These are included in the environment specifications of PyPSA-Eur v0.4.0. Many thanks to all who contributed to this release! From 23a167c308f438d10e4d5608f6457e3a1d46289a Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Mon, 4 Oct 2021 18:12:19 +0200 Subject: [PATCH 124/132] config: co2_budget is currently compulsory. Add back in. --- config.default.yaml | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index 4aad9eb6..8661fa5c 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -45,14 +45,14 @@ scenario: # CO2 budget as a fraction of 1990 emissions # this is over-ridden if CO2Lx is set in sector_opts # this is also over-ridden if cb is set in sector_opts -# co2_budget: -# 2020: 0.7011648746 -# 2025: 0.5241935484 -# 2030: 0.2970430108 -# 2035: 0.1500896057 -# 2040: 0.0712365591 -# 2045: 0.0322580645 -# 2050: 0 +co2_budget: + 2020: 0.7011648746 + 2025: 0.5241935484 + 2030: 0.2970430108 + 2035: 0.1500896057 + 2040: 0.0712365591 + 2045: 0.0322580645 + 2050: 0 # snapshots are originally set in PyPSA-Eur/config.yaml but used again by PyPSA-Eur-Sec snapshots: From 7592624ef2740b9d3e2b6a475c4e03a637a8c67a Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Wed, 6 Oct 2021 16:41:10 +0200 Subject: [PATCH 125/132] add new color scheme for more distinguishing colors --- config.default.yaml | 251 ++++++++++++++++++++++++-------------------- 1 file changed, 135 insertions(+), 116 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index 8661fa5c..d19e5a2f 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -413,6 +413,7 @@ plotting: - solar thermal collector - central solar thermal collector tech_colors: + # wind onwind: "#235ebc" onshore wind: "#235ebc" offwind: "#6895dd" @@ -421,123 +422,141 @@ plotting: offshore wind (AC): "#6895dd" offwind-dc: "#74c6f2" offshore wind (DC): "#74c6f2" - wave: '#004444' - hydro: '#3B5323' - hydro reservoir: '#3B5323' - ror: '#78AB46' - run of river: '#78AB46' - hydroelectricity: '#006400' + # water + hydro: '#298c81' + hydro reservoir: '#298c81' + ror: '#3dbfb0' + run of river: '#3dbfb0' + hydroelectricity: '#298c81' + PHS: '#51dbcc' + wave: '#a7d4cf' + # solar solar: "#f9d002" solar PV: "#f9d002" - solar thermal: coral - solar rooftop: '#ffef60' - OCGT: wheat - OCGT marginal: sandybrown - OCGT-heat: '#ee8340' - gas boiler: '#ee8340' - gas boilers: '#ee8340' - gas boiler marginal: '#ee8340' - gas-to-power/heat: '#ee8340' - gas: brown - natural gas: brown - SMR: '#4F4F2F' - oil: '#B5A642' - oil boiler: '#B5A677' - lines: k - transmission lines: k - H2: m - H2 liquefaction: m - hydrogen storage: m - battery: slategray - battery storage: slategray - home battery: '#614700' - home battery storage: '#614700' - Nuclear: r - Nuclear marginal: r - nuclear: r - uranium: r - Coal: k - coal: k - Coal marginal: k - Lignite: grey - lignite: grey - Lignite marginal: grey - CCGT: '#ee8340' - CCGT marginal: '#ee8340' - heat pumps: '#76EE00' - heat pump: '#76EE00' - air heat pump: '#76EE00' - ground heat pump: '#40AA00' - power-to-heat: '#40AA00' - resistive heater: pink - Sabatier: '#FF1493' - methanation: '#FF1493' - power-to-gas: '#FF1493' - power-to-liquid: '#FFAAE9' - helmeth: '#7D0552' - DAC: '#E74C3C' - co2 stored: '#123456' - CO2 sequestration: '#123456' - CC: k - co2: '#123456' - co2 vent: '#654321' - agriculture heat: '#D07A7A' - agriculture machinery oil: '#1e1e1e' - agriculture machinery oil emissions: '#111111' - agriculture electricity: '#222222' - solid biomass for industry co2 from atmosphere: '#654321' - solid biomass for industry co2 to stored: '#654321' - gas for industry co2 to atmosphere: '#654321' - gas for industry co2 to stored: '#654321' - Fischer-Tropsch: '#44DD33' - kerosene for aviation: '#44BB11' - naphtha for industry: '#44FF55' - land transport oil: '#44DD33' - water tanks: '#BBBBBB' - hot water storage: '#BBBBBB' - hot water charging: '#BBBBBB' - hot water discharging: '#999999' - CO2 pipeline: '#999999' - CHP: r - CHP heat: r - CHP electric: r - PHS: g - Ambient: k - Electric load: b - Heat load: r - heat: darkred - rural heat: '#880000' - central heat: '#b22222' - decentral heat: '#800000' - low-temperature heat for industry: '#991111' - process heat: '#FF3333' - heat demand: darkred - electric demand: k - Li ion: grey - district heating: '#CC4E5C' - retrofitting: purple - building retrofitting: purple - BEV charger: grey - V2G: grey - land transport EV: grey - electricity: k - gas for industry: '#333333' - solid biomass for industry: '#555555' - industry electricity: '#222222' - industry new electricity: '#222222' + solar thermal: '#ffbf2b' + solar rooftop: '#ffea80' + # gas + OCGT: '#e0986c' + OCGT marginal: '#e0986c' + OCGT-heat: '#e0986c' + gas boiler: '#db6a25' + gas boilers: '#db6a25' + gas boiler marginal: '#db6a25' + gas: '#e05b09' + natural gas: '#e05b09' + CCGT: '#a85522' + CCGT marginal: '#a85522' + gas for industry co2 to atmosphere: '#692e0a' + gas for industry co2 to stored: '#8a3400' + gas for industry: '#853403' + # oil + oil: '#c9c9c9' + oil boiler: '#adadad' + agriculture machinery oil: '#949494' + shipping oil: "#808080" + # nuclear + Nuclear: '#ff8c00' + Nuclear marginal: '#ff8c00' + nuclear: '#ff8c00' + uranium: '#ff8c00' + # coal + Coal: '#545454' + coal: '#545454' + Coal marginal: '#545454' + Lignite: '#826837' + lignite: '#826837' + Lignite marginal: '#826837' + # biomass + biogas: '#e3d37d' + solid biomass: '#baa741' + solid biomass transport: '#baa741' + solid biomass for industry: '#7a6d26' + solid biomass for industry co2 from atmosphere: '#736412' + solid biomass for industry co2 to stored: '#47411c' + # power transmission + lines: '#6c9459' + transmission lines: '#6c9459' + electricity distribution grid: '#97ad8c' + # electricity demand + Electric load: '#110d63' + electric demand: '#110d63' + electricity: '#110d63' + industry electricity: '#2d2a66' + industry new electricity: '#2d2a66' + agriculture electricity: '#494778' + # battery + EVs + battery: '#ace37f' + battery storage: '#ace37f' + home battery: '#80c944' + home battery storage: '#80c944' + BEV charger: '#baf238' + V2G: '#e5ffa8' + land transport EV: '#baf238' + Li ion: '#baf238' + # hot water storage + water tanks: '#e69487' + hot water storage: '#e69487' + hot water charging: '#e69487' + hot water discharging: '#e69487' + # heat demand + Heat load: '#cc1f1f' + heat: '#cc1f1f' + heat demand: '#cc1f1f' + rural heat: '#ff5c5c' + central heat: '#cc1f1f' + decentral heat: '#750606' + low-temperature heat for industry: '#8f2727' + process heat: '#ff0000' + agriculture heat: '#d9a5a5' + # heat supply + heat pumps: '#2fb537' + heat pump: '#2fb537' + air heat pump: '#36eb41' + ground heat pump: '#2fb537' + Ambient: '#98eb9d' + CHP: '#8a5751' + CHP heat: '#8a5751' + CHP electric: '#8a5751' + district heating: '#e8beac' + resistive heater: '#c78536' + retrofitting: '#8487e8' + building retrofitting: '#8487e8' + # hydrogen + H2 for industry: "#f073da" + H2 for shipping: "#ebaee0" + H2: '#bf13a0' + SMR: '#870c71' + H2 liquefaction: '#d647bd' + hydrogen storage: '#bf13a0' + # syngas + Sabatier: '#9850ad' + methanation: '#c44ce6' + helmeth: '#e899ff' + # synfuels + Fischer-Tropsch: '#25c49a' + kerosene for aviation: '#1cfcc1' + naphtha for industry: '#57ebc4' + land transport oil: '#02bf8d' + # co2 + CC: '#9e132c' + CO2 sequestration: '#9e132c' + DAC: '#ff5270' + co2 stored: '#f2385a' + co2: '#f29dae' + co2 vent: '#ffd4dc' + CO2 pipeline: '#f5627f' + # emissions + process emissions: '#222222' process emissions to stored: '#444444' process emissions to atmosphere: '#888888' - process emissions: '#222222' - oil emissions: '#666666' - land transport oil emissions: '#666666' - land transport fuel cell: '#AAAAAA' - biogas: '#800000' - solid biomass: '#DAA520' - today: '#D2691E' - shipping: '#6495ED' - shipping oil: "#6495ED" - shipping oil emissions: "#6495ED" - electricity distribution grid: '#333333' - solid biomass transport: green - H2 for industry: "#222222" - H2 for shipping: "#6495ED" + oil emissions: '#aaaaaa' + shipping oil emissions: "#555555" + land transport oil emissions: '#777777' + agriculture machinery oil emissions: '#333333' + # other + land transport fuel cell: '#0374ff' + shipping: '#03a2ff' + power-to-heat: '#cc1f1f' + power-to-gas: '#c44ce6' + power-to-liquid: '#25c49a' + gas-to-power/heat: '#ee8340' From c095c3aa105e9e2f66f0932ff8e35c40755a49eb Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Wed, 6 Oct 2021 18:33:54 +0200 Subject: [PATCH 126/132] review with lisazeyen --- config.default.yaml | 13 +++++++++++-- scripts/plot_summary.py | 5 +---- 2 files changed, 12 insertions(+), 6 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index d19e5a2f..4a17c06f 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -449,11 +449,14 @@ plotting: gas for industry co2 to atmosphere: '#692e0a' gas for industry co2 to stored: '#8a3400' gas for industry: '#853403' + gas for industry CC: '#692e0a' + gas pipeline: '#ebbca0' # oil oil: '#c9c9c9' oil boiler: '#adadad' agriculture machinery oil: '#949494' shipping oil: "#808080" + land transport oil: '#afafaf' # nuclear Nuclear: '#ff8c00' Nuclear marginal: '#ff8c00' @@ -471,6 +474,7 @@ plotting: solid biomass: '#baa741' solid biomass transport: '#baa741' solid biomass for industry: '#7a6d26' + solid biomass for industry CC: '#47411c' solid biomass for industry co2 from atmosphere: '#736412' solid biomass for industry co2 to stored: '#47411c' # power transmission @@ -515,6 +519,7 @@ plotting: ground heat pump: '#2fb537' Ambient: '#98eb9d' CHP: '#8a5751' + CHP CC: '#634643' CHP heat: '#8a5751' CHP electric: '#8a5751' district heating: '#e8beac' @@ -526,8 +531,13 @@ plotting: H2 for shipping: "#ebaee0" H2: '#bf13a0' SMR: '#870c71' + SMR CC: '#4f1745' H2 liquefaction: '#d647bd' hydrogen storage: '#bf13a0' + land transport fuel cell: '#6b3161' + H2 pipeline: '#f081dc' + H2 Fuel Cell: '#c251ae' + H2 Electrolysis: '#ff29d9' # syngas Sabatier: '#9850ad' methanation: '#c44ce6' @@ -536,7 +546,6 @@ plotting: Fischer-Tropsch: '#25c49a' kerosene for aviation: '#1cfcc1' naphtha for industry: '#57ebc4' - land transport oil: '#02bf8d' # co2 CC: '#9e132c' CO2 sequestration: '#9e132c' @@ -546,6 +555,7 @@ plotting: co2 vent: '#ffd4dc' CO2 pipeline: '#f5627f' # emissions + process emissions: '#000000' process emissions: '#222222' process emissions to stored: '#444444' process emissions to atmosphere: '#888888' @@ -554,7 +564,6 @@ plotting: land transport oil emissions: '#777777' agriculture machinery oil emissions: '#333333' # other - land transport fuel cell: '#0374ff' shipping: '#03a2ff' power-to-heat: '#cc1f1f' power-to-gas: '#c44ce6' diff --git a/scripts/plot_summary.py b/scripts/plot_summary.py index 5b045688..a7aefb92 100644 --- a/scripts/plot_summary.py +++ b/scripts/plot_summary.py @@ -34,11 +34,8 @@ def rename_techs(label): rename_if_contains_dict = { "water tanks": "hot water storage", "retrofitting": "building retrofitting", - "H2 Electrolysis": "hydrogen storage", - "H2 Fuel Cell": "hydrogen storage", - "H2 pipeline": "hydrogen storage", "battery": "battery storage", - "CC": "CC" + # "CC": "CC" } rename = { From ca3b30e63c4ad79e3946a17c6c6de69d8dfa9b60 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Thu, 7 Oct 2021 12:15:33 +0200 Subject: [PATCH 127/132] add basic setup of rsync with files to ignore --- .syncignore-receive | 14 ++++++++++++++ .syncignore-send | 14 ++++++++++++++ 2 files changed, 28 insertions(+) create mode 100644 .syncignore-receive create mode 100644 .syncignore-send diff --git a/.syncignore-receive b/.syncignore-receive new file mode 100644 index 00000000..3ebcbea8 --- /dev/null +++ b/.syncignore-receive @@ -0,0 +1,14 @@ +.snakemake +.git +.pytest_cache +.ipynb_checkpoints +.vscode +.DS_Store +__pycache__ +*.pyc +*.pyo +*.ipynb +data +notebooks +benchmarks +*.nc \ No newline at end of file diff --git a/.syncignore-send b/.syncignore-send new file mode 100644 index 00000000..38f4b664 --- /dev/null +++ b/.syncignore-send @@ -0,0 +1,14 @@ +.snakemake +.git +.pytest_cache +.ipynb_checkpoints +.vscode +.DS_Store +__pycache__ +*.pyc +*.pyo +*.ipynb +notebooks +benchmarks +resources +results \ No newline at end of file From 0a9210ed4404da30c5648fc7c9bd6742ac1722da Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Thu, 7 Oct 2021 14:36:34 +0200 Subject: [PATCH 128/132] copy pypsa-eur config.yaml into results folder --- scripts/copy_config.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/scripts/copy_config.py b/scripts/copy_config.py index 2f329dc3..d3408dbc 100644 --- a/scripts/copy_config.py +++ b/scripts/copy_config.py @@ -5,7 +5,8 @@ files = [ "config.yaml", "Snakefile", "scripts/solve_network.py", - "scripts/prepare_sector_network.py" + "scripts/prepare_sector_network.py", + "../pypsa-eur/config.yaml" ] if __name__ == '__main__': From d26dbcb7fd652de187e39b7070911ae2134b2bcb Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Sat, 23 Oct 2021 21:16:05 +0200 Subject: [PATCH 129/132] plot: correct h2 map legend overlap, change aggregation of techs --- scripts/plot_network.py | 10 +++++++--- scripts/plot_summary.py | 9 +++++---- 2 files changed, 12 insertions(+), 7 deletions(-) diff --git a/scripts/plot_network.py b/scripts/plot_network.py index 5182123b..7b8bce4c 100644 --- a/scripts/plot_network.py +++ b/scripts/plot_network.py @@ -19,9 +19,11 @@ def rename_techs_tyndp(tech): tech = rename_techs(tech) if "heat pump" in tech or "resistive heater" in tech: return "power-to-heat" - elif tech in ["methanation", "hydrogen storage", "helmeth"]: + elif tech in ["H2 Electrolysis", "methanation", "helmeth", "H2 liquefaction"]: return "power-to-gas" - elif tech in ["OCGT", "CHP", "gas boiler"]: + elif tech == "H2": + return "H2 storage" + elif tech in ["OCGT", "CHP", "gas boiler", "H2 Fuel Cell"]: return "gas-to-power/heat" elif "solar" in tech: return "solar" @@ -29,6 +31,8 @@ def rename_techs_tyndp(tech): return "power-to-liquid" elif "offshore wind" in tech: return "offshore wind" + elif "CC" in tech or "sequestration" in tech: + return "CCS" else: return tech @@ -283,7 +287,7 @@ def plot_h2_map(network): l2 = ax.legend( handles, labels, loc="upper left", - bbox_to_anchor=(0.01, 1.01), + bbox_to_anchor=(-0.03, 1.01), labelspacing=1.0, frameon=False, title='Electrolyzer capacity', diff --git a/scripts/plot_summary.py b/scripts/plot_summary.py index 5b045688..341f812c 100644 --- a/scripts/plot_summary.py +++ b/scripts/plot_summary.py @@ -34,11 +34,11 @@ def rename_techs(label): rename_if_contains_dict = { "water tanks": "hot water storage", "retrofitting": "building retrofitting", - "H2 Electrolysis": "hydrogen storage", - "H2 Fuel Cell": "hydrogen storage", - "H2 pipeline": "hydrogen storage", + # "H2 Electrolysis": "hydrogen storage", + # "H2 Fuel Cell": "hydrogen storage", + # "H2 pipeline": "hydrogen storage", "battery": "battery storage", - "CC": "CC" + # "CC": "CC" } rename = { @@ -90,6 +90,7 @@ preferred_order = pd.Index([ "offshore wind (DC)", "solar PV", "solar thermal", + "solar rooftop", "solar", "building retrofitting", "ground heat pump", From 2a0855915c3f685d44e359091d799051ed719d64 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Sat, 23 Oct 2021 21:23:01 +0200 Subject: [PATCH 130/132] add review suggestion for p2h technologies --- config.default.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index 4a17c06f..8c245fd6 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -523,7 +523,7 @@ plotting: CHP heat: '#8a5751' CHP electric: '#8a5751' district heating: '#e8beac' - resistive heater: '#c78536' + resistive heater: '#d8f9b8' retrofitting: '#8487e8' building retrofitting: '#8487e8' # hydrogen @@ -565,7 +565,7 @@ plotting: agriculture machinery oil emissions: '#333333' # other shipping: '#03a2ff' - power-to-heat: '#cc1f1f' + power-to-heat: '#2fb537' power-to-gas: '#c44ce6' power-to-liquid: '#25c49a' gas-to-power/heat: '#ee8340' From 04a6685e07ec8d9594c6ab32f6709c7b22535450 Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Sat, 23 Oct 2021 21:23:34 +0200 Subject: [PATCH 131/132] add additional aliases and colors --- config.default.yaml | 18 ++++++++++++++---- 1 file changed, 14 insertions(+), 4 deletions(-) diff --git a/config.default.yaml b/config.default.yaml index 8c245fd6..48630b89 100644 --- a/config.default.yaml +++ b/config.default.yaml @@ -466,11 +466,13 @@ plotting: Coal: '#545454' coal: '#545454' Coal marginal: '#545454' + solid: '#545454' Lignite: '#826837' lignite: '#826837' Lignite marginal: '#826837' # biomass biogas: '#e3d37d' + biomass: '#baa741' solid biomass: '#baa741' solid biomass transport: '#baa741' solid biomass for industry: '#7a6d26' @@ -530,10 +532,12 @@ plotting: H2 for industry: "#f073da" H2 for shipping: "#ebaee0" H2: '#bf13a0' + hydrogen: '#bf13a0' SMR: '#870c71' SMR CC: '#4f1745' H2 liquefaction: '#d647bd' hydrogen storage: '#bf13a0' + H2 storage: '#bf13a0' land transport fuel cell: '#6b3161' H2 pipeline: '#f081dc' H2 Fuel Cell: '#c251ae' @@ -541,21 +545,24 @@ plotting: # syngas Sabatier: '#9850ad' methanation: '#c44ce6' + methane: '#c44ce6' helmeth: '#e899ff' # synfuels Fischer-Tropsch: '#25c49a' - kerosene for aviation: '#1cfcc1' + liquid: '#25c49a' + kerosene for aviation: '#a1ffe6' naphtha for industry: '#57ebc4' # co2 - CC: '#9e132c' - CO2 sequestration: '#9e132c' + CC: '#f29dae' + CCS: '#f29dae' + CO2 sequestration: '#f29dae' DAC: '#ff5270' co2 stored: '#f2385a' co2: '#f29dae' co2 vent: '#ffd4dc' CO2 pipeline: '#f5627f' # emissions - process emissions: '#000000' + process emissions CC: '#000000' process emissions: '#222222' process emissions to stored: '#444444' process emissions to atmosphere: '#888888' @@ -567,5 +574,8 @@ plotting: shipping: '#03a2ff' power-to-heat: '#2fb537' power-to-gas: '#c44ce6' + power-to-H2: '#ff29d9' power-to-liquid: '#25c49a' gas-to-power/heat: '#ee8340' + waste: '#e3d37d' + other: '#000000' \ No newline at end of file From e6f4479544c6d45cafe725dd914230ba6310d28d Mon Sep 17 00:00:00 2001 From: Fabian Neumann Date: Thu, 28 Oct 2021 09:58:45 +0200 Subject: [PATCH 132/132] doc: add EMP-E presentation and speed preprint --- README.md | 17 ++++++++++------- doc/index.rst | 25 +++++++++++++++++++++++-- 2 files changed, 33 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index f4cc34cc..b6929873 100644 --- a/README.md +++ b/README.md @@ -9,13 +9,16 @@ -**WARNING**: This model is under construction and contains serious -problems that distort the results. See the github repository -[issues](https://github.com/PyPSA/pypsa-eur-sec/issues) for some of -the problems (please feel free to help or make suggestions). There is -neither documentation nor a paper yet, but we hope to have a preprint -out by autumn 2021. We cannot support this model if you choose to use -it. +**WARNING**: This model is under construction and contains serious problems that +distort the results. See the github repository +[issues](https://github.com/PyPSA/pypsa-eur-sec/issues) for some of the problems +(please feel free to help or make suggestions). There is neither a full +documentation nor a paper yet, but we hope to have a preprint out by the end of 2021. +You can find out more about the model capabilities in [a recent +presentation at EMP-E](https://nworbmot.org/energy/brown-empe.pdf) or the +following [preprint with a description of the industry +sector](https://arxiv.org/abs/2109.09563). We cannot support this model if you +choose to use it. PyPSA-Eur-Sec builds on the electricity generation and transmission diff --git a/doc/index.rst b/doc/index.rst index 0c6f929d..c4174b52 100644 --- a/doc/index.rst +++ b/doc/index.rst @@ -29,6 +29,11 @@ heating, biomass, industry and industrial feedstocks. This completes the energy system and includes all greenhouse gas emitters except waste management, agriculture, forestry and land use. +.. note:: + More about the current model capabilities and preliminary results + can be found in `a recent presentation at EMP-E `_ + and the the following `preprint with a description of the industry sector `_. + This diagram gives an overview of the sectors and the links between them: @@ -61,9 +66,25 @@ PyPSA-Eur-Sec is the different extra_functionality required to build storage and CHP constraints. -PyPSA-Eur-Sec is designed to be imported into the open toolbox `PyPSA `_ for which `documentation `_ is available as well. +PyPSA-Eur-Sec is designed to be imported into the open toolbox `PyPSA +`_ for which `documentation `_ is +available as well. -This project is maintained by the `Energy System Modelling group `_ at the `Institute for Automation and Applied Informatics `_ at the `Karlsruhe Institute of Technology `_. The group is funded by the `Helmholtz Association `_ until 2024. Previous versions were developed by the `Renewable Energy Group `_ at `FIAS `_ to carry out simulations for the `CoNDyNet project `_, financed by the `German Federal Ministry for Education and Research (BMBF) `_ as part of the `Stromnetze Research Initiative `_. +This project is currently maintained by the `Department of Digital +Transformation in Energy Systems `_ at the +`Technical University of Berlin `_. Previous versions +were developed by the `Energy System Modelling group +`_ at the `Institute for Automation +and Applied Informatics `_ at the +`Karlsruhe Institute of Technology `_ +which was funded by the `Helmholtz Association `_, +and by the `Renewable Energy Group +`_ +at `FIAS `_ to carry out simulations for the +`CoNDyNet project `_, financed by the `German Federal +Ministry for Education and Research (BMBF) `_ +as part of the `Stromnetze Research Initiative +`_. Documentation