Lemonergy Wiki

Concepts and methods

Thermal propagation verification examples

Explore finite heat release, bidirectional exchange, sampled triggering and energy accounting in four synthetic models.

Document created Updated
Draft explanationSource record reviewed

Purpose and governing balance

These four editable models test equations and event handling with authored synthetic inputs. Their independent references use closed-form thermal balances between events.

For each cell: C·dTi/dt = Pi − H·(Ti − Tambient) + G·(Tj − Ti). The coupling terms have opposite signs in the two cells. Released and ambient energy are integrated separately.

The energy residual is C·Σ(Ti − Ti,initial) + Eambient − ΣErelease,i. The one-cell case omits the coupling term.

Choose a case

Related research and model scope

The thermal-runaway modeling review by Tran and colleagues places these simplified balances in the broader context of heat generation, transport, prediction and detection. Use it to identify the physical mechanisms a real-cell study may require; these four verification cases do not reproduce or validate the experiments discussed in that review.

Events and gates

The trigger depends on the prepared case. These are authored benchmark choices, not measured ignition temperatures or cell datasheet ratings. The linked example pages provide the complete inputs, original model and reference evidence.

Prepared caseInitial release commandNeighbor conditionSample interval (s)Observation end (s)
Passive exchangeNone; no heat releaseNoneNot sampled100
Finite releaseTime seed at 2 sNo second cell0.130
Triggered propagationCell 1 time seed at 0 sCell 2 temperature strictly greater than 320 K0.140
Reduced couplingCell 1 time seed at 0 sSame 320 K condition; not reached in this observation window0.140

In the three heat-release cases, a trigger latches permanently and starts a 200 W pulse. The pulse ends after 100 sample intervals (10 s) and releases 2,000 J. Temperatures and energy remain continuous; latch and heat observations use the new right-hand value at event times.

Fixed absolute gates are 1e−6 K for temperature, 1e−10 W for heat power, 1e−3 J for released energy, ambient energy and residual, and exactly zero error for latch values. The full horizon and every required sample boundary are checked.

What the recorded passes mean

All four native cases passed in the October 1, 2026 report. MATLAB evidence was not supplied. The separate MATLAB script implements these reduced balances and events; it does not execute the vendor Simscape ARC model.

The models omit reaction kinetics, gas, flame, venting, radiation, ejecta, electrochemistry and changing material properties. No trigger during a finite synthetic observation window is not evidence of a safe physical barrier or certification.

This is a historical result tied to its retained inputs, settings, reference version and source fingerprints. The current source tree or Wasm artifact may differ; a new Studio run creates new evidence and does not retroactively update this result.

Models and evidence

Downloads preserve recorded inputs and results. Opening a saved result does not run a new simulation.

Related papers and references

  • paper

    A Review of Lithium-Ion Battery Thermal Runaway Modeling and Diagnosis Approaches

    Manh-Kien Tran; Anosh Mevawalla; Attar Aziz; Satyam Panchal; Yi Xie; Michael Fowler · MDPI — Processes · 2022-06-15

    A review connecting thermal-runaway model choices with prediction and detection methods; background for understanding what a numerical verification case can and cannot establish.

    Read original · DOI 10.3390/pr10061192

    Source description · Abstract and Sections 3–4: thermal-runaway models, prognosis and diagnosis. Background reading; the numerical verification cases do not reproduce a reviewed experiment.