PETLION – Porous Electrode Theory for Li-ion Batteries

High-performance simulations of the pseudo-2D porous electrode theory (PET) model in Julia

Built for efficient controls, parameter estimation, and other complex battery simulations using the rigorous PET model
Runs a full charge or discharge with 301 DAEs in ~3 ms on a laptop with 1 MB total memory usage
Includes thermal and aging modes

Installation

After installing Julia, run the following command to add the PETLION package

import Pkg; Pkg.add("PETLION")

Getting started

To get started, we recommend checking out the list of examples. To simulate a constant current-constant temperature-constant voltage (CC-CT-CV) fast charge, run the following:

using PETLION
p = petlion(LCO; temperature=true)

sol = simulate(p, I=4, SOC=0, V_max=4.1, T_max=40+273.15)
simulate!(sol, p, dT=:hold, V_max=4.1)
simulate!(sol, p, V=:hold)

julia> PETLION simulation
 --------
 Runs:    I → dT → V
 Time:    1865.61 s
 Current: 0.1959C
 Voltage: 4.1 V
 Power:   23.47 W/m²
 SOC:     1.0
 Temp.:   25.6963 °C
 Exit:    Above max. SOC

Credits

Marc D. Berliner – Creating and maintaining the code
Richard D. Braatz – Technical oversight
Richard B. Canty – Designing the PETLION logo

Citations

If you use PETLION in your work, please cite the paper:

@article{berliner2021petlion,
  title={Methods---{PETLION}: Open-Source Software for Millisecond-Scale Porous Electrode Theory-Based Lithium-Ion Battery Simulations},
  author={Berliner, Marc D and Cogswell, Daniel A and Bazant, Martin Z and Braatz, Richard D},
  journal={Journal of The Electrochemical Society},
  volume={168},
  number={9},
  pages={090504},
  year={2021},
  publisher={IOP Publishing}
}

Acknowledgements