findThermalIC

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

findThermalIC will be removed. Use the CellIC, FaceIC, EdgeIC, and VertexIC properties of femodel instead. (since R2023a) For more information on updating your code, see Version History.

Syntax

tica = findThermalIC(initialConditions,RegionType,RegionID)

Description

tica = findThermalIC(initialConditions,RegionType,RegionID) returns the thermal initial condition assigned to the specified region.

Examples

Find Initial Temperatures for Faces of 2-D Geometry

Create a transient thermal model that has three faces.

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

Set initial temperatures for each face.

thermalIC(thermalmodel,10,"Face",1);
thermalIC(thermalmodel,20,"Face",2);
thermalIC(thermalmodel,30,"Face",3);

Check the initial condition specification for face 1.

ticaFace1 = findThermalIC(thermalmodel.InitialConditions,"Face",1)

ticaFace1 = 
  GeometricThermalICs with properties:

            RegionType: 'face'
              RegionID: 1
    InitialTemperature: 10

Check the initial temperature specifications for faces 2 and 3.

tica = findThermalIC(thermalmodel.InitialConditions,"Face",[2 3]);
ticaFace2 = tica(1)

ticaFace2 = 
  GeometricThermalICs with properties:

            RegionType: 'face'
              RegionID: 2
    InitialTemperature: 20

ticaFace3 = tica(2)

ticaFace3 = 
  GeometricThermalICs with properties:

            RegionType: 'face'
              RegionID: 3
    InitialTemperature: 30

Input Arguments

initialConditions — Initial conditions of a thermal model

InitialConditions property of a thermal model

Initial conditions of a thermal model, specified as the InitialConditions property of a ThermalModel object.

Example: thermalmodel.InitialConditions

RegionType — Geometric region type

"Edge" | "Face" | "Vertex" | "Cell" for a 3-D model

Geometric region type, specified as "Edge", "Face", or "Vertex" for a 2-D model or 3-D model, or "Cell" for a 3-D model.

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 the pdegplot function with the "FaceLabels" (3-D) or "EdgeLabels" (2-D) value set to "on".

Data Types: double

Output Arguments

tica — Thermal initial condition for a particular region

GeometricThermalICs object | NodalThermalICs object

Thermal initial condition for a particular region, returned as a GeometricThermalICs Properties or NodalThermalICs Properties object.

Version History

Introduced in R2017a

R2025a: To be removed

findThermalIC will be removed. Use the CellIC, FaceIC, EdgeIC, and VertexIC properties of femodel instead.

For example, you can check the initial temperatures on the three faces of the 2-D geometry as follows.

model = femodel(AnalysisType="thermalSteady", ...
                Geometry=@lshapeg);
model.FaceIC(1) = faceIC(Temperature=10);
model.FaceIC(2) = faceIC(Temperature=20);
model.FaceIC(3) = faceIC(Temperature=30);
model.FaceIC

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.