ElectromagneticSourceAssignment Properties

(To be removed) Electromagnetic source assignments

Since R2021a

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

An ElectromagneticSourceAssignment object describes the source of an electromagnetic model. An ElectromagneticModel object contains a vector of ElectromagneticSourceAssignment objects in its Sources.SourceAssignments property.

Create electromagnetic source assignments for your model using the electromagneticSource 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 model or "Cell" for a 3-D model.

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

ChargeDensity — Charge density

real number | function handle

Charge density, specified as a real number or a function handle. Use a function handle to specify a charge density that depends on the coordinates.

Data Types: double | function_handle

CurrentDensity — Current density

real number | column vector | function handle | ConductionResults object

Current density, specified as a real number, a column vector, a function handle, or a ConductionResults object. Use a function handle to specify a current density that depends on the coordinates.

For magnetostatic analysis, the current density must be a real number for a 2-D model, a column vector of three elements for a 3-D model, a function handle for a 2-D or 3-D model, or a ConductionResults object for a 3-D model.

For harmonic analysis with the electric field type, the current density must be a column vector of two elements for a 2-D model, a column vector of three elements for a 3-D model, or a function handle for a 2-D or 3-D model. The toolbox multiplies the specified current density value by -i and by frequency.

For harmonic analysis with the magnetic field type, the current density must be a scalar for a 2-D model, a column vector of three elements for a 3-D model, or a function handle for a 2-D or 3-D model. The toolbox uses the curl of the specified current density.

Data Types: double | function_handle

Magnetization — Magnetization

column vector | function handle

Magnetization, specified as a column vector of two elements for a 2-D model, a column vector of three elements for a 3-D model, or a function handle. Use a function handle to specify a magnetization that depends on the coordinates.

Data Types: double | function_handle

Version History

Introduced in R2021a

R2025a: To be removed

ElectromagneticSourceAssignment will be removed. Use the CellLoad and FaceLoad properties of femodel instead.

For example, you can check the electromagnetic source for the three faces of the 2-D geometry as follows.

model = femodel(AnalysisType="magnetostatic", ...
                Geometry=@lshapeg);
model.FaceLoad(1) = faceLoad(CurrentDensity=10);
model.FaceLoad(2) = faceLoad(CurrentDensity=20);
model.FaceLoad(3) = faceLoad(CurrentDensity=30);
model.FaceLoad

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.