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:
Where:
Qis the net thermal heat flow entering the port in Watts (W).mis the mass of the body in kilograms (kg).c_pis the specific heat capacity in Joules per kilogram-Kelvin ().Tis the absolute temperature of the body in Kelvin (K).C_{th} = m \cdot c_pis 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 -> AmbientRemarks & 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 ().
- 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
- ThermalResistor: Linear thermal conduction resistance
- Convection: Convective heat transfer with fluid streams
- TemperatureSource: Prescribed boundary temperature reference
- HeatFlowSource: Prescribed thermal power generator
- TemperatureSensor: Absolute temperature sensor probe