Main Content


Enable catalog antenna elements for AI-based design space exploration

Since R2023b


    The AIAntenna object lets you convert a regular antenna from the antenna catalog to an AI-based object and leverage AI-based analysis for rapid characterization and design space exploration. Using AI-based antenna models over conventional full-wave solvers significantly reduces the simulation time required to fine-tune the antenna to meet your design goals.


    You can create an AIAntenna object for the supported catalog elements by setting the ForAI name-value argument to true in the design function. This object has 2 fixed read-only Properties and catalog element specific dynamic properties which are either tunable or read-only. See the individual catalog element pages for details on these dynamic properties.


    expand all

    Info Properties

    Since R2023b

    This property is read-only.

    Antenna type from the Antenna Catalog, returned as a string.

    Example: "patchMicrostrip"

    Data Types: string

    This property is read-only.

    Initial design frequency used to create the AIAntenna, returned as a positive scalar.

    Example: 1e9

    Data Types: double

    Object Functions

    defaultTunableParametersGet default values of tunable properties
    exportAntennaExport tunable property values of AI-based antenna to equivalent catalog element
    resonantFrequencyCalculate resonant frequency of antenna
    resetReset tunable property values to default
    showDisplay antenna, array structures, shapes, or platform
    tunableRangesFind upper and lower bounds of tunable properties


    collapse all

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

    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

    Vary its length and width and calculate its resonant frequency.

    pAI.Length = 0.0855;
    pAI.Width = 0.113;
    fR = resonantFrequency(pAI)
    fR = 1.6806e+09

    Convert the AIAntenna 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]

    Version History

    Introduced in R2023b