TMASS

Thermal Mass

Thermal
Run the live example Free · no sign-up · runs in your browser

The Thermal Mass block models lumped thermal energy storage in a physical body. It stores internal energy as heat, governed by its mass and specific heat capacity. Temperature change is directly proportional to the net incoming heat flow.

Because the Thermal Mass is an acausal conserving component, it acts as a thermal capacitor stamped directly into the system's conductance and dynamic storage matrices during Modified Nodal Analysis (MNA).

Real-World Analog: Represents a solid heat sink, aluminum enclosure block, engine cylinder head, or fluid volume storing thermal energy via heat capacity.

Mathematical Model

The continuous thermal storage dynamics are governed by the first law of thermodynamics:

Q=m⋅cp⋅dTdtQ = m \cdot c_p \cdot \frac{dT}{dt}

Where:

  • Q is the net thermal heat flow entering the port in Watts (W).
  • m is the mass of the body in kilograms (kg).
  • c_p is the specific heat capacity in Joules per kilogram-Kelvin (J/(kg⋅K)\text{J}/(\text{kg}\cdot\text{K})).
  • T is the absolute temperature of the body in Kelvin (K).
  • C_{th} = m \cdot c_p is the total lumped thermal capacitance in Joules per Kelvin (J/K).

Inputs & Outputs

Direction ID Label Type Status
→ In p H number Required

Parameters

Parameters Label Type Default Description
mass Mass (m) number 1 Mass of the thermal body in kilograms
heat_capacity Specific Heat Capacity (cp) number 450 Specific heat capacity (e.g. 450 J/(kg·K) for steel, 4184 for water, 1005 for air)
initial_temperature Initial Temperature (T0) number 293.15 Initial body temperature in Kelvin (293.15 K = 20 °C)

Usage Examples

Heated Aluminum Block

Simulate a 2 kg aluminum casing heated by a constant heat flow source:

HeatFlowSource(heat_flow: 250) -> ThermalMass(mass: 2.0, heat_capacity: 900)

Thermal Flywheel Energy Storage

Model a fluid or solid thermal buffer smoothing out temperature oscillations:

TemperatureSource -> Convection -> ThermalMass -> ThermalResistor -> Ambient

Remarks & Best Practices

  • Acausal Storage: Thermal mass acts as a capacitor connected between its node and absolute zero (0 K).
  • Absolute Temperature: All thermodynamic calculations in BlockWerk operate strictly in Kelvin (0 ∘C=273.15 K0\text{ }^\circ\text{C} = 273.15\text{ K}).
  • Energy Conservation: Heat entering the mass increases stored internal energy; heat leaving decreases it.
  • WASM Performance: Stamped into MNA dynamic state vectors and solved at 60 FPS in WebAssembly.

Related Components