Skip to content
LIBRARY
Components.Convection.md

Components.Convection

Models heat transfer by convection where the thermal conductance is a signal input.

This component represents a lumped thermal element that experiences heat convection. The rate of heat transfer, Q_flow, is determined by the product of the convective thermal conductance, Gc, and the temperature difference, ΔT, across the element. The convective thermal conductance Gc is not a fixed parameter but rather a time-varying signal input to the component. The governing equation is:

Qflow=GcΔT

The temperature difference ΔT and the heat flow Q_flow are typically defined in or inherited from the base class ConvectiveElement1D.

This component extends from ThermalComponents.Interfaces.ConvectiveElement1D

Usage

ThermalComponents.Components.Convection()

Connectors

  • solid - This connector represents a thermal port with temperature and heat flow as the potential and flow variables, respectively. (HeatPort)

  • fluid - This connector represents a thermal port with temperature and heat flow as the potential and flow variables, respectively. (HeatPort)

  • Gc - This connector represents a real signal as an input to a component (RealInput)

Variables

NameDescriptionUnits
ΔTTemperature difference across the element, defined as solid.T - fluid.T.K
Q_flowHeat flow rate from the solid node to the fluid node.W

Behavior

ΔT(t)=fluid.T(t)+solid.T(t)solid.Q_flow(t)=Q_flow(t)fluid.Q_flow(t)=Q_flow(t)Q_flow(t)=ΔT(t) Gc(t)

Source

dyad
"""
Models heat transfer by convection where the thermal conductance is a signal input.

This component represents a lumped thermal element that experiences heat convection.
The rate of heat transfer, `Q_flow`, is determined by the product of the
convective thermal conductance, `Gc`, and the temperature difference, `ΔT`,
across the element. The convective thermal conductance `Gc` is not a fixed
parameter but rather a time-varying signal input to the component.
The governing equation is:

math Q_{flow} = G_c \cdot \Delta T

The temperature difference `ΔT` and the heat flow `Q_flow` are typically
defined in or inherited from the base class `ConvectiveElement1D`.
"""
component Convection
  extends ThermalComponents.Interfaces.ConvectiveElement1D
  "Signal representing the convective thermal conductance"
  Gc = RealInput() {
    "Dyad": {"placement": {"icon": {"x1": 450, "y1": -50, "x2": 550, "y2": 50, "rot": 90}}}
  }
relations
  Q_flow = Gc * ΔT
metadata {
  "Dyad": {
    "labels": [{"label": "$(instance)", "x": 500, "y": 1100, "rot": 0}],
    "icons": {"default": "dyad://ThermalComponents/Convection.svg"}
  }
}
end
Flattened Source
dyad
"""
Models heat transfer by convection where the thermal conductance is a signal input.

This component represents a lumped thermal element that experiences heat convection.
The rate of heat transfer, `Q_flow`, is determined by the product of the
convective thermal conductance, `Gc`, and the temperature difference, `ΔT`,
across the element. The convective thermal conductance `Gc` is not a fixed
parameter but rather a time-varying signal input to the component.
The governing equation is:

math Q_{flow} = G_c \cdot \Delta T

The temperature difference `ΔT` and the heat flow `Q_flow` are typically
defined in or inherited from the base class `ConvectiveElement1D`.
"""
component Convection
  "Connector representing the solid side of the heat transfer interface."
  solid = HeatPort() {
    "Dyad": {
      "placement": {"icon": {"iconName": "heat_port_a", "x1": -50, "y1": 450, "x2": 50, "y2": 550}}
    }
  }
  "Connector representing the fluid side of the heat transfer interface."
  fluid = HeatPort() {
    "Dyad": {
      "placement": {
        "icon": {"iconName": "heat_port_b", "x1": 950, "y1": 450, "x2": 1050, "y2": 550}
      }
    }
  }
  "Temperature difference across the element, defined as solid.T - fluid.T."
  variable ΔT::Temperature
  "Heat flow rate from the solid node to the fluid node."
  variable Q_flow::HeatFlowRate
  "Signal representing the convective thermal conductance"
  Gc = RealInput() {
    "Dyad": {"placement": {"icon": {"x1": 450, "y1": -50, "x2": 550, "y2": 50, "rot": 90}}}
  }
relations
  ΔT = solid.T - fluid.T
  solid.Q_flow = Q_flow
  fluid.Q_flow = -Q_flow
  Q_flow = Gc * ΔT
metadata {
  "Dyad": {
    "labels": [{"label": "$(instance)", "x": 500, "y": 1100, "rot": 0}],
    "icons": {"default": "dyad://ThermalComponents/Convection.svg"}
  }
}
end


Test Cases

No test cases defined.

  • Examples

  • Experiments

  • Analyses