diff --git a/doc/index.rst b/doc/index.rst old mode 100644 new mode 100755 index 84f682f0..2f754840 --- a/doc/index.rst +++ b/doc/index.rst @@ -116,6 +116,17 @@ Documentation installation +**Myopic transition path** + +* :doc:`myopic` + +.. toctree:: + :hidden: + :maxdepth: 1 + :caption: Myopic transition path + + myopic + **References** * :doc:`release_notes` diff --git a/doc/installation.rst b/doc/installation.rst old mode 100644 new mode 100755 index 0698d602..9fab3cb6 --- a/doc/installation.rst +++ b/doc/installation.rst @@ -16,7 +16,7 @@ its dependencies. Clone the repository: .. code:: bash - projects % git clone git@github.com:PyPSA/pypsa-eur-sec.git + projects % git clone git@github.com:PyPSA/pypsa-eur.git then download and unpack all the PyPSA-Eur data files. diff --git a/doc/myopic.rst b/doc/myopic.rst new file mode 100755 index 00000000..669e374d --- /dev/null +++ b/doc/myopic.rst @@ -0,0 +1,114 @@ +.. _myopic: + +########################################## +Myopic transition path +########################################## + +The myopic code can be used to investigate progressive changes in a network, for instance, those taking place throughout a transition path. The capacities installed in a certain time step are maintained in the network until their operational lifetime expires. + +The myopic approach was initially developed and used in the paper [Early decarbonisation of the European Energy system pays off (2020)](https://arxiv.org/abs/2004.11009) but the current implementation complies with the pypsa-eur-sec standard working flow and is compatible with using the higher resolution electricity transmission model [PyPSA-Eur](https://github.com/PyPSA/pypsa-eur) rather than a one-node-per-country model, as well as including industry, industrial feedstocks, aviation, shipping, better carbon management, carbon capture and usage/sequestration, and gas networks. + +The current code applies the myopic approach to generators, storage technologies and links in the power sector and the space and water heating sector. + +The transport sector and industry and are not affected by the myopic code. In essence, the electrification of road and rail transport, the percentage of electric vehicles that allow demand-side management and vehicle-to-grid services, and the transformation in the different industrial subsectors do not evolve with time. They are kept fixed at the values specified in the configuration file. + + + +Configuration +================= + +PyPSA-Eur-Sec has several configuration options which are collected in a config.yaml file located in the root directory. Users should copy the provided default configuration (config.default.yaml) and amend their own modifications and assumptions in the user-specific configuration file (config.yaml). The following options included in the config.yaml file are relevant for the myopic code. + +To activate the myopic option select + +foresight: 'myopic' + + + +**existing capacities** + +Grouping years indicates the bins limits for grouping the existing capacities of different technologies + +grouping_years: [1980, 1985, 1990, 1995, 2000, 2005, 2010, 2015, 2019] + + + +**threshold capacity** + +if for a technology and grouping bin, the capacity is lower than threshold_capacity, it is ignored + +threshold_capacity: 10 + + + +**conventional carriers** + +conventional carriers indicate carriers used in the existing conventional technologies + +conventional_carriers: ['lignite', 'coal', 'oil', 'uranium'] + + +Wildcards +============================== + +**The {planning_horizons} wildcard** + +The {planning_horizons} wildcard indicates the timesteps in which the network is optimized, e.g. planning_horizons: [2020, 2030, 2040, 2050] + + + +**The {co2_budget_name} wildcard** + +The {co2_budget_name} wildcard indicates the name of the co2 budget. + +A csv file is used as input including the planning_horizons as index, the name of co2_budget as column name and the maximum co2 emissions (relative to 1990) as values. + +Rules overview +================= + +## General myopic code structure + +The myopic code solves the network for the time steps included in planning_horizons in a recursive loop, so that + +1.The existing capacities (those installed before the base year are added as fixed capacities with p_nom=value, p_nom_extendable=False). E.g. for baseyear=2020, capacities installed before 2020 are added. In addition, the network comprises additional generator, storage, and link capacities with p_nom_extendable=True. The non-solved network is saved in ‘results/run_name/networks/prenetworks_bronwfield’. + +Base year is the first element in planning_horizons. + + + +2.The 2020 network is optimized, and the optimized capacities are renamed eg. solar-2020, onwind-2020. The solved network is saved in ‘results/run_name/networks/postnetworks’ + + + +3.For the next planning horizon, e.g. 2030, the capacities from a previous time step are added if they are still in operation (i.e., if they fulfil planning horizon < commissioned year + lifetime). In addition, the network comprises additional generator, storage, and link capacities with p_nom_extendable=True. The non-solved network is saved in ‘networks/prenetworks_bronwfield’. + +Steps 2 and 3 are solved recursively for all the planning_horizons included in the configuration file + + + +## **add_existing baseyear** + +The rule add_existing_baseyear loads the network in ‘results/run_name/networks/prenetworks’ and performs the following operations: + +1.Add the conventional, wind and solar power generators that were installed before the base year. + +2.Add the heating capacities that were installed before the base year. + +The existing conventional generators are retrieved from the [powerplants.csv file](https://pypsa-eur.readthedocs.io/en/latest/preparation/build_powerplants.html?highlight=powerplants) generated by pypsa-eur which, in turn, is based on the [powerplantmatching](https://github.com/FRESNA/powerplantmatching) database. + +Existing wind and solar capacities are retrieved from [IRENA annual statistics](https://www.irena.org/Statistics/Download-Data) and distributed among the nodes in a country proportional to capacity factor. (This will be updated to include capacity distribution closer to reality.) + +Existing heating capacity factors are retrieved from the report [Mapping and analyses of the current and future (2020 - 2030) heating/cooling fuel deployment (fossil/renewables)](https://ec.europa.eu/energy/studies/mapping-and-analyses-current-and-future-2020-2030-heatingcooling-fuel-deployment_en?redir=1) + +The heating capacities are assumed to have a lifetime indicated by the parameter lifetime in the configuration file, e.g 25 years. They are assumed to be decommissioned linearly starting on the base year, e.g., from 2020 to 2045. + +Then, the resulting network is saved in ‘results/run_name/networks/prenetworks’ + +## **add_brownfield** + +The rule add_brownfield loads the network in ‘results/run_name/networks/prenetworks’ and performs the following operation: + +1.Read the capacities optimized in the previous time step and add them to the network if they are still in operation (i.e., if they fulfil planning horizon < commissioned year + lifetime) + +Then, the resulting network is saved in ‘results/run_name/networks/prenetworks_brownfield.’ +