addEvaluationParameter

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

Syntax

mnobjupdated = addEvaluationParameter(mnobj,parameter,comparison,targetdb,band,weight)

Description

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

Matching Network From Dipole Antenna

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);

Alternatively, load S-Parameters from the MAT file

% load('sparams_dipole.mat')

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'}        {'>'}       {[ -3]}    {1x2 double}    {[1]}     {'Automatic'     }
     {'Gt'}        {'<'}       {[-10]}    {1x2 double}    {[1]}     {'User-specified'}

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'}        {'<'}       {[-10]}    {1x2 double}    {[1]}     {'User-specified'}

Input Arguments

mnobj — Matching network

matchingnetwork object

Matching network, specified as a matchingnetwork object.

Data Types: char | string

parameter — Evaluation parameter

'gammain' | 'Gt'

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 — Comparison to rank, pass, or fail matching networks

'<' | '>'

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

Data Types: char | string

targetdb — Cut-off that determines particular performance goal

scalar

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

band — Frequency range in which performance goal or specifications are applied to matching network

vector

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 — Weight factor of each performance goal

scalar

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

mnobjupdated — Matching network updated according to evaluation parameters

matchingnetwork object

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