Main Content

resonantFrequency

Calculate resonant frequency of AI-based antenna

Since R2023b

Description

fR = resonantFrequency(aiant) calculates the resonant frequency of the AI-based antenna for current values of the tunable properties.

example

Examples

collapse all

This example shows how to create an AI-based microstrip patch antenna operating at 1.67 GHz, and calculate its bandwidth and resonant frequency.

Use the design function with the ForAI argument set to true to create an AI-based microstrip patch antenna operating at 1.67 GHz. To use the ForAI argument in the design function you need a license to the Statistics and Machine Learning Toolbox™.

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

Use 'showReadOnlyProperties(pAI)' to 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 absolute bandwidth of the antenna and its lower and upper bounds.

[absBW,fL,fU,matchingStatus] = bandwidth(pAI)
absBW = 
2.3422e+07
fL = 
1.6679e+09
fU = 
1.6913e+09
matchingStatus = categorical
     Matched 

Calculate the resonant frequency of the antenna.

fR = resonantFrequency(pAI)
fR = 
1.7016e+09

Convert the AI-based microstrip patch antenna to a regular microstrip patch antenna.

pm = exportAntenna(pAI)
pm = 
  patchMicrostrip with properties:

               Length: 0.0855
                Width: 0.1130
               Height: 0.0018
            Substrate: [1x1 dielectric]
    GroundPlaneLength: 0.1795
     GroundPlaneWidth: 0.1795
    PatchCenterOffset: [0 0]
           FeedOffset: [0.0181 0]
            Conductor: [1x1 metal]
                 Tilt: 0
             TiltAxis: [1 0 0]
                 Load: [1x1 lumpedElement]

Input Arguments

collapse all

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

Example: design(patchMicrostrip,1.67e9,ForAI=true)

Output Arguments

collapse all

Resonant frequency of the antenna for current values of tunable properties, returned as a scalar in Hertz.

Example: 6.1104e9

Version History

Introduced in R2023b