tunableRanges

Find upper and lower bounds of tunable properties

Since R2023b

Syntax

T = tunableRanges(aiant)

T = tunableRanges(aiant,option)

Description

T = tunableRanges(aiant) returns a m-by-n table of upper and lower bound values, where m is the number of analysis functions and n is the number of tunable properties of the input aiant object.

T = tunableRanges(aiant,option) returns a table of upper and lower bounds of tunable properties with additional option specified as a string.

Examples

Get Upper and Lower Bounds of AIAntenna Tunable Properties

This example shows how to find the upper and lower bounds of the tunable properties of an AI-based inset-fed microstrip patch antenna for different options.

Create AI-based Inset-Fed Microstrip Patch Antenna

Create an AI-based inset-fed microstrip patch antenna operating at 4.5GHz.

pAI = design(patchMicrostripInsetfed,4.5e9,ForAI=true)

pAI = 
  AIAntenna with properties:

   Antenna Info
               AntennaType: 'patchMicrostripInsetfed'
    InitialDesignFrequency: 4.5000e+09

   Tunable Parameters
                    Length: 0.0300
                     Width: 0.0300
                    Height: 0.0017
            StripLineWidth: 0.0019
               NotchLength: 0.0044
                NotchWidth: 0.0033

Use 'showReadOnlyProperties(pAI)' to show read-only properties

Get Upper and Lower Bounds of Tunable Properties for Different Options

Get the upper and lower bounds of the tunable properties of this antenna for various bound options like "all","strict","loose", or an analysis function.

Get tunable property bounds for default or "all" option.

tAll = tunableRanges(pAI)

tAll=2×6 table
                                Length                  Width                    Height               StripLineWidth             NotchLength                NotchWidth      
                         ____________________    ____________________    ______________________    _____________________    ______________________    ______________________

                           min         max         min         max          min          max          min         max          min          max          min          max   
                         ________    ________    ________    ________    _________    _________    _________    ________    _________    _________    _________    _________
                                                                                                                                                                            
    resonantFrequency    0.025482    0.034476    0.025482    0.034476    0.0014157    0.0019153    0.0016179    0.002189    0.0037752    0.0051076    0.0028314    0.0038307
    bandwidth            0.025482    0.034476    0.025482    0.034476    0.0014157    0.0019153    0.0016179    0.002189    0.0037752    0.0051076    0.0028314    0.0038307

Get tunable property bounds for "strict" option.

tStrict = tunableRanges(pAI,"strict")

tStrict=2×6 table
            Length      Width       Height      StripLineWidth    NotchLength    NotchWidth
           ________    ________    _________    ______________    ___________    __________

    min    0.025482    0.025482    0.0014157      0.0016179        0.0037752     0.0028314 
    max    0.034476    0.034476    0.0019153       0.002189        0.0051076     0.0038307 

Get tunable property bounds for "loose" option.

tLoose = tunableRanges(pAI,"loose")

tLoose=2×6 table
            Length      Width       Height      StripLineWidth    NotchLength    NotchWidth
           ________    ________    _________    ______________    ___________    __________

    min    0.025482    0.025482    0.0014157      0.0016179        0.0037752     0.0028314 
    max    0.034476    0.034476    0.0019153       0.002189        0.0051076     0.0038307 

Get tunable property bounds for "resonantFrequency" analysis method option.

tResFreq = tunableRanges(pAI,"resonantFrequency")

tResFreq=2×6 table
            Length      Width       Height      StripLineWidth    NotchLength    NotchWidth
           ________    ________    _________    ______________    ___________    __________

    min    0.025482    0.025482    0.0014157      0.0016179        0.0037752     0.0028314 
    max    0.034476    0.034476    0.0019153       0.002189        0.0051076     0.0038307 

Input Arguments

aiant — AI-based antenna to calculate resonant frequency

AIAntenna object (default)

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

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

option — Type of upper and lower bounds

"all" (default) | "strict" | "loose" | analysis function

Type of upper and lower bounds to tabulate, specified as either of these strings:

• "all" - List the upper and lower bounds for all the tunable properties and for all the analysis functions.

• "strict" - List the upper and lower bounds for all the tunable properties. The upper bound for a tunable property is chosen as the minimum of all the upper bounds across all the analysis functions for that property. And the lower bound for a property is chosen as the maximum of all the lower bounds across all the analysis functions for that property. This leads to a shorter design space.

• "loose" - List the upper and lower bounds for all the tunable properties. The upper bound for a tunable property is chosen as the maximum of all the upper bounds across all the analysis functions for that property. And the lower bound for a property is chosen as the minimum of all the lower bounds across all the analysis functions for that property. This leads to a larger design space.

• Analysis function - List the upper and lower bounds for all the tunable properties for the specified analysis function.

Example: "strict"

Example: "resonantFrequency"

Data Types: string

Output Arguments

T — Upper and lower bounds of tunable properties

m-by-n table | 2-by-n table

Upper and lower bounds of tunable properties, returned as either a m-by-n table when the option argument is "all" or a 2-by-n table when the option argument is "strict", "loose", or an analysis function. m is the number of analysis functions and n is the number of tunable properties.

Data Types: table

Version History

Introduced in R2023b