Main Content

bandwidth

Calculate absolute bandwidth of AI-based antenna

Since R2024a

collapse all in page

    Syntax

    bandwidth(aiant)
    [absBW,fL,fU,matching] = bandwidth(aiant)

    Description

    bandwidth(aiant) calculates and returns the absolute bandwidth of the AI-based antenna model.

    [absBW,fL,fU,matching] = bandwidth(aiant) calculates and returns the absolute bandwidth, its lower and upper frequency bound, and impedance matching status of the AI-based antenna model.

    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 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.

    Output Arguments

    collapse all

    Absolute bandwidth of the specified AI-based antenna in Hz, returned as a positive scalar.

    Example: 2.3422e7

    Data Types: double

    Lower frequency bound of the bandwidth in Hz, returned as a positive scalar.

    Example: 1.6679e9

    Data Types: double

    Upper frequency bound of bandwidth in Hz, returned as positive scalar.

    Example: 1.6913e9

    Data Types: double

    Impedance match to 50 ohms, returned as "Matched", "Almost", or "Not Matched". When the value is:

    • "Matched" — The antenna S11 dips below –10 dB.

    • "Almost" — The antenna S11 dip is around –8 dB to –10 dB.

    • "Not Matched" — The antenna S11 dip is around –8 dB or less (toward zero).

    Data Types: categorical

    Version History

    Introduced in R2024a

    See Also

    Objects

    Functions

    Topics