Lemonergy · Studio block

Thermal convection

Prescribed lumped film coefficient; no resolved fluid dynamics

Implementation ID
thermal-convection
Reviewed
2026-10-27

Behavior

Conserving component solved simultaneously with the connected network. Prescribed lumped film coefficient; no resolved fluid dynamics

Interface

Thermal convection interfaceInputs or arguments on the left, observed outputs on the right. Conserving terminals appear below the component. The tables give units and behavior.Thermal convectionStudio blockheatFlowtemperaturetemperatureDifferenceab
Original Lemonergy interface view. Lines identify ports; they are not a completed simulation circuit.
Ports and observed outputs
NameDirectionUnitMeaning
aterminalK; Wthermal conserving connection; absolute temperature with balanced heat flow.
bterminalK; Wthermal conserving connection; absolute temperature with balanced heat flow.
heatFlowoutputWRecorded heat flow measurement from the conserving simulation.
temperatureoutputKRecorded temperature measurement from the conserving simulation.
temperatureDifferenceoutputKRecorded temperatureDifference measurement from the conserving simulation.

Parameters

Defaults are initial model values. Select values for your own model and operating conditions.

Configuration fields
ParameterUnitDefaultMeaning and limits
Convection coefficient
coefficientWm2K
W/(m2 K)10Prescribed heat-transfer coefficient multiplying area and temperature difference.
Minimum 0; Maximum 1000000000
Exchange area
areaM2
m20.2Area used by the declared heat-transfer or parallel-plate field equation.
Minimum 1e-12; Maximum 1000000

Equations and rules

  • Q̇a→b = h A (Ta − Tb)

Worked example

Thermal convection worked example

Editable first-party network. hot-boundary: differenceK=320; cold-boundary: differenceK=300. Checks below were verified in the native execution engine.

Open Studio example after release →
Numerical checks for the bundled synthetic example
OutputTime (s)Expected valueUnitAbsolute tolerance
heatFlow
target/heatFlow
140W3.9999999999999996e-05
temperature
target/temperature
1320K0.00031999999999999997
temperatureDifference
target/temperatureDifference
120K1.9999999999999998e-05

Use in a workflow

Thermal convection worked example

Prescribed lumped film coefficient; no resolved fluid dynamics

  1. Thermal convection: Conserving component solved simultaneously with the connected network. Prescribed lumped film coefficient; no resolved fluid dynamics
    • Use the block reference for settings and connections.
    • Implementation tested locally; public release pending.
Open Studio example after release

Connected concepts

Limits and interpretation

  • Prescribed lumped film coefficient; no resolved fluid dynamics
  • Demonstration parameters are not calibrated hardware data. Singular or incompatible ideal constraints and unsupported state ranges stop the run.

Scientific and mathematical references

These sources explain the scientific and mathematical background. The behavior, interface and limits above define the Lemonergy implementation; a citation does not imply every model option in the source is implemented.

  1. University Physics Volume 2, §1.6: Mechanisms of Heat Transfer

    OpenStax, Rice University

    Technical reference · Conduction, convection, radiation and thermal resistance.

  2. Enthalpy

    NASA Glenn Research Center

    Technical reference · Underlying physical law or reduced-model basis; Lemonergy implementation choices and limits are documented separately.

Implementation sources

This reference follows the public interface and locally verified numerical checks for an upcoming release.

Contract: Lemonergy Studio public contract · Verification record: verification-2026-10-27

  • docs/glossary/native-block-verification.json

This implementation and its workflow uses (JSON) · Knowledge graph (JSON-LD)