Main Content

thermalProperties

(To be removed) Assign thermal properties of a material for a thermal model

thermalProperties will be removed. Use materialProperties instead. (since R2023a) For more information on updating your code, see Version History.

Description

thermalProperties(thermalmodel,"ThermalConductivity",TCval,"MassDensity",MDval,"SpecificHeat",SHval) assigns material properties, such as thermal conductivity, mass density, and specific heat. For transient analysis, specify all three properties. For steady-state analysis, specifying thermal conductivity is enough. This syntax sets material properties for the entire geometry.

For a nonconstant or nonlinear material, specify TCval, MDval, and SHval as function handles.

example

thermalProperties(___,RegionType,RegionID) assigns material properties for a specified geometry region.

mtl = thermalProperties(___) returns the material properties object.

Examples

collapse all

Assign material properties for a steady-state thermal model.

model = createpde("thermal","steadystate");
gm = importGeometry(model,"SquareBeam.stl");
thermalProperties(model,"ThermalConductivity",0.08)
ans = 
  ThermalMaterialAssignment with properties:

             RegionType: 'cell'
               RegionID: 1
    ThermalConductivity: 0.0800
            MassDensity: []
           SpecificHeat: []

Input Arguments

collapse all

Thermal model, specified as a ThermalModel object. The model contains the geometry, mesh, thermal properties of the material, internal heat source, boundary conditions, and initial conditions.

Example: thermalmodel = createpde("thermal","steadystate")

Geometric region type, specified as "Face" or "Cell".

Example: thermalProperties(thermalmodel,"Cell",1,"ThermalConductivity",100)

Data Types: char | string

Geometric region ID, specified as a vector of positive integers. Find the region IDs by using pdegplot.

Example: thermalProperties(thermalmodel,"Cell",1:3,"ThermalConductivity",100)

Data Types: double

Thermal conductivity of the material, specified as a positive number, a matrix, or a function handle. You can specify thermal conductivity for a steady-state or transient model. In case of orthotropic thermal conductivity, use a thermal conductivity matrix.

Use a function handle to specify the thermal conductivity that depends on space, time, or temperature. For details, see More About.

Example: thermalProperties(thermalmodel,"Cell",1,"ThermalConductivity",100) or thermalProperties(thermalmodel,"ThermalConductivity",[80;10;80]) for orthotropic thermal conductivity

Data Types: double | function_handle

Mass density of the material, specified as a positive number or a function handle. Specify this property for a transient thermal conduction analysis model.

Use a function handle to specify the mass density that depends on space, time, or temperature. For details, see More About.

Example: thermalProperties(thermalmodel,"Cell",1,"ThermalConductivity",100,"MassDensity",2730e-9,"SpecificHeat",910)

Data Types: double | function_handle

Specific heat of the material, specified as a positive number or a function handle. Specify this property for a transient thermal conduction analysis model.

Use a function handle to specify the specific heat that depends on space, time, or temperature. For details, see More About.

Example: thermalProperties(thermalmodel,"Cell",1,"ThermalConductivity",100,"MassDensity",2730e-9,"SpecificHeat",910)

Data Types: double | function_handle

Output Arguments

collapse all

Handle to material properties, returned as a ThermalMaterialAssignment object. See ThermalMaterialAssignment Properties.

mtl associates material properties with the geometric region.

More About

collapse all

Version History

Introduced in R2017a

collapse all