ElectromagneticModel

Electromagnetic model object

Description

An ElectromagneticModel object contains information about an electromagnetic analysis problem: the geometry, material properties, electromagnetic sources, boundary conditions, and mesh.

Creation

To create a ElectromagneticModel object, use the createpde function and specify "electromagnetic" as its first argument .

Properties

AnalysisType — Type of electromagnetic analysis

'electrostatic' | 'magnetostatic' | 'harmonic' | 'electrostatic-axisymmetric' | 'magnetostatic-axisymmetric' | 'harmonic-axisymmetric'

Type of electromagnetic analysis, returned as 'electrostatic', 'magnetostatic', 'harmonic', 'electrostatic-axisymmetric', 'magnetostatic-axisymmetric', or 'harmonic-axisymmetric'.

To change an electromagnetic analysis type, assign a new type to model.AnalysisType. Ensure that all other properties of the model are consistent with the new analysis type.

Geometry — Geometry description

AnalyticGeometry | DiscreteGeometry

Geometry description, returned as an AnalyticGeometry or DiscreteGeometry object.

MaterialProperties — Material properties within domain

object containing material property assignments

Material properties within the domain, returned as an object containing the material property assignments.

Sources — Electromagnetic sources within the domain or subdomain

object containing heat source assignments

Electromagnetic source within the domain or subdomain, returned as an object containing electromagnetic source assignments.

BoundaryConditions — Boundary conditions applied to geometry

object containing boundary condition assignments

Boundary conditions applied to the geometry, returned as an object containing the boundary condition assignments.

VacuumPermittivity — Permittivity of vacuum for entire model

number

Permittivity of vacuum for the entire model, returned as a number. This value must be consistent with the units of the model. If the model parameters are in the SI system of units, then the permittivity of vacuum must be 8.8541878128E-12.

VacuumPermeability — Permeability of vacuum for entire model

number

Permeability of vacuum for the entire model, returned as a number. This value must be consistent with the units of the model. If the model parameters are in the SI system of units, then the permeability of vacuum must be 1.2566370614E-6.

Mesh — Mesh for solution

FEMesh object

Mesh for the solution, returned as a FEMesh object. See FEMesh Properties. You create the mesh using the generateMesh function. For a 3-D magnetostatic model, the mesh must be linear.

SolverOptions — Algorithm options for PDE solvers

PDESolverOptions object

Algorithm options for the PDE solvers, returned as a PDESolverOptions object. The properties of a PDESolverOptions object include absolute and relative tolerances for internal ODE solvers, maximum solver iterations, and so on. For details, see PDESolverOptions Properties.

FieldType — Type of field for harmonic analysis

'electric' (default) | 'magnetic'

Type of field for a harmonic analysis, returned as 'electric' or 'magnetic'.

Object Functions

geometryFromEdges	Create 2-D geometry from decomposed geometry matrix
geometryFromMesh	Create 2-D or 3-D geometry from mesh
importGeometry	Import 2-D or 3-D geometry from STL data
generateMesh	Create triangular or tetrahedral mesh
electromagneticProperties	Assign properties of material for electromagnetic model
electromagneticSource	Specify current density or charge density for electromagnetic model
electromagneticBC	Apply boundary conditions to electromagnetic model
solve	Solve heat transfer, structural analysis, or electromagnetic analysis problem

Examples

Create Electromagnetic Model

Create a model for electrostatic analysis.

emagE = createpde("electromagnetic","electrostatic")

emagE = 
  ElectromagneticModel with properties:

          AnalysisType: "electrostatic"
              Geometry: []
    MaterialProperties: []
               Sources: []
    BoundaryConditions: []
    VacuumPermittivity: []
                  Mesh: []

Create an axisymmetric model for magnetostatic analysis. An axisymmetric model simplifies a 3-D problem to a 2-D problem using symmetry around the axis of rotation.

emagMA = createpde("electromagnetic","magnetostatic-axisymmetric")

emagMA = 
  ElectromagneticModel with properties:

          AnalysisType: "magnetostatic-axisymmetric"
              Geometry: []
    MaterialProperties: []
               Sources: []
    BoundaryConditions: []
    VacuumPermeability: []
                  Mesh: []

Create a model for harmonic analysis.

emagH = createpde("electromagnetic","harmonic")

emagH = 
  ElectromagneticModel with properties:

          AnalysisType: "harmonic"
              Geometry: []
    MaterialProperties: []
               Sources: []
    BoundaryConditions: []
    VacuumPermittivity: []
    VacuumPermeability: []
                  Mesh: []
             FieldType: "electric"

Version History

Introduced in R2021a