{
  "node": {
    "id": "term:thermal-model",
    "type": "Term",
    "label": "Thermal model",
    "properties": {
      "id": "thermal-model",
      "name": "Thermal model",
      "aka": [
        "lumped thermal model"
      ],
      "section": "topic-thermal",
      "definition": "A model of cell temperature: at its simplest one thermal mass with heat generation inside and convection outside, at its most detailed a 3D simulation of the pack. Temperature feeds back into every rate, so electrical and thermal models are usually solved together.",
      "related": [
        "heat-generation",
        "thermal-management",
        "arrhenius",
        "newman-model",
        "thermal-characterisation"
      ],
      "url": "https://lemonergy.com/learn/glossary/thermal-model/",
      "mentions": [
        "thermal-mass",
        "heat-transfer-modes"
      ]
    }
  },
  "edges": [
    {
      "id": "edge:109",
      "source": "term:thermal-model",
      "target": "workflow:charge-thermal",
      "type": "usedIn",
      "properties": {
        "sourceFile": "wiki-blocks.json"
      }
    },
    {
      "id": "edge:2192",
      "source": "term:thermal-model",
      "target": "topic:topic-thermal",
      "type": "belongsTo",
      "properties": {
        "sourceFile": "terms.json"
      }
    },
    {
      "id": "edge:2193",
      "source": "term:thermal-model",
      "target": "term:heat-generation",
      "type": "relatedTo",
      "properties": {
        "sourceFile": "terms.json",
        "meaning": "Related context; not a causal claim"
      }
    },
    {
      "id": "edge:2194",
      "source": "term:thermal-model",
      "target": "term:thermal-management",
      "type": "relatedTo",
      "properties": {
        "sourceFile": "terms.json",
        "meaning": "Related context; not a causal claim"
      }
    },
    {
      "id": "edge:2195",
      "source": "term:thermal-model",
      "target": "term:arrhenius",
      "type": "relatedTo",
      "properties": {
        "sourceFile": "terms.json",
        "meaning": "Related context; not a causal claim"
      }
    },
    {
      "id": "edge:2196",
      "source": "term:thermal-model",
      "target": "term:newman-model",
      "type": "relatedTo",
      "properties": {
        "sourceFile": "terms.json",
        "meaning": "Related context; not a causal claim"
      }
    },
    {
      "id": "edge:2197",
      "source": "term:thermal-model",
      "target": "term:thermal-characterisation",
      "type": "relatedTo",
      "properties": {
        "sourceFile": "terms.json",
        "meaning": "Related context; not a causal claim"
      }
    },
    {
      "id": "edge:mentions/thermal-model/thermal-mass",
      "source": "term:thermal-model",
      "target": "term:thermal-mass",
      "type": "mentions",
      "properties": {
        "sourceFile": "terms.json",
        "method": "build_glossary.mention_index + mentions",
        "field": "definition",
        "meaning": "Text mention; not a causal claim"
      }
    },
    {
      "id": "edge:mentions/thermal-model/heat-transfer-modes",
      "source": "term:thermal-model",
      "target": "term:heat-transfer-modes",
      "type": "mentions",
      "properties": {
        "sourceFile": "terms.json",
        "method": "build_glossary.mention_index + mentions",
        "field": "definition",
        "meaning": "Text mention; not a causal claim"
      }
    },
    {
      "id": "edge:2200",
      "source": "term:thermal-model",
      "target": "visual:thermal",
      "type": "illustratedBy",
      "properties": {
        "sourceFile": "visual-pages.json"
      }
    },
    {
      "id": "edge:2201",
      "source": "term:thermal-model",
      "target": "reference:bernardi-energy",
      "type": "cites",
      "properties": {
        "sourceFile": "wiki-references.json",
        "scope": "direct technical reference"
      }
    }
  ],
  "neighbors": [
    {
      "id": "workflow:charge-thermal",
      "type": "Workflow",
      "label": "Inspect pack temperature",
      "properties": {
        "id": "charge-thermal",
        "title": "Inspect pack temperature",
        "kind": "protocol",
        "summary": "The separate Charge session can include a lumped thermal node.",
        "steps": [
          "Provide thermal mass and conductance.",
          "Compare two ambient temperatures."
        ],
        "example": "100 kJ/K thermal mass and 100 W/K conductance give a 1000 s no-source temperature-difference time constant.",
        "observe": "Temperature limits can pause charge; heater and mass are separate.",
        "limits": "One node does not resolve gradients, coolant geometry or runaway. Studio’s native charger instead uses external temperature.",
        "url": "https://design.lemonergy.com/",
        "label": "Open Design → Charge session",
        "evidence": [
          "js/charger.js"
        ]
      }
    },
    {
      "id": "topic:topic-thermal",
      "type": "Topic",
      "label": "Thermal management and heat transfer",
      "properties": {
        "id": "topic-thermal",
        "name": "Thermal management and heat transfer",
        "lede": "How heat is made, moved and removed in cells and packs, and the hardware that keeps a battery at the right temperature.",
        "context": "Select spatial detail for the question.",
        "example": "Equal total heat in different layouts can produce different gradients. Average temperature can miss a hot spot.",
        "lesson_url": "https://lemonergy.com/learn/fundamentals/battery-aging/",
        "lesson_label": "Open temperature and aging"
      }
    },
    {
      "id": "term:heat-generation",
      "type": "Term",
      "label": "Heat generation",
      "properties": {
        "id": "heat-generation",
        "name": "Heat generation",
        "aka": [
          "Bernardi equation"
        ],
        "section": "topic-thermal",
        "definition": "The heat a cell produces in operation: an irreversible part equal to current times overpotential, and a reversible part from the entropy change, I·T·dE/dT. The Bernardi equation sums them and feeds every thermal model.",
        "formula": "q = I(V − E_OCV) + I·T·(dE/dT)",
        "unit": "W",
        "related": [
          "entropy-coefficient",
          "internal-resistance",
          "thermal-model",
          "thermal-management",
          "exothermic"
        ],
        "example": {
          "title": "Keep reversible and irreversible heat separate",
          "text": "With charging current +5 A and terminal voltage 0.10 V above OCV, the irreversible term is 0.50 W. At 300 K with dE/dT = +0.1 mV/K, the reversible contribution is +0.15 W, giving 0.65 W under this sign convention."
        },
        "url": "https://lemonergy.com/learn/glossary/heat-generation/",
        "mentions": [
          "overpotential"
        ]
      }
    },
    {
      "id": "term:thermal-management",
      "type": "Term",
      "label": "Thermal management",
      "properties": {
        "id": "thermal-management",
        "name": "Thermal management",
        "abbr": "TMS",
        "aka": [
          "battery thermal management system",
          "BTMS"
        ],
        "section": "topic-thermal",
        "definition": "Keeping cells in their comfortable range, roughly 15–35 °C, and within a few degrees of each other: liquid cooling plates, refrigerant plates or immersion for heat removal, and heaters or waste heat for warming before fast charging in the cold.",
        "related": [
          "cooling-plate",
          "thermal-interface-material",
          "operating-temperature",
          "heat-generation",
          "preconditioning",
          "temperature-sensor"
        ],
        "url": "https://lemonergy.com/learn/glossary/thermal-management/",
        "mentions": [
          "fast-charging"
        ]
      }
    },
    {
      "id": "term:arrhenius",
      "type": "Term",
      "label": "Arrhenius law",
      "properties": {
        "id": "arrhenius",
        "name": "Arrhenius law",
        "section": "topic-aging",
        "definition": "The rule that a rate constant is proportional to exp(−Ea/RT), so a thermally activated reaction speeds up steeply with temperature. Near room temperature many degradation reactions roughly double their rate for every +10 °C.",
        "formula": "k = A·exp(−Eₐ/RT)",
        "related": [
          "activation-energy",
          "calendar-aging",
          "operating-temperature",
          "accelerated-aging",
          "celsius-kelvin"
        ],
        "lesson": "fundamentals/battery-aging/#arrhenius",
        "example": {
          "title": "Compare reaction-rate factors",
          "text": "For an illustrative activation energy of 40 kJ/mol, increasing temperature from 25 °C to 35 °C multiplies the modeled rate by about 1.69. Convert both temperatures to kelvin before evaluating the exponential."
        },
        "notes": [
          "A reaction-rate factor alone is not a prediction of battery lifetime."
        ],
        "url": "https://lemonergy.com/learn/glossary/arrhenius/",
        "mentions": []
      }
    },
    {
      "id": "term:newman-model",
      "type": "Term",
      "label": "Newman model",
      "properties": {
        "id": "newman-model",
        "name": "Newman model",
        "abbr": "P2D",
        "aka": [
          "pseudo-two-dimensional model",
          "Doyle–Fuller–Newman",
          "DFN"
        ],
        "section": "topic-transport",
        "definition": "The standard physics-based lithium-ion cell model: porous-electrode theory across the cell thickness, with solid diffusion solved in a representative spherical particle at every point — hence pseudo-two-dimensional. It predicts voltage from first principles but needs dozens of parameters.",
        "related": [
          "porous-electrode-theory",
          "single-particle-model",
          "butler-volmer",
          "ficks-second-law",
          "parameterisation",
          "pybamm"
        ],
        "url": "https://lemonergy.com/learn/glossary/newman-model/",
        "mentions": [
          "diffusion"
        ]
      }
    },
    {
      "id": "term:thermal-characterisation",
      "type": "Term",
      "label": "Thermal characterisation",
      "properties": {
        "id": "thermal-characterisation",
        "name": "Thermal characterisation",
        "aka": [
          "heat capacity test",
          "entropy test"
        ],
        "section": "topic-testing",
        "definition": "Measuring the thermal properties a model needs: specific heat capacity in a calorimeter, thermal conductivity through and along the layers, the entropy coefficient from OCV against temperature, and heat generation under load. Without them a thermal model is a guess.",
        "related": [
          "heat-generation",
          "entropy-coefficient",
          "thermal-model",
          "accelerating-rate-calorimetry"
        ],
        "url": "https://lemonergy.com/learn/glossary/thermal-characterisation/",
        "mentions": [
          "open-circuit-voltage",
          "thermal-conductivity",
          "specific-heat-capacity"
        ]
      }
    },
    {
      "id": "term:thermal-mass",
      "type": "Term",
      "label": "Thermal mass",
      "properties": {
        "id": "thermal-mass",
        "name": "Thermal mass",
        "aka": [
          "thermal inertia",
          "thermal time constant"
        ],
        "section": "topic-thermal",
        "definition": "A body’s total heat capacity seen as a buffer against temperature change. A 500 kg pack at about 1 kJ/(kg·K) stores roughly 500 kJ per kelvin, so 10 kW of uncooled heat warms it only about 1.2 K a minute. Together with the thermal resistance to the coolant it sets the pack’s thermal time constant.",
        "formula": "τ = m·cₚ·R_th",
        "related": [
          "specific-heat-capacity",
          "thermal-resistance",
          "thermal-model",
          "phase-change-material",
          "thermal-management"
        ],
        "example": {
          "title": "Calculate a thermal time constant",
          "text": "With mass 0.5 kg, cₚ = 900 J/(kg·K) and R_th = 2 K/W, the lumped thermal time constant is 900 s, or 15 min. The calculation assumes a nearly uniform internal temperature."
        },
        "url": "https://lemonergy.com/learn/glossary/thermal-mass/",
        "mentions": []
      }
    },
    {
      "id": "term:heat-transfer-modes",
      "type": "Term",
      "label": "Heat transfer modes",
      "properties": {
        "id": "heat-transfer-modes",
        "name": "Heat transfer modes",
        "aka": [
          "conduction",
          "convection",
          "thermal radiation"
        ],
        "section": "topic-thermal",
        "definition": "The three ways heat moves: conduction through solids and still fluids, convection carried by a moving fluid, and radiation emitted as infrared by every warm surface. In a pack, conduction takes heat from the cell into the cooling plate and convection carries it away in the coolant; radiation matters mainly at the high temperatures of thermal runaway.",
        "related": [
          "thermal-conductivity",
          "heat-transfer-coefficient",
          "thermography",
          "cooling-plate",
          "thermal-propagation"
        ],
        "url": "https://lemonergy.com/learn/glossary/heat-transfer-modes/",
        "mentions": [
          "thermal-runaway"
        ]
      }
    },
    {
      "id": "visual:thermal",
      "type": "Visual",
      "label": "Heat approaches an equilibrium",
      "properties": {
        "title": "Heat approaches an equilibrium",
        "summary": "Thermal resistance sets the steady temperature rise; thermal mass sets the response time.",
        "readout": "Steady rise: 10 K. Time constant: 8.333 min.",
        "formula": "ΔT = P R_th [1 − exp(−t / (C_th R_th))]",
        "note": "C_th = 500 J/K, fixed ambient and heat input, uniform temperature.",
        "software": {
          "status": "reference",
          "label": "Reference concept",
          "body": "Analysis → Charge session supports optional lumped thermal behavior. This independent explanation uses a 500 J/K thermal mass and constant heat input; it is not an application simulation result.",
          "href": "https://design.lemonergy.com/"
        },
        "html": "<figure class=\"visual-figure\"><figcaption>Temperature above ambient</figcaption><svg class=\"visual-chart\" viewBox=\"0 0 360 330\" role=\"img\" aria-labelledby=\"static-thermal-0-title static-thermal-0-desc\"><title id=\"static-thermal-0-title\">Temperature above ambient</title><desc id=\"static-thermal-0-desc\">Time (min) versus Temperature rise (K). Lumped response. Interpretation follows the graphs.</desc><path d=\"M74,238h268\" stroke=\"currentColor\" opacity=\".13\"/><text x=\"64\" y=\"242\" text-anchor=\"end\" font-size=\"13\" fill=\"currentColor\">0</text><text x=\"74\" y=\"265\" text-anchor=\"middle\" font-size=\"13\" fill=\"currentColor\">0</text><path d=\"M74,188.5h268\" stroke=\"currentColor\" opacity=\".13\"/><text x=\"64\" y=\"192.5\" text-anchor=\"end\" font-size=\"13\" fill=\"currentColor\">15</text><text x=\"141\" y=\"265\" text-anchor=\"middle\" font-size=\"13\" fill=\"currentColor\">15</text><path d=\"M74,139h268\" stroke=\"currentColor\" opacity=\".13\"/><text x=\"64\" y=\"143\" text-anchor=\"end\" font-size=\"13\" fill=\"currentColor\">30</text><text x=\"208\" y=\"265\" text-anchor=\"middle\" font-size=\"13\" fill=\"currentColor\">30</text><path d=\"M74,89.5h268\" stroke=\"currentColor\" opacity=\".13\"/><text x=\"64\" y=\"93.5\" text-anchor=\"end\" font-size=\"13\" fill=\"currentColor\">45</text><text x=\"275\" y=\"265\" text-anchor=\"middle\" font-size=\"13\" fill=\"currentColor\">45</text><path d=\"M74,40h268\" stroke=\"currentColor\" opacity=\".13\"/><text x=\"64\" y=\"44\" text-anchor=\"end\" font-size=\"13\" fill=\"currentColor\">60</text><text x=\"342\" y=\"265\" text-anchor=\"middle\" font-size=\"13\" fill=\"currentColor\">60</text><path d=\"M74,40v198h268\" fill=\"none\" stroke=\"currentColor\" opacity=\".3\"/><polyline fill=\"none\" stroke=\"#a45b2b\" stroke-width=\"2.8\" points=\"74.00,238.00 76.23,236.08 78.47,234.27 80.70,232.56 82.93,230.96 85.17,229.45 87.40,228.02 89.63,226.68 91.87,225.42 94.10,224.23 96.33,223.11 98.57,222.06 100.80,221.06 103.03,220.13 105.27,219.25 107.50,218.42 109.73,217.64 111.97,216.90 114.20,216.21 116.43,215.55 118.67,214.94 120.90,214.36 123.13,213.82 125.37,213.30 127.60,212.82 129.83,212.36 132.07,211.93 134.30,211.53 136.53,211.15 138.77,210.79 141.00,210.45 143.23,210.14 145.47,209.84 147.70,209.56 149.93,209.29 152.17,209.04 154.40,208.81 156.63,208.58 158.87,208.38 161.10,208.18 163.33,207.99 165.57,207.82 167.80,207.66 170.03,207.50 172.27,207.35 174.50,207.22 176.73,207.09 178.97,206.97 181.20,206.85 183.43,206.74 185.67,206.64 187.90,206.55 190.13,206.46 192.37,206.37 194.60,206.29 196.83,206.22 199.07,206.15 201.30,206.08 203.53,206.02 205.77,205.96 208.00,205.90 210.23,205.85 212.47,205.80 214.70,205.75 216.93,205.71 219.17,205.67 221.40,205.63 223.63,205.59 225.87,205.56 228.10,205.53 230.33,205.49 232.57,205.47 234.80,205.44 237.03,205.41 239.27,205.39 241.50,205.37 243.73,205.35 245.97,205.33 248.20,205.31 250.43,205.29 252.67,205.27 254.90,205.26 257.13,205.24 259.37,205.23 261.60,205.21 263.83,205.20 266.07,205.19 268.30,205.18 270.53,205.17 272.77,205.16 275.00,205.15 277.23,205.14 279.47,205.13 281.70,205.12 283.93,205.12 286.17,205.11 288.40,205.10 290.63,205.10 292.87,205.09 295.10,205.09 297.33,205.08 299.57,205.08 301.80,205.07 304.03,205.07 306.27,205.06 308.50,205.06 310.73,205.06 312.97,205.05 315.20,205.05 317.43,205.05 319.67,205.04 321.90,205.04 324.13,205.04 326.37,205.04 328.60,205.04 330.83,205.03 333.07,205.03 335.30,205.03 337.53,205.03 339.77,205.03 342.00,205.02\"/><text transform=\"translate(208 303)\" text-anchor=\"middle\" font-size=\"14\" fill=\"currentColor\"><tspan x=\"0\" dy=\"0\">Time (min)</tspan></text><text transform=\"translate(20 139) rotate(-90)\" text-anchor=\"middle\" font-size=\"14\" fill=\"currentColor\"><tspan x=\"0\" dy=\"0\">Temperature rise (K)</tspan></text></svg><div class=\"visual-legend\"><span><i style=\"background:#a45b2b\"></i>Lumped response</span></div></figure>"
      }
    },
    {
      "id": "reference:bernardi-energy",
      "type": "Reference",
      "label": "A General Energy Balance for Battery Systems",
      "properties": {
        "title": "A General Energy Balance for Battery Systems",
        "publisher": "Journal of The Electrochemical Society",
        "url": "https://doi.org/10.1149/1.2113792",
        "type": "Research article",
        "scope": "Battery energy balance and irreversible and reversible heat contributions. Reduced thermal models require explicit assumptions and current-sign conventions.",
        "year": 1985,
        "authors": [
          "Dawn Bernardi",
          "Ellen Pawlikowski",
          "John Newman"
        ],
        "accessed": "2026-10-27"
      }
    }
  ]
}
