addEvaluationParameter

Adds performance goal for sort, pass, or fail matching network design

Description

example

mnobjupdated = addEvaluationParameter(mnobj,parameter,comparison,targetdb,band,weight) adds a performance goal to an existing matching network and returns an updated matching network object.

Examples

collapse all

Create a dipole antenna and create the S-parameters of the antenna. This example requires Antenna Toolbox.

d = dipole('Length', 0.103, 'Width',0.0022);
freq = linspace(0.5e9,2.5e9,1001);
sd = sparameters(d, freq);

Create a matching network from the S-parameters.

n = matchingnetwork('LoadImpedance',sd,'Components',3,...
    'LoadedQ',7,'CenterFrequency',2e9);

Get the evaluation parameters of the network.

t = getEvaluationParameters(n)
t=1×6 table
    Parameter    Comparison     Goal         Band        Weight       Source    
    _________    __________    ______    ____________    ______    _____________

     {'Gt'}        {'>'}       {[-3]}    {1x2 double}    {[1]}     {'Automatic'}

Plot the reflection coefficient and transducer gain of the matching network circuit 1 , at a frequency range of 1 GHz to 2.5 GHz.

rfplot(n, [1e9:0.001e9:2.5e9],1);

Add a new evaluation parameter to compare the transducer gain to have a cut-off of less than -10 dB. Use a frequency range of 0.5 GHz to 1.5 GHz. Plot the comparisons.

n = addEvaluationParameter(n, 'Gt', '<', -10, [0.5e9 1.5e9], 1);
t = getEvaluationParameters(n)
t=2×6 table
    Parameter    Comparison     Goal          Band        Weight          Source      
    _________    __________    _______    ____________    ______    __________________

     {'Gt'}        {'<'}       {[-10]}    {1x2 double}    {[1]}     {'User-specified'}
     {'Gt'}        {'>'}       {[ -3]}    {1x2 double}    {[1]}     {'Automatic'     }

rfplot(n, [1e9:0.001e9:2.5e9],1);

Clear evaluation parameters.

n = clearEvaluationParameter(n,1);
t = getEvaluationParameters(n)
t=1×6 table
    Parameter    Comparison     Goal         Band        Weight       Source    
    _________    __________    ______    ____________    ______    _____________

     {'Gt'}        {'>'}       {[-3]}    {1x2 double}    {[1]}     {'Automatic'}

Input Arguments

collapse all

Matching network, specified as a matchingnetwork object.

Data Types: char | string

Evaluation parameter to define targets for input reflection coefficients or transducer gain for matching networks when cascaded between source and load impedance, specified as 'gammain' or 'Gt'.

Data Types: char | string

Comparison to rank, pass, or fail matching networks, specified as '<' or '>'.

Data Types: char | string

Cut-off that determines a particular performance goal, specified as a scalar in dB. The targetdb is shaded when you use the rfplot function. The shade is green when the matching network meets the performance goal. The shade is red when the matching network does not meet the performance goal.

Data Types: double

Frequency range in which the performance goal or the specifications are applied to matching network, specified as a vector with each element in Hz.

Data Types: double

Weight factor of each performance goal when you specify more than one goal, specified as a scalar in the range of 0 to 1.

Data Types: double

Output Arguments

collapse all

Matching network updated according to evaluation parameters, returned as a matchingnetwork object.

Introduced in R2019a