Skip to content

Commit

Permalink
Updates docs
Browse files Browse the repository at this point in the history
  • Loading branch information
@romainsacchi
romainsacchi committed Aug 4, 2024
1 parent 1b59f34 commit 562c5c4
Show file tree
Hide file tree
Showing 11 changed files with 735 additions and 18 deletions.
120 changes: 110 additions & 10 deletions docs/transform.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -11,10 +11,6 @@ Inventories for several battery technologies for mobile applications are provide
in *premise*. See EXTRACT/Import of additional inventories/Li-ion batteries for
additional information.

*premise* adjusts the mass of battery packs throughout the database
to reflect progress in specific energy density (kWh/kg cell).


Run

.. code-block:: python
Expand Down Expand Up @@ -75,6 +71,9 @@ Sodium-ion, SiB 0.22 75%
====================== ==================================== ==================== ==================
*premise* adjusts the mass of battery packs throughout the database
to reflect progress in specific energy density (kWh/kg cell).
For example, in 2050, the mass of NMC811 batteries (cells and Balance of Plant) is expected to
be 0.5/0.22 = 2.3 times lower for a same energy capacity. The report of changes
shows the new mass of battery packs for each activity using them.
Expand Down Expand Up @@ -108,6 +107,110 @@ market for battery capacity, Sodium-ion, SiB GLO 8.33
Changing the target values in the YAML file will change the scaling factors
and the mass of battery packs per kWh in the database.
Finally, *premise* also create a technology-average dataset for mobile batteries
according to four scenarios provided in Degen_ et al, 2023.:
============================================= =========== ===================================================================
Name Location Description
============================================= =========== ===================================================================
market for battery capacity (LFP scenario) GLO LFP dominates the market for mobile batteries.
market for battery capacity (NCx scenario) GLO NCA and NCM dominate the market for mobile batteries.
market for battery capacity (PLiB scenario) GLO Post-lithium batteries dominate the market for mobile batteries.
market for battery capacity (MIX scenario) GLO A mix of lithium and post-lithium batteries dominates the market.
============================================= =========== ===================================================================
These datasets provide 1 kWh of battery capacity, and the technology
shares are adjusted over time with values found
under https://github.com/polca/premise/blob/master/premise/data/battery/scenario.csv.
.. _Degen: https://doi.org/10.1016/j.joule.2023.01.001
Stationary batteries
""""""""""""""""""""
Inventories for several battery technologies for stationary applications are provided:
* Lithium-ion batteries (NMC-111, NMC-622, NMC-811, LFP)
* Lead-acid batteries
* Vanadium redox flow batteries (VRFB)
As for batteries for mobile applications, *premise* adjusts the mass of battery packs
throughout the database to reflect progress in specific energy density (kWh/kg cell).
The current specific energy densities are given in the table below.
====================== ==================================== ==================== ==================
Type Specific energy density (current) BoP mass share [%] Battery energy
[kWh/kg cell] density [kWh/kg
battery]
====================== ==================================== ==================== ==================
Li-ion, NMC111 0.15 73% 0.11
Li-ion, NMC622 0.20 73% 0.15
Li-ion, NMC811 0.22 71% 0.16
Li-ion, LFP 0.14 73% 0.10
Sodium-ion, SiB 0.16 75% 0.12
Lead-acid 0.03 80% 0.02
VRFB 0.02 75% 0.02
====================== ==================================== ==================== ==================
The future specific energy densities are given in the table below.
====================== ==================================== ==================== ==================
Type Specific energy density (2050) BoP mass share [%] Battery energy
[kWh/kg cell] density [kWh/kg
battery]
====================== ==================================== ==================== ==================
Li-ion, NMC111 0.2 73% 0.15
Li-ion, NMC811 0.5 71% 0.36
Li-ion, NCA 0.35 71% 0.25
Li-ion, LFP 0.25 73% 0.18
Sodium-ion, SiB 0.22 75% 0.17
Lead-acid 0.04 80% 0.03
VRFB 0.04 75% 0.03
====================== ==================================== ==================== ==================
The target values used for scaling can be modified by the user.
The YAML file is located under premise/data/battery/energy_density.yaml.
For each battery technology *premise* creates a market dataset that represents the
supply of 1 kWh of electricity stored in a battery of the given technology.
The table below shows the market for battery capacity datasets created by *premise*.
========================================================================== =========== ============================= ===============================
Name Location Kg per kWh in 2020 (kg/kWh) Kg per kWh in 2050 (kg/KWh)
========================================================================== =========== ============================= ===============================
market for battery capacity, Li-ion, LFP, stationary GLO 8.6 6.22
market for battery capacity, Li-ion, NMC111, stationary GLO 7.61 6.85
market for battery capacity, Li-ion, NMC523, stationary GLO 6.85 6.23
market for battery capacity, Li-ion, NMC622, stationary GLO 5.71 5.27
market for battery capacity, Li-ion, NMC811, stationary GLO 5.03 4.14
market for battery capacity, Li-ion, NMC955, stationary GLO 4.14 3.71
market for battery capacity, Sodium-Nickel-Chloride, Na-NiCl, stationary GLO 8.62 8.62
market for battery capacity, Sodium-ion, SiB, stationary GLO 8.33 6.54
market for battery capacity, lead acid, rechargeable, stationary GLO 33.33 28.60
market for battery capacity, redox-flow, Vanadium, stationary GLO 51.55 25.00
========================================================================== =========== ============================= ===============================
Changing the target values in the YAML file will change the scaling factors
and the mass of battery packs per kWh in the database.
Finally, *premise* also create a technology-average dataset for stationary batteries
according to three scenarios provided in Schlichenmaier_ & Naegler, 2022:
======================================================== =========== =============================================================================
Name Location Description
======================================================== =========== =============================================================================
market for battery capacity, stationary (CONT scenario) GLO LFP and NMC dominate the market for stationary batteries.
market for battery capacity, stationary (TC scenario) GLO Vanadium Redox Flow batteries dominate the market for stationary batteries.
======================================================== =========== =============================================================================
.. _Schlichenmaier: https://doi.org/10.1016/j.egyr.2022.11.025
`market for battery capacity, stationary (CONT scenario)` supplies any storage
capacity needed in high voltage electricity markets.
Biomass
"""""""
Expand Down Expand Up @@ -161,12 +264,9 @@ The following market is created for each IAM region:
inside of which, the shares of "purpose grown" and "residual" biomass
is represented by the following activities:
========================== ===================================== ======================================= ===========================
name in premise name in REMIND name in IMAGE name in LCI database
========================== ===================================== ======================================= ===========================
biomass - purpose grown SE|Electricity|Biomass|Energy Crops Primary Energy|Biomass|Energy Crops market for wood chips
biomass - residual SE|Electricity|Biomass|Residues Primary Energy|Biomass|Residues supply of forest residue
========================== ===================================== ======================================= ===========================
* market for wood chips (for "purpose grown" biomass)
* market for wood chips (for "purpose grown" woody biomass)
* supply of forest residue (for "residual" biomass)
The sum of those shares equal 1. The activity "supply of forest residue" includes
the energy, embodied biogenic CO2, transport and associated emissions to chip the residual biomass
Expand Down
Binary file modified premise/data/additional_inventories/lci-PV-perovskite.xlsx
View file
Binary file not shown.
Binary file modified premise/data/additional_inventories/lci-batteries-LiS.xlsx
View file
Binary file not shown.
Binary file modified premise/data/additional_inventories/lci-batteries-SIB.xlsx
View file
Binary file not shown.
Binary file added premise/data/additional_inventories/lci-batteries-vanadium-redox-flow.xlsx
View file
Binary file not shown.
0 .../additional_inventories/lci-vanadium.xlsx → ...l_inventories/lci-batteries-vanadium.xlsx
View file
File renamed without changes.
Binary file modified premise/data/additional_inventories/lci-battery-capacity.xlsx
View file
Binary file not shown.
40 changes: 40 additions & 0 deletions premise/data/battery/energy_density.yaml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ NMC111:
- market for battery cell, Li-ion, NMC111
- market for battery, Li-ion, NMC111, rechargeable, prismatic
- market for battery capacity, Li-ion, NMC111
- market for battery capacity, Li-ion, NMC111, stationary
target:
# values from https://doi.org/10.3390/batteries9070379.
2020:
Expand All @@ -25,6 +26,7 @@ NMC523:
name:
- market for battery, Li-ion, NMC523
- market for battery capacity, Li-ion, NMC523
- market for battery capacity, Li-ion, NMC523, stationary
target:
# values from https://doi.org/10.3390/batteries9070379.
2020:
Expand All @@ -44,6 +46,7 @@ NMC622:
- market for battery cell, Li-ion, NMC622
- market for battery, Li-ion, NMC622, rechargeable, prismatic
- market for battery capacity, Li-ion, NMC622
- market for battery capacity, Li-ion, NMC622, stationary
target:
# values from https://doi.org/10.3390/batteries9070379.
2020:
Expand All @@ -63,6 +66,7 @@ NMC811:
- market for battery cell, Li-ion, NMC811
- market for battery, Li-ion, NMC811, rechargeable, prismatic
- market for battery capacity, Li-ion, NMC811
- market for battery capacity, Li-ion, NMC811, stationary
target:
# values from https://doi.org/10.3390/batteries9070379.
2020:
Expand All @@ -82,6 +86,7 @@ NMC955:
name:
- market for battery, Li-ion, NMC955
- market for battery capacity, Li-ion, NMC955
- market for battery capacity, Li-ion, NMC955, stationary
target:
# values from https://doi.org/10.3390/batteries9070379.
2020:
Expand Down Expand Up @@ -120,6 +125,7 @@ LFP:
- market for battery cell, Li-ion, LFP
- market for battery, Li-ion, LFP, rechargeable, prismatic
- market for battery capacity, Li-ion, LFP
- market for battery capacity, Li-ion, LFP, stationary
target:
# values from https://doi.org/10.3390/batteries9070379.
2020:
Expand Down Expand Up @@ -217,3 +223,37 @@ SiB:
mean: 0.200
minimum: 0.160
maximum: 0.220

VRFB:
ecoinvent_aliases:
name:
- market for battery, redox-flow, Vanadium
- market for battery capacity, redox-flow, Vanadium, stationary
target:
# current value from https://doi.org/10.1021/acs.est.8b02073; http://dx.doi.org/10.1016/j.apenergy.2014.09.081
2020:
mean: 0.0194
minimum: 0.010
maximum: 0.030
# future value doubles, from https://doi.org/10.1039/C7CP07456E
2050:
mean: 0.040
minimum: 0.020
maximum: 0.060

LEAD-ACID:
ecoinvent_aliases:
name:
- market for battery capacity, lead acid, rechargeable, stationary
- market for battery, lead acid, rechargeable, stationary
target:
# current value from http://dx.doi.org/10.1016/j.rser.2014.10.072
2020:
mean: 0.030
minimum: 0.027
maximum: 0.032
# future values from https://doi.org/10.1007/s41918-022-00134-w
2050:
mean: 0.035
minimum: 0.030
maximum: 0.040
Loading

0 comments on commit 562c5c4

Please sign in to comment.