Simulink Model for Thermal Runaway of a Single Li-ion Cell using the Hatchard-Kim Reaction Mechanism and 0D Lumped Body Approach

<p><strong>Purpose:</strong></p> <p>This Simulink<sup>(R)</sup> model may be used to simulate thermal runaway in Li-ion battery cells.  The model tracks the cell temperature, heat generation rate, total heat released, and progress of decomposition reactions.  The model layout is designed for a friendly user experience,  allowing the user to easily modify geometric parameters, thermal boundary and initial conditions, and reaction kinetic parameters.</p> <p><strong>Method:</strong></p> <p>Refer to the included white paper or <a href="https://youtu.be/Gm5Pnet3qks?feature=shared">YouTube video</a> for more information on theory and numerical methods used.  </p> <p><iframe align="middle" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen="" frameborder="0" height="315" referrerpolicy="strict-origin-when-cross-origin" scrolling="no" src="https://www.youtube.com/embed/Gm5Pnet3qks?si=An59tTdZHC_eVV_J" title="YouTube video player" width="560"></iframe></p> <p><strong>Bundle Includes:</strong></p> <ul> <li>Simulink model, version 2018a</li> <li>Simulink model, version 2024a</li> <li>White paper with description of model theory, mathematical framework, description of model, and presentation of results</li> <li>Results file in tab-delimited text format (.DAT)</li> </ul> <p><strong>Quick-Start Guide:</strong></p> <ol> <li>Download bundle</li> <li>Launch MATLAB</li> <li>Move the Simulink file (.SLX) of choice to the MATLAB working directory</li> <li>Launch the Simulink model file</li> <li>Run the simulation by clicking the green arrow in the ribbon at the top of the Simulink window</li> <li>View results by double clicking on "scope" icons within the Simulink model or by inspecting data in the MATLAB workspace</li> </ol> <p><strong>References:</strong></p> <p>[1]    T. D. Hatchard, D. D. MacNeil, A. Basu, and J. R. Dahn, "Thermal model of cylindrical and prismatic lithium-ion cells," J Electrochem Soc, vol. 148, no. 7, pp. A755-A761, 2001, doi: 10.1149/1.1377592.</p> <p>[2]    G.-H. Kim, A. Pesaran, and R. Spotnitz, "A three-dimensional thermal abuse model for lithium-ion cells," J Power Sources, vol. 170, no. 2, pp. 476-489, 2007, doi: 10.1016/j.jpowsour.2007.04.018.<br />  </p>