solver

Access FMM solver settings for electromagnetic analysis

Since R2021b

Description

Use the solver object to access the fast multipole method (FMM) solver settings in the large antenna structures such as egg crate, platform-installed antenna, plane wave excitation environment, and curved reflectors for electromagnetic (EM) analysis.

Creation

Syntax

s = solver(obj)

Description

s = solver(obj) returns the solver used in the antenna defined in obj for EM analysis. For more information on EM analysis, see Analysis. After you create a solver object, you can modify the object properties using dot notation.

Note

You must set the SolverType property to 'FMM' in the egg crate, platform-installed antenna, plane wave excitation environment, or curved reflector antenna objects to access the solver object.

Input Arguments

obj — Large antenna

eggCrate object | installedAntenna object | planeWaveExcitation object | curved reflector objects

Large antenna, specified as one of the following:

Antenna Name	Antenna Objects
Egg crate	eggCrate
Platform-installed antenna	installedAntenna
Plane wave excitation environment	planeWaveExcitation
Curved reflectors	cassegrain cassegrainOffset gregorian gregorianOffset reflectorParabolic reflectorSpherical

Example: s = solver(obj)

Properties

Iterations — Maximum number of iterations

100 (default) | positive scalar

Maximum number of iterations needed by the FMM solver to achieve convergence, specified as a positive scalar. During EM analysis, if convergence is achieved with fewer iterations than the maximum number of iterations specified using this property, the FMM solver terminates the EM analysis and displays the EM analysis solutions.

Example: obj.Iterations = 150;

RelativeResidual — Residual error allowed in EM solution

1.0000e-4 (default) | positive scalar

Residual error allowed in EM solution, specified as a positive scalar.

Example: obj.RelativeResidual = 1.5e-3;

Precision — FMM solver precision

2.0000e-4 (default) | positive scalar

FMM solver precision, specified as a positive scalar.

Example: obj.Precision = 2.0000e-5;

Object Functions

convergence

Calculate and plot convergence of FMM solver

Examples

Calculate and Plot Convergence of FMM Solver

Design a default parabolic reflector antenna.

m = reflectorParabolic;

Set the solver type of the parabolic reflector antenna to FMM.

m.SolverType = 'FMM';

Calculate the impedance of the parabolic reflector antenna at 10 GHz.

Z = impedance(m,10e9);

Access the FMM solver and set the relative residual to 1e-3.

s = solver(m);
s.RelativeResidual = 1e-3;

Calculate and plot the convergence of the FMM solver for the parabolic reflector antenna.

convergence(s)

Version History

Introduced in R2021b