findThermalBC

(To be removed) Find thermal boundary conditions assigned to a geometric region

findThermalBC will be removed. Use the EdgeBC and FaceBC properties of femodel instead. (since R2023a) For more information on updating your code, see Version History.

Syntax

tbca = findThermalBC(boundaryConditions,RegionType,RegionID)

Description

tbca = findThermalBC(boundaryConditions,RegionType,RegionID) returns the thermal boundary condition assigned to the specified region.

Examples

Find Thermal Boundary Conditions for Edges of 2-D Geometry

Create a thermal model and include a square geometry.

thermalmodel = createpde("thermal");
geometryFromEdges(thermalmodel,@squareg);
pdegplot(thermalmodel,"EdgeLabels","on")
ylim([-1.1 1.1])
axis equal

Apply temperature boundary conditions on edges 1 and 3 of the square.

thermalBC(thermalmodel,"Edge",[1 3],"Temperature",100);

Apply a heat flux boundary condition on edge 4 of the square.

thermalBC(thermalmodel,"Edge",4,"HeatFlux",20);

Check the boundary condition specification on edge 1.

tbcaEdge1 = findThermalBC(thermalmodel.BoundaryConditions,"Edge",1)

tbcaEdge1 = 
  ThermalBC with properties:

               RegionType: 'Edge'
                 RegionID: [1 3]
              Temperature: 100
                 HeatFlux: []
    ConvectionCoefficient: []
               Emissivity: []
       AmbientTemperature: []
               Vectorized: 'off'
                    Label: []
               InternalBC: []

Check the boundary condition specifications on edges 3 and 4.

tbca = findThermalBC(thermalmodel.BoundaryConditions,"Edge",3:4);
tbcaEdge3 = tbca(1)

tbcaEdge3 = 
  ThermalBC with properties:

               RegionType: 'Edge'
                 RegionID: [1 3]
              Temperature: 100
                 HeatFlux: []
    ConvectionCoefficient: []
               Emissivity: []
       AmbientTemperature: []
               Vectorized: 'off'
                    Label: []
               InternalBC: []

tbcaEdge4 = tbca(2)

tbcaEdge4 = 
  ThermalBC with properties:

               RegionType: 'Edge'
                 RegionID: 4
              Temperature: []
                 HeatFlux: 20
    ConvectionCoefficient: []
               Emissivity: []
       AmbientTemperature: []
               Vectorized: 'off'
                    Label: []
               InternalBC: []

Input Arguments

boundaryConditions — Boundary conditions of a thermal model

BoundaryConditions property of a thermal model

Boundary conditions of a thermal model, specified as the BoundaryConditions property of a ThermalModel object.

Example: thermalmodel.BoundaryConditions

RegionType — Geometric region type

"Face" | "Edge"

Geometric region type, specified as "Face" for 3-D geometry or "Edge" for 2-D geometry.

Data Types: char | string

RegionID — Geometric region ID

vector of positive integers

Geometric region ID, specified as a vector of positive integers. Find the region IDs using pdegplot with the "FaceLabels" (3-D) or "EdgeLabels" (2-D) value set to "on".

Data Types: double

Output Arguments

tbca — Thermal boundary condition for a particular region

ThermalBC object

Thermal boundary condition for a particular region, returned as a ThermalBC object.

Version History

Introduced in R2017a

R2025a: To be removed

findThermalBC will be removed. Use the EdgeBC and FaceBC properties of femodel instead.

For example, you can check the boundary condition on edges of the unit square as follows.

model = femodel(AnalysisType="thermalSteady", ...
                Geometry=@squareg);
model.EdgeBC([1 3]) = edgeBC(Temperature=25);
model.EdgeBC

The unified finite element model workflow defines the type of a problem and all of its parameters as the properties of an femodel object. This object enables you to specify physical parameters for structural, thermal, and electromagnetic types of analyses. The solver in the unified workflow uses only the parameters (properties) appropriate for the current analysis type while ignoring all other properties. If you switch the analysis type by setting the AnalysisType property of the model, the solver uses the appropriate set of properties corresponding to the new analysis type.

For more help migrating your existing code that uses ThermalModel to the unified finite element workflow, see Migration from Domain-Specific to Unified Workflow.