peakRadiation

R2026b

Calculate maximum radiation points of AI-based antenna

Since R2025a

Syntax

peakRadiation(aiant,frequency)

rad = peakRadiation(aiant,frequency)

[rad,az,el] = peakRadiation(aiant,frequency)

Description

peakRadiation(aiant,frequency) calculates the maximum radiation value (gain) in dBi of an AI-based antenna object at the specified frequency and displays a visualization of the far-field analysis, including:

• Peak radiation direction

• Beamwidth spans in the principal planes

• Supporting geometric context

The calculated peak radiation value is also displayed in the output.

rad = peakRadiation(aiant,frequency) calculates and returns the maximum radiation value (gain) in dBi of the AI-based antenna object at the specified frequency.

[rad,az,el] = peakRadiation(aiant,frequency) calculates and returns the maximum radiation value (gain) in dBi and its corresponding azimuth and elevation coordinates of the AI-based antenna object at the specified frequency.

Examples

Calculate Radiation Peak Point of AI-based Microstrip Patch Antenna

This example shows how to create an AI-based microstrip patch antenna operating at 1.67 GHz, and calculate its radiation peak point.

Use the design function with the ForAI argument set to true to create an AI-based microstrip patch antenna operating at 1.67 GHz.

pAI = design(patchMicrostrip,1.67e9,ForAI=true)

pAI = 
  AIAntenna with properties:

   Antenna Info
               AntennaType: 'patchMicrostrip'
    InitialDesignFrequency: 1.6700e+09

   Tunable Parameters
                    Length: 0.0862
                     Width: 0.1122
                    Height: 0.0018

Show read-only properties

Explore the design space by changing its length and width with values within the tunable range of these properties. You can get the tunable range of a property by using tunableRanges function on the AI-based antenna object.

pAI.Length = 0.0855;
pAI.Width = 0.113;

Calculate the maximum gain value of the antenna and its azimuth and elevation coordinates.

[rad,az,el] = peakRadiation(pAI,1.67e9)

rad = 
10.0822

az = 
0.8794

el = 
88.6926

Visualize Peak Radiation During Parameter Sweep

Create an AI-based microstrip H-notch patch antenna operating at 1 GHz.

f0 = 1e9;
aiant = design(patchMicrostripHnotch, f0, ForAI=true);

Perform length sweep. Visualize the peak radiation at each step.

tol = 0.85:0.05:1.15;
for k = 1:numel(tol)
    aiant.Length = tol(k) * aiant.Length0;
    peakRadiation(aiant,f0)
    pause(0.5); 
end

ans = 
5.6076

ans = 
6.2611

ans = 
7.2607

ans = 
7.8373

ans = 
6.8617

ans = 
5.8131

ans = 
5.4082

Input Arguments

aiant — AI-based antenna

AIAntenna object

AI-based antenna, specified as an AIAntenna object created using the design function.

Example: aiant = design(patchMicrostrip,1.67e9,ForAI=true); rad = peakRadiation(aiant,1.67e9) calculates and returns the maximum radiation value of AI-based microstrip patch antenna at 1.67 GHz.

frequency — Frequency to calculate radiation peak

scalar in Hertz

Frequency to calculate radiation peak, specified as a scalar in Hertz.

Example: 70e6

Data Types: double

Output Arguments

rad — Maximum radiation value

scalar in dBi

Maximum radiation value, returned as a scalar in dBi.

Example: 10

Data Types: double

az — Azimuth coordinate of maximum radiation point

scalar in degrees | vector in degrees | []

Azimuth coordinate of maximum radiation point, returned as:

• A scalar in degrees for a radiation pattern with a single peak.

• A vector in degrees for a radiation pattern with multiple peaks.

• An empty vector for omnidirectional and near-omnidirectional radiation patterns.

Example: 0

Data Types: double

el — Elevation coordinate of maximum radiation point

scalar in degrees

Elevation coordinate of maximum radiation point, returned as a scalar in degrees.

Example: 90

Data Types: double

Version History

Introduced in R2025a

R2026b: Visualize peak radiation

You can now visualize peak radiation in 3-D, providing clear geometric context to interpret results, compare designs, and validate analysis before full-wave simulation. To plot the peak radiation, run the peakRadiation function without output arguments.