ElectromagneticMaterialAssignment Properties

(To be removed) Electromagnetic material properties assignments

Since R2021a

findElectromagneticProperties will be removed. Use the MaterialProperties property of femodel instead. (since R2023a) For more information on updating your code, see Version History.

An ElectromagneticMaterialAssignment object describes the material properties of an electromagnetic model. An ElectromagneticModel object contains a vector of ElectromagneticMaterialAssignment objects in its MaterialProperties.MaterialAssignments property.

Create material property assignments for your electromagnetic model using the electromagneticProperties function.

Properties

RegionType — Geometric region type

"Face" for a 2-D model | "Cell" for a 3-D model

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

Data Types: char | string

RegionID — Region ID

vector of positive integers

Region ID, specified as a vector of positive integers. Find the face or cell IDs by using pdegplot with the "FaceLabels" or "CellLabels" name-value argument set to "on".

Data Types: double

RelativePermittivity — Relative permittivity of material

positive number | complex number | function handle

Relative permittivity of the material, specified as a positive or complex number or a function handle.

• A positive number specifies a relative permittivity for an electrostatic analysis.

• A complex number specifies a relative permittivity for a harmonic electromagnetic analysis.

• A function handle specifies a relative permittivity that depends on the coordinates or, for a harmonic analysis, on the frequency.

Data Types: double | function_handle
Complex Number Support: Yes

RelativePermeability — Relative permeability of material

positive number | complex number | function handle

Relative permeability of the material, specified as a positive or complex number or a function handle.

• A positive number specifies a relative permeability for a magnetostatic analysis.

• A complex number specifies a relative permeability for a harmonic electromagnetic analysis.

• A function handle specifies a relative permeability that depends on the coordinates or, for a harmonic analysis, on the frequency.

Data Types: double | function_handle
Complex Number Support: Yes

Conductivity — Conductivity of material

nonnegative number | function handle

Conductivity of the material, specified as a nonnegative number or a function handle. A function handle specifies a conductivity that depends on the coordinates or, for a harmonic analysis, on the frequency.

Data Types: double | function_handle

Tips

• When there are multiple assignments to the same face, the toolbox uses the last applied setting.

• To avoid assigning material properties to the wrong region, check that you are using the correct face IDs and cell IDs by plotting and visually inspecting the geometry. Use pdegplot with the "FaceLabels" or "CellLabels" name-value argument set to "on".

Version History

Introduced in R2021a

R2025a: To be removed

ElectromagneticMaterialAssignment will be removed. Use the MaterialProperties property of femodel instead.

For example, you can check the electromagnetic properties of the block as follows.

model = femodel(AnalysisType="electrostatic", ...
                Geometry=@lshapeg);
model.MaterialProperties(1) = ...
  materialProperties(RelativePermittivity=2.5);
model.MaterialProperties(2) = ...
  materialProperties(RelativePermittivity=2.25);
model.MaterialProperties(3) = ...
  materialProperties(RelativePermittivity=1);
model.MaterialProperties

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 ElectromagneticModel to the unified finite element workflow, see Migration from Domain-Specific to Unified Workflow.