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>