SimRF™ Reference
SimRF™ Reference
SimRF™ Reference
Reference
R2014a
How to Contact MathWorks
www.mathworks.com Web
comp.soft-sys.matlab Newsgroup
www.mathworks.com/contact_TS.html Technical Support
508-647-7000 (Phone)
508-647-7001 (Fax)
Trademarks
MATLAB and Simulink are registered trademarks of The MathWorks, Inc. See
www.mathworks.com/trademarks for a list of additional trademarks. Other product or brand
names may be trademarks or registered trademarks of their respective holders.
Patents
MathWorks products are protected by one or more U.S. patents. Please see
www.mathworks.com/patents for more information.
Revision History
September 2010 Online only New for Version 3.0 (Release 2010b)
April 2011 Online only Revised for Version 3.0.2 (Release 2011a)
September 2011 Online only Revised for Version 3.1 (Release 2011b)
March 2012 Online only Revised for Version 3.2 (Release 2012a)
September 2012 Online only Revised for Version 3.3 (Release 2012b)
March 2013 Online only Revised for Version 4.0 (Release 2013a)
September 2013 Online only Revised for Version 4.1 (Release 2013b)
March 2014 Online only Revised for Version 4.2 (Release 2014a)
Contents
v
vi Contents
1
Library Elements
Description Use the Amplifier block to model a linear or nonlinear amplifier, with
or without noise. Defining the amplifier gain using a data source
also defines input data visualization and modeling. Use the Main
tab parameters to specify amplifier gain and noise using data sheet
values, standard s2p files, S-parameters or circuit envelope polynomial
coefficients.
The amplifier is implemented as a polynomial, voltage-controlled
voltage source (VCVS). The VCVS includes nonlinearities that are
described using parameters listed in the Nonlinearity tab. To model
linear amplification, the amplifier implements the relation Vout = a1*Vin
between the input and output voltages. The input voltage is Vi(t) =
Ai(t)ejωt, and the output voltage is Vo(t) = Ao(t)ejωt at each carrier w =
2πf in the SimRF™ environment.
Nonlinear amplification is modeled as a polynomial (with the
saturation power computed automatically). It also produces additional
intermodulation frequencies.
1-2
Amplifier
1-3
Amplifier
s21
a1
1 s11
for the maximal value of S21.
When using the data source option, S11 and S22, are used as the
input and output impedances. The data sources are specified
using either Data file or Network-parameters or Rational
model, depending on the value of Data source.
• Polynomial coefficients — The block implements a
nonlinear voltage gain according to the polynomial you specify.
The order of the polynomial must be less than or equal to 9.
The coefficients are ordered in ascending powers. If a vector
has 10 coefficients, [a0,a1,a2, ... a9], the polynomial it
represents is:
Vout = a0 + a1Vin + a2Vin2 + ... + a9Vin9
1-4
Amplifier
1-5
Amplifier
⎛ n Ck ⎞
F (s) = ⎜ ∑ + D ⎟ , s = j 2πf
⎜ ⎟
⎝ k=1 s − Ak ⎠
In this rational model equation, each Ck is the residue of the
pole Ak. If Ck is complex, a corresponding complex conjugate
pole and residue must also be enumerated. The example,
Model an RF Filter Using S-Parameter Data, shows how
to use the RF Toolbox™ rationalfit function to create an
rfmodel.rational object. This object has the properties C, A,
and D. You can use these properties to specify the Residues,
Poles, and Direct feedthrough parameters.
Noise figure (dB)
Specify the noise figure of the amplifier. The default value of this
parameter is 0 dB, which implies that no noise is added to the
system by this block.
1-6
Amplifier
Nonlinearity Tab
1-7
Amplifier
• When you select Odd order, the amplifier generates only odd
order intermodulation frequencies.
The linear gain determines the linear a1 term. The block
calculates the remaining terms from the specified parameters.
These parameters are IP3, 1-dB gain compression power,
Output saturation power, and Gain compression at
saturation. The number of constraints you specify determines
the order of the model.
1-8
Amplifier
1-9
Amplifier
1-10
Amplifier
Modeling Tab
Setting Source of amplifier gain to Data source activates the
Modeling Tab.
Modeling options
Modeling domain. Select Frequency domain or Time domain
(rationalfit) from the drop-down list.
1-11
Amplifier
Visualization Tab
Setting Source of amplifier gain to Data source activates the
Visualization tab.
1-12
Amplifier
1-13
Amplifier
1-14
Amplifier
Y-axis scale
Scale for the Y-axis.
addpath(fullfile(docroot,'toolbox','simrf','examples'))
ex_amplify_simulink_signal
1-15
Amplifier
1-16
Amplifier
The Outputscope displays both the Real Passband signal and the
change in magnitude of the input ramp signal.
1-17
Amplifier
1-18
Amplifier
1-19
C (Capacitor)
Library Elements
Dialog
Box and
Parameters
Capacitance
Specify the capacitance, C, as either 0 or a real number greater
than or equal to 1e-18 F. If you set this parameter to a value
between 0 and 1e-18 F, the block uses a value equal to 1e-18 F
during simulation. The default value of this parameter is 1e-12 F.
1-20
C (Capacitor)
1-21
Circulator
Library Junctions
Description Use the Circulator block to model ideal passive three-port circulators in
a circuit envelope environment.
Select component
• Circulator clockwise
The default option is Circulator clockwise. The s-parameter
matrix for Circulator clockwise is:
1-22
Circulator
0 0 1
1 0 0
0
When1 0
you select this option, the following parameter is
available:
— Reference impedances (Ohm)
Specify the reference impedances of Circulator clockwise
as a scalar or three-tuple. The default values are 50 Ohms.
• Circulator counter clockwise
The s-parameter matrix for Circulator counter clockwise
is:
0 1 0
0 0 1
1
When0 0
you select this option, the following parameter is
available:
— Reference impedances (Ohm)
Specify the reference impedances of Circulator counter
clockwise as a scalar or three-tuple. The default values
are 50 Ohms.
1-23
Configuration
Library Utilities
Description Use the Configuration block to set the model conditions for a circuit
envelope simulation. The block parameters define a set of simulation
frequencies, solver attributes, and thermal noise.
Connect one Configuration block to each topologically distinct SimRF
subsystem. Each Configuration block defines the parameters of the
connected SimRF subsystem. To see an example of the Configuration
block in a model, enter simrfV2_noise in a MATLAB Command
Window.
For an introduction to RF simulation, see “Simulate High Frequency
Components”.
Dialog
Box and
Parameters
1-24
Configuration
1-25
Configuration
1-26
Configuration
I 2 Q2
In this case, the corresponding passband signal at ω is represented
by the equation
I 2 Q2
2
In this case, the corresponding passband signal at ω represented
by the equation
1-27
Configuration
1-28
Configuration
References Motchenbacher, C.D. and J.A. Connely. Low Noise Electronic System
Design. New York: John Wiley & Sons, 1993.
Rodrigues, Paulo J. C. Computer-Aided Analysis of Nonlinear
Microwave Circuits. Norwood, MA: Artech House, Inc., 1998.
1-29
Continuous Wave
Library Sources
Description
v(t) = v0 e jkt
or
i(t) = i0 e jkt
at the carrier ωk, depending on the source type.
1-30
Continuous Wave
Dialog
Box and
Parameters
Source type
Specify the wave type as:
• Ideal Voltage — The block simulates a constant voltage
envelope v0 at the specified Carrier frequencies. The
envelope has real and imaginary parts specified by the
Constant in-phase value and Constant quadrature value
parameters.
• Ideal Current — The block simulates a constant current
envelope i0 at the specified Carrier frequencies. The
envelope has real and imaginary parts determined by the
Constant in-phase value and Constant quadrature value
parameters.
• Power — The block simulates the constant voltage envelope
1-31
Continuous Wave
j
v0 = 2 P0 Re ( Zs )e 180
where:
— P0 is the value of the Available power parameter
— Zs is the value of the Source impedance (ohms)
parameter.
— ϕ is the value of the Angle (degrees) parameter.
The default value of this parameter is Ideal Voltage.
Constant in-phase value
When the Source type is Ideal Voltage or Ideal Current,
specify the in-phase modulations for each of the specified Carrier
frequencies as a vector of real numbers. Specify the units
from the corresponding drop-down list. The default value of this
parameter is 0 V.
Constant quadrature value
When the Source type is Ideal Voltage or Ideal Current,
specify the quadrature modulations for each of the specified
Carrier frequencies as a vector of real numbers. Specify the
units from the corresponding drop-down list. The quadrature
value at baseband must equal 0. The default value of this
parameter is 0 V.
Source impedance (ohms)
When the Source type is Power, specify the source impedance as
either 0 or a complex number with real and imaginary parts that
are greater than or equal to 1e-18 Ohm. If you set this parameter to
a value with real or imaginary part between 0 and 1e-18 Ohm, the
block uses a value with real or imaginary part equal to 1e-18 Ohm
during simulation. The default value of this parameter is 0 Ohm.
Available power
When the Source type is Power, specify the available power at
the specified Carrier frequencies as a vector of real numbers.
Specify the units from the corresponding drop-down list. The
default value of this parameter is 0 W.
1-32
Continuous Wave
Angle (degrees)
When the Source type is Power, specify the phase angles of the
power waves at the specified Carrier frequencies as a vector of
real numbers. The default value of this parameter is 0 degrees.
Carrier frequencies
Enter a vector of carrier frequencies whose elements are
combinations of fundamental tones and corresponding harmonics
in the Configuration block. Specify the units from the
corresponding drop-down list. The default value of this parameter
is 0 Hz.
Ground and hide negative terminals
Select this option to internally ground and hide the negative
terminals. Clear this to expose the negative terminals. By
exposing these terminals, you can connect them to other parts
of your model.
Examples All models in the SimRF documentation that contain a Mixer block also
contain a Continuous Wave block used as a local oscillator.
1-33
Coupler
Library Junctions
Description Use the Coupler block to model four port directional couplers in a circuit
envelope environment as an ideal S-parameter model.
1-34
Coupler
Select component
• Directional coupler
The default option is Directional coupler. The s-parameter
matrix for Directional coupler is:
rl il is c
i r c i
l l s
is c rl il
where:
c is il rl
— rl = 10(-ReturnLoss/20)
— il = 10(-InsertionLoss/20)
— is = 10(-(Coupling+Directivity)/20)
— c = 10(-Coupling/20)
When you select this option, the following parameters are
available:
— Coupling (dB)
Specify the coupling factor of Directional coupler. The
valid value is nonnegative and real. The default value is 0
dB.
— Directivity (dB)
Specify the directivity of Directional coupler. The valid
values are nonnegative and real. The default value is inf.
— Isolation (dB)
Specify the isolation of Directional coupler. The valid
values are nonnegative and real. The default value is inf.
— Return loss (dB)
1-35
Coupler
0 0 j
0 j 0
0 j 0
where:
j 0 0
— |α| ≤ 1 = Power transmission coefficient
— β = sqrt(1– α*α)
When you select this option, the following parameters are
available:
— Power transmission coefficient
Specify the power transmission coefficient of Coupler
symmetrical. The valid values are real. The default value
is 0.
— Reference impedance (Ohm)
Specify the reference impedances of Coupler symmetrical
as scalar or three-tuple. The default values are 50 Ohms.
• Coupler antisymmetrical
The s-parameter matrix for Coupler antisymmetrical is:
1-36
Coupler
0 0
0 0
0 0
where:
0 0
— |α| ≤ 1 = Power transmission coefficient.
— β = sqrt(1– α*α)
When you select this option, the following parameters are
available:
— Power transmission coefficient
Specify the power transmission coefficient of Coupler
antisymmetrical. The valid values are real. The default
value is 0.
— Reference impedance (Ohm)
Specify the reference impedances of Coupler
antisymmetrical as scalar or three-tuple. The default
values are 50 Ohms.
• Hybrid quadrature (90deg)
The s-parameter matrix for Hybrid quadrature(90deg) is:
0 -j / 2 0 -1 / 2
- j / 2 0 -1 / 2 0
you
When 0 select
-1 / this
2 option,
0 the 2
- j / following parameter is available:
-1 / 2
• Reference impedance (Ohm)
0 - j / 2 0
1-37
Coupler
0 j / 2 0 j / 2
j / 2 0 j/ 2 0
0 j/ 2 0 j / 2
you select this option, the following
When parameter is available:
j / 2 0 j / 2 0
• Reference impedance (Ohm)
Specify the reference impedances of Hybrid rat-race as scalar
or three-tuple. The default values are 50 Ohms.
Ground and hide negative terminals
Select this option to internally ground and hide the negative
terminals. Clear the option to expose the negative terminals. By
exposing these terminals, you can connect them to other parts
of your model.
1-38
Divider
Library Junctions
Description Use the Divider block to model power dividers (combiners) in a circuit
envelope environment as an ideal s-parameter model.
Select component
• T power divider
The default option is T power divider. The s-parameter
matrix for T-power divider is :
1-39
Divider
0 1 / 2 1 / 2
1 / 2 0 1 / 2
1 / 2 1 / 2 0
1-40
Divider
0 - j / 2 - j / 2
- j / 2 0 0
When
- j / 2you select
0 this0option,
the following parameter is
available:
— Reference impedance (Ohm)
Specify the reference impedances of Wilkinson power
divideras scalar or three-tuple. The default values are 50.
1-41
Divider
1-42
Gnd (Ground)
Library Elements
Examples All models in the SimRF documentation contain a Ground block. See
Model an RF Mixer for an introduction to circuit envelope simulation.
1-43
Ideal Transformer
Library Elements
Dialog
Box and
Parameters
Winding ratio
Specify the winding ratio.
1-44
Inport
Library Utilities
Description The Inport block imports Simulink® signals into the SimRF circuit
envelope simulation environment. For an introduction to RF simulation,
see the example, “Simulate High Frequency Components”.
Complex-valued input signals Ik(t) + j · Qk(t) are the modulations at
the frequencies {fk} specified in the Carrier frequencies parameter
of the block.
The Source type parameter specifies the Simulink signal as either
current, or voltage, or power source.
Dialog
Box and
Parameters
Source type
Specify a current, voltage, or power source. If the input signal is a
vector containing more than one signal, the block assigns the kth
input signal to the kth carrier.
1-45
Inport
1-46
Inport
2 Re( Zs )
Pload v(t)
2
Zs Zl
When Zl = Zs*, this generator delivers the available power
|vSL(t)|2.
Source impedance (ohms)
When Input is set to Power, specify a source impedance for
available power match. When you use multiple Inport blocks as
power sources at the same node in a given circuit, each block
modifies the load for other components connected to that shared
node, so the maximum available power is not achieved. By
default, the series impedance is 50.
Carrier frequencies
Enter a vector of carrier frequencies whose elements are
combinations of fundamental tones and corresponding harmonics
in the Configuration block. Specify the units from the
corresponding drop-down list. The default value of this parameter
is 0 Hz.
1-47
Inport
Examples The example “Two-Tone Envelope Analysis Using Real Signals” shows
how to use Inport and Outport blocks to position an RF system as part
of a larger workflow.
1-48
Z (Impedance)
Library Elements
Description The Impedance block implements the relation, vk(t) = Z(fk)*ik(t), for each
simulation frequency, fk, where:
Circuit envelope current and voltage signals comprise in-phase, Ik, and
quadrature, Qk, components at each frequency, fk.
Frequency-dependent impedance typically cannot be realized as
a physical network such as an RLC chain. You can, however,
use the Impedance block to model nonphysical behavior, such as
frequency-independent negative capacitance or negative inductance.
You can also use this block to specify resonant frequency offsets in
filter networks.
Dialog
Box and
Parameters
1-49
Z (Impedance)
Impedance type
Choose Frequency independent to apply the same impedance
for all frequencies. Choose Frequency dependent to apply the
impedance as a piecewise linear function.
Complex impedance (ohm)
When Impedance type is set to Frequency independent,
impedance is a scalar complex number that is applied to
all simulation frequencies. When Impedance type is set
to Frequency dependent, impedance is a vector of complex
numbers, [Z1, Z2, Z3, …]. This vector is linearly interpolated for
all simulation frequencies.
1-50
L (Inductor)
Library Elements
Dialog
Box and
Parameters
Inductance
Specify the inductance, L, as either 0 or a real number greater
than or equal to 1e-18 H. If you set this parameter to a value
between 0 and 1e-18 H, the block uses a value equal to 1e-18 H
during simulation. The default value of this parameter is 1e-9 H.
1-51
L (Inductor)
1-52
LC Ladder
Library Elements
1-53
LC Ladder
Dialog
Box and
Parameters
1-54
LC Ladder
Ladder Topology
LC
Lowpass
Tee
LC
Lowpass
Pi
LC
Highpass
Tee
LC
Highpass
Pi
1-55
LC Ladder
LC
Bandpass
Tee
LC
Bandpass
Pi
LC
Bandstop
Tee
LC
Bandstop
Pi
1-56
LC Ladder
Inductance
Specify a vector of inductance values. The vector index of a value
corresponds to the inductance index in the corresponding selected
ladder topology. All values must be greater than zero.
Capacitance
Specify a vector of capacitance values. The vector index of a value
corresponds to the capacitance index in the corresponding selected
ladder topology. All values must be greater than zero.
Examples • The section, “Filter Mixing Products”, shows the use of a LC Ladder.
1-57
Mixer
Library Elements
Description The Mixer block performs signal frequency translation and nonlinear
amplification.
For a given RF input signal VRF = ARFcos(ωRFt) and an LO input signal
VLO = ALOcos(ωLOt), the mixer multiplies the signals at the input ports:
1-58
Mixer
1-59
Mixer
1-60
Mixer
1-61
Mixer
Nonlinearity Tab
1-62
Mixer
1-63
Mixer
1-64
Mixer
References [1] Grob, Siegfried and Lindner, Jurgen, “Polynomial Model Derivation
of Nonlinear Amplifiers”, Department of Information Technology,
University of Ulm, Germany.
1-65
Mutual Inductor
Library Elements
Description The Mutual Inductor block models an inductor within the SimRF
circuit envelope simulation environment. For an introduction to RF
simulation, see the example, “Simulate High Frequency Components”.
The block implements the relations
d d
v1 (t) = L1 [i1 (t)] + M [i2 (t)]
dt dt
d d
v2 (t) = M [ i1 (t) ] + L2 [ i2 (t) ]
dt dt
M = K L1 L2
where:
i(t) = ∑ ( iI k
)
(t) + j ⋅ iQk (t) e j (2 fk )t
{ fk }
v(t) = ∑ ( vI k
)
(t) + j ⋅ vQk (t) e j (2 fk )t
{ fk }
1-66
Mutual Inductor
Dialog
Box and
Parameters
Inductance L1
Specify the inductance of the first inductor as a scalar value
greater than or equal to 0. Specify the units of the inductance
from the corresponding drop-down list. The default value of this
parameter is 1e-6 H.
Inductance L2
Specify the inductance of the second inductor as a scalar value
greater than or equal to 0. Specify the units of the inductance
from the corresponding drop-down list. The default value of this
parameter is 1e-6 H.
Coefficient of coupling
Specify the coefficient of coupling for the mutual inductance of the
two inductors as a scalar value between 0 and 1, inclusive. The
default value of this parameter is 0.9.
1-67
Mutual Inductor
1-68
Noise
Library Sources
Description Use the Noise block to model noise as a current or voltage source for
blocks other than Amplifier and Mixer blocks. When you use a Noise to
simulate noise in an RF model, also select the Simulate noise check
box in the Configuration block. Otherwise, the model simulates without
noise. The Noise block does not depend on the Temperature parameter
in the Configuration.
Dialog
Box and
Parameters
Source type
Specify the noise type as Ideal Voltage or Ideal Current. The
default is Ideal Voltage.
Noise distribution
Specify the noise distribution type as White or Piece-wise
linear. The default is White.
Noise power spectral density
Specify the single-sided noise power spectral distribution (PSD).
The default value of this parameter is 0.
1-69
Noise
Use the Noise block to calculate the classic thermal noise floor, kT, for
a matched resistor circuit.
From the MATLAB command prompt , open the model
ex_simrf_noise_source:
addpath(fullfile(docroot,'toolbox','simrf','examples'))
ex_simrf_noise_source
1-70
Noise
To run the model, select Simulation > Run. With the bandwidth
included using the Configuration block, noise power is in the range
of 173.98 - 174.1 dBm
1-71
Noise
References Motchenbacher, C.D. and J.A. Connelly. Low Noise Electronic System
Design. New York: John Wiley & Sons, 1993.
1-72
Outport
Library Utilities
Description The Outport block outputs carrier modulation signals in the SimRF
circuit envelope simulation environment as Simulink signal. For
an introduction to RF simulation, see the example, “Simulate High
Frequency Components”.
SimRF current and voltage signals consist of in-phase (Ik) and
quadrature (Qk) components at each frequency fk specified in the
Configuration block
The Sensor type parameter determines which signal the block
measures, and the Output parameter defines the format of the
Simulink signal.
Dialog
Box and
Parameters
Sensor type
Specify the type of signal measured by the sensor:
• Ideal voltage — The block outputs the modulations of the
voltage signal at the specified Carrier frequencies in the
format specified by the Output parameter.
• Ideal current — The block outputs the modulations of the
current signal at the specified Carrier frequencies in the
format specified by the Output parameter.
1-73
Outport
Re ( Zl )
v(t)
Zl
where Zl is the value of the Load impedance (ohms)
parameter, at the specified Carrier frequencies. Output
parameter specifies the format of the signal.
1-74
Outport
1-75
Outport
min(h,((1 / 2 f ) 8))
f is the largest listed carrier frequency.
h is the time step listed in Configuration block.
Clear the selection to enter a value for step size. By default,
this option is selected.
— Set Step size to -1 to inherit the time step specified from
Step size in Configuration block.
— Set Step size to a user specified time step. The step size
should be small enough to resolve the fastest carrier signal.
This helps to avoid passband output undersampling and
aliasing effects.
The passband formula is defined by the Normalized carrier
power option in the Configuration block:
— When this option is selected, SimRF interprets complex
envelope I+jQ signal for the kth carrier as,
1-76
Outport
Note When using the Real Passband option, the solver will
take time steps small enough to resolve the carrier. Thus,
simulation speed improvements from envelope simulation may
be lost.
Carrier frequencies
Enter a vector of carrier frequencies whose elements are
combinations of fundamental tones and corresponding harmonics
in the Configuration block. Specify the units from the
corresponding drop-down list. The default value of this parameter
is 0 Hz.
Ground and hide negative terminals
Select this option to internally ground and hide the negative
terminals. Clear this to expose the negative terminals. By
exposing these terminals, you can connect them to other parts
of your model.
1-77
Phase Shift
Library Elements
Description The Phase Shift block models an ideal phase shift in the circuit envelope
environment.
Dialog
Box and
Parameters
Phase-shift
The default value of this parameter is 90 deg. The phase shift
is applied to all nonzero simulation frequencies. For zero (DC)
frequency, the shift is always zero.
Ground and hide negative terminals
Select this option to internally ground and hide the negative
terminals. Clear this to expose the negative terminals. By
exposing these terminals, you can connect them to other parts
of your model.
1-78
Phase Shift
Examples The example, “”, shows how to use Phase Shift blocks to model an LO
phase offset in a receiver architecture.
1-79
R (Resistor)
Library Elements
Description The Resistor block models a resistor within the SimRF circuit envelope
simulation environment. For an introduction to RF simulation, see the
example, “Simulate High Frequency Components”.
The block implements the relation
v(t) = Ri(t)
where:
i(t) = ∑ ( iI k
)
(t) + j ⋅ iQk (t) e j (2 fk )t
{ fk }
v(t) = ∑ ( vI k
)
(t) + j ⋅ vQk (t) e j (2 fk )t
{ fk }
1-80
R (Resistor)
Dialog
Box and
Parameters
Resistance
Specify the resistance, R0, as a real number greater than zero.
Specify the units of the resistance from the corresponding
drop-down menu. The default value of this parameter is 50 Ohm.
Simulate noise
To simulate thermal noise in a resistor, select this check box.
Then, in the Configuration block dialog box, also select the
Simulate noise check box. By default, both Simulate noise
check boxes are selected.
1-81
S-Parameters
Library Elements
Data source
Specify the source of the data that describes the amplifier
behavior. The data source must contain network parameters.
The value can be Data file, Network-parameters, or Rational
model. The default value of this parameter is Data file.
1-82
S-Parameters
When you select Rational model, also select values for the
Residues, Poles, and Direct feedthrough parameters
corresponding to the equation for a rational model:
⎛ n Ck ⎞
F (s) = ⎜ ∑ + D ⎟ , s = j 2πf
⎜ ⎟
⎝ k=1 s − Ak ⎠
In this equation, for a rational model F(s), each Ck is the residue of
the pole Ak with direct feedthrough D. The example, Model an RF
Filter Using S-Parameter Data, shows how to use the RF Toolbox
rationalfit function to create an rfmodel.rational object. This
object has the properties C, A, and D that can be used to specify the
Residues, Poles, and Direct feedthrough parameters.
Data file
When Data source is Data file, specify the name of the file that
contains the S-parameter data. The file name must include the
extension. If the file is not in your MATLAB path, specify the full
path to the file, or click the Browse button to locate the file. By
default, this parameter specifies the data file unitygain.s2p.
Network parameter type
Specify the type of Network parameters: S-parameters,
Y-parameters, or Z-parameters.
Network-parameters
When Data source is Network-parameters, specify a
multidimensional array of network parameters. The third
dimension of the S-parameter array must be the same length as
the vector of frequencies specified by the Frequency parameter.
Frequency
Specify the frequency range of Network-parameters. Specify the
units from the corresponding drop-down list.
Reference impedance (Ohms)
Specify the nonzero reference impedance of the S-parameter data.
The default value is 50.
1-83
S-Parameters
Modeling Tab
Modeling options
Modeling domain. Select Frequency domain or Time domain
(rationalfit) from the drop-down list.
1-84
S-Parameters
Visualization Tab
For an example of using the Visualization tab, see Verify That the
S-parameter Block Is Fitting a Rational Function with Acceptable
Accuracy on page 1-90.
1-85
S-Parameters
1-86
S-Parameters
1-87
S-Parameters
addpath(fullfile(docroot,'toolbox','simrf','examples'))
ex_simrf_sparams
The signals displayed in the scope match the results of the simulation in
the Model an RF Filter section. The filter attenuates the high-frequency
carrier and passes the low-frequency carrier. For more information on
modeling RF components in with RF Toolbox objects, see Examples of
Basic Operations with RF Toolbox Objects.
1-88
S-Parameters
addpath(fullfile(docroot,'toolbox','simrf','examples'))
ex_simrf_sparams
write(hfilt.AnalyzedResult,'teefilt.s2p')
1-89
S-Parameters
addpath(fullfile(docroot,'toolbox','simrf','examples'))
ex_simrf_sparams
To run the model, select Simulation > Run. For more information on
writing data files using RF Toolbox software, see Exporting Component
Data to a File.
1 On the Main tab, specify the Data source parameter and requisite
data to plot.
3 Specify the type of plot that you want to produce with your data. The
Plot type parameter provides the following options:
• X-Y plane — Generate a Cartesian plot of your data versus
frequency. To create linear, semilog, or log-log plots, set the Y-axis
scale and X-axis scale accordingly.
1-90
S-Parameters
• Polar plane — Generate a polar plot of your data. The block plots
only the range of data corresponding to the specified frequencies.
• Z smith chart, Y smith chart, and ZY smith chart —
Generate a Smith chart. The block plots only the range of data
corresponding to the specified frequencies.
For X-Y plots, format the units of the parameters to plot from the
Format1 and Format2 drop-down lists. For polar plots and Smith
charts, the formats are set automatically.
5 Click Apply.
6 Click Plot. The block plots your data and a rational function
approximation.
1-91
Signal Combiner
Library Elements
Description Use the Signal Combiner block to sum signals across each carrier
frequency in the SimRF circuit envelope simulation environment. For
an introduction to RF simulation, see the example, “Simulate High
Frequency Components”
Dialog
Box and
Parameters
1-92
Sinusoid
Library Sources
Description The Sinusoid block implements a voltage or current source that provides
a DC offset and sine wave modulation. This block can be used with each
listed block carrier in the circuit envelope environment.
The block implements the following voltage (or current) relationships
for the in-phase, (ui), and quadrature, (uq), components of the kth listed
block carrier:
1-93
Sinusoid
Dialog
Box and
Parameters
Source type
Specify the wave type as:
• Ideal Voltage — The block simulates a voltage envelope v(t)
at the specified Carrier frequencies.
• Ideal Current — The block simulates a current envelope i(t)
at the specified Carrier frequencies.
The default value of this parameter is Ideal Voltage.
1-94
Sinusoid
Offset in-phase
Specify the in-phase offset, Di, as a scalar or vector. Specify the
units of the offset from the corresponding drop-down list. The
default value of this parameter is 0 V for a voltage signal or 0 A
for a current signal.
Offset quadrature
Specify the quadrature offset, Dq, as a scalar or vector. Specify
the units of the offset from the corresponding drop-down list. The
default value of this parameter is 0 V for a voltage signal or 0 A
for a current signal.
Sinusoidal amplitude in-phase
Specify the in-phase amplitude, Ai, as a scalar or vector. Specify
the units of the offset from the corresponding drop-down list. The
default value of this parameter is 0 V for a voltage signal or 0 A
for a current signal.
Sinusoidal amplitude quadrature
Specify the quadrature amplitude, Aq, as a scalar or vector.
Specify the units of the offset from the corresponding drop-down
list. The default value of this parameter is 0 V for a voltage signal
or 0 A for a current signal.
Sinusoidal modulation frequency
At each carrier fk specified by the Carrier frequencies
parameter, specify the modulation frequency mk. Specify the
units from the corresponding drop-down list. The default value of
this parameter is 0 Hz.
Time delay
Specify the time delay, τ, of the modulation as a scalar or vector.
Specify the units from the corresponding drop-down list. The
default value of this parameter is 0 s.
Damping factor (1/s)
Specify the damping factor, ζ, of the modulation as a nonzero
scalar or vector with nonzero elements. The default value of this
parameter is 0 s-1, representing an undamped sinusoid.
1-95
Sinusoid
Carrier frequencies
Enter a vector of carrier frequencies whose elements are
combinations of fundamental tones and corresponding harmonics
in the Configuration block. Specify the units from the
corresponding drop-down list. The default value of this parameter
is 0 Hz.
Ground and hide negative terminals
Select this option to internally ground and hide the negative
terminals. Clear this to expose the negative terminals. By
exposing these terminals, you can connect them to other parts
of your model.
1-96
Three-Winding Transformer
Library Elements
Description
d d d
v1 (t) = L1 [i1 (t)] + M12 [i2 (t)] + M13 [i3 (t)]
dt dt dt
d d d
v2 (t) = M12 [ i1 (t) ] + L2 [ i2 (t) ] + M23 [ i3 (t) ]
dt dt dt
d d d
v3 (t) = M13 [ i1 (t) ] + M23 [ i2 (t) ] + L3 [ i3 (t) ]
dt dt dt
M pq = K pq L p Lq
where:
1-97
Three-Winding Transformer
• i1(t), i2(t), and i3(t) represent the current through the inductors at
time t. The block uses standard dot notation to indicate the direction
of positive current flow relative to a positive voltage.
i(t) = ∑ ( iI k
)
(t) + j ⋅ iQk (t) e j (2 fk )t
{ fk }
v(t) = ∑ ( vI k
)
(t) + j ⋅ vQk (t) e j (2 fk )t
{ fk }
Dialog
Box and
Parameters
Inductance L1
Specify the inductance of the first inductor, L1, as a scalar value
greater than or equal to 0. Specify the units of the inductance
from the corresponding drop-down list. The default value of this
parameter is 1e-6 H.
1-98
Three-Winding Transformer
Inductance L2
Specify the inductance of the second inductor, L2, as a scalar value
greater than or equal to 0. Specify the units of the inductance
from the corresponding drop-down list. The default value of this
parameter is 1e-6 H.
Inductance L3
Specify the inductance of the third inductor, L3, as a scalar value
greater than or equal to 0. Specify the units of the inductance
from the corresponding drop-down list. The default value of this
parameter is 1e-6 H.
Coefficient of coupling K12
Specify the coefficient of coupling for the mutual inductance of the
first and second inductors, K12, as a scalar value between 0 and 1,
inclusive. The default value of this parameter is 0.9.
Coefficient of coupling K13
Specify the coefficient of coupling for the mutual inductance of the
first and third inductors, K13, as a scalar value between 0 and 1,
inclusive. The default value of this parameter is 0.9.
Coefficient of coupling K23
Specify the coefficient of coupling for the mutual inductance of the
second and third inductors, K23, as a scalar value between 0 and
1, inclusive. The default value of this parameter is 0.9.
1-99
Transmission Line
Library Elements
Model type
•
1-100
Transmission Line
Specify the delay and select the units. The default value
is 4.7e-9 s.
— Characteristic impedance
Specify the characteristic impedance of the transmission line
and select the units. The default value is 50 Ohm.
•
1-101
Transmission Line
1-102
Transmission Line
1-103
Transmission Line
1-104
Transmission Line
1-105
Transmission Line
Coaxial
Specify the transmission line as a coaxial transmission line.
A coaxial transmission line is shown in cross-section in the
following figure. Its physical characteristics include the radius
of the inner conductor, a, and the radius of the outer conductor
b.
1-106
Transmission Line
R + j ωL
Z0 =
G + j ωC
k = kr + jki = ( R + jωL)(G + jωC)
where
1-107
Transmission Line
1 1 1
R a b
2 cond cond
b
L ln
2 a
2
G
b
ln
a
2
C
b
ln
a
In these equations:
a is the radius of the inner conductor.
b is the radius of the outer conductor.
σcond is the conductivity in the conductor.
μ is the permeability of the dielectric.
ε is the permittivity of the dielectric.
ε″ is the imaginary part of ε, ε″ = ε0εrtan δ, where:
ε0 is the permittivity of free space.
εr is the Relative permittivity constant parameter
value.
tan δ is the Loss tangent of dielectric parameter
value.
δcond is the skin depth of the conductor, which the block
calculates as 1 / f cond .
f is a vector of internal modeling frequencies.
Z0 is the specified characteristic impedance.
1-108
Transmission Line
a = − ln (10 / 20 )
2 f
=
Vp
Coplanar waveguide
Specify the transmission line as a coplanar waveguide. A
coplanar waveguide transmission line is shown in cross-section
in the following figure. Its physical characteristics include the
conductor width, w, the conductor thickness, t, the slot width, s,
the substrate height, d, and the relative permittivity constant,
ε.
1-109
Transmission Line
— Conductor width
Specify the physical width of the conductor. The default
value is 0.6 mm.
— Slot width
Specify the physical width of the slot. The default value is
0.2 mm.
— Substrate height
Specify the thickness of the dielectric on which the conductor
resides. The default is 0.635 mm.
— Strip thickness
Specify the physical thickness of the conductor. The default
value is 5 mm.
— Relative permittivity constant
Specify the relative permittivity of the dielectric. This value
is expressed as the ratio of the permittivity of the dielectric
to permittivity in free space, ε0. The default value is 2.2.
— Loss tangent of dielectric
Specify the loss angle tangent of the dielectric. The default
value is 1.
— Line length
Specify the physical length of the transmission line. The
default value is 1 cm.
— Conductivity of conductor
Specify the conductivity of the conductor in siemens per
meter. The default value is inf S/m.
— Stub mode
1-110
Transmission Line
Microstrip
Specify the transmission line as a microstrip transmission
line. A microstrip transmission line is shown in cross-section
in the following figure. Its physical characteristics include the
microstrip width, w, the microstrip thickness, t, the substrate
height, d, and the relative permittivity constant, ε.
1-111
Transmission Line
Two-wire
Specify the transmission line as two-wire transmission line.
A two-wire transmission line is shown in cross-section in the
following figure. Its physical characteristics include the radius
of the wires, a, the separation or physical distance between the
wire centers, S, and the relative permittivity and permeability
of the wires. [2] SimRF Equivalent Baseband software assumes
the relative permittivity and permeability are uniform.
1-112
Transmission Line
Wires
a
Dielectric
1-113
Transmission Line
Parallel plate
Specify the transmission line as a parallel-plate transmission
line. A parallel-plate transmission line is shown in cross-section
in the following figure. Its physical characteristics include the
plate width, w, and the plate separation, d. [2]
1-114
Transmission Line
— Plate separation
Specify the thickness of the dielectric separating the plates.
The default value is 1 mm.
— Relative permeability constant
Specify the relative permeability of the dielectric expressed
as the ratio of the permeability of the dielectric to
permeability in free space, μ0. The default value is 1.
— Relative permittivity constant
Specify the relative permittivity of the dielectric expressed as
the ratio of the permittivity of the dielectric to permittivity
in free space, ε0. The default value is 2.2.
— Loss tangent of dielectric
Specify the loss angle tangent of the dielectric. The default
value is 0.
— Line length
Specify the physical length of the transmission line. The
default value is 1 cm.
— Conductivity of conductor
Specify the conductivity of the conductor. The default value
is inf S/m.
— Stub mode
Specify the type of stub. Choices are Not a stub, Shunt, or
Series. The default value is Not a stub. See Transmission
Line with Stub on page 119 for more information.
•
Equation-based
Specify the transmission line as an equation-based transmission
line. The transmission line, which can be lossy or lossless, is
treated as a two-port linear network.
1-115
Transmission Line
1-116
Transmission Line
RLCG
Specify the transmission line as an RLCG transmission line.
This line is described in the block dialog box in terms of its
frequency-dependent resistance, inductance, capacitance, and
conductance. The transmission line, which can be lossy or
lossless, is treated as a two-port linear network.
I(z) R L I(z)
V(z) V(z)
G C
z z
where z′ = z + Δz.
1-117
Transmission Line
1-118
Transmission Line
ekd + e− kd
A=
2
B=
(
Z0 * ekd − e− kd )
2
kd − kd
e −e
C=
2 * Z0
ekd + e− kd
D=
2
Transmission Line with Stub
When you set the Stub mode parameter in the mask dialog box to
Shunt, the two-port network consists of a transmission line in series
with a stub. You can terminate the stub with a short circuit or an open
circuit as shown in the following figure.
A =1
B=0
C = 1 / Zin
D =1
1-119
Transmission Line
When you set the Stub mode parameter in the mask dialog box to
Series, the two-port network comprises a series transmission line. You
can terminate this line with either a short circuit or an open circuit
as shown here.
A =1
B = Zin
C=0
D =1
1-120
Transmission Line
Modeling Tab
1-121
Transmission Line
Modeling options
Select Frequency domain or Time domain (rationalfit)
from the drop-down list. Distributed transmission lines use
S-parameter internal representation, while delay based and
lumped employ a time domain representation. S-parameter
modeling options in SimRF can be Time domain or Frequency
domain. For an introduction to RF simulation and modeling
options, see, “Simulate High Frequency Components”
For the Transmission Line block, the default value is Share all
poles.
Relative error desired (dB)
This field displays when you select Time domain(rationalfit)
as the modeling option. Enter the desired relative error in decibels
(dB). The default value is -40.
Rational fitting results
These fields display the results of rational fitting when you select
Time domain(rationalfit) as the modeling option.
1-122
Transmission Line
Visualization Tab
1-123
Transmission Line
1-124
Transmission Line
Tip In general, blocks that model delay effects rely on signal history. You
can minimize numerical error that occur due to a lack of signal history
at the start of a simulation. To do so, in the Configuration Parameters
dialog box Solver pane you can specify an Initial step size. For models
with delay-based Transmission Line blocks, use an initial step size that
is less than the value of the Delay parameter.
[3] Gupta, K. C., Ramesh Garg, Inder Bahl, and Prakash Bhartia.
Microstrip Lines and Slotlines, 2nd Edition, Norwood, MA: Artech
House, Inc., 1996.
1-125
Transmission Line
1-126
2
Library Mathematical
Note To use this block, you must install DSP System Toolbox™
software. For more information, see the SimRF release notes.
Modeling Nonlinearity
Use the Method parameter in the block dialog box to specify the
method for modeling amplifier nonlinearity. The options for the
Method parameter are
• Linear
• Cubic polynomial
• Hyperbolic tangent
• Saleh model
• Ghorbani model
• Rapp model
2-2
Amplifier (Idealized Baseband)
Application of Nonlinearity
All five subsystems for the nonlinear Method options apply a
memoryless nonlinearity to the complex baseband input signal. Each
one
2 Splits the complex signal into its magnitude and angle components.
2-3
Amplifier (Idealized Baseband)
2 Select Look under mask in the pop-up menu. This displays the
block’s configuration underneath the mask. The block contains five
subsystems corresponding to the five nonlinearity methods.
2-4
Amplifier (Idealized Baseband)
Note The Amplifier block also enables you to model a linear amplifier.
3 3
f = =
IIP 3 (Watts) 10( IIP3(dBm) − 30 ) / 10
2-5
Amplifier (Idealized Baseband)
u3
FAM / AM (u) = u −
3
where u is the magnitude of the scaled input signal, which is a
unitless normalized input voltage.
(AM/PM conversion) ⋅ (upper input power limit − lower input power limit),
respectively.
The Linear gain (dB) parameter scales the output signal.
Hyperbolic Tangent Model
When you select Hyperbolic tangent for the nonlinearity modeling
Method parameter, the Amplifier block computes and adds the AM/AM
nonlinearity by:
3 3
f = =
IIP 3 (Watts) 10( IIP3(dBm) − 30 ) / 10
2-6
Amplifier (Idealized Baseband)
(AM/PM conversion) ⋅ (upper input power limit − lower input power limit),
respectively.
The Linear gain (dB) parameter scales the output signal.
Saleh Model
When you select Saleh model for the nonlinearity modeling Method
parameter, the Input scaling (dB) parameter scales the input signal
before the nonlinearity is applied. The block multiplies the input signal
by the parameter value, converted from decibels to linear units. If you
set the parameter to be the inverse of the input signal amplitude, the
scaled signal has amplitude normalized to 1.
The AM/AM parameters, alpha and beta, are used to compute the
amplitude gain for an input signal using the following function
u
FAM / AM (u) =
1 + u2
2-7
Amplifier (Idealized Baseband)
The AM/PM parameters, alpha and beta, are used to compute the phase
change for an input signal using the following function
u2
FAM / PM (u) =
1 + u2
where u is the magnitude of the input signal. Note that the AM/AM
and AM/PM parameters, although similarly named alpha and beta,
are distinct.
The Output scaling (dB) parameter scales the output signal similarly.
Ghorbani Model
When you select Ghorbani model for the nonlinearity modeling
Method parameter, the Input scaling (dB) parameter scales the
input signal before the nonlinearity is applied. The block multiplies the
input signal by the parameter value, converted from decibels to linear
units. If you set the parameter to be the inverse of the input signal
amplitude, the scaled signal has amplitude normalized to 1.
The AM/AM parameters, [x1 x2 x3 x4], are used to compute the amplitude
gain for an input signal using the following function
x1u x2
FAM / AM (u) = + x4 u
1 + x3u x2
y1u y2
FAM / PM (u) = + y4 u
1 + y3u y2
2-8
Amplifier (Idealized Baseband)
Rapp Model
When you select Rapp model for the nonlinearity modeling Method
parameter, the Smoothness factor and Output saturation level
parameters are used to compute the amplitude gain for an input signal
by the following function
u
FAM / AM (u) =
1
⎛ 2S ⎞ 2S
⎜ 1 + ⎛⎜ u ⎞⎟ ⎟
⎜ ⎝ Osat ⎠ ⎟⎠
⎝
Noise temperature
Noise factor = 1 +
290
2-9
Amplifier (Idealized Baseband)
Dialog
Box
The parameters displayed in the dialog box vary for different methods
of modeling nonlinearity. Only some of these parameters are visible
in the dialog box at any one time.
2-10
Amplifier (Idealized Baseband)
Method
Method used to model the nonlinearity. The choices are Linear,
Cubic polynomial, Hyperbolic tangent, Saleh model,
Ghorbani model, Rapp model. Tunable.
Linear gain (dB)
Scalar specifying the linear gain for the output function. This
field becomes visible if you select Linear, Cubic polynomial,
Hyperbolic tangent, or Rapp model as the Method parameter.
Tunable.
IIP3 (dBm)
Input power intercept point as a scalar value. This field becomes
visible if you select Cubic polynomial or Hyperbolic tangent as
the Method parameter. For both of these methods, the nominal
impedance is 1 ohm. Tunable.
AM/PM conversion (degrees per dB)
Scalar specifying the AM/PM conversion in degrees per decibel.
This field becomes visible if you select Cubic polynomial or
Hyperbolic tangent as the Method parameter. Tunable.
Lower input power limit for AM/PM conversion (dBm)
Scalar specifying the minimum input power for which AM/PM
conversion scales linearly with input power value. Below this
value, the phase shift resulting from AM/PM conversion is zero.
This field becomes visible if you select Cubic polynomial or
Hyperbolic tangent as the Method parameter. Tunable.
Upper input power limit for AM/PM conversion (dBm)
Scalar specifying the maximum input power for which AM/PM
conversion scales linearly with input power value. Above this
value, the phase shift resulting from AM/PM conversion is
constant. The value of this maximum shift is given by:
(AM/PM conversion) ⋅ (upper input power limit − lower input power limit),
2-11
Amplifier (Idealized Baseband)
2-12
Amplifier (Idealized Baseband)
Specification method
The method by which you specify the amount of noise. The choices
are Noise temperature, Noise figure, and Noise factor.
Tunable.
Noise temperature (K)
Scalar specifying the amount of noise. This field becomes visible
if you select Noise temperature as the Specification method
parameter. Tunable.
Noise figure (dB)
Scalar specifying the amount of noise relative to a noise
temperature of 290 kelvin. A Noise figure setting of 0 decibels
indicates a noiseless system. This field becomes visible if you
select Noise figure as the Specification method parameter.
Tunable.
Noise factor
Scalar specifying the amount of noise relative to a noise
temperature of 290 kelvin. This field becomes visible if you
select Noise factor as the Specification method parameter.
Tunable.
Initial seed
Nonnegative integer specifying the initial seed for the random
number generator the block uses to generate noise.
Examples You can see the effect of the Amplifier block in the example
Intermodulation: Mathematical Amplifier.
2-13
Amplifier (Idealized Baseband)
2-14
Amplifier (Idealized Baseband)
The next figure shows the same signal after it passes through the
Amplifier block, with the Method parameter set to Hyperbolic
tangent. The example uses the default Amplifier block IIP3 (dBm)
value of 30. It uses no AM/PM conversion. The example specifies
thermal noise as Noise figure, for which it uses the default 3.01 dB.
References [1] Ghorbani, A. and M. Sheikhan, “The Effect of Solid State Power
Amplifiers (SSPAs) Nonlinearities on MPSK and M-QAM Signal
Transmission,” Sixth Int’l Conference on Digital Processing of Signals in
Comm., 1991, pp. 193-197.
2-15
Bandpass RF Filter
Library Mathematical
Note To use this block, you must install DSP System Toolbox software.
For more information, see the SimRF release notes.
Description The Bandpass RF Filter block lets you design standard analog bandpass
filters, implemented in baseband-equivalent complex form. The
following table describes the available design methods.
2-16
Bandpass RF Filter
Select the design of the filter from the Design method list in the dialog
box. For each design method, the block enables you to specify the filter
design parameters shown in the following table.
The Bandpass RF Filter block designs the filters using the Signal
Processing Toolbox™ filter design functions buttap, cheb1ap, cheb2ap,
ellipap, and besselap.
2-17
Bandpass RF Filter
Dialog
Box
The parameters displayed in the dialog box vary for different design
methods. Only some of these parameters are visible in the dialog box
at any one time.
You can change tunable parameters while the model is running.
Design method
Filter design method. The design method can be Butterworth,
Chebyshev I, Chebyshev II, Elliptic, or Bessel. Tunable.
Filter order
Order of the lowpass analog prototype filter that forms the basis
for the bandpass filter design. The order of the final filter is twice
this value.
2-18
Bandpass RF Filter
2-19
Bandstop RF Filter
Library Mathematical
Note To use this block, you must install DSP System Toolbox software.
For more information, see the SimRF release notes.
Description The Bandstop RF Filter block lets you design standard analog bandstop
filters, implemented in baseband-equivalent complex form. The
following table describes the available design methods.
2-20
Bandstop RF Filter
Select the design of the filter from the Design method list in the dialog
box. For each design method, the block enables you to specify the filter
design parameters shown in the following table.
The Bandstop RF Filter block designs the filters using the Signal
Processing Toolbox filter design functions buttap, cheb1ap, cheb2ap,
ellipap, and besselap.
2-21
Bandstop RF Filter
Dialog
Box
The parameters displayed in the dialog box vary for different design
methods. Only some of these parameters are visible in the dialog box
at any one time.
You can change tunable parameters while the model is running.
Design method
Filter design method. The design method can be Butterworth,
Chebyshev I, Chebyshev II, Elliptic, or Bessel. Tunable.
Filter order
Order of the lowpass analog prototype filter that forms the basis
for the bandstop filter design. The order of the final filter is twice
this value.
Lower passband edge frequency (Hz)
Lower passband edge frequency for Butterworth, Chebyshev I,
elliptic, and Bessel designs. Tunable.
2-22
Bandstop RF Filter
2-23
Coaxial Transmission Line
Description The Coaxial Transmission Line block models the coaxial transmission
line described in the block dialog box in terms of its frequency-dependent
S-parameters. A coplanar waveguide transmission line is shown in
cross-section in the following figure. Its physical characteristics include
the radius of the inner conductor a and the radius of the outer conductor
b.
The block lets you model the transmission line as a stub or as a stubless
line.
2-24
Coaxial Transmission Line
ekd + e− kd
A=
2
B=
(
Z0 * ekd − e− kd )
2
kd − kd
e −e
C=
2 * Z0
ekd + e− kd
D=
2
R + j ωL
Z0 =
G + j ωC
k = kr + jki = ( R + jωL)(G + jωC)
where
1 1 1
R a b
2 cond cond
b
L ln
2 a
2
G
b
ln
a
2
C
b
ln
a
In these equations:
2-25
Coaxial Transmission Line
as 1 / f cond .
Shunt ABCD-Parameters
When you set the Stub mode parameter in the mask dialog box to
Shunt, the two-port network consists of a stub transmission line that
you can terminate with either a short circuit or an open circuit as
shown here.
2-26
Coaxial Transmission Line
A =1
B=0
C = 1 / Zin
D =1
Series ABCD-Parameters
When you set the Stub mode parameter in the mask dialog box to
Series, the two-port network consists of a series transmission line
that you can terminate with either a short circuit or an open circuit
as shown here.
2-27
Coaxial Transmission Line
A =1
B = Zin
C=0
D =1
2-28
Coaxial Transmission Line
2-29
Coaxial Transmission Line
Visualization Tab
References [1] Pozar, David M. Microwave Engineering, John Wiley & Sons, Inc.,
2005.
2-30
Connection Port
Dialog
Box
Port number
This field labels the subsystem connector port created by this
block. Multiple connector ports on the boundary of a single
subsystem require different numbers as labels. The default value
for the first port is 1.
2-31
Connection Port
2-32
Coplanar Waveguide Transmission Line
Description The Coplanar Waveguide Transmission Line block models the coplanar
waveguide transmission line described in the block dialog box in terms
of its frequency-dependent S-parameters. A coplanar waveguide
transmission line is shown in cross-section in the following figure. Its
physical characteristics include the conductor width (w), the conductor
thickness (t), the slot width (s), the substrate height (d), and the relative
permittivity constant (ε).
The block lets you model the transmission line as a stub or as a stubless
line.
2-33
Coplanar Waveguide Transmission Line
ekd + e− kd
A=
2
B=
(
Z0 * ekd − e− kd )
2
kd − kd
e −e
C=
2 * Z0
ekd + e− kd
D=
2
Shunt ABCD-Parameters
When you set the Stub mode parameter in the mask dialog box to
Shunt, the two-port network consists of a stub transmission line that
you can terminate with either a short circuit or an open circuit as
shown here.
2-34
Coplanar Waveguide Transmission Line
A =1
B=0
C = 1 / Zin
D =1
Series ABCD-Parameters
When you set the Stub mode parameter in the mask dialog box to
Series, the two-port network consists of a series transmission line
that you can terminate with either a short circuit or an open circuit
as shown here.
2-35
Coplanar Waveguide Transmission Line
A =1
B = Zin
C=0
D =1
2-36
Coplanar Waveguide Transmission Line
2-37
Coplanar Waveguide Transmission Line
Visualization Tab
References [1] Gupta, K. C., Ramesh Garg, Inder Bahl, and Prakash Bhartia,
Microstrip Lines and Slotlines, 2nd Edition, Artech House, Inc.,
Norwood, MA, 1996.
2-38
General Amplifier
Description The General Amplifier block models the nonlinear amplifier described
by a data source. The data source consists of either an RF Toolbox data
(rfdata.data) object or data from a file.
Network Parameters
If network parameter data and corresponding frequencies exist
as S-parameters in the data source, the General Amplifier block
interpolates the S-parameters to determine their values at the modeling
frequencies. If the network parameters are Y- or Z-parameters, the
block first converts them to S-parameters. For more information, see
“SimRF Equivalent Baseband Algorithms”.
Nonlinearity
If power data exists in the data source, the block extracts the
AMAM/AMPM nonlinearities from the power data.
If the data source contains no power data, then you can introduce
nonlinearities into your model by specifying parameters in the
Nonlinearity Data tab of the General Amplifier block dialog box.
Depending on which of these parameters you specify, the block computes
up to four of the coefficients c1 , c3 , c5 , and c7 of the polynomial
2 4 6
FAM / AM (s) = c1 s + c3 s s + c5 s s + c7 s s
that determines the AM/AM conversion for the input signal s . The
block automatically calculates c1 , the linear gain term. If you do not
specify additional nonlinearity data, the block operates as a linear
amplifier. If you do, the block calculates one or more of the remaining
coefficients as the solution to a system of linear equations, determined
by the following method.
2-39
General Amplifier
1 The block checks whether you have specified a value other than Inf
for:
• The third-order intercept point ( OIP3 or IIP3 ).
( ) ( ) ( )
3 5 7
Psat,out = c1 Psat,in + c3 Psat,in + c5 Psat,in + c7 Psat,in
( ) ( ) ( )
3 5 7
P1dB,out = c1 P1dB,in + c3 P1dB,in + c5 P1dB,in + c7 P1dB,in
c1
0= + c3
IIP 3
2-40
General Amplifier
Active Noise
You can specify active block noise in one of the following ways:
The latter four options are only available if noise data does not exist
in the data source.
2-41
General Amplifier
If you specify block noise as spot noise data, the block uses the data to
calculate noise figure. The block first interpolates the noise data for the
modeling frequencies, using the specified Interpolation method. It
then calculates the noise figure using the resulting values.
Operating Conditions
Agilent® P2D and S2D files define block parameters for several
operating conditions. Operating conditions are the independent
parameter settings that are used when creating the file data. By default,
SimRF Equivalent Baseband software defines the block behavior using
the parameter values that correspond to the operating conditions that
appear first in the file. To use other property values, you must select a
different operating condition in the General Amplifier block dialog box.
Data Consistency
If the data source is a MathWorks™ AMP file or an Agilent S2D file that
contains both network parameter data and power data, the blockset
checks the data for consistency and reconciles it as necessary.
The blockset compares the small-signal amplifier gain defined by
the network parameters, S21, and by the power data, Pout-Pin. The
discrepancy between the two is computed in dBm using the following
equation:
2-42
General Amplifier
x x x
x
x
Pout (dBm)
* * *
x
*
DP *
fP Pin (dBm)
2-43
General Amplifier
Data source
Determines the source of the data that describes the amplifier
behavior. The data source must contain network parameters and
may also include noise data, nonlinearity data, or both. The value
can be Data file or RFDATA object.
Data file
If Data source is set to Data file, use this field to specify the
name of the file that contains the amplifier data. The file name
must include the extension. If the file is not in your MATLAB
2-44
General Amplifier
path, specify the full path to the file or click the Browse button
to find the file.
RFDATA object
If Data source is set to RFDATA object, use this field to specify
an RF Toolbox data (rfdata.data) object that describes an
amplifier. You can specify the object as:
• The handle of a data object previously created using RF Toolbox
software.
• An RF Toolbox command such as
rfdata.data('Freq',1e9,'S_Parameters',[0 0; 0.5 0]),
which creates a data object.
• A MATLAB expression that generates such an object.
Interpolation method
The method used to interpolate the network parameters. The
following table lists the available methods describes each one.
Method Description
Linear (default) Linear interpolation
Spline Cubic spline interpolation
Cubic Piecewise cubic Hermite
interpolation
2-45
General Amplifier
Noise type
Type of noise data. The value can be Noise figure, Spot noise
data, Noise factor, or Noise temperature. This parameter is
disabled if the data source contains noise data.
2-46
General Amplifier
2-47
General Amplifier
2-48
General Amplifier
IP3 type
Type of third-order intercept point. The value can be IIP3 (input
intercept point) or OIP3 (output intercept point). This parameter
is disabled if the data source contains power data or IP3 data.
IP3 (dBm)
Value of third-order intercept point. This parameter is disabled if
the data source contains power data or IP3 data. Use the default
value, Inf, if you do not know the IP3 value. This parameter can
be a scalar (to specify frequency-independent nonlinearity data)
or a vector (to specify frequency-dependent nonlinearity data).
1 dB gain compression power (dBm)
Output power value ( P1dB,out ) at which gain has decreased by 1
dB. This parameter is disabled if the data source contains power
data or 1-dB compression point data. Use the default value, Inf, if
you do not know the 1-dB compression point. This parameter can
be a scalar (to specify frequency-independent nonlinearity data)
or a vector (to specify frequency-dependent nonlinearity data).
Output saturation power (dBm)
Output power value ( Psat,out ) that the amplifier produces when
fully saturated. This parameter is disabled if the data source
contains output saturation power data. Use the default value,
Inf, if you do not know the saturation power. If you specify
this parameter, you must also specify the Gain compression
at saturation (dB). This parameter can be a scalar (to specify
frequency-independent nonlinearity data) or a vector (to specify
frequency-dependent nonlinearity data).
Gain compression at saturation (dB)
Decrease in gain ( GCsat ) when the power is fully saturated. The
block ignores this parameter if you do not specify the Output
saturation power (dBm). This parameter can be a scalar (to
specify frequency-independent nonlinearity data) or a vector (to
specify frequency-dependent nonlinearity data).
2-49
General Amplifier
Frequency (Hz)
Scalar or vector value of frequency points corresponding to the
third-order intercept and power data. This parameter is disabled
if the data source contains power data or IP3 data. If you use a
scalar value, the IP3 (dBm), 1 dB gain compression power
(dBm), and Output saturation power (dBm) parameters must
all be scalars. If you use a vector value, one or more of the IP3
(dBm), 1 dB gain compression power (dBm), and Output
saturation power (dBm) parameters must also be a vector.
Visualization Tab
2-50
General Amplifier
For information about plotting, see “Create Plots”. Use rftool or the
RF Toolbox plotting functions to plot other data.
2-51
General Amplifier
2-52
General Amplifier
2-53
General Amplifier
Click Plot. This action creates Z Smith chart of the S22 parameters
using the frequencies taken from the data source.
2-54
General Amplifier
For more about using an Agilent .s2d file in a Simulink model, see
Effect of Nonlinear Amplifier on QPSK Modulation.
2-55
General Circuit Element
Description The General Circuit Element block models the two-port network
described by an RF Toolbox circuit (rfckt) object.
The block uses the rfckt/analyze method to calculate the network
parameters at the modeling frequencies.
RFCKT object
An RF Toolbox circuit (rfckt) object. You can specify the object
as (1) the handle of a circuit object previously created using
RF Toolbox software, (2) an RF Toolbox command such as
rfckt.txline, rfckt.coaxial, or rfckt.cascade that creates
a default circuit object of the specified type, or (3) a MATLAB
expression that generates such an object. See “RF Circuit Objects”
in the RF Toolbox documentation for more information about
circuit objects.
2-56
General Circuit Element
Visualization Tab
2-57
General Circuit Element
2-58
General Circuit Element
Click Plot. This action creates an X-Y Plane plot of the S12
parameters in the frequency range 1.9 to 2.2 GHz.
2-59
General Circuit Element
2-60
General Mixer
Description The General Mixer block models the mixer described by an RF Toolbox
data (rfdata.data) object.
Network Parameters
The network parameter values all refer to the mixer input frequency.
If network parameter data and corresponding frequencies exist as
S-parameters in the rfdata.data object, the General Mixer block
interpolates the S-parameters to determine their values at the modeling
frequencies. If the block contains network Y- or Z-parameters, the block
first converts them to S-parameters. See “Map Network Parameters to
Modeling Frequencies” for more details.
SimRF Equivalent Baseband software computes the reflected wave at
the mixer input ( b1 ) and at the mixer output ( b2 ) from the interpolated
S-parameters as
where
• fin and f out are the mixer input and output frequencies, respectively.
• a1 and a2 are the incident waves at the mixer input and output,
respectively.
Active Noise
You can specify active block noise in one of the following ways:
2-61
General Mixer
The latter four options are only available if noise data does not exist
in the data source.
If you specify block noise as spot noise data, the block uses the data to
calculate noise figure. The block first interpolates the noise data for the
modeling frequencies, using the specified Interpolation method. It
then calculates the noise figure using the resulting values.
Phase Noise
The General Mixer block applies phase noise to a complex baseband
signal. The block first generates additive white Gaussian noise (AWGN)
and filters the noise with a digital FIR filter. It then adds the resulting
noise to the angle component of the input signal.
The blockset computes the digital filter by:
2 Taking the IFFT of the resulting phase noise spectrum to get the
coefficients of the FIR filter.
Note If you specify phase noise as a scalar value, the blockset assumes
that the phase noise is constant at all modeling frequencies and does
not have a 1/f slope. This assumption differs from that made by the
Mathematical Mixer block.
2-62
General Mixer
Nonlinearity
If power data exists in the data source, the block extracts the
AMAM/AMPM nonlinearities from it.
If the data source contains no power data, then you can introduce
nonlinearities into your model by specifying parameters in the
Nonlinearity Data tab of the General Mixer block dialog box.
Depending on which of these parameters you specify, the block computes
up to four of the coefficients c1 , c3 , c5 , and c7 of the polynomial
2 4 6
FAM / AM (s) = c1 s + c3 s s + c5 s s + c7 s s
that determines the AM/AM conversion for the input signal s . The
block automatically calculates c1 , the linear gain term. If you do not
specify additional nonlinearity data, the block operates as a mixer
with a linear gain. If you do, the block calculates one or more of the
remaining coefficients as the solution to a system of linear equations,
determined by the following method.
1 The block checks whether you have specified a value other than Inf
for:
• The third-order intercept point ( OIP3 or IIP3 ).
2-63
General Mixer
( ) ( ) ( )
3 5 7
Psat,out = c1 Psat,in + c3 Psat,in + c5 Psat,in + c7 Psat,in
( ) ( ) ( )
3 5 7
P1dB,out = c1 P1dB,in + c3 P1dB,in + c5 P1dB,in + c7 P1dB,in
c1
0= + c3
IIP 3
The first two equations are the evaluation of the polynomial
2-64
General Mixer
Operating Conditions
Agilent P2D and S2D files define block parameters for several operating
conditions. Operating conditions are the independent parameter
settings that are used when creating the file data. By default, the
blockset defines the block behavior using the parameter values that
correspond to the operating conditions that appear first in the file.
To use other property values, you must select a different operating
condition in the General Mixer block dialog box.
2-65
General Mixer
Data source
Determines the source of the data that describes the mixer
behavior. The data source must contain network parameters and
may also include noise data, nonlinearity data, or both. The value
can be Data file or RFDATA object.
Data file
If Data source is set to Data file, use this field to specify the
name of the file that contains the mixer data. The file name must
include the extension. If the file is not in your MATLAB path,
2-66
General Mixer
specify the full path to the file or click the Browse button to find
the file.
RFDATA object
If Data source is set to RFDATA object, use this field to specify
an RF Toolbox data (rfdata.data) object that describes a mixer.
You can specify the object as one of the following:
• The handle of a data object previously created using RF Toolbox
software.
• An RF Toolbox command such as
rfdata.data('Freq',1e9,'S_Parameters',[0 0; 0.5 0]),
which creates a data object.
• A MATLAB expression that generates a data object.
For more information about data objects, see the rfdata.data
reference page in the RF Toolbox documentation.
Interpolation method
The method used to interpolate the network parameters. The
following table lists the available methods describes each one.
Method Description
Linear (default) Linear interpolation
Spline Cubic spline interpolation
Cubic Piecewise cubic Hermite
interpolation
2-67
General Mixer
Mixer Type
Type of mixer. Choices are Downconverter (default) and
Upconverter.
LO frequency (Hz)
Local oscillator frequency. If you choose Downconverter, the
blockset computes the mixer output frequency, fout, from the mixer
input frequency, fin, and the local oscillator frequency, flo, as
fout = fin – flo. If you choose Upconverter, fout = fin + flo.
2-68
General Mixer
2-69
General Mixer
Noise type
Type of noise data. The value can be Noise figure, Spot noise
data, Noise factor, or Noise temperature. This parameter is
disabled if the data source contains noise data.
Noise figure (dB)
Scalar ratio or vector of ratios, in decibels, of the available
signal-to-noise power ratio at the input to the available
signal-to-noise power ratio at the output, (Si/Ni)/(So/No). This
parameter is enabled if Noise type is set to Noise figure.
Minimum noise figure (dB)
Minimum scalar ratio or vector of minimum ratios of the
available signal-to-noise power ratio at the input to the available
signal-to-noise power ratio at the output, (Si/Ni)/(So/No). This
parameter is enabled if Noise type is set to Spot noise data.
Optimal reflection coefficient
Optimal mixer source impedance. This parameter is enabled if
Noise type is set to Spot noise data. The value can be a scalar
or vector.
Equivalent normalized resistance
Resistance or vector of resistances normalized to the resistance
value or values used to take the noise measurement. This
parameter is enabled if Noise type is set to Spot noise data.
Noise factor
Scalar ratio or vector of ratios of the available signal-to-noise
power ratio at the input to the available signal-to-noise power
ratio at the output, (Si/Ni)/(So/No). This parameter is enabled if
Noise type is set to Noise factor.
Noise temperature (K)
Equivalent temperature or vector of temperatures that produce
the same amount of noise power as the mixer. This parameter is
enabled if Noise type is set to Noise temperature.
2-70
General Mixer
Frequency (Hz)
Scalar value or vector corresponding to the domain of frequencies
over which you are specifying the noise data. If you provide a
scalar value for your noise data, the block ignores the Frequency
(Hz) parameter and uses the noise data for all frequencies. If
you provide a vector of values for your noise data, it must be
the same size as the vector of frequencies. The block uses the
Interpolation method specified in the Main tab to interpolate
noise data.
2-71
General Mixer
IP3 type
Type of third-order intercept point. The value can be IIP3 (input
intercept point) or OIP3 (output intercept point). This parameter
is disabled if the data source contains power data or IP3 data.
2-72
General Mixer
IP3 (dBm)
Value of third-order intercept point. This parameter is disabled if
the data source contains power data or IP3 data. Use the default
value, Inf, if you do not know the IP3 value. This parameter can
be a scalar (to specify frequency-independent nonlinearity data)
or a vector (to specify frequency-dependent nonlinearity data).
1 dB gain compression power (dBm)
Output power value ( P1dB,out ) at which gain has decreased by 1
dB. This parameter is disabled if the data source contains power
data or 1-dB compression point data. Use the default value, Inf, if
you do not know the 1 dB compression point. This parameter can
be a scalar (to specify frequency-independent nonlinearity data)
or a vector (to specify frequency-dependent nonlinearity data).
Output saturation power (dBm)
Output power value ( Psat,out ) that the mixer produces when fully
saturated. This parameter is disabled if the data source contains
output saturation power data. Use the default value, Inf, if you do
not know the saturation power. If you specify this parameter, you
must also specify the Gain compression at saturation (dB).
This parameter can be a scalar (to specify frequency-independent
nonlinearity data) or a vector (to specify frequency-dependent
nonlinearity data).
Gain compression at saturation (dB)
Decrease in gain ( GCsat ) when the power is fully saturated. The
block ignores this parameter if you do not specify the Output
saturation power (dBm). This parameter can be a scalar (to
specify frequency-independent nonlinearity data) or a vector (to
specify frequency-dependent nonlinearity data).
Frequency (Hz)
Scalar or vector value of frequency points corresponding to the
third-order intercept and power data. This parameter is disabled
if the data source contains power data or IP3 data. If you use a
scalar value, the IP3 (dBm), 1 dB gain compression power
2-73
General Mixer
Visualization Tab
For information about plotting, see “Create Plots”. Use rftool or the
RF Toolbox plotting functions to plot other data.
2-74
General Mixer
2-75
General Mixer
2-76
General Passive Network
Description The General Passive Network block models the two-port passive
network described by an RF Toolbox data (rfdata.data) object.
If network parameter data and their corresponding frequencies exist as
S-parameters in the rfdata.data object, the General Passive Network
block interpolates the S-parameters to determine their values at the
modeling frequencies. If the block contains network Y- or Z-parameters,
the block first converts them to S-parameters. See “Map Network
Parameters to Modeling Frequencies” for more details.
Data source
Determines the source of the data that describes the passive device
behavior. The data source must contain network parameters and
2-77
General Passive Network
may also include noise data, nonlinearity data, or both. The value
can be Data file or RFDATA object.
RFDATA object
If Data source is set to RFDATA object, use this field to specify
an RF Toolbox data (rfdata.data) object. You can specify the
object as (1) the handle of a data object previously created
using RF Toolbox software, (2) an RF Toolbox command such as
rfdata.data('Freq',1e9,'S_Parameters',[0 0; 0.5 0]),
which creates a data object, or (3) a MATLAB expression that
generates such an object.
Data file
If Data source is set to Data file, use this field to specify the
name of the file that contains the amplifier data. The file name
must include the extension. If the file is not in your MATLAB
path, specify the full path to the file or click the Browse button
to find the file.
Interpolation method
The method used to interpolate the network parameters. The
following table lists the available methods describes each one.
Method Description
Linear (default) Linear interpolation
Spline Cubic spline interpolation
Cubic Piecewise cubic Hermite
interpolation
2-78
General Passive Network
Visualization Tab
2-79
General Passive Network
2-80
General Passive Network
Click Plot. This action creates a Z Smith chart of the S11 parameters,
using the frequencies taken from the RFDATA object parameter on
the Main tab.
2-81
General Passive Network
See Also General Circuit Element, Output Port, S-Parameters Passive Network,
Y-Parameters Passive Network, Z-Parameters Passive Network
rfdata.data (RF Toolbox)
interp1 (MATLAB)
2-82
Highpass RF Filter
Library Mathematical
Note To use this block, you must install DSP System Toolbox software.
For more information, see the SimRF release notes.
Description The Highpass RF Filter block lets you design standard analog highpass
filters, implemented in baseband-equivalent complex form. The
following table describes the available design methods.
2-83
Highpass RF Filter
Select the design of the filter from the Design method list in the dialog
box. For each design method, the block lets you specify the filter design
parameters shown in the following table.
The Highpass RF Filter block designs the filters using the Signal
Processing Toolbox filter design functions buttap, cheb1ap, cheb2ap,
ellipap, and besselap.
2-84
Highpass RF Filter
Dialog
Box
The parameters displayed in the dialog box vary for different design
methods. Only some of these parameters are visible in the dialog box
at any one time.
You can change tunable parameters while the model is running.
Design method
Filter design method. The design method can be Butterworth,
Chebyshev I, Chebyshev II, Elliptic, or Bessel. Tunable.
Filter order
Order of the filter.
Passband edge frequency (Hz)
Passband edge frequency for Butterworth, Chebyshev I, elliptic,
and Bessel designs. Tunable.
Stopband edge frequency (Hz)
Stopband edge frequency for Chebyshev II designs. Tunable.
2-85
Highpass RF Filter
Passband ripple in dB
Passband ripple for Chebyshev I and elliptic designs. Tunable.
Stopband attenuation in dB
Stopband attenuation for Chebyshev II and elliptic designs.
Tunable.
Finite impulse response filter length
Desired length of the baseband-equivalent impulse response for
the filter.
Center frequency (Hz)
Center of the modeling frequencies.
Sample time
Time interval between consecutive samples of the input signal.
2-86
Input Port
Description The Input Port block is a connecting port from the Simulink, or
mathematical, part of the model to an RF physical part of the model.
The Input Port block lets you provide the parameter data needed
to calculate the modeling frequencies and the baseband-equivalent
impulse response for the physical subsystem. It also lets you specify
information about how to interpret the incoming Simulink signal.
For more information about how the Input Port block converts the
mathematical Simulink signals to physical modeling environment
signals, see “Convert to and from Simulink Signals”.
2-87
Input Port
Dialog
Box
2-88
Input Port
2-89
Input Port
A value less than or equal to 0 tells the Input Port block to use a
rectangular (rectwin) window. A value greater than or equal to 1
tells the Input Port block to use a hann window.
2-90
Input Port
2-91
Input Port
Add noise
If you select this parameter, noise data in the RF physical blocks
that are bracketed by the Input Port block and Output Port block
is taken into consideration. If you do not select this parameter,
noise data is ignored.
Initial seed
Nonnegative integer specifying the initial seed for the random
number generator the block uses to generate noise. This
parameter becomes visible if you select the Add noise parameter.
If you specify the initial seed parameter with a variable, the
initial seed changes each successive time you run a model.
2-92
LC Bandpass Pi
L2 C2 L4 C4
L1 C1 L3 C3
[L1, L2, L3, L4, ...] is the value of the 'L' property, and [C1, C2, C3, C4, ...]
is the value of the 'C' property.
2-93
LC Bandpass Pi
Inductance (H)
Vector containing the inductances, in order from source to load, of
all inductors in the network. The inductance vector must contain
at least three elements. All values must be strictly positive.
Capacitance (F)
Vector containing the capacitances, in order from source to load,
of all capacitors in the network. Its length must be equal to the
length of the vector you provide in the Inductance parameter.
All values must be strictly positive.
2-94
LC Bandpass Pi
Visualization Tab
2-95
LC Bandpass Pi
2-96
LC Bandpass Pi
2-97
LC Bandpass Pi
2-98
LC Bandpass Pi
References [1] Ludwig, Reinhold and Pavel Bretchko, RF Circuit Design: Theory
and Applications, Prentice-Hall, 2000.
[2] Zverev, Anatol I., Handbook of Filter Synthesis, John Wiley & Sons,
1967.
2-99
LC Bandpass Tee
Description The LC Bandpass Tee block models the LC bandpass tee network
described in the block dialog box, in terms of its frequency-dependent
S-parameters.
For each inductor and capacitor pair in the network, the block first
calculates the ABCD-parameters at each frequency contained in the
vector of modeling frequencies. For each series pair, A = 1, B = Z, C = 0,
and D = 1, where Z is the impedance of the series pair. For each shunt
pair, A = 1, B = 0, C = Y, and D = 1, where Y is the admittance of the
shunt pair.
The LC Bandpass Tee block then cascades the ABCD-parameters
for each series and shunt pair at each of the modeling frequencies,
and converts the cascaded parameters to S-parameters using the RF
Toolbox abcd2s function.
See the Output Port block reference page for information about
determining the modeling frequencies.
The LC bandpass tee network object is a two-port network as shown
in the following circuit diagram.
L1 C1 L3 C3
L2 C2 L4 C4
[L1, L2, L3, L4, ...] is the value of the 'L' property, and [C1, C2, C3, C4, ...]
is the value of the 'C' property.
2-100
LC Bandpass Tee
Inductance (H)
Vector containing the inductances, in order from source to load, of
all inductors in the network. The inductance vector must contain
at least three elements. All values must be strictly positive.
Capacitance (F)
Vector containing the capacitances, in order from source to load,
of all capacitors in the network. Its length must be equal to the
length of the vector you provide in the Inductance parameter.
All values must be strictly positive.
2-101
LC Bandpass Tee
Visualization Tab
References [1] Ludwig, Reinhold and Pavel Bretchko, RF Circuit Design: Theory
and Applications, Prentice-Hall, 2000.
[2] Zverev, Anatol I., Handbook of Filter Synthesis, John Wiley & Sons,
1967.
2-102
LC Bandstop Pi
L2 L4
C2 C4
L1 L3
C1 C3
[L1, L2, L3, L4, ...] is the value of the 'L' property, and [C1, C2, C3, C4, ...]
is the value of the 'C' property.
2-103
LC Bandstop Pi
Inductance (H)
Vector containing the inductances, in order from source to load, of
all inductors in the network. The inductance vector must contain
at least three elements. All values must be strictly positive.
Capacitance (F)
Vector containing the capacitances, in order from source to load,
of all capacitors in the network. Its length must be equal to the
length of the vector you provide in the Inductance parameter.
All values must be strictly positive.
2-104
LC Bandstop Pi
Visualization Tab
References [1] Ludwig, Reinhold and Pavel Bretchko, RF Circuit Design: Theory
and Applications, Prentice-Hall, 2000.
[2] Zverev, Anatol I., Handbook of Filter Synthesis, John Wiley & Sons,
1967.
2-105
LC Bandstop Tee
Description The LC Bandstop Tee block models the LC bandstop tee network
described in the block dialog box, in terms of its frequency-dependent
S-parameters.
For each inductor and capacitor pair in the network, the block first
calculates the ABCD-parameters at each frequency contained in the
vector of modeling frequencies. For each series pair, A = 1, B = Z, C = 0,
and D = 1, where Z is the impedance of the series pair. For each shunt
pair, A = 1, B = 0, C = Y, and D = 1, where Y is the admittance of the
shunt pair.
The LC Bandstop Tee block then cascades the ABCD-parameters
for each series and shunt pair at each of the modeling frequencies,
and converts the cascaded parameters to S-parameters using the RF
Toolbox abcd2s function.
See the Output Port block for information about determining the
modeling frequencies.
The LC bandstop tee network object is a two-port network as shown
in the following circuit diagram.
L1 L3
C1 C3
L2 L4
C2 C4
[L1, L2, L3, L4, ...] is the value of the 'L' property, and [C1, C2, C3, C4, ...]
is the value of the 'C' property.
2-106
LC Bandstop Tee
Inductance (H)
Vector containing the inductances, in order from source to load, of
all inductors in the network. The inductance vector must contain
at least three elements. All values must be strictly positive.
Capacitance (F)
Vector containing the capacitances, in order from source to load,
of all capacitors in the network. Its length must be equal to the
length of the vector you provide in the Inductance parameter.
All values must be strictly positive.
2-107
LC Bandstop Tee
Visualization Tab
References [1] Ludwig, Reinhold and Pavel Bretchko, RF Circuit Design: Theory
and Applications, Prentice-Hall, 2000.
[2] Zverev, Anatol I., Handbook of Filter Synthesis, John Wiley & Sons,
1967.
2-108
LC Highpass Pi
C1 C2
L1 L2 L3
[L1, L2, L3, ...] is the value of the 'L' property, and [C1, C2, ...] is the
value of the 'C' property.
2-109
LC Highpass Pi
Inductance (H)
Vector containing the inductances, in order from source to load, of
all inductors in the network. The inductance vector must contain
at least two elements. All values must be strictly positive.
Capacitance (F)
Vector containing the capacitances, in order from source to load,
of all capacitors in the network. Its length must be equal to or one
less than the length of the vector you provide in the Inductance
parameter. All values must be strictly positive.
2-110
LC Highpass Pi
Visualization Tab
References [1] Ludwig, Reinhold and Pavel Bretchko, RF Circuit Design: Theory
and Applications, Prentice-Hall, 2000.
[2] Zverev, Anatol I., Handbook of Filter Synthesis, John Wiley & Sons,
1967.
2-111
LC Highpass Tee
Description The LC Highpass Tee block models the LC highpass tee network
described in the block dialog box, in terms of its frequency-dependent
S-parameters.
For each inductor and capacitor in the network, the block first calculates
the ABCD-parameters at each frequency contained in the vector of
modeling frequencies. For each series circuit, A = 1, B = Z, C = 0, and
D = 1, where Z is the impedance of the series circuit. For each shunt,
A = 1, B = 0, C = Y, and D = 1, where Y is the admittance of the shunt
circuit.
The LC Highpass Tee block then cascades the ABCD-parameters for
each circuit element at each of the modeling frequencies, and converts
the cascaded parameters to S-parameters using the RF Toolbox abcd2s
function.
See the Output Port block reference page for information about
determining the modeling frequencies.
The LC highpass tee network object is a two-port network as shown
in the following circuit diagram.
C1 C2 C3
L1 L2 L3
[L1, L2, L3, ...] is the value of the 'L' property, and [C1, C2, C3, ...] is the
value of the 'C' property.
2-112
LC Highpass Tee
Inductance (H)
Vector containing the inductances, in order from source to load, of
all inductors in the network. All values must be strictly positive.
The vector cannot be empty.
Capacitance (F)
Vector containing the capacitances, in order from source to load, of
all capacitors in the network. The capacitance vector must contain
at least two elements. Its length must be equal to or one greater
than the length of the vector you provide in the Inductance
parameter. All values must be strictly positive.
2-113
LC Highpass Tee
Visualization Tab
References [1] Ludwig, Reinhold and Pavel Bretchko, RF Circuit Design: Theory
and Applications, Prentice-Hall, 2000.
[2] Zverev, Anatol I., Handbook of Filter Synthesis, John Wiley & Sons,
1967.
2-114
LC Lowpass Pi
L1 L2
C1 C2 C3
[L1, L2, ...] is the value of the 'L' property, and [C1, C2, C3, ...] is the
value of the 'C' property.
2-115
LC Lowpass Pi
Inductance (H)
Vector containing the inductances, in order from source to load, of
all inductors in the network. All values must be strictly positive.
The vector cannot be empty.
Capacitance (F)
Vector containing the capacitances, in order from source to load, of
all capacitors in the network. The capacitance vector must contain
at least two elements. Its length must be equal to or one greater
than the length of the vector you provide in the Inductance
parameter. All values must be strictly positive.
2-116
LC Lowpass Pi
Visualization Tab
References [1] Ludwig, Reinhold and Pavel Bretchko, RF Circuit Design: Theory
and Applications, Prentice-Hall, 2000.
[2] Zverev, Anatol I., Handbook of Filter Synthesis, John Wiley & Sons,
1967.
2-117
LC Lowpass Tee
Description The LC Lowpass Tee block models the LC lowpass tee network
described in the block dialog box in terms of its frequency-dependent
S-parameters.
For each inductor and capacitor in the network, the block first calculates
the ABCD-parameters at each frequency contained in the vector of
modeling frequencies. For each series circuit, A = 1, B = Z, C = 0, and
D = 1, where Z is the impedance of the series circuit. For each shunt,
A = 1, B = 0, C = Y, and D = 1, where Y is the admittance of the shunt
circuit.
The LC Lowpass Tee block then cascades the ABCD-parameters for
each circuit element at each of the modeling frequencies, and converts
the cascaded parameters to S-parameters using the RF Toolbox abcd2s
function.
See the Output Port block reference page for information about
determining the modeling frequencies.
The LC lowpass tee network object is a two-port network as shown
in the following circuit diagram.
L1 L2 L3
C1 C2 C3
[L1, L2, L3, ...] is the value of the 'L' property, and [C1, C2, C3, ...] is the
value of the 'C' property.
2-118
LC Lowpass Tee
Inductance (H)
Vector containing the inductances, in order from source to load, of
all inductors in the network. The inductance vector must contain
at least two elements. All values must be strictly positive.
Capacitance (F)
Vector containing the capacitances, in order from source to load,
of all capacitors in the network. Its length must be equal to or one
less than the length of the vector you provide in the Inductance
parameter. All values must be strictly positive.
2-119
LC Lowpass Tee
Visualization Tab
References [1] Ludwig, Reinhold and Pavel Bretchko, RF Circuit Design: Theory
and Applications, Prentice-Hall, 2000.
[2] Zverev, Anatol I., Handbook of Filter Synthesis, John Wiley & Sons,
1967.
2-120
Lowpass RF Filter
Library Mathematical
Note To use this block, you must install DSP System Toolbox software.
For more information, see the SimRF release notes.
Description The Lowpass RF Filter block lets you design standard analog lowpass
filters, implemented in baseband-equivalent complex form. The
following table describes the available design methods.
2-121
Lowpass RF Filter
Select the design of the filter from the Design method list in the dialog
box. For each design method, the block enables you to specify the filter
design parameters shown in the following table.
The Lowpass RF Filter block designs the filters using the Signal
Processing Toolbox filter design functions buttap, cheb1ap, cheb2ap,
ellipap, and besselap.
2-122
Lowpass RF Filter
Dialog
Box
The parameters displayed in the dialog box vary for different design
methods. Only some of these parameters are visible in the dialog box
at any one time.
Parameters that are tunable can be changed while the model is running.
Design method
Filter design method. The design method can be Butterworth,
Chebyshev I, Chebyshev II, Elliptic, or Bessel. Tunable.
Filter order
Order of the filter.
Passband edge frequency (Hz)
Passband edge frequency for Butterworth, Chebyshev I, elliptic,
and Bessel designs. Tunable.
Stopband edge frequency (Hz)
Stopband edge frequency for Chebyshev II designs. Tunable.
2-123
Lowpass RF Filter
Passband ripple in dB
Passband ripple for Chebyshev I and elliptic designs. Tunable.
Stopband attenuation in dB
Stopband attenuation for Chebyshev II and elliptic designs.
Tunable.
Finite impulse response filter length
Desired length of the baseband-equivalent impulse response for
the filter.
Center frequency (Hz)
Center of the modeling frequencies.
Sample time (s)
Time interval between consecutive samples of the input signal.
2-124
Microstrip Transmission Line
The block lets you model the transmission line as a stub or as a stubless
line.
2-125
Microstrip Transmission Line
ekd + e− kd
A=
2
B=
(
Z0 * ekd − e− kd )
2
kd − kd
e −e
C=
2 * Z0
ekd + e− kd
D=
2
Shunt ABCD-Parameters
When you set the Stub mode parameter in the mask dialog box to
Shunt, the two-port network consists of a stub transmission line that
you can terminate with either a short circuit or an open circuit as
shown here.
2-126
Microstrip Transmission Line
A =1
B=0
C = 1 / Zin
D =1
Series ABCD-Parameters
When you set the Stub mode parameter in the mask dialog box to
Series, the two-port network consists of a series transmission line
that you can terminate with either a short circuit or an open circuit
as shown here.
2-127
Microstrip Transmission Line
A =1
B = Zin
C=0
D =1
2-128
Microstrip Transmission Line
Visualization Tab
2-129
Microstrip Transmission Line
References [1] Gupta, K.C., G. Ramesh, I. Bahl, and P. Bhartia, Microstrip Lines
and Slotlines, Second Edition, Artech House, 1996. pp. 102-109.
2-130
Mixer (Idealized Baseband)
Purpose Complex baseband model of mixer and local oscillator with phase noise
Library Mathematical
Note To use this block, you must install DSP System Toolbox software.
For more information, see the SimRF release notes.
Description The Mixer block generates a complex baseband model of the following:
• A mixer
• A local oscillator with phase noise whose spectrum is characterized
by a 1/f slope
2 Adds the resulting phase noise to the angle component of the input
signal.
2-131
Mixer (Idealized Baseband)
Dialog
Box
You can change parameters that are marked as tunable in the following
descriptions while the model is running.
2-132
Mixer (Idealized Baseband)
References [1] Kasdin, N.J., “Discrete Simulation of Colored Noise and Stochastic
Processes and 1/(f^alpha); Power Law Noise Generation,” The
Proceedings of the IEEE, May, 1995, Vol. 83, No. 5.
2-133
Output Port
Linear Subsystem
For the linear subsystem, the Output Port block uses the Input Port
block parameters and the interpolated S-parameters calculated by each
of the cascaded physical blocks to calculate the baseband-equivalent
impulse response. Specifically, it
2-134
Output Port
n −1
fn = fmin + n = 1,..., N
ts N
where
1
fmin = fc −
2ts
VL ( f )
H( f ) =
VS ( f )
where VS and VL are the source and load voltages, and f represents
the modeling frequencies. More specifically,
S21 (1 + Γ l ) (1 − Γ s )
H( f ) =
2 (1 − S22 Γ l ) (1 − Γin Γ s )
where
2-135
Output Port
Zl − Zo
Γl =
Zl + Zo
Zs − Zo
Γs =
Zs + Zo
⎛ Γl ⎞
Γin = S11 + ⎜ S12 S21 ⎟
⎜ (1 − S22Γ l ) ⎠⎟
⎝
and
• ZS is the source impedance.
• ZL is the load impedance.
• Sij are the S-parameters of a two-port network.
The blockset derives the passband transfer function from the Input
Port block parameters as shown in the following figure:
2-136
Output Port
Magnitude
fc
Frequency
fmin fn fmax
Bandwidth = 1/ts
2-137
Output Port
Baseband-Equivalent Spectrum
Magnitude
Centered at zero
Frequency
-1/2ts 0 1/2ts
1/ts
For the linear subsystem, the Output Port block uses the calculated
impulse response as input to the DSP System Toolbox Digital Filter
block to determine the output.
Nonlinear Subsystem
The nonlinear subsystem is implemented by AM/AM and AM/PM
nonlinear models, as shown in the following figure.
2-138
Output Port
AMout = Rl Pout
PMout =
AMin = Rs Pin
where AMin is the AM of the input voltage, AMout and PMout are the AM
and PM of the output voltage, Rs is the source resistance (50 ohms), Rl is
the load resistance (50 ohms), Pin is the input power, Pout is the output
power, andϕ is the phase shift between the input and output voltage.
Note You can provide power data via a .amp file. See “AMP File
Format” in the RF Toolbox documentation for information about this
format.
2-139
Output Port
2-140
Output Port
2-141
Output Port
Visualization Tab
This tab shows parameters for creating plots if you display the Output
Port mask after you perform one or more of the following actions:
• Run a model with two or more blocks between the Input Port block
and the Output Port block.
• Click the Update Diagram button to initialize a model with two or
more blocks between the Input Port block and the Output Port block.
2-142
Parallel-Plate Transmission Line
The block lets you model the transmission line as a stub or as a stubless
line.
2-143
Parallel-Plate Transmission Line
ekd + e− kd
A=
2
B=
(
Z0 * ekd − e− kd )
2
kd − kd
e −e
C=
2 * Z0
ekd + e− kd
D=
2
R + j ωL
Z0 =
G + j ωC
k = kr + jki = ( R + jωL)(G + jωC)
where
2
R=
w cond cond
d
L=
w
w
G = ′′
d
w
C=
d
In these equations:
2-144
Parallel-Plate Transmission Line
as 1 / f cond .
• f is a vector of modeling frequencies determined by the Output Port
block.
Shunt ABCD-Parameters
When you set the Stub mode parameter in the mask dialog box to
Shunt, the two-port network consists of a stub transmission line that
you can terminate with either a short circuit or an open circuit as
shown here.
2-145
Parallel-Plate Transmission Line
A =1
B=0
C = 1 / Zin
D =1
Series ABCD-Parameters
When you set the Stub mode parameter in the mask dialog box to
Series, the two-port network consists of a series transmission line
that you can terminate with either a short circuit or an open circuit
as shown here.
A =1
B = Zin
C=0
D =1
2-146
Parallel-Plate Transmission Line
2-147
Parallel-Plate Transmission Line
Visualization Tab
References [1] Pozar, David M. Microwave Engineering, John Wiley & Sons, Inc.,
2005.
2-148
Parallel-Plate Transmission Line
2-149
RLCG Transmission Line
Description The RLCG Transmission Line block models the RLCG transmission line
described in the block dialog box in terms of its frequency-dependent
resistance, inductance, capacitance, and conductance. The transmission
line, which can be lossy or lossless, is treated as a two-port linear
network.
I(z) R L I(z)
V(z) V(z)
G C
z z
where z′ = z + Δz.
The block lets you model the transmission line as a stub or as a stubless
line.
2-150
RLCG Transmission Line
ekd + e− kd
A=
2
B=
(
Z0 * ekd − e− kd )
2
kd − kd
e −e
C=
2 * Z0
ekd + e− kd
D=
2
R + j ωL
Z0 =
G + j ωC
k = kr + jki = ( R + jωL)(G + jωC)
Shunt ABCD-Parameters
When you set the Stub mode parameter in the mask dialog box to
Shunt, the two-port network consists of a stub transmission line that
you can terminate with either a short circuit or an open circuit as
shown here.
2-151
RLCG Transmission Line
A =1
B=0
C = 1 / Zin
D =1
Series ABCD-Parameters
When you set the Stub mode parameter in the mask dialog box to
Series, the two-port network consists of a series transmission line
that you can terminate with either a short circuit or an open circuit
as shown here.
2-152
RLCG Transmission Line
A =1
B = Zin
C=0
D =1
2-153
RLCG Transmission Line
Interpolation method
Specify the interpolation method the block uses to calculate the
parameter values at the modeling frequencies. Your choices are
Linear, Spline, or Cubic.
Transmission line length (m)
Physical length of the transmission line.
Stub mode
Type of stub. Your choices are Not a stub, Shunt, or Series.
Termination of stub
Stub termination for stub modes Shunt and Series. Choices are
Open or Short. This parameter becomes visible only when Stub
mode is set to Shunt or Series.
Visualization Tab
2-154
RLCG Transmission Line
References [1] Pozar, David M. Microwave Engineering, John Wiley & Sons, Inc.,
2005.
2-155
S-Parameters Amplifier
Network Parameters
In the S-parameters field of the block dialog box, provide the
S-parameters for each of M frequencies as a 2-by-2-by-M array. In the
Frequency field, specify the frequencies for the S-parameters as an
M-element vector. The elements of the frequencies vector must be in
the same order as the S-parameters. All frequencies must be positive.
For example, the following figure shows the correspondence between
the S-parameters array and the vector of frequencies.
Nonlinearity
You can introduce nonlinearities into your model by specifying
parameters in the Nonlinearity Data tab of the S-Parameters
Amplifier block dialog box. Depending on which of these parameters
2-156
S-Parameters Amplifier
2 4 6
FAM / AM (s) = c1 s + c3 s s + c5 s s + c7 s s
that determines the AM/AM conversion for the input signal s . The
block automatically calculates c1 , the linear gain term. If you do not
specify additional nonlinearity data, the block operates as a linear
amplifier. If you do, the block calculates one or more of the remaining
coefficients as the solution to a system of linear equations, determined
by the following method.
1 The block checks whether you have specified a value other than Inf
for:
• The third-order intercept point ( OIP3 or IIP3 ).
2-157
S-Parameters Amplifier
( ) ( ) ( )
3 5 7
Psat,out = c1 Psat,in + c3 Psat,in + c5 Psat,in + c7 Psat,in
( ) ( ) ( )
3 5 7
P1dB,out = c1 P1dB,in + c3 P1dB,in + c5 P1dB,in + c7 P1dB,in
c1
0= + c3
IIP 3
The first two equations are the evaluation of the polynomial
Active Noise
You can specify active block noise in one of the following ways:
2-158
S-Parameters Amplifier
If you specify block noise as spot noise data, the block uses the data to
calculate noise figure. The block first interpolates the noise data for the
modeling frequencies, using the specified Interpolation method. It
then calculates the noise figure using the resulting values.
2-159
S-Parameters Amplifier
S-Parameters
S-parameters for a nonlinear amplifier in a 2-by-2-by-M array. M
is the number of S-parameters.
Frequency (Hz)
Frequencies of the S-parameters as an M-element vector. The
order of the frequencies must correspond to the order of the
S-parameters in S-Parameters. All frequencies must be positive.
Reference impedance (ohms)
Reference impedance of the S-parameters as a scalar or a vector
of length M. The value of this parameter can be real or complex.
If you provide a scalar value, then that value is applied to all
frequencies.
Interpolation method
The method used to interpolate the network parameters. The
following table lists the available methods describes each one.
Method Description
Linear (default) Linear interpolation
Spline Cubic spline interpolation
Cubic Piecewise cubic Hermite
interpolation
2-160
S-Parameters Amplifier
Noise type
Type of noise data. The value can be Noise figure, Spot noise
data, Noise factor, or Noise temperature. This parameter is
disabled if the data source contains noise data.
Noise figure (dB)
Scalar ratio or vector of ratios, in decibels, of the available
signal-to-noise power ratio at the input to the available
2-161
S-Parameters Amplifier
2-162
S-Parameters Amplifier
IP3 type
Type of third-order intercept point. The value can be IIP3 (input
intercept point) or OIP3 (output intercept point). This parameter
is disabled if the data source contains power data or IP3 data.
2-163
S-Parameters Amplifier
IP3 (dBm)
Value of third-order intercept point. This parameter is disabled if
the data source contains power data or IP3 data. Use the default
value, Inf, if you do not know the IP3 value. This parameter can
be a scalar (to specify frequency-independent nonlinearity data)
or a vector (to specify frequency-dependent nonlinearity data).
1 dB gain compression power (dBm)
Output power value ( P1dB,out ) at which gain has decreased by 1
dB. This parameter is disabled if the data source contains power
data or 1-dB compression point data. Use the default value, Inf, if
you do not know the 1-dB compression point. This parameter can
be a scalar (to specify frequency-independent nonlinearity data)
or a vector (to specify frequency-dependent nonlinearity data).
Output saturation power (dBm)
Output power value ( Psat,out ) that the amplifier produces when
fully saturated. This parameter is disabled if the data source
contains output saturation power data. Use the default value,
Inf, if you do not know the saturation power. If you specify
this parameter, you must also specify the Gain compression
at saturation (dB). This parameter can be a scalar (to specify
frequency-independent nonlinearity data) or a vector (to specify
frequency-dependent nonlinearity data).
Gain compression at saturation (dB)
Decrease in gain ( GCsat ) when the power is fully saturated. The
block ignores this parameter if you do not specify the Output
saturation power (dBm). This parameter can be a scalar (to
specify frequency-independent nonlinearity data) or a vector (to
specify frequency-dependent nonlinearity data).
Frequency (Hz)
Scalar or vector value of frequency points corresponding to the
third-order intercept and power data. This parameter is disabled
if the data source contains power data or IP3 data. If you use a
scalar value, the IP3 (dBm), 1 dB gain compression power
2-164
S-Parameters Amplifier
Visualization Tab
2-165
S-Parameters Amplifier
sparams = cat(3,...
[-.33+0.71i, -.03i; 8.12-.02i, -.37-.37i],...
[ .16+0.20i, -.03-.04i; 7.71-8.04i, -.70-.12i])
2-166
S-Parameters Amplifier
2-167
S-Parameters Amplifier
Click Plot. This action creates an X-Y Plane plot of the S11
parameters using the frequencies taken from the Frequency (Hz)
parameter on the Main tab.
2-168
S-Parameters Amplifier
2-169
S-Parameters Mixer
Description The S-Parameters Mixer block models the nonlinear mixer described in
the block dialog box, in terms of its frequency-dependent S-parameters,
the frequencies and reference impedance of the S-parameters, noise
data (including phase noise data), and nonlinearity data.
Network Parameters
The S21 parameter values describe the conversion gain as a function
of frequency, referred to the mixer input frequency. The other
S-parameters also refer to the mixer input frequency.
The S-Parameters Mixer block interpolates the given S-parameters to
determine their values at the modeling frequencies the Output Port
block calculates. For more details about how the Output Port block
calculates the modeling frequencies, see “SimRF Equivalent Baseband
Algorithms”.
SimRF Equivalent Baseband software computes the reflected wave at
the mixer input ( b1 ) and at the mixer output ( b2 ) from the interpolated
S-parameters as
where
• fin and f out are the mixer input and output frequencies, respectively.
• a1 and a2 are the incident waves at the mixer input and output,
respectively.
2-170
S-Parameters Mixer
Active Noise
You can specify active block noise in one of the following ways:
If you specify block noise as spot noise data, the block uses the data to
calculate noise figure. The block first interpolates the noise data for the
modeling frequencies, using the specified Interpolation method. It
then calculates the noise figure using the resulting values.
Phase Noise
The S-Parameters Mixer block applies phase noise to a complex
baseband signal. The block first generates additive white Gaussian
noise (AWGN) and filters the noise with a digital FIR filter. It then
adds the resulting noise to the angle component of the input signal.
The blockset computes the digital filter by:
2 Taking the IFFT of the resulting phase noise spectrum to get the
coefficients of the FIR filter.
Note If you specify phase noise as a scalar value, the blockset assumes
that the phase noise is the phase noise is constant at all modeling
frequencies and does not have a 1/f slope. This assumption differs from
that made by the Mathematical Mixer block.
Nonlinearity
You can introduce nonlinearities into your model by specifying
parameters in the Nonlinearity Data tab of the S-parameters Mixer
block dialog box. Depending on which of these parameters you specify,
2-171
S-Parameters Mixer
2 4 6
FAM / AM (s) = c1 s + c3 s s + c5 s s + c7 s s
that determines the AM/AM conversion for the input signal s . The
block automatically calculates c1 , the linear gain term. If you do not
specify additional nonlinearity data, the block operates as a mixer
with a linear gain. If you do, the block calculates one or more of the
remaining coefficients as the solution to a system of linear equations,
determined by the following method.
1 The block checks whether you have specified a value other than Inf
for:
• The third-order intercept point ( OIP3 or IIP3 ).
2-172
S-Parameters Mixer
( ) ( ) ( )
3 5 7
Psat,out = c1 Psat,in + c3 Psat,in + c5 Psat,in + c7 Psat,in
( ) ( ) ( )
3 5 7
P1dB,out = c1 P1dB,in + c3 P1dB,in + c5 P1dB,in + c7 P1dB,in
c1
0= + c3
IIP 3
The first two equations are the evaluation of the polynomial
2-173
S-Parameters Mixer
S-Parameters
S-parameters for a nonlinear mixer in a 2-by-2-by-M array. M is
the number of S-parameters.
Frequency (Hz)
Frequencies of the S-parameters as an M-element vector. The
order of the frequencies must correspond to the order of the
S-parameters in S-Parameters. All frequencies must be positive.
The following figure shows the correspondence between the
S-parameters array and the vector of frequencies.
2-174
S-Parameters Mixer
Method Description
Linear (default) Linear interpolation
Spline Cubic spline interpolation
Cubic Piecewise cubic Hermite
interpolation
Mixer Type
Type of mixer. Choices are Downconverter (default) and
Upconverter.
LO frequency (Hz)
Local oscillator frequency. If you choose Downconverter, the
blockset computes the mixer output frequency, fout, from the mixer
input frequency, fin, and the local oscillator frequency, flo, as
fout = fin – flo. If you choose Upconverter, fout = fin + flo.
2-175
S-Parameters Mixer
2-176
S-Parameters Mixer
2-177
S-Parameters Mixer
2-178
S-Parameters Mixer
IP3 type
Type of third-order intercept point. The value can be IIP3 (input
intercept point) or OIP3 (output intercept point). This parameter
is disabled if the data source contains power data or IP3 data.
2-179
S-Parameters Mixer
IP3 (dBm)
Value of third-order intercept point. This parameter is disabled if
the data source contains power data or IP3 data. Use the default
value, Inf, if you do not know the IP3 value. This parameter can
be a scalar (to specify frequency-independent nonlinearity data)
or a vector (to specify frequency-dependent nonlinearity data).
1 dB gain compression power (dBm)
Output power value ( P1dB,out ) at which gain has decreased by 1
dB. This parameter is disabled if the data source contains power
data or 1-dB compression point data. Use the default value, Inf, if
you do not know the 1-dB compression point. This parameter can
be a scalar (to specify frequency-independent nonlinearity data)
or a vector (to specify frequency-dependent nonlinearity data).
Output saturation power (dBm)
Output power value ( Psat,out ) that the mixer produces when fully
saturated. This parameter is disabled if the data source contains
output saturation power data. Use the default value, Inf, if you do
not know the saturation power. If you specify this parameter, you
must also specify the Gain compression at saturation (dB).
This parameter can be a scalar (to specify frequency-independent
nonlinearity data) or a vector (to specify frequency-dependent
nonlinearity data).
Gain compression at saturation (dB)
Decrease in gain ( GCsat ) when the power is fully saturated. The
block ignores this parameter if you do not specify the Output
saturation power (dBm). This parameter can be a scalar (to
specify frequency-independent nonlinearity data) or a vector (to
specify frequency-dependent nonlinearity data).
Frequency (Hz)
Scalar or vector value of frequency points corresponding to the
third-order intercept and power data. This parameter is disabled
if the data source contains power data or IP3 data. If you use a
scalar value, the IP3 (dBm), 1 dB gain compression power
2-180
S-Parameters Mixer
Visualization Tab
2-181
S-Parameters Mixer
See Also General Mixer, Output Port, Y-Parameters Mixer, Z-Parameters Mixer
2-182
S-Parameters Passive Network
Description The S-Parameters Passive Network block models the two-port passive
network described in the block dialog box, in terms of its S-parameters
and the frequencies and reference impedance of the S-parameters.
In the S-Parameters field of the block dialog box, provide the
S-parameters for each of M frequencies as a 2-by-2-by-M array. In the
Frequency field, specify the frequencies for the S-parameters as an
M-element vector. The elements of the vector must be in the same order
as the S-parameters. All frequencies must be positive. For example, the
following figure shows the correspondence between the S-parameters
array and the vector of frequencies.
2-183
S-Parameters Passive Network
S-Parameters
S-parameters for a two-port passive network in a 2-by-2-by-M
array. M is the number of S-parameters.
Frequency (Hz)
Frequencies of the S-parameters as an M-element vector. The
order of the frequencies must correspond to the order of the
S-parameters in S-Parameters. All frequencies must be positive.
Reference impedance (ohms)
Reference impedance of the network as a scalar or a vector of
length M. The value of this parameter can be real or complex.
If you provide a scalar value, then that value is applied to all
frequencies.
2-184
S-Parameters Passive Network
Interpolation method
The method used to interpolate the network parameters. The
following table lists the available methods describes each one.
Method Description
Linear (default) Linear interpolation
Spline Cubic spline interpolation
Cubic Piecewise cubic Hermite
interpolation
Visualization Tab
2-185
S-Parameters Passive Network
You could also use the MATLAB reshape function. The following
command produces the same result as previous command.
reshape([-.96-.23i;.03-.12i;.03-.12i;-.96-.23i;...
-.96-.11i;.02-.21i;.02-.21i;-.96-.11i],2,2,2)
sparams = cat(3,...
[-.96-.23i, .03-.12i; .03-.12i, -.96-.23i],...
[-.96-.11i, .02-.21i; .02-.21i, -.96-.11i])
2-186
S-Parameters Passive Network
2-187
S-Parameters Passive Network
Click Plot. This action creates an X-Y Plane plot of the magnitude of
the S21 parameters, in decibels, in the frequency range 1.9 to 2.2 GHz.
2-188
S-Parameters Passive Network
See Also General Circuit Element, General Passive Network, Output Port,
Y-Parameters Passive Network, Z-Parameters Passive Network
interp1 (MATLAB)
2-189
Series C
Description The Series C block models the series capacitor described in the block
dialog box, in terms of its frequency-dependent S-parameters.
The series C object is a two-port network, as shown in the following
circuit diagram.
2-190
Series C
Capacitance (F)
Scalar value for the capacitance. The value must be nonnegative.
Visualization Tab
2-191
Series L
Description The Series L block models the series inductor described in the block
dialog box, in terms of its frequency-dependent S-parameters.
The series L object is a two-port network, as shown in the following
circuit diagram.
2-192
Series L
Inductance (H)
Scalar value for the inductance. The value must be nonnegative.
Visualization Tab
2-193
Series R
Description The Series R block models the series resistor described in the block
dialog box, in terms of its frequency-dependent S-parameters.
The series R object is a two-port network, as shown in the following
circuit diagram.
2-194
Series R
Resistance (ohms)
Scalar value for the resistance. The value must be nonnegative.
Visualization Tab
2-195
Series RLC
Description The Series RLC block models the series RLC network described in the
block dialog box, in terms of its frequency-dependent S-parameters.
For the given resistance, inductance, and capacitance, the block first
calculates the ABCD-parameters at each frequency contained in the
vector of modeling frequencies, and then converts the ABCD-parameters
to S-parameters using the RF Toolbox abcd2s function. See the
Output Port block reference page for information about determining
the modeling frequencies.
For this circuit, A = 1, B = Z, C = 0, and D = 1, where
− LC 2 + jRC + 1
Z=
jC
and = 2 f .
The series RLC object is a two-port network as shown in the following
circuit diagram.
R L C
2-196
Series RLC
Resistance (ohms)
Scalar value for the resistance. The value must be nonnegative.
Inductance (H)
Scalar value for the inductance. The value must be nonnegative.
Capacitance (F)
Scalar value for the capacitance. The value must be nonnegative.
2-197
Series RLC
Visualization Tab
2-198
Shunt C
Description The Shunt C block models the shunt capacitor described in the block
dialog box, in terms of its frequency-dependent S-parameters.
The shunt C object is a two-port network, as shown in the following
circuit diagram.
2-199
Shunt C
Capacitance (F)
Scalar value for the capacitance. The value must be nonnegative.
Visualization Tab
2-200
Shunt L
Description The Shunt L block models the shunt inductor described in the block
dialog box, in terms of its frequency-dependent S-parameters.
The shunt L object is a two-port network, as shown in the following
circuit diagram.
2-201
Shunt L
Inductance (H)
Scalar value for the inductance. The value must be nonnegative.
Visualization Tab
2-202
Shunt R
Description The Shunt R block models the shunt resistor described in the block
dialog box, in terms of its frequency-dependent S-parameters.
The shunt R object is a two-port network, as shown in the following
circuit diagram.
2-203
Shunt R
Resistance (ohms)
Scalar value for the resistance. The value must be nonnegative.
Visualization Tab
2-204
Shunt RLC
Description The Shunt RLC block models the shunt RLC network described in the
block dialog box, in terms of its frequency-dependent S-parameters.
For the given resistance, inductance, and capacitance, the block first
calculates the ABCD-parameters at each frequency contained in the
vector of modeling frequencies, and then converts the ABCD-parameters
to S-parameters using the RF Toolbox abcd2s function. See the
Output Port block reference page for information about determining
the modeling frequencies.
For this circuit, A = 1, B = 0, C = Y, and D = 1, where
− LC 2 + j( L / R) + 1
Y =
jL
and = 2 f .
The shunt RLC object is a two-port network as shown in the following
circuit diagram.
R L C
2-205
Shunt RLC
Resistance (ohms)
Scalar value for the resistance. The value must be nonnegative.
Inductance (H)
Scalar value for the inductance. The value must be nonnegative.
Capacitance (F)
Scalar value for the capacitance. The value must be nonnegative.
2-206
Shunt RLC
Visualization Tab
2-207
Transmission Line (Equivalent Baseband)
Description The Transmission Line block models the transmission line described
in the block dialog box in terms of its physical parameters. The
transmission line, which can be lossy or lossless, is treated as a two-port
linear network.
The block enables you to model the transmission line as a stub or as
a stubless line.
ekd + e− kd
A=
2
B=
(
Z0 * ekd − e− kd )
2
kd − kd
e −e
C=
2 * Z0
ekd + e− kd
D=
2
2-208
Transmission Line (Equivalent Baseband)
a = − ln (10 / 20 )
2 f
=
Vp
Shunt ABCD-Parameters
When you set the Stub mode parameter in the mask dialog box to
Shunt, the two-port network consists of a stub transmission line that
you can terminate with either a short circuit or an open circuit as
shown here.
2-209
Transmission Line (Equivalent Baseband)
A =1
B=0
C = 1 / Zin
D =1
Series ABCD-Parameters
When you set the Stub mode parameter in the mask dialog box to
Series, the two-port network consists of a series transmission line
that you can terminate with either a short circuit or an open circuit
as shown here.
A =1
B = Zin
C=0
D =1
2-210
Transmission Line (Equivalent Baseband)
2-211
Transmission Line (Equivalent Baseband)
Visualization Tab
References [1] Ludwig, Reinhold and Pavel Bretchko, RF Circuit Design: Theory
and Applications, Prentice-Hall, 2000.
2-212
Transmission Line (Equivalent Baseband)
2-213
Two-Wire Transmission Line
Wires
a
Dielectric
2-214
Two-Wire Transmission Line
ekd + e− kd
A=
2
B=
(
Z0 * ekd − e− kd )
2
kd − kd
e −e
C=
2 * Z0
ekd + e− kd
D=
2
R + j ωL
Z0 =
G + j ωC
k = kr + jki = ( R + jωL)(G + jωC)
where
2-215
Two-Wire Transmission Line
1
R=
a cond cond
⎛ D⎞
L= a cosh ⎜ ⎟
⎝ 2a ⎠
′′
G=
⎛ D⎞
a cosh ⎜ ⎟
⎝ 2a ⎠
C=
⎛ D⎞
a cosh ⎜ ⎟
⎝ 2a ⎠
and = 2 f .
In these equations:
as 1 / f cond .
• f is a vector of modeling frequencies determined by the Output Port
block.
2-216
Two-Wire Transmission Line
Shunt ABCD-Parameters
When you set the Stub mode parameter in the mask dialog box to
Shunt, the two-port network consists of a stub transmission line that
you can terminate with either a short circuit or an open circuit as
shown here.
A =1
B=0
C = 1 / Zin
D =1
Series ABCD-Parameters
When you set the Stub mode parameter in the mask dialog box to
Series, the two-port network consists of a series transmission line
that you can terminate with either a short circuit or an open circuit
as shown here.
2-217
Two-Wire Transmission Line
A =1
B = Zin
C=0
D =1
2-218
Two-Wire Transmission Line
2-219
Two-Wire Transmission Line
Visualization Tab
References [1] Pozar, David M. Microwave Engineering, John Wiley & Sons, Inc.,
2005.
2-220
Y-Parameters Amplifier
2-221
Y-Parameters Amplifier
2 4 6
FAM / AM (s) = c1 s + c3 s s + c5 s s + c7 s s
that determines the AM/AM conversion for the input signal s . The
block automatically calculates c1 , the linear gain term. If you do not
specify additional nonlinearity data, the block operates as a linear
amplifier. If you do, the block calculates one or more of the remaining
coefficients as the solution to a system of linear equations, determined
by the following method.
1 The block checks whether you have specified a value other than Inf
for:
• The third-order intercept point ( OIP3 or IIP3 ).
2-222
Y-Parameters Amplifier
( ) ( ) ( )
3 5 7
Psat,out = c1 Psat,in + c3 Psat,in + c5 Psat,in + c7 Psat,in
( ) ( ) ( )
3 5 7
P1dB,out = c1 P1dB,in + c3 P1dB,in + c5 P1dB,in + c7 P1dB,in
c1
0= + c3
IIP 3
The first two equations are the evaluation of the polynomial
Active Noise
You can specify active block noise in one of the following ways:
2-223
Y-Parameters Amplifier
If you specify block noise as spot noise data, the block uses the data to
calculate noise figure. The block first interpolates the noise data for the
modeling frequencies, using the specified Interpolation method. It
then calculates the noise figure using the resulting values.
Y-Parameters
Y-parameters for a nonlinear amplifier in a 2-by-2-by-M array. M
is the number of Y-parameters.
2-224
Y-Parameters Amplifier
Frequency (Hz)
Frequencies of the Y-parameters as an M-element vector. The
order of the frequencies must correspond to the order of the
Y-parameters in Y-Parameters. All frequencies must be positive.
Interpolation method
The method used to interpolate the network parameters. The
following table lists the available methods describes each one.
Method Description
Linear (default) Linear interpolation
Spline Cubic spline interpolation
Cubic Piecewise cubic Hermite
interpolation
2-225
Y-Parameters Amplifier
Noise type
Type of noise data. The value can be Noise figure, Spot noise
data, Noise factor, or Noise temperature. This parameter is
disabled if the data source contains noise data.
Noise figure (dB)
Scalar ratio or vector of ratios, in decibels, of the available
signal-to-noise power ratio at the input to the available
2-226
Y-Parameters Amplifier
2-227
Y-Parameters Amplifier
IP3 type
Type of third-order intercept point. The value can be IIP3 (input
intercept point) or OIP3 (output intercept point). This parameter
is disabled if the data source contains power data or IP3 data.
2-228
Y-Parameters Amplifier
IP3 (dBm)
Value of third-order intercept point. This parameter is disabled if
the data source contains power data or IP3 data. Use the default
value, Inf, if you do not know the IP3 value. This parameter can
be a scalar (to specify frequency-independent nonlinearity data)
or a vector (to specify frequency-dependent nonlinearity data).
1 dB gain compression power (dBm)
Output power value ( P1dB,out ) at which gain has decreased by 1
dB. This parameter is disabled if the data source contains power
data or 1-dB compression point data. Use the default value, Inf, if
you do not know the 1-dB compression point. This parameter can
be a scalar (to specify frequency-independent nonlinearity data)
or a vector (to specify frequency-dependent nonlinearity data).
Output saturation power (dBm)
Output power value ( Psat,out ) that the amplifier produces when
fully saturated. This parameter is disabled if the data source
contains output saturation power data. Use the default value,
Inf, if you do not know the saturation power. If you specify
this parameter, you must also specify the Gain compression
at saturation (dB). This parameter can be a scalar (to specify
frequency-independent nonlinearity data) or a vector (to specify
frequency-dependent nonlinearity data).
Gain compression at saturation (dB)
Decrease in gain ( GCsat ) when the power is fully saturated. The
block ignores this parameter if you do not specify the Output
saturation power (dBm). This parameter can be a scalar (to
specify frequency-independent nonlinearity data) or a vector (to
specify frequency-dependent nonlinearity data).
Frequency (Hz)
Scalar or vector value of frequency points corresponding to the
third-order intercept and power data. This parameter is disabled
if the data source contains power data or IP3 data. If you use a
scalar value, the IP3 (dBm), 1 dB gain compression power
2-229
Y-Parameters Amplifier
Visualization Tab
2-230
Y-Parameters Amplifier
yparams = cat(3,...
[-.06+.58i, -.08i; 1.14-1.82i, -.07+.28i],...
[ .02-.21i, 0.03i; -.21+.72i, .03-.11i])
2-231
Y-Parameters Amplifier
2-232
Y-Parameters Amplifier
Click Plot. This action creates an X-Y Plane plot of the S11
parameters in the frequency range 1.8 to 2.3 GHz.
2-233
Y-Parameters Amplifier
2-234
Y-Parameters Mixer
Description The Y-Parameters Mixer block models the nonlinear mixer described in
the block dialog box in terms of its frequency-dependent Y-parameters,
the frequencies of the Y-parameters, noise data (including phase noise
data), and nonlinearity data.
Network Parameters
The Y-parameter values all refer to the mixer input frequency.
The Y-Parameters Mixer block uses the RF Toolbox y2s function to
convert the Y-parameters to S-parameters and then interpolates the
resulting S-parameters to determine their values at the modeling
frequencies. See “SimRF Equivalent Baseband Algorithms” for more
details.
SimRF Equivalent Baseband software computes the reflected wave at
the mixer input ( b1 ) and at the mixer output ( b2 ) from the interpolated
S-parameters as
where
• fin and f out are the mixer input and output frequencies, respectively.
• a1 and a2 are the incident waves at the mixer input and output,
respectively.
2-235
Y-Parameters Mixer
If you specify block noise as spot noise data, the block uses the data to
calculate noise figure. The block first interpolates the noise data for the
modeling frequencies, using the specified Interpolation method. It
then calculates the noise figure using the resulting values.
Phase Noise
The Y-Parameters Mixer block applies phase noise to a complex
baseband signal. The block first generates additive white Gaussian
noise (AWGN) and filters the noise with a digital FIR filter. It then
adds the resulting noise to the angle component of the input signal.
The blockset computes the digital filter by:
2 Taking the IFFT of the resulting phase noise spectrum to get the
coefficients of the FIR filter.
Note If you specify phase noise as a scalar value, the blockset assumes
that the phase noise is the phase noise is constant at all modeling
frequencies and does not have a 1/f slope. This assumption differs from
that made by the Mathematical Mixer block.
Nonlinearity
You can introduce nonlinearities into your model by specifying
parameters in the Nonlinearity Data tab of the Y-Parameters Mixer
block dialog box. Depending on which of these parameters you specify,
the block computes up to four of the coefficients c1 , c3 , c5 , and c7 of
the polynomial
2-236
Y-Parameters Mixer
2 4 6
FAM / AM (s) = c1 s + c3 s s + c5 s s + c7 s s
that determines the AM/AM conversion for the input signal s . The
block automatically calculates c1 , the linear gain term. If you do not
specify additional nonlinearity data, the block operates as a mixer
with a linear gain. If you do, the block calculates one or more of the
remaining coefficients as the solution to a system of linear equations,
determined by the following method.
1 The block checks whether you have specified a value other than Inf
for:
• The third-order intercept point ( OIP3 or IIP3 ).
2-237
Y-Parameters Mixer
( ) ( ) ( )
3 5 7
Psat,out = c1 Psat,in + c3 Psat,in + c5 Psat,in + c7 Psat,in
( ) ( ) ( )
3 5 7
P1dB,out = c1 P1dB,in + c3 P1dB,in + c5 P1dB,in + c7 P1dB,in
c1
0= + c3
IIP 3
The first two equations are the evaluation of the polynomial
2-238
Y-Parameters Mixer
Y-Parameters
Y-parameters for a nonlinear mixer in a 2-by-2-by-M array. M is
the number of Y-parameters.
Frequency (Hz)
Frequencies of the Y-parameters as an M-element vector. The
order of the frequencies must correspond to the order of the
Y-parameters in Y-Parameters. All frequencies must be positive.
The following figure shows the correspondence between the
Y-parameters array and the vector of frequencies.
2-239
Y-Parameters Mixer
Interpolation method
The method used to interpolate the network parameters. The
following table lists the available methods describes each one.
Method Description
Linear (default) Linear interpolation
Spline Cubic spline interpolation
Cubic Piecewise cubic Hermite
interpolation
Mixer Type
Type of mixer. Choices are Downconverter (default) and
Upconverter.
LO frequency (Hz)
Local oscillator frequency. If you choose Downconverter, the
blockset computes the mixer output frequency, fout, from the mixer
input frequency, fin, and the local oscillator frequency, flo, as
fout = fin – flo. If you choose Upconverter, fout = fin + flo.
2-240
Y-Parameters Mixer
2-241
Y-Parameters Mixer
2-242
Y-Parameters Mixer
2-243
Y-Parameters Mixer
IP3 type
Type of third-order intercept point. The value can be IIP3 (input
intercept point) or OIP3 (output intercept point). This parameter
is disabled if the data source contains power data or IP3 data.
2-244
Y-Parameters Mixer
IP3 (dBm)
Value of third-order intercept point. This parameter is disabled if
the data source contains power data or IP3 data. Use the default
value, Inf, if you do not know the IP3 value. This parameter can
be a scalar (to specify frequency-independent nonlinearity data)
or a vector (to specify frequency-dependent nonlinearity data).
1 dB gain compression power (dBm)
Output power value ( P1dB,out ) at which gain has decreased by 1
dB. This parameter is disabled if the data source contains power
data or 1-dB compression point data. Use the default value, Inf, if
you do not know the 1-dB compression point. This parameter can
be a scalar (to specify frequency-independent nonlinearity data)
or a vector (to specify frequency-dependent nonlinearity data).
Output saturation power (dBm)
Output power value ( Psat,out ) that the mixer produces when fully
saturated. This parameter is disabled if the data source contains
output saturation power data. Use the default value, Inf, if you do
not know the saturation power. If you specify this parameter, you
must also specify the Gain compression at saturation (dB).
This parameter can be a scalar (to specify frequency-independent
nonlinearity data) or a vector (to specify frequency-dependent
nonlinearity data).
Gain compression at saturation (dB)
Decrease in gain ( GCsat ) when the power is fully saturated. The
block ignores this parameter if you do not specify the Output
saturation power (dBm). This parameter can be a scalar (to
specify frequency-independent nonlinearity data) or a vector (to
specify frequency-dependent nonlinearity data).
Frequency (Hz)
Scalar or vector value of frequency points corresponding to the
third-order intercept and power data. This parameter is disabled
if the data source contains power data or IP3 data. If you use a
scalar value, the IP3 (dBm), 1 dB gain compression power
2-245
Y-Parameters Mixer
Visualization Tab
2-246
Y-Parameters Mixer
See Also General Mixer, Output Port, S-Parameters Mixer, Z-Parameters Mixer
2-247
Y-Parameters Passive Network
Description The Y-Parameters Passive Network block models the two-port passive
network described in the block dialog box, in terms of its Y-parameters
and their associated frequencies.
In the Y-Parameters field of the block dialog box, provide the
Y-parameters for each of M frequencies as a 2-by-2-by-M array. In the
Frequency field, specify the frequencies for the Y-parameters as an
M-element vector. The elements of the vector must be in the same order
as the Y-parameters. All frequencies must be positive. For example, the
following figure shows the correspondence between the Y-parameters
array and the vector of frequencies.
2-248
Y-Parameters Passive Network
Y-Parameters
Y-parameters for a two-port passive network in a 2-by-2-by-M
array. M is the number of Y-parameters.
Frequency (Hz)
Frequencies of the Y-parameters as an M-element vector. The
order of the frequencies must correspond to the order of the
Y-parameters in Y-Parameters. All frequencies must be positive.
Interpolation method
The method used to interpolate the network parameters. The
following table lists the available methods describes each one.
2-249
Y-Parameters Passive Network
Method Description
Linear (default) Linear interpolation
Spline Cubic spline interpolation
Cubic Piecewise cubic Hermite
interpolation
Visualization Tab
2-250
Y-Parameters Passive Network
2.1 GHz respectively. It uses the MATLAB cat function to create the
2-by-2-by-2 Y-parameters array.
cat(3,[.23i,-.12i;-.12i,.23i],...
[.02-.13i,-.02+.25i;-.02+.25i, .02-.13i])
yparams = cat(3,[.23i,-.12i;-.12i,.23i],...
[.02-.13i,-.02+.25i;-.02+.25i, .02-.13i])
2-251
Y-Parameters Passive Network
Click Plot. This action creates a polar plane plot of the S11
parameters in the frequency range 1.9 to 2.2 GHz.
2-252
Y-Parameters Passive Network
See Also General Circuit Element, General Passive Network, Output Port,
S-Parameters Passive Network, Z-Parameters Passive Network
y2s (RF Toolbox)
interp1 (MATLAB)
2-253
Z-Parameters Amplifier
Network Parameters
In the Z-Parameters field of the block dialog box, provide the
Z-parameters for each of M frequencies as a 2-by-2-by-M array. In the
Frequency field, specify the frequencies for the Z-parameters as an
M-element vector. The elements of the frequencies vector must be in
the same order as the Z-parameters. All frequencies must be positive.
For example, the following figure shows the correspondence between
the Z-parameters array and the vector of frequencies.
2-254
Z-Parameters Amplifier
Nonlinearity
You can introduce nonlinearities into your model by specifying
parameters in the Nonlinearity Data tab of the Z-Parameters
Amplifier block dialog box. Depending on which of these parameters
you specify, the block computes up to four of the coefficients c1 , c3 , c5 ,
and c7 of the polynomial
2 4 6
FAM / AM (s) = c1 s + c3 s s + c5 s s + c7 s s
that determines the AM/AM conversion for the input signal s . The
block automatically calculates c1 , the linear gain term. If you do not
specify additional nonlinearity data, the block operates as a linear
amplifier. If you do, the block calculates one or more of the remaining
coefficients as the solution to a system of linear equations, determined
by the following method.
1 The block checks whether you have specified a value other than Inf
for:
• The third-order intercept point ( OIP3 or IIP3 ).
2-255
Z-Parameters Amplifier
( ) ( ) ( )
3 5 7
Psat,out = c1 Psat,in + c3 Psat,in + c5 Psat,in + c7 Psat,in
( ) ( ) ( )
3 5 7
P1dB,out = c1 P1dB,in + c3 P1dB,in + c5 P1dB,in + c7 P1dB,in
c1
0= + c3
IIP 3
The first two equations are the evaluation of the polynomial
2-256
Z-Parameters Amplifier
Active Noise
You can specify active block noise in one of the following ways:
If you specify block noise as spot noise data, the block uses the data to
calculate noise figure. The block first interpolates the noise data for the
modeling frequencies, using the specified Interpolation method. It
then calculates the noise figure using the resulting values.
2-257
Z-Parameters Amplifier
Z-Parameters
Z-parameters for a nonlinear amplifier in a 2-by-2-by-M array. M
is the number of Z-parameters.
Frequency (Hz)
Frequencies of the Z-parameters as an M-element vector. The
order of the frequencies must correspond to the order of the
Z-parameters in Z-Parameters. All frequencies must be positive.
Interpolation method
The method used to interpolate the network parameters. The
following table lists the available methods describes each one.
2-258
Z-Parameters Amplifier
Method Description
Linear (default) Linear interpolation
Spline Cubic spline interpolation
Cubic Piecewise cubic Hermite
interpolation
2-259
Z-Parameters Amplifier
Noise type
Type of noise data. The value can be Noise figure, Spot noise
data, Noise factor, or Noise temperature. This parameter is
disabled if the data source contains noise data.
Noise figure (dB)
Scalar ratio or vector of ratios, in decibels, of the available
signal-to-noise power ratio at the input to the available
signal-to-noise power ratio at the output, (Si/Ni)/(So/No). This
parameter is enabled if Noise type is set to Noise figure.
Minimum noise figure (dB)
Minimum scalar ratio or vector of minimum ratios of the
available signal-to-noise power ratio at the input to the available
signal-to-noise power ratio at the output, (Si/Ni)/(So/No). This
parameter is enabled if Noise type is set to Spot noise data.
Optimal reflection coefficient
Optimal amplifier source impedance. This parameter is enabled
if Noise type is set to Spot noise data. The value can be a
scalar or vector.
Equivalent normalized resistance
Resistance or vector of resistances normalized to the resistance
value or values used to take the noise measurement. This
parameter is enabled if Noise type is set to Spot noise data.
Noise factor
Scalar ratio or vector of ratios of the available signal-to-noise
power ratio at the input to the available signal-to-noise power
ratio at the output, (Si/Ni)/(So/No). This parameter is enabled if
Noise type is set to Noise factor.
Noise temperature (K)
Equivalent temperature or vector of temperatures that produce
the same amount of noise power as the amplifier. This parameter
is enabled if Noise type is set to Noise temperature.
2-260
Z-Parameters Amplifier
Frequency (Hz)
Scalar value or vector corresponding to the domain of frequencies
over which you are specifying the noise data. If you provide a
scalar value for your noise data, the block ignores the Frequency
(Hz) parameter and uses the noise data for all frequencies. If
you provide a vector of values for your noise data, it must be
the same size as the vector of frequencies. The block uses the
Interpolation method specified in the Main tab to interpolate
noise data.
2-261
Z-Parameters Amplifier
IP3 type
Type of third-order intercept point. The value can be IIP3 (input
intercept point) or OIP3 (output intercept point). This parameter
is disabled if the data source contains power data or IP3 data.
2-262
Z-Parameters Amplifier
IP3 (dBm)
Value of third-order intercept point. This parameter is disabled if
the data source contains power data or IP3 data. Use the default
value, Inf, if you do not know the IP3 value. This parameter can
be a scalar (to specify frequency-independent nonlinearity data)
or a vector (to specify frequency-dependent nonlinearity data).
1 dB gain compression power (dBm)
Output power value ( P1dB,out ) at which gain has decreased by 1
dB. This parameter is disabled if the data source contains power
data or 1-dB compression point data. Use the default value, Inf, if
you do not know the 1-dB compression point. This parameter can
be a scalar (to specify frequency-independent nonlinearity data)
or a vector (to specify frequency-dependent nonlinearity data).
Output saturation power (dBm)
Output power value ( Psat,out ) that the amplifier produces when
fully saturated. This parameter is disabled if the data source
contains output saturation power data. Use the default value,
Inf, if you do not know the saturation power. If you specify
this parameter, you must also specify the Gain compression
at saturation (dB). This parameter can be a scalar (to specify
frequency-independent nonlinearity data) or a vector (to specify
frequency-dependent nonlinearity data).
Gain compression at saturation (dB)
Decrease in gain ( GCsat ) when the power is fully saturated. The
block ignores this parameter if you do not specify the Output
saturation power (dBm). This parameter can be a scalar (to
specify frequency-independent nonlinearity data) or a vector (to
specify frequency-dependent nonlinearity data).
Frequency (Hz)
Scalar or vector value of frequency points corresponding to the
third-order intercept and power data. This parameter is disabled
if the data source contains power data or IP3 data. If you use a
scalar value, the IP3 (dBm), 1 dB gain compression power
2-263
Z-Parameters Amplifier
Visualization Tab
2-264
Z-Parameters Amplifier
cat(3,...
[12.60+3.80i, 3.77-0.17i; 80.02+54.68i, 26.02+3.84i],...
[15.12+3.55i, 4.14-0.92i; 92.10+23.67i, 27.59+2.71i])
zparams = cat(3,...
[12.60+3.80i, 3.77-0.17i; 80.02+54.68i, 26.02+3.84i],...
[15.12+3.55i, 4.14-0.92i; 92.10+23.67i, 27.59+2.71i])
2-265
Z-Parameters Amplifier
2-266
Z-Parameters Amplifier
Click Plot. This action creates an X-Y Plane plot of the S11
parameters in the frequency range 1.9 to 2.2 GHz.
2-267
Z-Parameters Amplifier
2-268
Z-Parameters Mixer
Description The Z-Parameters Mixer block models the nonlinear mixer described in
the block dialog box in terms of its frequency-dependent Z-parameters,
the frequencies of the Z-parameters, noise data (including phase noise
data), and nonlinearity data.
Network Parameters
The Z-parameter values all refer to the mixer input frequency.
The Z-Parameters Mixer block uses the RF Toolbox z2s function to
convert the Z-parameters to S-parameters and then interpolates the
resulting S-parameters to determine their values at the modeling
frequencies. See “SimRF Equivalent Baseband Algorithms” for more
details.
SimRF Equivalent Baseband software computes the reflected wave at
the mixer input ( b1 ) and at the mixer output ( b2 ) from the interpolated
S-parameters as
where
• fin and f out are the mixer input and output frequencies, respectively.
• a1 and a2 are the incident waves at the mixer input and output,
respectively.
2-269
Z-Parameters Mixer
If you specify block noise as spot noise data, the block uses the data to
calculate noise figure. The block first interpolates the noise data for the
modeling frequencies, using the specified Interpolation method. It
then calculates the noise figure using the resulting values.
Phase Noise
The Z-Parameters Mixer block applies phase noise to a complex
baseband signal. The block first generates additive white Gaussian
noise (AWGN) and filters the noise with a digital FIR filter. It then
adds the resulting noise to the angle component of the input signal.
The blockset computes the digital filter by:
2 Taking the IFFT of the resulting phase noise spectrum to get the
coefficients of the FIR filter.
Note If you specify phase noise as a scalar value, the blockset assumes
that the phase noise is the phase noise is constant at all modeling
frequencies and does not have a 1/f slope. This assumption differs from
that made by the Mathematical Mixer block.
Nonlinearity
You can introduce nonlinearities into your model by specifying
parameters in the Nonlinearity Data tab of the Z-Parameters Mixer
block dialog box. Depending on which of these parameters you specify,
the block computes up to four of the coefficients c1 , c3 , c5 , and c7 of
the polynomial
2-270
Z-Parameters Mixer
2 4 6
FAM / AM (s) = c1 s + c3 s s + c5 s s + c7 s s
that determines the AM/AM conversion for the input signal s . The
block automatically calculates c1 , the linear gain term. If you do not
specify additional nonlinearity data, the block operates as a mixer
with a linear gain. If you do, the block calculates one or more of the
remaining coefficients as the solution to a system of linear equations,
determined by the following method.
1 The block checks whether you have specified a value other than Inf
for:
• The third-order intercept point ( OIP3 or IIP3 ).
2-271
Z-Parameters Mixer
( ) ( ) ( )
3 5 7
Psat,out = c1 Psat,in + c3 Psat,in + c5 Psat,in + c7 Psat,in
( ) ( ) ( )
3 5 7
P1dB,out = c1 P1dB,in + c3 P1dB,in + c5 P1dB,in + c7 P1dB,in
c1
0= + c3
IIP 3
The first two equations are the evaluation of the polynomial
2-272
Z-Parameters Mixer
Z-Parameters
Z-parameters for a nonlinear mixer in a 2-by-2-by-M array. M is
the number of Z-parameters.
Frequency (Hz)
Frequencies of the Z-parameters as an M-element vector. The
order of the frequencies must correspond to the order of the
Z-parameters in Z-Parameters. All frequencies must be positive.
The following figure shows the correspondence between the
Z-parameters array and the vector of frequencies.
2-273
Z-Parameters Mixer
Interpolation method
The method used to interpolate the network parameters. The
following table lists the available methods describes each one.
Method Description
Linear (default) Linear interpolation
Spline Cubic spline interpolation
Cubic Piecewise cubic Hermite
interpolation
Mixer Type
Type of mixer. Choices are Downconverter (default) and
Upconverter.
LO frequency (Hz)
Local oscillator frequency. If you choose Downconverter, the
blockset computes the mixer output frequency, fout, from the mixer
input frequency, fin, and the local oscillator frequency, flo, as
fout = fin – flo. If you choose Upconverter, fout = fin + flo.
2-274
Z-Parameters Mixer
2-275
Z-Parameters Mixer
2-276
Z-Parameters Mixer
2-277
Z-Parameters Mixer
IP3 type
Type of third-order intercept point. The value can be IIP3 (input
intercept point) or OIP3 (output intercept point). This parameter
is disabled if the data source contains power data or IP3 data.
2-278
Z-Parameters Mixer
IP3 (dBm)
Value of third-order intercept point. This parameter is disabled if
the data source contains power data or IP3 data. Use the default
value, Inf, if you do not know the IP3 value. This parameter can
be a scalar (to specify frequency-independent nonlinearity data)
or a vector (to specify frequency-dependent nonlinearity data).
1 dB gain compression power (dBm)
Output power value ( P1dB,out ) at which gain has decreased by 1
dB. This parameter is disabled if the data source contains power
data or 1-dB compression point data. Use the default value, Inf, if
you do not know the 1-dB compression point. This parameter can
be a scalar (to specify frequency-independent nonlinearity data)
or a vector (to specify frequency-dependent nonlinearity data).
Output saturation power (dBm)
Output power value ( Psat,out ) that the mixer produces when fully
saturated. This parameter is disabled if the data source contains
output saturation power data. Use the default value, Inf, if you do
not know the saturation power. If you specify this parameter, you
must also specify the Gain compression at saturation (dB).
This parameter can be a scalar (to specify frequency-independent
nonlinearity data) or a vector (to specify frequency-dependent
nonlinearity data).
Gain compression at saturation (dB)
Decrease in gain ( GCsat ) when the power is fully saturated. The
block ignores this parameter if you do not specify the Output
saturation power (dBm). This parameter can be a scalar (to
specify frequency-independent nonlinearity data) or a vector (to
specify frequency-dependent nonlinearity data).
Frequency (Hz)
Scalar or vector value of frequency points corresponding to the
third-order intercept and power data. This parameter is disabled
if the data source contains power data or IP3 data. If you use a
scalar value, the IP3 (dBm), 1 dB gain compression power
2-279
Z-Parameters Mixer
Visualization Tab
2-280
Z-Parameters Mixer
See Also General Mixer, Output Port, S-Parameters Mixer, Y-Parameters Mixer
2-281
Z-Parameters Passive Network
Description The Z-Parameters Passive Network block models the two-port passive
network described in the block dialog box, in terms of its Z-parameters
and their associated frequencies.
In the Z-Parameters field of the block dialog box, provide the
Z-parameters for each of M frequencies as a 2-by-2-by-M array. In the
Frequency field, specify the frequencies for the Z-parameters as an
M-element vector. The elements of the vector must be in the same order
as the Z-parameters. All frequencies must be positive. For example, the
following figure shows the correspondence between the Z-parameters
array and the vector of frequencies.
2-282
Z-Parameters Passive Network
Z-Parameters
Z-parameters for a two-port passive network in a 2-by-2-by-M
array. M is the number of Z-parameters.
Frequency (Hz)
Frequencies of the Z-parameters as an M-element vector. The
order of the frequencies must correspond to the order of the
Z-parameters in Z-Parameters. All frequencies must be positive.
Interpolation method
The method used to interpolate the network parameters. The
following table lists the available methods describes each one.
2-283
Z-Parameters Passive Network
Method Description
Linear (default) Linear interpolation
Spline Cubic spline interpolation
Cubic Piecewise cubic Hermite
interpolation
Visualization Tab
2-284
Z-Parameters Passive Network
frequencies 2.0 GHz and 2.1 GHz respectively. It uses the MATLAB cat
function to create the 2-by-2-by-2 Z-parameters array.
zparams = cat(3,...
[0.13-5.93i,.03-3.16i; 0.03-3.16i,.13-5.93i],...
[0.27-2.86i,-.09-5.41i; -.09-5.41i,.27-2.86i])
2-285
Z-Parameters Passive Network
Click Plot. This action creates an X-Y plane plot of the S12
parameters in the frequency range 1.9 to 2.2 GHz.
2-286
Z-Parameters Passive Network
See Also General Circuit Element, General Passive Network, Output Port,
S-Parameters Passive Network, Y-Parameters Passive Network
z2s (RF Toolbox)
interp1 ( MATLAB)
2-287