tidy3d.ConvectionBC#

class ConvectionBC[source]#

Bases: HeatChargeBC

Convective thermal boundary conditions.

Parameters:
  • ambient_temperature (PositiveFloat) – [units = K]. Ambient temperature.

  • transfer_coeff (Union[NonNegativeFloat, VerticalNaturalConvectionCoeffModel]) – [units = W/(um^2*K)]. Heat transfer coefficient value.

Example

>>> import tidy3d as td
>>> bc = td.ConvectionBC(ambient_temperature=300, transfer_coeff=1)
>>> # Convection with a natural convection model.
>>> # First, define the fluid medium (e.g. air at 300 K).
>>> air = td.FluidMedium.from_si_units(
...     thermal_conductivity=0.0257,  # Unit: W/(m*K)
...     viscosity=1.81e-5,          # Unit: Pa*s
...     specific_heat=1005,         # Unit: J/(kg*K)
...     density=1.204,              # Unit: kg/m^3
...     expansivity=1/293.15        # Unit: 1/K
... )
>>>
>>> # Next, create the model, which requires the fluid and a characteristic length.
>>> natural_conv_model = td.VerticalNaturalConvectionCoeffModel.from_si_units(
...     medium=air, plate_length=1e-5
... )
>>>
>>> # Finally, create the boundary condition using this model.
>>> bc_natural = td.ConvectionBC(
...     ambient_temperature=300, transfer_coeff=natural_conv_model
... )
>>> # If the fluid medium is not provided to the coefficient model, it is automatically retrieved from
>>> # the interface.
>>> natural_conv_model = td.VerticalNaturalConvectionCoeffModel.from_si_units(plate_length=1e-5)
>>> bc_natural_nom = td.ConvectionBC(
...     ambient_temperature=300, transfer_coeff=natural_conv_model
... )

Attributes

ambient_temperature#
transfer_coeff#