Ionworks

Battery thermal modeling

A battery thermal model predicts how a cell heats up under load by coupling the irreversible and entropic heat sources in the electrochemistry to heat transfer through the cell, its tabs, and the cooling interface.

The engineering question is when thermal modeling actually changes a design decision, and at what level of fidelity. This page maps that out.

What a battery thermal model is

A battery thermal model predicts cell and cell-component temperature over time, coupled to the electrochemical heat sources that drive it.

Thermal models sit on top of an electrochemical model. The electrochemistry produces heat from irreversible losses and from entropic reactions. The thermal model spreads that heat through the cell, the tabs, and the cooling interface. The coupling is two-way: temperature changes kinetics, transport, and degradation rates, which change the heat the electrochemistry produces.

The fidelity ladder

Lumped (0D)

One temperature per cell

Fast, cheap, good for early scoping and for BMS-side estimation.

1D

Through-thickness

Captures temperature gradients across the electrode stack. Useful when stack height is large relative to in-plane dimensions or when surface cooling dominates.

Pseudo-3D

In-plane coupled

1D electrochemistry coupled to a 3D thermal and current-collector network. The practical choice for large-format pouch and prismatic cells.

Full 3D CFD

External tool

External tool territory (COMSOL, Simcenter, Ansys). Needed for pack-level airflow and coolant channel design.

Heat sources that matter

Reversible (entropic) heat

Tied to the open-circuit voltage temperature coefficient. Can be positive or negative depending on chemistry and state of charge.

Irreversible heat

Ohmic losses in the electrolyte and current collectors, and overpotentials from reaction kinetics and transport limitations. The dominant term at high C-rate.

Contact resistance

At tabs, welds, and interconnects. Often overlooked. Can dominate local heating on large-format cells.

When thermal modeling changes the answer

ScenarioLumped enoughNeed distributed
Small coin cell or 18650 at low C-rateYes
Large-format pouch > 50 AhYes
Fast charge (3–6C) on automotive cellsYes
Thermal runaway risk screeningYes (plus safety models)
Warranty-grade operating envelope for ESSYes

Electrothermal coupling

Thermal and electrochemical behavior are not separable at high C-rate. Conductivity, transport, reaction kinetics, and degradation rates all depend on temperature. A 3 °C error in predicted cell temperature propagates through the plating overpotential, the SEI growth rate, and the fast-charge limit.

Ionworks couples the thermal model to the same parameterized electrochemical model used in Predict. The heat produced by the electrochemistry drives the thermal model, and the temperature from the thermal model feeds back into the electrochemistry every time step. Teams do not run thermal in isolation.

Cooling topologies

Tab cooling

Heat extracted through the tabs. Good for thin cells where tab contact area is large relative to surface area. Sensitive to tab resistance.

Surface cooling

Cold plate on one or both faces of the cell. The default for automotive pouch and prismatic designs. Creates through-thickness gradients that the thermal model has to resolve.

Immersion cooling

Cell fully in contact with a dielectric fluid. Uniform but expensive. Used where peak power density is high and pack-level constraints rule out surface cooling.

How Ionworks fits in

How Ionworks supports thermal modeling

01

Coupled thermal out of the box

Thermal submodels couple to DFN, SPM, and SPMe through PyBaMM. Teams do not write the coupling themselves.

02

Pseudo-3D for large-format cells

Pouch and prismatic cells above about 50 Ah usually need distributed thermal. The pseudo-3D workflow plugs into the same parameter set.

03

Validate against cycling data

Cycling data with temperature measurements from Maccor, Neware, BioLogic, or Arbin flows into Measure and supports validation of the coupled thermal model.

04

Design sweeps in Optimize

Sweeps over cooling parameters, cell geometry, and operating protocol run in the same framework as electrochemical sweeps.

05

Honest scoping

Ionworks is not a CFD tool. Pack-level airflow, coolant channel design, and full fluid-structure problems belong in an external simulator, with Ionworks on the cell side.

Example questions teams answer

Fast-charge envelope

Does the cooling envelope hold at 3C DC fast charge, 40 °C ambient, for this pack topology?

Hotspot at end-of-discharge

Where is the hottest point in the pack at end-of-discharge, and is it where we are monitoring?

Cooling rate for warranty

What surface cooling rate do we need to keep cycle life above 3000 cycles under the customer duty cycle?

Frequently asked questions

A lumped model represents the cell as a single temperature. A distributed model resolves temperature variations across the cell, either through the stack thickness, across the in-plane dimensions, or both. Distributed is needed whenever spatial gradients change cycle life, plating risk, or the operating envelope.
At low C-rate and moderate temperatures, an uncoupled thermal model is often close enough. At high C-rate, during fast charge, or when degradation is part of the question, the coupling matters. Temperature changes kinetics and transport, which changes the heat source, which changes the temperature.
Tab cooling is represented through boundary conditions on the current-collector network in the pseudo-3D workflow: a thermal contact at the tabs with a configurable heat transfer coefficient. Tab geometry and tab resistance are explicit inputs, because both matter once the cell is large.
Thermal runaway requires abuse models (short circuits, internal shorts, decomposition reactions) that sit on top of the standard thermal model. Ionworks supports the thermal and electrochemical side of the problem and is commonly paired with purpose-built safety tools on the abuse side.
At a minimum, surface thermocouple data at one or two points across cycling at several C-rates. More informative datasets add infrared imaging or internal thermocouples. The validation workflow in Ionworks Studio compares predicted and measured temperatures at those points across the same cycling protocol used for voltage validation.
For cell-level coupled electrothermal work, yes. For pack-level CFD, fluid-structure interaction, or general 3D thermal at the module and pack scale, no. Teams commonly use Ionworks for the cell and COMSOL or Simcenter for the pack, with the cell-model outputs handed across.

See whether your cell actually needs a distributed thermal model

Bring cycling data with temperature measurements. We will run lumped and pseudo-3D side by side on your cell and show where the answers diverge.