addEvaluationParameter
Adds performance goal for sort, pass, or fail matching network design
Description
adds a performance goal to an existing matching network and returns an updated
matching network object.mnobjupdated
= addEvaluationParameter(mnobj
,parameter
,comparison
,targetdb
,band
,weight
)
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]} {[1.8571e+09 2.1429e+09]} {[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]} {[1.8571e+09 2.1429e+09]} {[1]} {'Automatic' }
{'Gt'} {'<'} {[-10]} {[ 500000000 1.5000e+09]} {[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]} {[500000000 1.5000e+09]} {[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.
Version History
Introduced in R2019a
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)