peakRadiation

Calculate maximum radiation points of AI-based antenna

Since R2025a

collapse all in page

    Syntax

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

    Description

    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.

    example

    Examples

    collapse all

    This example uses:

    Open Live Script

    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

    Input Arguments

    collapse all

    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 to calculate radiation peak, specified as a scalar in Hertz.

    Example: 70e6

    Data Types: double

    Output Arguments

    collapse all

    Maximum radiation value, returned as a scalar in dBi.

    Example: 10

    Data Types: double

    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

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

    Example: 90

    Data Types: double

    Version History

    Introduced in R2025a

    See Also

    Objects

    Functions