Reproducible battery thermal research software

ThermoWeave-3D makes inter-cell heat exchange inspectable.

An independent MATLAB graph model that extends the earlier ThermoWeave core to deterministic 3-D lattices, publishes exact synthetic evidence, and keeps the scientific limitations visible.

Layer-resolved field

One numerical state drives tests, data, and the 3-D figure.

Synthetic three-layer battery module graph at 120 seconds, with cooler lower cells in purple, middle cells in green, and warmer upper cells in red — The 3x4x3 nominal scenario at 120 s. Cuboids visualize lumped graph nodes; they are not a resolved solid or fluid mesh.

Method

Deterministic topology, not a copied example.

Cartesian graph

Rows, columns, and layers generate canonical node IDs, physical x/y/z coordinates, and nearest-neighbour interfaces.

Directional transport

Independent g_x, g_y, and g_z conductances make anisotropic sensitivity explicit.

Six exterior faces

Boolean face masks identify geometric boundaries without silently imposing a cooling technology.

Backward compatible

A one-layer cuboid reproduces the established 2-D rectangular edges, coordinates, conductances, and Laplacian.

Synthetic E10 sensitivity study

Stronger declared through-layer coupling reduces the constructed layer spread.

Weak

4.589 K

Final layer-mean spread at g_z = 0.10 W/K.

Nominal

3.883 K

Final layer-mean spread at g_z = 0.25 W/K.

Strong

2.450 K

Final layer-mean spread at g_z = 0.75 W/K.

Accounting

~1e-13

Normalized instantaneous energy residual across the three runs.

Review package

Read the paper, inspect the data, and reproduce the exact study.

Journal-formatted manuscript

Methods, equations, related work, evidence, limitations, declarations, and AI-assistance disclosure.

Read PDF Download DOCX

Machine-readable evidence

Portable JSON summary and compact CSV with scenario hashes and all reported metrics.

Open JSON Download CSV

Source and tests

MATLAB implementation, configuration, 37-test suite, provenance, and reproducibility commands.

Open GitHub repository

Originality record

Established concepts are separated from independent code and from novelty claims that still require peer review.

Read originality matrix

Scientific boundary

What this publication does not claim.

No measured validation. Parameters and boundary fields are synthetic software-study assumptions.
No safety approval. The model omits detailed electrochemistry, ageing, abuse, gas generation, and thermal runaway.
No Simscape agreement. Structural Simscape generation remains policy-gated and the optional adapter stays explicitly skipped.
No guaranteed novelty or journal acceptance. The manuscript is a journal-formatted preprint draft that requires accountable human scientific review.
No autonomous authorship claim. OpenAI Codex assisted implementation, evidence generation, drafting, and site integration; AI is not an author or validation authority.

Prior-art boundary

High-level concepts were cited; protected expression was not copied.

Official MathWorks documentation on inter-cell thermal paths and module heat exchange was consulted only for high-level context. ThermoWeave-3D does not copy MathWorks code, prose, equations, figures, screenshots, topology counts, parameter values, object names, model hierarchy, page structure, or numerical scenarios. MathWorks does not sponsor or endorse this project.