findElectromagneticBC

(To be removed) Find electromagnetic boundary conditions assigned to geometric region

Since R2021a

findElectromagneticBC will be removed. Use the FaceBC and EdgeBC properties property of femodel instead. (since R2023a) For more information on updating your code, see Version History.

Syntax

emBC = findElectromagneticBC(boundaryConditions,RegionType,RegionID)

Description

emBC = findElectromagneticBC(boundaryConditions,RegionType,RegionID) returns the boundary conditions assigned to the specified region of the specified model.

Examples

Find Electromagnetic Boundary Conditions for Edges of 2-D Geometry

Create an electromagnetic model for magnetostatic analysis.

emagmodel = createpde("electromagnetic","magnetostatic");

Include an L-shaped membrane geometry in the model and plot it with the face labels.

geometryFromEdges(emagmodel,@lshapeg);
pdegplot(emagmodel,"FaceLabels","on")
ylim([-1.1 1.1])
axis equal

Assign magnetic potential values to edges 1 and 2.

electromagneticBC(emagmodel,"Edge",1,"MagneticPotential",1);
electromagneticBC(emagmodel,"Edge",2,"MagneticPotential",0);

Check the boundary condition specifications for edges 1 and 2.

emBC = findElectromagneticBC(emagmodel.BoundaryConditions,"Edge",1:2);
emBC(1)

ans = 
  ElectromagneticBCAssignment with properties:

             RegionID: 1
           RegionType: 'Edge'
           Vectorized: 'off'
           InternalBC: []
    MagneticPotential: 1

emBC(2)

ans = 
  ElectromagneticBCAssignment with properties:

             RegionID: 2
           RegionType: 'Edge'
           Vectorized: 'off'
           InternalBC: []
    MagneticPotential: 0

Input Arguments

boundaryConditions — Boundary conditions of electromagnetic model

BoundaryConditions property

Boundary conditions of an electromagnetic model, specified as the BoundaryConditions property of the model.

Example: findElectromagneticBC(emagmodel.BoundaryConditions,"Edge",1)

RegionType — Geometric region type

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

Geometric region type, specified as "Edge" for a 2-D model or "Face" 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 edge or face IDs by using pdegplot with the "EdgeLabels" or "FaceLabels" name-value argument set to "on".

Data Types: double

Output Arguments

emBC — Electromagnetic boundary condition assignment

ElectromagneticBCAssignment object

Electromagnetic boundary condition assignment, returned as an ElectromagneticBCAssignment object. For more information, see ElectromagneticBCAssignment Properties.

Version History

Introduced in R2021a

R2025a: To be removed

findElectromagneticBC will be removed. Use the FaceBC and EdgeBC properties of femodel instead.

For example, you can check the boundary conditions for particular edges as follows.

model = femodel(AnalysisType="magnetostatic", ...
                Geometry=@lshapeg);
model.EdgeBC(1) = edgeBC(MagneticPotential=1);
model.EdgeBC(2) = edgeBC(MagneticPotential=0);
model.EdgeBC

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.