SimRF™ Reference

Download as pdf or txt
Download as pdf or txt
You are on page 1of 419

SimRF™

Reference

R2014a
How to Contact MathWorks

www.mathworks.com Web
comp.soft-sys.matlab Newsgroup
www.mathworks.com/contact_TS.html Technical Support

[email protected] Product enhancement suggestions


[email protected] Bug reports
[email protected] Documentation error reports
[email protected] Order status, license renewals, passcodes
[email protected] Sales, pricing, and general information

508-647-7000 (Phone)

508-647-7001 (Fax)

The MathWorks, Inc.


3 Apple Hill Drive
Natick, MA 01760-2098
For contact information about worldwide offices, see the MathWorks Web site.
SimRF™ Reference
© COPYRIGHT 2010–2014 by The MathWorks, Inc.
The software described in this document is furnished under a license agreement. The software may be used
or copied only under the terms of the license agreement. No part of this manual may be photocopied or
reproduced in any form without prior written consent from The MathWorks, Inc.
FEDERAL ACQUISITION: This provision applies to all acquisitions of the Program and Documentation
by, for, or through the federal government of the United States. By accepting delivery of the Program
or Documentation, the government hereby agrees that this software or documentation qualifies as
commercial computer software or commercial computer software documentation as such terms are used
or defined in FAR 12.212, DFARS Part 227.72, and DFARS 252.227-7014. Accordingly, the terms and
conditions of this Agreement and only those rights specified in this Agreement, shall pertain to and govern
the use, modification, reproduction, release, performance, display, and disclosure of the Program and
Documentation by the federal government (or other entity acquiring for or through the federal government)
and shall supersede any conflicting contractual terms or conditions. If this License fails to meet the
government’s needs or is inconsistent in any respect with federal procurement law, the government agrees
to return the Program and Documentation, unused, to The MathWorks, Inc.

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

Blocks — Alphabetical List


1

Blocks — Alphabetical List


2

v
vi Contents
1

Blocks — Alphabetical List


Amplifier

Purpose Model amplifier in RF systems

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

Dialog Main Tab


Box and
Parameters

Source of amplifier gain


Specify the source parameter of the amplifier gain as:
• Available power gain — Available power gain parameter
is used to calculate the linear voltage gain term of the
polynomial VCVS, a1. This calculation assumes a matched load
termination for the amplifier.
• Open circuit voltage gain — Open circuit voltage gain
parameter is used as the linear voltage gain term of the
polynomial VCVS, a1.

1-3
Amplifier

• Data source — Linear voltage gain term of the polynomial


VCVS is calculated from the specified data source options:

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

where a1 represents the linear gain term, and higher-order


terms are modeled according to [2].
For example, the vector [a0,a1,a2,a3] specifies the relation
Vo = a0 + a1V1 + a2V12 + a3V13. Trailing zeroes are omitted. If a3
= 0, then [a0,a1,a2] defines the same polynomial as [a0,a1,a2,
0]. The default value of this parameter is [0,1], corresponding
to the linear relation Vo = Vi.
The default value of this parameter is Available power gain.
Available power gain
When you set the Source of amplifier gain parameter to
Available power gain, you can specify the available power
gain of the amplifier. Specify the units from the corresponding
drop-down list.

1-4
Amplifier

The default value of this parameter is 0 dB.


Open circuit voltage gain
When you set the Source of amplifier gain to Open circuit
voltage gain, you can specify the open circuit voltage gain of the
amplifier. Specify the units from the corresponding drop-down
list.

The default value of this parameter is 0 dB.


Input impedance (ohms)
When you set the Source of amplifier gain to Available
power gain, Open circuit voltage gain, or Polynomial
coefficients, you can specify the scalar input impedance of the
amplifier.

The default value of this parameter is 50 ohms.


Output impedance (ohms)
When you set the Source of amplifier gain to Available
power gain, Open circuit voltage gain, or Polynomial
coefficients, you can specify the scalar output impedance of
the amplifier.

The default value of this parameter is 50 ohms.


Data source
When you set Source of amplifier gain to Data source,
you can specify the data source as either Data file or
Network-parameters or Rational model.
• Data file — Name of a Touchstone file with the extension.s2p
. The block ignores noise and nonlinearity data in imported
files.
• Network-parameters — Provide Network parameter data
such as S-parameters, Y-parameters, and Z-parameters
with corresponding Frequency and Reference impedance
(ohms) for the amplifier.

1-5
Amplifier

• Rational model — Provide values for Residues, Poles, and


Direct feedthrough parameters which correspond to the
equation for a rational model

⎛ 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.

You can model noise in a SimRF model with a Noise, Resistor,


Amplifier, or Mixer block. To do so, in the Configuration block
dialog box, verify that the Simulate noise check box is selected
(default).
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.

By default, this option is selected.

1-6
Amplifier

Nonlinearity Tab

Nonlinear polynomial type


Specify either an Even and odd order or Odd order polynomial
nonlinearity. The default value is Even and odd order.
• When you select Even and odd order, the amplifier can
produce second- and third-order intermodulation frequencies
in addition to a linear term.

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

The preceding figure shows the graphical definition of the


nonlinear amplifier parameters.
Intercept points convention
Specify either an Input-referred or Output-referred convention.
Use this specification for the intercept points, 1-dB gain
compression power, and saturation power.

1-9
Amplifier

The default value is Output.


IP2
When Nonlinear polynomial type is Even and odd order,
specify the second-order intercept point of the amplifier.

The default value is inf dBm, which corresponds to an unspecified


point.
IP3
Specify the third-order intercept point of the amplifier. The
default value is inf dBm, which corresponds to an unspecified
point.
1-dB gain compression power
When Nonlinear polynomial type is Odd order, specify the
1-dB gain compression point. The 1-dB gain compression point
must be less than the output saturation power.

The default value is inf dBm, which corresponds to an unspecified


point.
Output saturation power
When Nonlinear polynomial type is Odd order, specify the
output saturation power. The block uses this value to calculate
the voltage saturation point used in the nonlinear model. In this
case, the first derivative of the polynomial is zero, and the second
derivative is negative.

The default value is inf dBm, which corresponds to an unspecified


point in the polynomial model.
Gain compression at saturation
When Nonlinear polynomial type is Odd order, specify the
gain compression at saturation. This parameter cannot be set
unless Output saturation power is specified.

The default value is inf dBm.

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.

When modelling using Frequency domain, Visualization tab


plots only the data defined in Data Source.

1-11
Amplifier

When modelling using Time domain, Visualization tab plots the


data defined Data Source and the rationalfit values .

For the Amplifier and S-parameters blocks, the default value is


Time domain (rationalfit). For the Transmission Line block,
the default value is Frequency domain.
Fitting options
This field displays when you select Time domain (rationalfit)
as the Modeling options. Valid values are Share all poles,
Share poles by columns, and Fit individually.

For the Amplifier block, the default value is Fit individually.


For the S-parameters block, the default value is Share all
poles.
Relative error desired (dB)
This field displays when you select Time domain (rationalfit)
as the Modeling options. 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 options.

Visualization Tab
Setting Source of amplifier gain to Data source activates the
Visualization tab.

1-12
Amplifier

Source of frequency data


Frequency data source. When Source of frequency data is
Extracted from data source, the Data source must be set to
Data file. Verify that the specified Data file contains frequency
data.

When Source of frequency data is User-specified, specify a


vector of frequencies in the Frequency data parameter. Also,
specify units from the corresponding drop-down list.

1-13
Amplifier

For the Amplifier and S-parameters blocks, the default value is


Extracted from source data. For the Transmission Line block,
the default value is User-specified.
Plot type
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.
• 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.

The default value is X-Y plane.


Parameter #
Specify the S-parameters to plot. From the Parameter1 and
Parameter2 drop-down lists, select the S-parameters that you
want to plot. If you specify two parameters, the block plots both
parameters in a single window.

The default value for Parameter1 is S11. For the Amplifier


and S-parameters blocks, the default value for Parameter2 is
None. For the Transmission Line block, the default value for
Parameter2 is S22.
Format #
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.

The default value is Magnitude (decibels).

1-14
Amplifier

Y-axis scale
Scale for the Y-axis.

The default value is Linear.


X-axis scale
Scale for the X-axis.

The default value is Linear.

Examples Circuit Envelope Simulation to Amplify Signals

Use the Amplifier block to amplify an input ramp signal riding on


a 2 GHz carrier.
From the MATLAB® command prompt, open the model
ex_amplify_simulink_signal:

addpath(fullfile(docroot,'toolbox','simrf','examples'))
ex_amplify_simulink_signal

This example model has the following configuration:

• The input baseband (i.e modulation) signal is SimRF Ramp. The


Input scope displays the signal.
• The Inport parameter Carrier frequencies defines the ramp input
carrier frequency as 2 GHz.

1-15
Amplifier

• In the Configuration block, the Carrier frequencies parameter


specifies all of the carriers to be modeled in the SimRF circuit
envelope simulation environment. The Stepsize is set to 2e-11/16
for smoother output signal. For more options please refer to
Configuration block.
• Amplifier block amplifies the modulated signal. In this example,
the Amplifier option is set to Available power gain to add a 30dB
gain to the modulated signal.
• The Amplifier signal is send to two Outport blocks to observe
both baseband (modulation) and passband (both modulation and
carrier) signals. In Outport 1, the output is Real Passband signal
on a 2-GHz carrier. In Outport 2, you compute the magnitude and
phase of the baseband signal. This helps you observe the change in
magnitude of the output signal as compared to the input signal. The
Angle portion of the Outport 2 is terminated.

To run the model, select Simulation Run.


The Input scope displays the input ramp signal:

1-16
Amplifier

The Outputscope displays both the Real Passband signal and the
change in magnitude of the input ramp signal.

1-17
Amplifier

• The example, “Validating IP2/IP3 Using Complex Signals”, verifies


the nonlinear modeling capabilities of the amplifier block.
• The example, “Impact of an RF Receiver on Communication System
Performance”, performs quantitative noise analysis of the noise from
an RF cascade.
• The example, Create a Low-IF Receiver Model, uses an amplifier in
an IF receiver with specified gain and noise figure.

References [1] Gonzalez, Guillermo. “Microwave Transistor Amplifiers: Analysis


and Design”, Englewood Cliffs, N.J.: Prentice-Hall, 1984.

[2] Grob, Siegfried and Juergen Lindner. “Polynomial Model Derivation


of Nonlinear Amplifiers, Department of Information Technology,
University of Ulm, Germany.

1-18
Amplifier

[3] Kundert, Ken. “Accurate and Rapid Measurement of IP 2 and


IP 3”, The Designers Guide Community, Version 1b, May 22, 2002.
http://www.designers-guide.org/analysis/intercept-point.pdf.

[4] Pozar, David M. “Microwave Engineering”, Hoboken NJ: John Wiley


& Sons, 2005.

See Also Mixer | S-Parameters

1-19
C (Capacitor)

Purpose Model capacitor for circuit envelope analysis

Library Elements

Description The Capacitor block models a capacitor in circuit envelope environment.

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.

Examples • The example “AC Analysis of an RF System” analyzes an LC filter


using harmonic balance.

Note Harmonic balance method calculates the steady


state response of SimRF systems. For further information
please refer to Kenneth, S.Kundrt. “ Introduction to RF
Simulation.” The Designers Guide Community, April 2003,
http://www.designers-guide.org/analysis/rf-sim.pdf.

1-20
C (Capacitor)

• The example “Frequency Response of an RF Transmit/Receive


Duplex Filter” simulates an analog RF filter comprised of Capacitor,
Inductor, Resistor, and Impedance blocks.
• The section Filter Mixing Products walks through the construction of
an LC low-pass tee filter in SimRF software.

See Also Impedance | Inductor | Three-Winding Transformer | Resistor

1-21
Circulator

Purpose Model ideal frequency-independent circulators with S-parameters

Library Junctions

Description Use the Circulator block to model ideal passive three-port circulators in
a circuit envelope environment.

Dialog Main Tab


Box and
Parameters

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.

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.

By default, this option is selected.

See Also Coupler | Divider

1-23
Configuration

Purpose Specify system-wide parameters for circuit envelope analysis

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

Automatically select fundamental tones and harmonic order


When this check box is selected, the block determines the
Fundamental tones and Harmonic order parameters
automatically when you update the model. Automatic selection
does not always return the smallest possible set of simulation
frequencies.

1-24
Configuration

Clearing this check box enables you to manually set the


Fundamental tones and Harmonic order parameters. A
smaller set of simulation frequencies decreases simulation time
and decreases memory requirements. However, a decrease in
simulation frequencies can reduce accuracy.
Fundamental tones
When Automatically select fundamental tones and
harmonic order is cleared, specify a vector of positive
frequencies. These frequencies represent the fundamental tones
[f1, f2, …] of the set of simulation frequencies. See the Total
simulation frequencies parameter for additional information.
Harmonic order
When Automatically select fundamental tones and
harmonic order is cleared, specify the harmonic order [h1, h2, …]
of each fundamental tone. Each hi is a positive integer. You can
specify a scalar that will be applied to each Fundamental tones
parameter. See the Total simulation frequencies parameter
for additional information.
Total simulation frequencies: Computed at simulation time
The block displays the number of simulation frequencies for
a nonlinear model. For linear models, the actual number of
frequencies are automatically optimized during simulation.
Because the solver computes a solution to the network at each
simulation frequency, computation time scales according to the
size of this value.

Click View to open dialog box containing additional information


about the simulation frequencies in your system. The
Configuration: Explaining simulation frequencies dialog box lists
tones and simulation frequencies. By clicking a listed simulation
frequency, you can see which linear or multiple combinations of
fundamental tones represent that frequency. From the dialog box,
you can also plot the simulation frequencies on a number line.

1-25
Configuration

The block parameters define a set of simulation frequencies


as combinations of fundamental tones: [m*f1 + n*f2 + …]. In
this case, represented as [f1,f2,…], and the integers m and n are
bounded by the corresponding Harmonic order, |m| h1, |n|
h2, etc. Only positive frequencies are considered.

For example, suppose you have a single fundamental tone f1 =


2 GHz and corresponding harmonic order h1 = 3. The set of
simulation frequencies [ 0, f1, 2f1, 3f1] = [ 0GHz, 2GHz, 4GHz,
6GHz ].

As a second example, suppose you have a circuit with two


fundamental tones [f1 = 2 GHz, f2 = 50 MHz] and corresponding
harmonic orders h1 = h2 = 1. This setup results in five simulation
frequencies with values [ 0, f2, f1-f2, f1, f1+f2].

The set of simulation frequencies must include all carrier


frequencies specified in the SimRF subsystem such as the carrier
frequencies inside Inport, Outport, and source blocks.

1-26
Configuration

Normalize Carrier Power


When this option is selected, the carrier power is normalized such
that the average power of the signal is:

I 2  Q2
In this case, the corresponding passband signal at ω is represented
by the equation

sk (t)  I (t) 2 cos(2 fk t)  Q(t) 2 sin(2 fk t)


where:
• I(t) is the in-phase part of the carrier signal.
• Q(t) is the quadrature part of the carrier signal.
• fk are the carrier frequencies.

When this option is not selected, the carrier power is not


normalized. In this case, the average power of the signal is:

I 2  Q2
2
In this case, the corresponding passband signal at ω represented
by the equation

sk (t)  I (t) cos(2 fk t)  Q(t) sin(2 fk t)

Note that 0 carrier frequency is a special case. Its passband


representation is always I and average power I2

By default, the check box is selected.


Solver
Specify the fixed-step solver for the SimRF environment. When
you are not sure which solver to use, set this parameter to auto.
When manually choosing a solver, consider the following benefits
and drawbacks:

1-27
Configuration

• The Backward Euler solver is able to simulate the largest


class of systems and signals. Damping effects make this solver
suitable for wideband simulation, but overall accuracy is low.
• The Trapezoidal Rule solver is accurate for narrowband
simulations. However, frequency warping and the lack of
damping effects make this method inappropriate for most
wideband simulations.
• The NDF2 solver balances narrowband and wideband accuracy.
This solver is suitable for situations where the frequency
content of the signals in the system is unknown relative to the
Nyquist rate.

By default, Solver is set to auto.

The SimRF solver is an extension of the Simscape™ local solver.


For more information on the Simscape local solver, see the Solver
Configuration block reference page.
Step size
Specify a time step h for fixed-step integration. The default
value is 1e-6 s, which is sufficient for modeling envelope signals
with bandwidths of up to 1/h, or 1 MHz by default. However,
simulation accuracy is reduced when simulating close to the
maximum bandwidth. Reduce the step size to model signals with
a larger bandwidth, or improve accuracy.

When the noise is simulated, the noise bandwidth for each


simulation frequency is equal to 1/h.
Simulate noise
Use this parameter to globally enable or disable noise modeling for
SimRF blocks that support noise. When this check box is selected:
• Amplifier and Mixer blocks use the value of their respective
Noise figure (dB) parameters.
• Amplifier and Mixer blocks simulate with thermal noise at the
temperature specified by the Temperature parameter.

1-28
Configuration

• Resistor blocks model thermal noise using the Temperature


parameters.
• Noise blocks model a specified noise power as a voltage or
current source.
Clearing this check box disables noise modeling in the SimRF
environment. By default, this check box is selected.
Temperature
When Simulate noise is selected, specify a global noise
temperature. The default value of this parameter is 290.0 K.

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

Purpose Model constant envelope source

Library Sources

Description

The Continuous Wave block models a constant modulation on a


carrier in 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) = v0 e jkt
or

i(t) = i0 e jkt
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.

By default, this option is selected.

Examples All models in the SimRF documentation that contain a Mixer block also
contain a Continuous Wave block used as a local oscillator.

See Also Inport | Sinusoid

1-33
Coupler

Purpose Model ideal frequency-independent couplers with S-parameters

Library Junctions

Description Use the Coupler block to model four port directional couplers in a circuit
envelope environment as an ideal S-parameter model.

Dialog Main Tab


Box and
Parameters

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

Specify the return loss of Directional coupler. The valid


values are nonnegative and real. The default value is inf.
— Reference impedance (Ohm)
Specify the reference impedances of Directional coupler
as scalar or three-tuple. The default values are 50 Ohms.
• Coupler symmetrical
The s-parameter matrix for Coupler symmetrical is:

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

Specify the reference impedances of Hybrid


quadrature(90deg) as scalar or three-tuple. The
default values are 50 Ohms.
• Hybrid rat-race
The s-parameter matrix for Hybrid rat-race is:

 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.

By default, this option is selected.

See Also Circulator | Divider

1-38
Divider

Purpose Model ideal frequency-independent dividers (combiners) with


S-parameters

Library Junctions

Description Use the Divider block to model power dividers (combiners) in a circuit
envelope environment as an ideal s-parameter model.

Dialog Main Tab


Box and
Parameters

Select component
• T power divider
The default option is T power divider. The s-parameter
matrix for T-power divider is :

1-39
Divider

 s11 s21 s31 


s s32 
 21 s22
 s31 s32
where: s33 

— s11 = (z23 –z1) / (z23 + z1)


— s22 = (z13 –z2) / (z13 + z2)
— s33 = (z12 –z3) / (z12 + z3)
— s21 = (1+ s11) * sqrt(z1 / z2)
— s31 = (1+ s11) * sqrt(z1 / z3)
— s32 = (1+ s22) * sqrt(z2 / z3)
— z12 = z1 * z2 / (z1 + z2)
— z13 = z1 * z3 / (z1 + z3)
— z23 = z2 * z3 / (z2 + z3)
— z1 = Z0(1), z2 = Z0(2), z3 = Z0(3)
— Reference Impedances: Z0 = [z1, z2, z3 ]
When you select this option, the following parameter is
available:
— Reference impedance (Ohm)
Specify the reference impedances of T power divider as scalar
or three-tuple. The default values are 50.
• Resistive power divider
The s-parameter matrix for Resistive power divider is :

 0 1 / 2 1 / 2
1 / 2 0 1 / 2

1 / 2 1 / 2 0 

1-40
Divider

When you select this option, the following parameter is


available:
— Reference impedance (Ohm)
Specify the reference impedances of Resistive power divider
as scalar or three-tuple. The default values are 50.
• Wilkinson power divider
The s-parameter matrix for Wilkinson power divider is:

 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.

Note For DC carrier (0 Hz) frequency, Wilkinson power


divider is a zero matrix.

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.

By default, this option is selected.

Examples The example, “Wireless Digital Video Broadcasting with RF


Beamforming”, uses ideal dividers as combiners in the Receive Antenna

1-41
Divider

Array. This removes the need for Phase/Frequency offset compensation


in the Baseband Processing Receive

See Also Coupler | Circulator

1-42
Gnd (Ground)

Purpose Simulate connection to electrical ground

Library Elements

Description The Ground block represents an electrical ground in a SimRF circuit


envelope simulation environment. Connect at least one Ground to the
SimRF environment; otherwise, models with SimRF blocks do not run.

Dialog The Ground block has no parameters.


Box and
Parameters

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

Purpose Model ideal transformer

Library Elements

Description The Ideal Transformer block models a constant IV relationship


within the SimRF circuit envelope simulation environment. For an
introduction to RF simulation, see the example, “Simulate High
Frequency Components”.

Dialog
Box and
Parameters

Winding ratio
Specify the winding ratio.

See Also Mutual Inductor | Three Winding Transformer

1-44
Inport

Purpose Convert Simulink input signal to SimRF signal

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

Choose how the block interprets the Simulink signal:


• Ideal voltage — The block outputs Simulink signals as
voltage signals v(t) in the SimRF environment. When you
choose this option, the following figure illustrates the internal
configuration of the block.

• Ideal current — The block outputs Simulink signals as


current signals i(t) in the SimRF environment. When you
choose this option, the following figure illustrates the internal
configuration of the block.

• Power — The block interprets the Simulink signals, Pv(t), as


available power and internally uses a voltage source, and series
impedance as shown in the following figure.

1-46
Inport

The voltage v(t) is a scaling of the Simulink signal vSL(t):

v(t)  2 Re  Zs vSL (t)


In the preceding equation, Zs is the value of the Source
impedance (ohms) parameter.
The generator delivers a real power to a load Zl:

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

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.

By default, this option is selected.

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.

See Also Continuous Wave | Outport | Configuration

1-48
Z (Impedance)

Purpose Model complex impedance

Library Elements

Description The Impedance block implements the relation, vk(t) = Z(fk)*ik(t), for each
simulation frequency, fk, where:

• Z(fk) represents complex-valued impedance at a specified simulation


frequency.
• vk(t) represents the voltage across the terminals of the element at
time t.
• ik(t) represents the current through the element at time t.

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.

In both cases, for zero simulation frequency, the imaginary part


of the impedance is ignored. Also, the real part is forced to be
positive to produce a stable simulation.
Frequency
When Impedance type is set to Frequency independent,
specify a vector of nonnegative frequencies, [f1, f2, f3, …]. The
pairs, fi, Zi, define a piecewise linear function, Z(f), that is linearly
interpolated for the simulation frequencies. For values outside
the range, there is constant extrapolation. The default value of
this parameter is 0 Hz.

Examples The example, “Frequency Response of an RF Transmit/Receive Duplex


Filter”, simulates an analog RF filter comprising Capacitor, Inductor,
Resistor, and Impedance blocks.

See Also Capacitor | Inductor | Resistor

1-50
L (Inductor)

Purpose Model inductor for circuit envelope analysis

Library Elements

Description The Inductor block models an inductor in circuit envelope environment.

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.

Examples • The example “AC Analysis of an RF System” analyzes an LC filter


using harmonic balance.

Note Harmonic balance method calculates the steady


state response of SimRF systems. For further information
please refer to Kenneth, S.Kundrt. “ Introduction to RF
Simulation.” The Designers Guide Community, April 2003,
http://www.designers-guide.org/analysis/rf-sim.pdf.

1-51
L (Inductor)

• The example “Frequency Response of an RF Transmit/Receive


Duplex Filter” simulates an analog RF filter comprised of Capacitor,
Inductor, Resistor, and Impedance blocks.
• The section Filter Mixing Products walks through the construction
of an LC lowpass filter in SimRF software.

See Also Capacitor | Resistor | Mutual Inductor | Three-Winding Transformer

1-52
LC Ladder

Purpose Model LC ladder networks

Library Elements

Description The LC Ladder block models common two-port LC lossless networks.

1-53
LC Ladder

Dialog
Box and
Parameters

Specify ladder topology from the following options:

1-54
LC Ladder

Ladder Topology

LC
Lowpass
Tee

LC
Lowpass
Pi

LC
Highpass
Tee

LC
Highpass
Pi

1-55
LC Ladder

Ladder Topology (Continued)

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.

The relationship between vector lengths of Capacitance and


Inductance values must correspond to the Ladder topology
selected.
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.

By default, this option is selected.

Examples • The section, “Filter Mixing Products”, shows the use of a LC Ladder.

1-57
Mixer

Purpose Model mixer in RF systems

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:

Vin VLO = Ain cos (in t ) ALO cos ( LO t )


Ain ALO A A
cos ⎡⎣(in +  LO ) t ⎤⎦ + in LO cos ⎡⎣(in −  LO ) t ⎤⎦
2 2
This mixing converts the frequency of RF signal to ωRF + ωLO and
ωRF – ωLO. For the mixer to perform this operation correctly, you must
include the frequencies ωRF + ωLO or ωRF – ωLO in the simulation
frequencies the Configuration block calculates.
The Power gain specification for this block relates the power of a
single-sideband (SSB) to the input.
After mixing the RF and LO signals, the mixer block performs
amplification. To model linear amplification, the mixer scales
the signals by the coefficient a1. A Voltage Controlled Voltage
Source (VCVS), specified with a polynomial, implements nonlinear
amplification. The polynomial includes saturation automatically and
produces additional intermodulation frequencies.

1-58
Mixer

Dialog Main Tab


Box and
Parameters

Source of conversion gain


Specify the source parameter of the conversion gain as:
• Available power gain — The block uses the value of the
Available power gain parameter to calculate the linear voltage
gain term of the polynomial VCVS, a1. This calculation assumes
a matched load termination for the mixer.
• Open circuit voltage gain — The block uses the value of
the Open circuit voltage gain parameter as the linear voltage
gain term of the polynomial VCVS, a1.
• 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
and the coefficients are ordered in ascending powers. If a
vector a has 10 coefficients, [a0, a1, a2, …, a9], the polynomial
it represents is Vout = a0 + a1 Vin + a2 Vin2+ + a9 Vin9. In this
case, a1 represents the linear gain term, and the modeling of
higher-order terms is done according to [1].
For example, the vector [a0, a1, a2, a3] specifies the relation Vout
= a0 + a1 Vin + a2 Vin2 + + a3 Vin3.

1-59
Mixer

Trailing zeroes are omitted; if a3 = 0, [a0, a1, a2] defines the


same polynomial as [a0, a1, a2, 0]. The default value of this
parameter is [0 1], corresponding to the linear relation Vo = Vi.
The default value of this parameter is Available power gain.
Available power gain
When Source of conversion gain is Available power gain,
specify the linear gain of the mixer. Specify the units from the
corresponding drop-down list. The default value of this parameter
is 0 dB.
Open circuit voltage gain
When Source of conversion gain is Open circuit voltage
gain, specify the open circuit voltage gain of the mixer. Specify
the units from the corresponding drop-down list. If you specify the
units as None, the gain must be positive. The default value of
this parameter is 0 dB.
Input impedance (ohms)
Specify the scalar impedance at the In port of the mixer. The
default value of this parameter is 50 Ω.
Output impedance (ohms)
Specify the scalar impedance at the Out port of the mixer. The
default value of this parameter is 50 Ω.
LO impedance (ohms)
Specify the scalar impedance at the LO port of the mixer. The
default value of this parameter is Inf Ω.
Noise figure (dB)
Specify the single-sideband (SSB) noise figure of the mixer. The
default value of this parameter is 0 dB.

To model noise in circuit envelope model with a Noise, Amplifier,


or Mixer block, you must select the Simulate noise check box in
the Configuration block dialog box.

1-60
Mixer

The following table summarizes the two competing definitions for


specifying SSB noise, where the image frequency (IM) is defined
as ωIM = ωLO + (ωLO – ωRF).

Noise Signal at RF Signal at IM Mixer Block


Convention Frequency Frequency Supports
This Model?
Single-sideband S + N, signal N, noise only Yes
noise (SSB) with noise
IEEE S + N, signal No signal No; you can
definition of with noise create an
single-sideband equivalent
noise model using
(SSBIEEE) an ideal
filter created
from an
S-parameters
block.

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.

By default, this option is selected.

1-61
Mixer

Nonlinearity Tab

The specification is identical to that of the Amplifier block, except that


it includes a scaling factor of 2 to account for the SSB mixer conversion
gain.

Nonlinear polynomial type


Specify either an Even and odd order or Odd order polynomial
nonlinearity. The default value is Even and odd order.
• When you select Even and odd order, the amplifier can
produce second- and third-order intermodulation frequencies
in addition to a linear term.
• 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-62
Mixer

The preceding figure shows the graphical definition of the


nonlinear amplifier parameters.
Intercept points convention
Specify either an Input-referred or Output-referred convention.
Use this specification for the intercept points, 1-dB gain
compression power, and saturation power.

1-63
Mixer

The default value is Output.


IP2
When Nonlinear polynomial type is Even and odd order,
specify the second-order intercept point of the amplifier.

The default value is inf dBm, which corresponds to an unspecified


point.
IP3
Specify the third-order intercept point of the amplifier. The
default value is inf dBm, which corresponds to an unspecified
point.
1-dB gain compression power
When Nonlinear polynomial type is Odd order, specify the
1-dB gain compression point. The 1-dB gain compression point
must be less than the output saturation power.

The default value is inf dBm, which corresponds to an unspecified


point.
Output saturation power
When Nonlinear polynomial type is Odd order, specify the
output saturation power. The block uses this value to calculate
the voltage saturation point used in the nonlinear model. In this
case, the first derivative of the polynomial is zero, and the second
derivative is negative.

The default value is inf dBm, which corresponds to an unspecified


point in the polynomial model.
Gain compression at saturation
When Nonlinear polynomial type is Odd order, specify the
gain compression at saturation. This parameter cannot be set
unless Output saturation power is specified.

The default value is inf dBm.

1-64
Mixer

Examples • The example, “Validating IP2/IP3 Using Complex Signals”, verifies


the nonlinear modeling capabilities of the Amplifier block.
• The example, “Impact of an RF Receiver on Communication System
Performance”, performs quantitative noise analysis of the noise from
an RF cascade.
• The section, Create a Low-IF Receiver Model, uses an amplifier in an
IF receiver with specified gain and noise figure.
• The section, “Model an RF Mixer”, steps through setting up an RF
mixer in the SimRF environment.

References [1] Grob, Siegfried and Lindner, Jurgen, “Polynomial Model Derivation
of Nonlinear Amplifiers”, Department of Information Technology,
University of Ulm, Germany.

See Also Amplifier

1-65
Mutual Inductor

Purpose Model two coupled inductors for circuit envelope analysis

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:

• L1 and L2 represent inductances.


• M represents a mutual inductance with coefficient of coupling K.
• v1(t) and v2(t) represent the voltage across the terminals of the
inductors at time t.
• i1(t) and i2(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.

SimRF current and voltage signals consist of in-phase (Ik) and


quadrature (Qk) components at each frequency fk specified in the
Configuration block:

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.

Note The minimum nonzero inductance value that the SimRF


environment recognizes is 1e-18 H. During simulation, the block uses
a value of 1e-18 H for any inductance and mutual inductance values
specified between 0 and 1e-18 H.

1-67
Mutual Inductor

See Also Inductor | Three-Winding Transformer

1-68
Noise

Purpose Model noise using current or voltage noise source in RF systems

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.

When Noise distribution is set to:

1-69
Noise

• White, spectral density is a single non-negative value.


• Piece-wise linear, spectral density is a vector of values [pi].

When Source type is set to:


• Ideal voltage, spectral density units are V2/Hz.
• Ideal Current, spectral density units are A2/Hz.
Frequencies
This parameter appears only when Noise distribution is set
to Piece-wise linear.

Parameter values are specified as a vector of non-negative


frequencies [fi] with the same length as the vector of power
spectral densities [pi]. The pairs, (fi,pi), define an arbitrary
piece-wise linear noise distribution. The default value of this
parameter is 0 Hz.

Examples Explicitly Simulate Resistor Thermal 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

Model configuration is as follows:

• The model properties, R, k, Freq, and time_step, are


defined in File > Model Properties > Callbacks > Model
callbacks > PreLoadFcn*.
• The Resistor noise source is modelled explicitly to make it noiseless.
In Resistor blocks, the Simulate Noise box is not selected.
• Noise current source parallel to the Resistor block models the
noise. In the Noise block, the Source type is set to Ideal current
to make it a current source. The Noise spectral density is defined
as (4kT/R)(A2/Hz).
• The Masked block, Calculate Noise Power, calculates the noise
floor as a standard deviation of the output signal.

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.

See Also Configuration

1-72
Outport

Purpose Convert SimRF signal to Simulink output signals

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

• Power — The block outputs the modulations of the voltage


signal

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.

If the Carrier frequencies parameter specifies more than one


frequency, the block outputs a vector of signals. The kth output
signal corresponds to the modulation of the kth carrier.
Load impedance (ohms)
When Output is set to Power, the Outport loads the circuit with
the specified impedance. When you use multiple Outport blocks
as power sources at the same node in a given circuit, the resulting
load is the parallel combination of the specified load impedances.
By default, the impedance is 50.
Output
Specify the format of the output signals:
• Complex Baseband — The block outputs a vector of
complex-valued signals Ik(t) + j · Qk(t) at the port labeled SL.
The kth element of the vector is the kth frequency specified by
the Carrier frequencies parameter.
• In-phase and Quadrature Baseband — The block outputs
two vectors of real-valued signals Ik(t) and Qk(t) at the I port
and Q port, respectively. The signal at the I port contains the
in-phase components, and the signal at the Q port contains
the quadrature components. The kth element of the vector
is the kth frequency specified by the Carrier frequencies
parameter.
• Magnitude and Angle Baseband — The block outputs two
real-valued vectors, whose elements are the magnitude

1-74
Outport

and phase angle of the modulation. The Mag port outputs


|Ik(t) + j · Qk(t)| and the Ang port outputs Arg[Ik(t) + j · Qk(t)].
The kth element of the vector is the kth frequency specified by
the Carrier frequencies parameter.
• Real Passband — The block outputs real passband signals by
combining envelope and carrier signals for all frequencies listed
under Carrier frequencies.
You can use the following options to control passband output
step size:

— Select Automatically compute output step size to allow


SimRF to determine the optimal time step to resolve the

1-75
Outport

highest listed carrier frequency. The formula for the time


step selected is:
where

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,

sk (t)  I (t) 2 cos(2 fk t)  Q(t) 2 sin(2 fk t)

— When this option is not selected, the signal on the kth

sk (t)  I (t) cos(2 fk t)  Q(t) sin(2 fk t)

— In both cases, the signal for zero-frequency (DC) carrier is x(


t ) = I( t ). The final output signal is computed as s(t) = sum(
sk )

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.

By default, this option is selected.

Examples • The example, “Passband Signal Representation in Circuit Envelope”,


shows how to set the step size value in the Outport block to avoid
undersampling.
• The example, “Simulate High Frequency Components”, compares the
Real Passband and In-phase and Quadrature Baseband output
options of the Outport block.
• The example, “Validating IP2/IP3 Using Complex Signals”, shows
how to use Outport blocks to probe RF systems in multiple locations.

See Also Inport

1-77
Phase Shift

Purpose Model phase shift in RF systems

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.

By default, this option is selected.

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)

Purpose Model resistor for circuit envelope analysis

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:

• R represents the resistance, as a function of temperature.


• i(t) represents the current through the capacitor at time t.
• v(t) represents the voltage across the terminals of the capacitor at
time t.

SimRF current and voltage signals consist of in-phase (Ik) and


quadrature (Qk) components at each frequency fk specified in the
Configuration block:

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.

This parameter inserts a current noise source with the


single-sided power density of 4 kT/R A2/Hz, where:
• k is the Boltzmann constant
• T is the value of the Temperature parameter, in degrees
Kelvin. (Also located in the Configuration block.)

See Also Capacitor | Inductor

1-81
S-Parameters

Purpose Model S-parameter network

Library Elements

Description The S-Parameters block models a network defined by S-parameters in


the SimRF circuit envelope simulation environment. The device can
have up to four ports. For an introduction to RF simulation, see the
example, “Simulate High Frequency Components”.
The block models S-parameter data in the SimRF environment by
fitting a rational function to the specified data. For more information
about rational fitting of S-parameters, see the RF Toolbox rationalfit
function.

Dialog Main Tab


Box and
Parameters

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

Ground and hide negative terminals


Select this option to automatically ground and hide negative
terminals in the model.

Modeling Tab

Modeling options
Modeling domain. Select Frequency domain or Time domain
(rationalfit) from the drop-down list.

When modelling using Frequency domain, Visualization tab


plots only the data defined in Data Source.

When modelling using Time domain, Visualization tab plots the


data defined Data Source and the rationalfit values .

For the Amplifier and S-parameters blocks, the default value is


Time domain (rationalfit). For the Transmission Line block,
the default value is Frequency domain.
Fitting options
This field displays when you select Time domain (rationalfit)
as the Modeling options. Valid values are Share all poles,
Share poles by columns, and Fit individually.

For the Amplifier block, the default value is Fit individually.


For the S-parameters block, the default value is Share all
poles.
Relative error desired (dB)
This field displays when you select Time domain (rationalfit)
as the Modeling options. 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 options.

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.

Source of frequency data


Frequency data source. When Source of frequency data is
Extracted from data source, the Data source must be set to
Data file. Verify that the specified Data file contains frequency
data.

When Source of frequency data is User-specified, specify a


vector of frequencies in the Frequency data parameter. Also,
specify units from the corresponding drop-down list.

For the Amplifier and S-parameters blocks, the default value is


Extracted from source data. For the Transmission Line block,
the default value is User-specified.
Plot type
Specify the type of plot that you want to produce with your data.
The Plot type parameter provides the following options:

1-85
S-Parameters

• 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.
• 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.

The default value is X-Y plane.


Parameter #
Specify the S-parameters to plot. From the Parameter1 and
Parameter2 drop-down lists, select the S-parameters that you
want to plot. If you specify two parameters, the block plots both
parameters in a single window.

The default value for Parameter1 is S11. For the Amplifier


and S-parameters blocks, the default value for Parameter2 is
None. For the Transmission Line block, the default value for
Parameter2 is S22.
Format #
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.

The default value is Magnitude (decibels).


Y-axis scale
Scale for the Y-axis.

The default value is Linear.


X-axis scale
Scale for the X-axis.

1-86
S-Parameters

The default value is Linear.

Examples • “Architectural Design of a Low-IF Receiver System” uses an


S-Parameters block to model a surface acoustic wave (SAW) filter.
• “Comparing Time- and Frequency-Domain Simulation Options for
S-parameters” shows how to choose a selection for the Modeling
options parameter based on the type of behavior you want to model
in your system.

Model an RF Filter Using S-Parameter Data


The model ex_simrf_sparams replaces the LC lowpass tee filter in
the model from the section, Model an RF Filter, with an S-parameters
block. It reproduces the results of the original model. To recreate an
S-parameter representation of the filter, the model uses MATLAB code
in the PreLoadFcn callback to:

• Create an RF Toolbox rfckt.lclowpasstee object.


• Specify the filter coefficients used in the Model an RF Filter example.
• Analyze the filter object from 0 Hz to 2 GHz.
• Compute rational function coefficients using the RF Toolbox
rationalfit function.

For information on using callbacks in SimRF models, see Model an


RF Mixer.

1-87
S-Parameters

To run the model:

1 To open this model, at the MATLAB command line, enter:

addpath(fullfile(docroot,'toolbox','simrf','examples'))
ex_simrf_sparams

2 Select Simulation > Run.

To view the results of the simulation, double-click the scope.

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.

Model an RF Filter from Rational Function Coefficients


The model ex_simrf_sparams replaces the LC lowpass tee filter in
the model from the section, Model an RF Filter, with an S-parameters
block. It reproduces the results of the original model. To configure
the S-parameters block in this model to simulate the same filter from
rational function coefficients:

1-88
S-Parameters

1 Set the Data source parameter to Rational model.

2 Set the Residues parameter to the variable C.

3 Set the Poles parameter to the variable A.

4 Set the Direct feedthrough parameter to the variable D.

To open this model, at the MATLAB command line, enter:

addpath(fullfile(docroot,'toolbox','simrf','examples'))
ex_simrf_sparams

To run the model, select Simulation > Run.


The rfmodel.rational object stores the residues, poles, and direct
feedthrough data as vectors. However, because the S-parameters block
requires matrices for the Residues, Poles, and Direct feedthrough
parameters, rearrangement is necessary. To rearrange the vectors into
matrices in the required format, the initialization function of the model
transposes the output of the reshape function. For more information on
rational function fitting with RF Toolbox software, see the rationalfit
reference page.

Model an RF Filter from an S2P Data File


The model ex_simrf_sparams replaces the LC lowpass tee filter in
the model from the section, Model an RF Filter, with an S-parameters
block. It reproduces the results of the original model. To configure the
S-parameters block in this model to simulate the same filter from an
S2P data file:

1 Write the S-parameter data in this model to a data file. To do so, in


the MATLAB Command Window, type:

write(hfilt.AnalyzedResult,'teefilt.s2p')

2 Set the Data source parameter to Data file.

1-89
S-Parameters

3 Set the Data file parameter to teefilt.s2p.

To open this model, at the MATLAB command line, enter:

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.

Verify That the S-parameter Block Is Fitting a Rational Function


with Acceptable Accuracy
The S-Parameters block provides a visualization tool for validating
RF-component data modeling. Use the visualization tool to verify that
the S-parameter block is fitting a rational function with acceptable
accuracy. To produce a data plot:

1 On the Main tab, specify the Data source parameter and requisite
data to plot.

2 Specify frequency data:

• When Source of frequency data is Extracted from data


source, the Data source must be set to Data file, and the
specified Data file must contain frequency data.
• When Source of frequency data is User-specified, specify a
vector of frequencies in the Frequency data parameter.

Also, specify units from the corresponding drop-down list.

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.

4 Specify the S-parameters to plot. From the Parameter1 and


Parameter2 drop-down lists, select the S-parameters that you
want to plot. If you specify two parameters, the block plots both
parameters in a single window.

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.

See Also Transmission Line | rationalfit

1-91
Signal Combiner

Purpose Compute sum of RF signals

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

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.

By default, this option is selected.

Examples • The example, “Measuring Image Rejection Ratio in Receivers” shows


how to use a signal combiner to perform image rejection.
• The example, Carrier to Interference Performance of a Weaver
Receiver uses a Signal Combiner block as part of a realization of
the Weaver receiver architecture.

1-92
Sinusoid

Purpose Model DC offset and sinusoidal modulation

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:

uk,i (t)  Di  Ai sin(wk (t   ))


uk,q (t)  Dq  Aq sin(wk (t   ))
where:

• Di and Dq are DC offsets.


• Ai and Aq are in-phase and quadrature amplitudes.
• τ is the time delay.
• ωk is the specified modulation frequency at a given carrier frequency
f k.
• t is the time.

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.

By default, this option is selected.

Examples • The example “Validating IP2/IP3 Using Complex Signals” highlights


the difference between sinusoidal SimRF and Simulink sources and
shows how to use them in the same model.
• The section Model an RF Mixer uses a Sinusoid block to model an
AM waveform at the input port of a mixer.

See Also Continuous Wave

1-96
Three-Winding Transformer

Purpose Model three coupled inductors for circuit envelope analysis

Library Elements

Description

The Three-Winding Transformer block models three coupled inductors


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 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:

• L1, L2, and L3 represent inductances.


• Mpq represents the mutual inductance between the pth and qth
inductors, with coefficient of coupling Kpq.
• v1(t), v2(t), and v3(t) represent the voltage across the terminals of the
inductors at time t.

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.

SimRF current and voltage signals consist of in-phase (Ik) and


quadrature (Qk) components at each frequency fk specified in the
Configuration block:

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.

Note The minimum nonzero inductance value that the SimRF


environment recognizes is 1e-18 H. During simulation, the block uses
a value of 1e-18 H for any inductance and mutual inductance values
specified between 0 and 1e-18 H.

See Also Inductor | Mutual Inductor

1-99
Transmission Line

Purpose Model transmission line

Library Elements

Description Use the Transmission Line block to model delayed-based, lumped,


and distributed transmission lines. Mask dialog options will change
automatically to accommodate model type selection.

Dialog Main Tab


Box and
Parameters

Model type

Delay-based and lossless


Specify the transmission line as delay-based and lossless. When
you select this option, the following parameters are available:
— Transmission delay

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.

Delay-based and lossy


Specify the transmission line as delay-based and lossy.

When you select this option, the following dialog box


parameters are available:
— Transmission delay
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.
— Resistance per unit length
Specify the resistance per unit length R and select the units.
The default value is .3 Ohm/m.
— Line length
Specify the physical length of the transmission line l and
select the units. The default length is 1 cm.
— Number of segments

1-101
Transmission Line

Specify the number of segments of the transmission line N.


The default number is 10.

Lumped parameter L-section


Specify the transmission line as a number of RLGC L-sections.

When you select this option, the following dialog box


parameters are available:
— Parameterization
Choose a parameterization for the segments. The options are
By characteristic impedance and capacitance and By
inductance and capacitance.
The default parameterization is By characteristic
impedance and capacitance and the following parameters
are available:
Characteristic impedance
Specify the characteristic impedance of the transmission
line and select the units. The default value is 50 Ohm.
Resistance per unit length
Specify the resistance per unit length R and select the
units. The default value is .3 Ohm/m.
Capacitance per unit length
Specify the capacitance per unit length C and select the
units. The default value is 94e-12 F/m.

1-102
Transmission Line

Conductance per unit length


Specify the conductance per unit length G and select the
units. The default value is 5e-6 S/m.
Line length
Specify the physical length of the transmission line l and
select the units. The default length is 1 cm.
Number of segments
Specify the number of segments of the transmission line
N. The default number of segments are 10.
When you select the second option, the following parameters
are available:
Resistance per unit length
Specify the resistance per unit length R and select the
units. The default value is .3 Ohm/m.
Inductance per unit length
Specify the inductance per unit length G and select the
units. The default value is 235e-9 H/m.
Capacitance per unit length
Specify the capacitance per unit length C and select the
units. The default value is 94e-12 F/m.
Conductance per unit length
Specify the conductance per unit length G and select the
units. The default value is 5e-6 S/m.
Line length
Specify the physical length of the transmission line l and
select the units. The default length is 1 cm.
Number of segments

1-103
Transmission Line

Specify the number of segments of the transmission line


N. The default number is 10.

Lumped parameter pi-section


Specify the transmission line as a number of RLGC pi-sections.

When you select this option, the following dialog box


parameters are available:
— Parameterization
Choose a parameterization for the segments. The options are
By characteristic impedance and capacitance and By
inductance and capacitance.
The default parameterization is By characteristic
impedance and capacitance and the following parameters
are available:
Characteristic impedance
Specify the characteristic impedance of the transmission
line and select the units. The default value is 50 Ohm.
Resistance per unit length
Specify the resistance per unit length R and select the
units. The default value is .3 Ohm/m.
Capacitance per unit length
Specify the capacitance per unit length C and select the
units. The default value is 94e-12 F/m.

1-104
Transmission Line

Conductance per unit length


Specify the conductance per unit length G and select the
units. The default value is 5e-6 S/m.
Line length
Specify the physical length of the transmission line l and
select the units. The default length is 1 cm.
Number of segments
Specify the number of segments of the transmission line
N. The default is 10.
When you select the second option, the following parameters
are available:
Resistance per unit length
Specify the resistance per unit length R and select the
units. The default value is .3 Ohm/m.
Inductance per unit length
Specify the inductance per unit length G and select the
units. The default value is 235e-9 H/m.
Capacitance per unit length
Specify the capacitance per unit length C and select the
units. The default value is 94e-12 F/m.
Conductance per unit length
Specify the conductance per unit length G and select the
units. The default value is 5e-6 S/m.
Line length
Specify the physical length of the transmission line l and
select the units. The default length is 1 cm.
Number of segments

1-105
Transmission Line

Specify the number of segments of the transmission line


N. The default number is 10.

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.

When you select this option, the following parameters are


available:
— Outer radius
Specify the radius of the outer conductor of the coaxial
transmission line. The default value is 2.57 mm.
— Inner radius
Specify the radius of the inner conductor of the coaxial
transmission line. The default value is 0.725 mm.
— Relative permeability constant

1-106
Transmission Line

Specify the relative permeability of the dielectric. This value


is 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. 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 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 in siemens per
meter. 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.
The following auxiliary equations are used for
ABCD-parameter calculations. For general information, see
Parameter Calculations for Distributed Transmission Line
on page 118.

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

k is a vector whose elements correspond to the elements


of the input vector, freq. The block calculates k from
the specified parameters as k = αa + iβ, where αa is the
attenuation coefficient and β is the wave number. The
attenuation coefficient αa is related to the specified loss,
α, by

 a = − ln (10 / 20 )

The wave number β is related to the specified phase


velocity, Vp, by

2 f
 =
Vp

The phase velocity VP is also known as the wave


propagation velocity.

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,
ε.

When you select this option, the following parameters are


available:

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

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.

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, ε.

When you select this option, the following parameters are


available:
— Strip width
Specify the width of the microstrip transmission line. The
default value is 0.6 mm.
— Substrate height
Specify the thickness of the dielectric on which the microstrip
resides. The default value is 0.635 mm.
— Strip thickness
Specify the physical thickness of the microstrip. The default
value is 5 mm.
— Relative permittivity constant

1-111
Transmission Line

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 in siemens per
meter. 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.

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

When you select this option, the following parameters are


available:
— Wire radius
Specify the radius of the conducting wires of the two-wire
transmission line. The default value is 0.67 mm.
— Wire separation
Specify the physical distance between the wires. The default
value is 1.62 mm.
— Relative permeability constant
Specify the relative permeability of the dielectric. This value
is 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

1-113
Transmission Line

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 in siemens per
meter. 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.

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]

When you select this option, the following parameters are


available:
— Plate width
Specify the physical width of the parallel-plate transmission
line. The default value is 5 mm.

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

When you select this option, the following parameters are


available:
— Phase velocity (m/s)
Specify the propagation velocity of a uniform plane wave on
the transmission line. The default value is 299792458.
— Characteristic impedance
Specify the characteristic impedance of the transmission
line. The value can be complex. The default value is 50 Ohm.
— Loss (dB/m)
Specify the reduction in strength of the signal as it travels
over the transmission line. This value must be positive. The
default value is 0.
— Line length
Specify the physical length of the transmission line. The
default value is 1 cm.
— Frequency
Specify the vector of modeling frequencies. The block
performs the calculations listed in the Description section at
each frequency you provide. The default value is 1e9 Hz.
— 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. The default is Linear.
— 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.

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.

When you select this option, the following parameters are


available:
— Resistance per unit length
Specify the vector of resistance values in ohms per meter.
The default value is 0.3 Ohm/m.
— Inductance per unit length
Specify the vector of inductance values in henries per meter.
The default value is 235e-9 H/m.
— Capacitance per unit length
Specify the vector of capacitance values in farads per meter.
The default value is 94e-12 F/m.
— Conductance per unit length

1-117
Transmission Line

Specify the vector of conductance values in siemens per


meter. The default value is 5e-6 S/m.
— Line length
Specify the physical length of the transmission line. The
default value is 1 cm.
— Frequency
Specify the vector of frequency values at which the
resistance, inductance, capacitance, and conductance values
are known. The default value is 1e9 Hz.
— 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. The default value is
Linear.
— 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.
Ground and hide negative terminals
Select this check box to internally ground and hide the negative
terminals. Clear the check box to expose the negative terminals.
By exposing these terminals, you can connect them to other parts
of your model.

By default, this check box is selected.

Parameter Calculations for Distributed Transmission Line


When modeling distributed transmission lines, the block first
calculates ABCD-parameters at a set of internal frequencies. The
ABCD-parameters are converted S-parameters for simulation.

1-118
Transmission Line

The block calculates the ABCD-parameters from the physical length


of the transmission line, d, and the complex propagation constant, k,
using the following set of equations:

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.

Zin is the input impedance of the shunt circuit. The ABCD-parameters


for the shunt stub are calculated as

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.

Zin is the input impedance of the series circuit. The ABCD-parameters


for the series stub are:

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 Frequency


domain.
Fitting options
This field displays when you select Time domain(rationalfit)
as the modeling option. Valid values are Share all poles, Share
poles by columns, and Fit individually.

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

Source of frequency data


The only option for Source of frequency data is
User-specified. To plot, specify a vector of frequencies in the
Frequency data parameter and select units.
Plot type
Specify the type of plot that you want to produce with your data.
When you model using Frequency domain, Visualization tab
plots only the data defined in Data Source. When you model
using Time domain, Visualization tab plots the data defined
in Data Source and the rationalfit values. 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.
• 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.

The default value is X-Y plane.


Parameter #
Specify the S-parameters to plot. From the Parameter1 and
Parameter2 drop-down lists, select the S-parameters that you
want to plot. If you specify two parameters, the block plots both
parameters in a single window.

The default value for Parameter1 is S11. For the Transmission


Line block, the default value for Parameter2 is S22.
Format #
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.

1-124
Transmission Line

The default value is Magnitude (decibels).


Y-axis scale
Scale for the Y-axis.

The default value is Linear.


X-axis scale
Scale for the X-axis.

The default value is Linear.

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.

Examples The example, “Transmission Lines, Delay-based and Lumped Models”,


shows how to use Delay-based and Lumped Transmission Line blocks.

References [1] Sussman-Fort, S. E., and J. C. Hantgan. “SPICE Implementation


of Lossy Transmission Line and Schottky Diode Models.” IEEE
Transactions on Microwave Theory and Techniques.Vol. 36, No.1,
January 1988.

[2] Pozar, David M. Microwave Engineering. Hoboken, NJ: John Wiley


& Sons, Inc., 2005.

[3] Gupta, K. C., Ramesh Garg, Inder Bahl, and Prakash Bhartia.
Microstrip Lines and Slotlines, 2nd Edition, Norwood, MA: Artech
House, Inc., 1996.

[4] Ludwig, Reinhold and Pavel Bretchko. RF Circuit Design: Theory


and Applications. Englewood Cliffs: NJ: Prentice-Hall, 2000.

1-125
Transmission Line

[5] True, Kenneth M. “Data Transmission Lines and Their


Characteristics.” National Semiconductor Application Note 806, April
1992.

See Also S-Parameters

1-126
2

Blocks — Alphabetical List


Amplifier (Idealized Baseband)

Purpose Complex baseband model of amplifier with 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 Amplifier block generates a complex baseband model of an amplifier


with thermal noise. It provides six methods for modeling nonlinearity
and three ways to specify noise.

Note This block assumes a nominal impedance of 1 ohm.

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

The linear method is implemented by a Gain block. The other nonlinear


methods are implemented by subsystems underneath the block’s mask.
Each subsystem has the same basic structure, as shown in the following
figure.

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

1 Multiplies the signal by a gain factor.

2 Splits the complex signal into its magnitude and angle components.

3 Applies an AM/AM conversion to the magnitude of the signal,


according to the selected nonlinearity method, to produce the
magnitude of the output signal.

4 Applies an AM/PM conversion to the phase of the signal, according to


the selected nonlinearity method, and adds the result to the angle of
the signal to produce the angle of the output signal.

5 Combines the new magnitude and angle components into a complex


signal and multiplies the result by a gain factor, which is controlled
by the Linear gain parameter.

AM/AM and AM/PM Conversions


The subsystems for the nonlinear methods implement the AM/AM and
AM/PM conversions differently, according to the nonlinearity method
you specify. To see exactly how the Amplifier block implements the
conversions for a specific method, you can view the AM/AM and AM/PM
subsystems that implement these conversions as follows:

1 Right-click the Amplifier block.

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.

3 Double-click the subsystem for the method in which you are


interested. A subsystem displays similar to the one shown in the
preceding figure.

4 Double-click one of the subsystems labeled AM/AM or AM/PM to view


how the block implements the conversions.

The following figure shows, for the Saleh method, plots of

• Output voltage against input voltage for the AM/AM conversion


• Output phase against input voltage for the AM/PM conversion

2-4
Amplifier (Idealized Baseband)

Model Parameters and Characteristics of Nonlinearity


Modeling Methods
The following sections discuss how the parameters specific to the
following nonlinear amplifier models affect the AM/AM and AM/PM
characteristics of the Amplifier block:

• Cubic Polynomial Model on page 5


• Hyperbolic Tangent Model on page 6
• Saleh Model on page 7
• Ghorbani Model on page 8
• Rapp Model on page 9

Note The Amplifier block also enables you to model a linear amplifier.

Cubic Polynomial Model


When you select Cubic polynomial for the nonlinearity modeling
Method parameter, the Amplifier block models the AM/AM
nonlinearity by:

1 Using the third-order input intercept point IIP3 (dBm) parameter to


compute the factor, f, that scales the input signal before the Amplifier
block applies the nonlinearity:

3 3
f = =
IIP 3 (Watts) 10( IIP3(dBm) − 30 ) / 10

2 Computing the scaled input signal by multiplying the amplifier input


signal by f.

3 Limiting the scaled input signal to a maximum value of 1.

2-5
Amplifier (Idealized Baseband)

4 Applying an AM/AM conversion to the amplifier gain, according to


the following cubic polynomial equation:

u3
FAM / AM (u) = u −
3
where u is the magnitude of the scaled input signal, which is a
unitless normalized input voltage.

The Amplifier block uses the AM/PM conversion (degrees per


dB) parameter, which specifies the linear phase change, to add the
AM/PM nonlinearity within the power limits specified by the Lower
input power limit for AM/PM conversion (dBm) parameter and
the Upper input power limit for AM/PM conversion (dBm)
parameter. Outside those limits, the phase change is constant at the
values corresponding to the lower and upper input power limits, which
are zero and

(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:

1 Using the third-order input intercept point IIP3 (dBm) parameter to


compute the factor, f, that scales the input signal before the Amplifier
block applies the nonlinearity:

3 3
f = =
IIP 3 (Watts) 10( IIP3(dBm) − 30 ) / 10

2 Computing the scaled input signal by multiplying the amplifier input


signal by f.

2-6
Amplifier (Idealized Baseband)

3 Limiting the scaled input signal to a maximum value of 1.

4 Applying an AM/AM conversion to the amplifier gain, according to


the following cubic polynomial equation:

FAM / AM (u) = tanh u


where u is the magnitude of the scaled input signal, which is a
unitless normalized input voltage.

The Amplifier block uses the AM/PM conversion (degrees per


dB) parameter, which specifies the linear phase change, to add the
AM/PM nonlinearity within the power limits specified by the Lower
input power limit for AM/PM conversion (dBm) parameter and
the Upper input power limit for AM/PM conversion (dBm)
parameter. Outside those limits, the phase change is constant at the
values corresponding to the lower and upper input power limits, which
are zero and

(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

where u is the magnitude of the scaled signal.

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

where u is the magnitude of the scaled signal.


The AM/PM parameters, [y1 y2 y3 y4], are used to compute the phase
change for an input signal using the following function

y1u y2
FAM / PM (u) = + y4 u
1 + y3u y2

where u is the magnitude of the scaled signal.


The Output scaling (dB) parameter scales the output signal similarly.

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 ⎠ ⎟⎠

where u is the magnitude of the scaled signal, S is the Smoothness


factor and Osat is the Output saturation level.
The Rapp model does not apply a phase change to the input signal.
The Output saturation level parameter limits the output signal
level. The Smoothness factor parameter controls the transition for
the amplitude gain as the input amplitude approaches saturation. The
smaller the smoothness factor, the smoother the curve.

Thermal Noise Simulation


You can specify the amount of thermal noise in three ways, according to
the Specification method parameter you select.

• Noise temperature — Specifies the noise in kelvin.


• Noise factor — Specifies the noise by the following equation:

Noise temperature
Noise factor = 1 +
290

• Noise figure — Specifies the noise in decibels relative to a noise


temperature of 290 kelvin. In terms of noise factor,

Noise figure = 10log(Noise factor)

2-9
Amplifier (Idealized Baseband)

Note Some RF blocks require the sample time to perform baseband


modeling calculations. To ensure the accuracy of these calculations,
the Input Port block, as well as the mathematical RF blocks, compare
the input sample time to the sample time you provide in the mask. If
they do not match, or if the input sample time is missing because the
blocks are not connected, an error message appears.

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)

You can change tunable parameters while the model is running.

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)

This field becomes visible if you select Cubic polynomial or


Hyperbolic tangent as the Method parameter. Tunable.
Input scaling (dB)
Number that scales the input signal level. This field becomes
visible if you select Saleh model or Ghorbani model as the
Method parameter. Tunable.
Output scaling (dB)
Number that scales the output signal level. This field becomes
visible if you select Saleh model or Ghorbani model as the
Method parameter. Tunable.
AM/AM parameters [alpha beta]
Vector specifying the AM/AM parameters. This field becomes
visible if you select Saleh model as the Method parameter.
Tunable.
AM/PM parameters [alpha beta]
Vector specifying the AM/PM parameters. This field becomes
visible if you select Saleh model as the Method parameter.
Tunable.
AM/AM parameters [x1 x2 x3 x4]
Vector specifying the AM/AM parameters. This field becomes
visible if you select Ghorbani model as the Method parameter.
Tunable.
AM/PM parameters [y1 y2 y3 y4]
Vector specifying the AM/PM parameters. This field becomes
visible if you select Ghorbani model as the Method parameter.
Tunable.
Smoothness factor
Scalar specifying the smoothness factor. This field becomes visible
if you select Rapp model as the Method parameter. Tunable.
Output saturation level
Scalar specifying the output saturation level. This field becomes
visible if you select Rapp model as the Method parameter.
Tunable.

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)

This example uses a baseband-equivalent multitone signal as input to


the Amplifier block. A Simulink Slider Gain block enables you to vary
the gain from 1 to 10. The following figure shows the input signal with
gain set to the default 1.

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] Rapp, C., “Effects of HPA-Nonlinearity on a 4-DPSK/OFDM-Signal


for a Digital Sound Broadcasting System,” in Proceedings of the Second
European Conference on Satellite Communications, Liege, Belgium, Oct.
22-24, 1991, pp. 179-184.

[3] Saleh, A.A.M., “Frequency-independent and frequency-dependent


nonlinear models of TWT amplifiers,” IEEE Trans. Communications,
vol. COM-29, pp.1715-1720, November 1981.

See Also Bandpass RF Filter, Bandstop RF Filter, Highpass RF Filter, Lowpass


RF Filter, Mixer

2-15
Bandpass RF Filter

Purpose Standard bandpass RF filters in baseband-equivalent complex form

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.

Design Method Description


Butterworth The magnitude response of a Butterworth
filter is maximally flat in the passband and
monotonic overall.
Chebyshev I The magnitude response of a Chebyshev I filter
is equiripple in the passband and monotonic
in the stopband.
Chebyshev II The magnitude response of a Chebyshev II
filter is monotonic in the passband and
equiripple in the stopband.
Elliptic The magnitude response of an elliptic filter
is equiripple in both the passband and the
stopband.
Bessel The delay of a Bessel filter is maximally flat
in the passband.

The block input must be a discrete-time complex signal.

Note This block assumes a nominal impedance of 1 ohm.

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.

Design Method Filter Design Parameters


Butterworth Order, lower passband edge frequency, upper
passband edge frequency
Chebyshev I Order, lower passband edge frequency, upper
passband edge frequency, passband ripple
Chebyshev II Order, lower stopband edge frequency, upper
stopband edge frequency, stopband attenuation
Elliptic Order, lower passband edge frequency, upper
passband edge frequency, passband ripple,
stopband attenuation
Bessel Order, lower passband edge frequency, upper
passband edge frequency

The Bandpass RF Filter block designs the filters using the Signal
Processing Toolbox™ filter design functions buttap, cheb1ap, cheb2ap,
ellipap, and besselap.

Note Some RF blocks require the sample time to perform baseband


modeling calculations. To ensure the accuracy of these calculations, the
Input Port block, as well as the mathematical RF blocks, compare the
input sample time to the sample time you provide in the mask. If they
do not match, or if the input sample time is missing because the blocks
are not connected, an error message appears.

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

Lower passband edge frequency (Hz)


Lower passband edge frequency for Butterworth, Chebyshev I,
elliptic, and Bessel designs. Tunable.
Upper passband edge frequency (Hz)
Upper passband edge frequency for Butterworth, Chebyshev I,
elliptic, and Bessel designs. Tunable.
Lower stopband edge frequency (Hz)
Lower stopband edge frequency for Chebyshev II designs.
Tunable.
Upper stopband edge frequency (Hz)
Upper stopband edge frequency for Chebyshev II designs.
Tunable.
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.

See Also Amplifier, Bandstop RF Filter, Highpass RF Filter, Lowpass RF Filter,


Mixer
buttap, cheb1ap, cheb2ap, ellipap, besselap (Signal Processing
Toolbox)

2-19
Bandstop RF Filter

Purpose Standard bandstop RF filters in baseband-equivalent complex form

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.

Design Method Description


Butterworth The magnitude response of a Butterworth
filter is maximally flat in the passband
and monotonic overall.
Chebyshev I The magnitude response of a Chebyshev I
filter is equiripple in the passband and
monotonic in the stopband.
Chebyshev II The magnitude response of a Chebyshev II
filter is monotonic in the passband and
equiripple in the stopband.
Elliptic The magnitude response of an elliptic
filter is equiripple in both the passband
and the stopband.
Bessel The delay of a Bessel filter is maximally
flat in the passband.

The block input must be a discrete-time complex signal.

Note This block assumes a nominal impedance of 1 ohm.

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.

Design Method Filter Design Parameters


Butterworth Order, lower passband edge frequency,
upper passband edge frequency
Chebyshev I Order, lower passband edge frequency,
upper passband edge frequency, passband
ripple
Chebyshev II Order, lower stopband edge frequency,
upper stopband edge frequency, stopband
attenuation
Elliptic Order, lower passband edge frequency,
upper passband edge frequency, passband
ripple, stopband attenuation
Bessel Order, lower passband edge frequency,
upper passband edge frequency

The Bandstop RF Filter block designs the filters using the Signal
Processing Toolbox filter design functions buttap, cheb1ap, cheb2ap,
ellipap, and besselap.

Note Some RF blocks require the sample time to perform baseband


modeling calculations. To ensure the accuracy of these calculations, the
Input Port block, as well as the mathematical RF blocks, compare the
input sample time to the sample time you provide in the mask. If they
do not match, or if the input sample time is missing because the blocks
are not connected, an error message appears.

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

Upper passband edge frequency (Hz)


Upper passband edge frequency for Butterworth, Chebyshev I,
elliptic, and Bessel designs. Tunable.
Lower stopband edge frequency (Hz)
Lower stopband edge frequency for Chebyshev II designs.
Tunable.
Upper stopband edge frequency (Hz)
Upper stopband edge frequency for Chebyshev II designs.
Tunable.
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.

See Also Amplifier, Bandpass RF Filter, Highpass RF Filter, Lowpass RF Filter,


Mixer
buttap, cheb1ap, cheb2ap, ellipap, besselap (Signal Processing
Toolbox)

2-23
Coaxial Transmission Line

Purpose Model coaxial transmission line

Library Transmission Lines sublibrary of the Physical library

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.

Stubless Transmission Line


If you model a coaxial transmission line as a stubless line, the Coaxial
Transmission Line block first calculates the ABCD-parameters at each
frequency contained in the modeling frequencies vector. It then uses
the abcd2s function to convert the ABCD-parameters to S-parameters.
The block calculates the ABCD-parameters using the physical length
of the transmission line, d, and the complex propagation constant, k,
using the following equations:

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

Z0 and k are vectors whose elements correspond to the elements of f, a


vector of modeling frequencies, determined by the Output Port block.
Both can be expressed in terms of the resistance (R), inductance (L),
conductance (G), and capacitance (C) per unit length (meters) as follows:

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

• 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.μ = μ0 μrwhere:
- μ0 is the permeability in free space.
- μr is the Relative permeability constant parameter value.
• The is a complex dielectric constant given by ε = ε′ − јε″= ε′ ( 1
− јtanδ)
• ε′ is the real part of complex dielectric constant ε, ε′ = ε0εr. ε″ is the
imaginary part of complex dielectric constant ε, ε″ = ε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 .

Shunt and Series Stubs


If you model the transmission line as a shunt or series stub, the Coaxial
Transmission Line block first calculates the ABCD-parameters at each
frequency contained in the modeling frequencies vector. It then uses
the abcd2s function to convert the ABCD-parameters to S-parameters.

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

Zin is the input impedance of the shunt circuit. The ABCD-parameters


for the shunt stub are calculated as

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.

Zin is the input impedance of the series circuit. The ABCD-parameters


for the series stub are calculated as

2-27
Coaxial Transmission Line

A =1
B = Zin
C=0
D =1

Dialog Main Tab


Box

Outer radius (m)


Radius of the outer conductor of the coaxial transmission line.
Inner radius (m)
Radius of the inner conductor of the coaxial transmission line.
Relative permeability constant
Relative permeability of the dielectric expressed as the ratio of the
permeability of the dielectric to permeability in free space μ0.

2-28
Coaxial Transmission Line

Relative permittivity constant


Relative permittivity of the dielectric expressed as the ratio of the
permittivity of the dielectric to permittivity in free space ε0.
Loss tangent of dielectric
Loss angle tangent of the dielectric.
Conductivity of conductor (S/m)
Conductivity of the conductor in siemens per meter.
Transmission line length (m)
Physical length of the transmission line.
Stub mode
Type of stub. 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.

2-29
Coaxial Transmission Line

Visualization Tab

For information about plotting, see “Create Plots”.

References [1] Pozar, David M. Microwave Engineering, John Wiley & Sons, Inc.,
2005.

See Also Coplanar Waveguide Transmission Line, General Passive Network,


Transmission Line, Microstrip Transmission Line, Parallel-Plate
Transmission Line, Two-Wire Transmission Line

2-30
Connection Port

Purpose Connection port for RF subsystem

Library Input/Output Ports sublibrary of the Physical library

Description The Connection Port block, placed inside a subsystem composed of


SimRF Equivalent Baseband blocks, creates an open round physical
modeling connector port on the boundary of the subsystem. When it
is connected to a connection line, the port becomes solid .
You connect individual blocks and subsystems made of SimRF
Equivalent Baseband blocks to one another with connection lines
instead of normal Simulink signal lines. These blocks and subsystems
are anchored at the open, round physical modeling connector ports .
Subsystems constructed out of SimRF Equivalent Baseband blocks
automatically have such open round physical modeling connector ports.
You can add additional connector ports by adding Connection Port
blocks to your subsystem.

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

Port location on parent subsystem


Use this parameter to choose on which side of the parent
subsystem boundary the Port is placed. The choices are Left or
Right. The default choice is Left.

See Also See Creating Subsystems in the Simulink documentation.

2-32
Coplanar Waveguide Transmission Line

Purpose Model coplanar waveguide transmission line

Library Transmission Lines sublibrary of the Physical library

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.

Stubless Transmission Line


If you model a coplanar waveguide transmission line as a stubless
line, the Coplanar Waveguide Transmission Line block first calculates
the ABCD-parameters at each frequency contained in the modeling
frequencies vector. It then uses the abcd2s function to convert the
ABCD-parameters to S-parameters.
The block calculates the ABCD-parameters using the physical length
of the transmission line, d, and the complex propagation constant, k,
using the following equations:

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

Z0 and k are vectors whose elements correspond to the elements of


f, a vector of modeling frequencies. Both can be expressed in terms
of the specified conductor strip width, slot width, substrate height,
conductor strip thickness, relative permittivity constant, conductivity
and dielectric loss tangent of the transmission line, as described in [1].

Shunt and Series Stubs


If you model the transmission line as a shunt or series stub, the
Coplanar Waveguide Transmission Line block first calculates the
ABCD-parameters at each frequency contained in the vector of
modeling frequencies. It then uses the abcd2s function to convert the
ABCD-parameters to S-parameters.

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

Zin is the input impedance of the shunt circuit. The ABCD-parameters


for the shunt stub are calculated as

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.

Zin is the input impedance of the series circuit. The ABCD-parameters


for the series stub are calculated as

2-35
Coplanar Waveguide Transmission Line

A =1
B = Zin
C=0
D =1

Dialog Main Tab


Box

Conductor width (m)


Physical width of the conductor.
Slot width (m)
Physical width of the slot.
Substrate height (m)
Thickness of the dielectric on which the conductor resides.
Strip thickness (m)
Physical thickness of the conductor.

2-36
Coplanar Waveguide Transmission Line

Relative permittivity constant


Relative permittivity of the dielectric expressed as the ratio of the
permittivity of the dielectric to permittivity in free space ε0.
Conductivity of conductor (S/m)
Conductivity of the conductor in siemens per meter.
Loss tangent of dielectric
Loss angle tangent of the dielectric.
Transmission line length (m)
Physical length of the transmission line.
Stub mode
Type of stub. 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.

2-37
Coplanar Waveguide Transmission Line

Visualization Tab

For information about plotting, see “Create Plots”.

References [1] Gupta, K. C., Ramesh Garg, Inder Bahl, and Prakash Bhartia,
Microstrip Lines and Slotlines, 2nd Edition, Artech House, Inc.,
Norwood, MA, 1996.

See Also Coaxial Transmission Line, General Passive Network, Transmission


Line, Microstrip Transmission Line, Parallel-Plate Transmission Line,
Two-Wire Transmission Line

2-38
General Amplifier

Purpose Model nonlinear amplifier described by rfdata object or file data

Library Amplifiers sublibrary of the Physical library

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

• The output power at the 1-dB compression point ( P1dB,out ).

• The output power at saturation ( Psat,out ).


In addition, if you have specified Psat,out , the block uses the value for
the gain compression at saturation ( GCsat ). Otherwise, GCsat is not
used. You define each of these parameters in the block dialog box,
on the Nonlinearity Data tab.

2 The block calculates a corresponding input or output value for the


parameters that you have specified. In units of dB and dBm,

Psat,out + GCsat = Psat,in + Glin


P1dB,out + 1 = P1dB,in + Glin
OIP 3 = IIP 3 + Glin

where Glin is c1 in units of dB.

3 The block formulates the coefficients c3 , c5 , and c7 , where


applicable, as the solutions to a system of one, two, or three linear
equations. The number of equations is equal to the number of
parameters that you provide. For example, if you specify all three
parameters, the block formulates the coefficients according to the
following equations:

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

The first two equations are the evaluation of the polynomial

FAM / AM (s) at the points ( Psat,in , Psat,out ) and

( P1dB,in , P1dB,out ) , expressed in linear units (such as W


or mW) and normalized to a 1-Ω impedance. The third equation is
the definition of the third-order intercept point.

The calculation omits higher-order terms according to the available


degrees of freedom of the system. If you specify only two of the
three parameters, the block does not use the equation involving the
parameter you did not specify, and eliminates any c7 terms from
the remaining equations. Similarly, if you provide only one of the
parameters, the block uses only the solution to the equation involving
that parameter and omits any c5 or c7 terms.

If you provide vectors of nonlinearity and frequency data, the block


calculates the polynomial coefficients using values for the parameters
interpolated at the center frequency.

Active Noise
You can specify active block noise in one of the following ways:

• Spot noise data in the data source.


• Spot noise data in the block dialog box.
• Spot noise data (rfdata.noise) object in the block dialog box.
• Noise figure, noise factor, or noise temperature value in the block
dialog box.
• Frequency-dependent noise figure data (rfdata.nf) object in the
block dialog box.

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:

ΔP = S21 ( f P ) − Pout ( f P ) + Pin ( f P ) (dBm)

where fP is the lowest frequency for which power data is specified.


If ΔP is more than 0.4 dB, a warning appears, and the blockset adds
ΔP to the output power values at each specified input power value to
resolve the discrepancy for simulation. The following graph shows this
discrepancy.

2-42
General Amplifier

Small Signal Network Data


*** Specified Power Data
xxx Reconciled Power Data

x x x
x
x
Pout (dBm)
* * *
x
*
DP *

fP Pin (dBm)

2-43
General Amplifier

Dialog Main Tab


Box

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 Data Tab

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

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.
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

2-47
General Amplifier

Interpolation method specified in the Main tab to interpolate


noise data.

Nonlinearity Data Tab

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.

Operating Conditions Tab

If the data source contains data at multiple operating conditions, the


Operating Conditions tab contains two columns. The Conditions
column shows the available conditions, and the Values column contains
a drop-down list of the available values for the corresponding condition.

2-51
General Amplifier

Use the drop-down lists to specify the operating condition values to


use in simulation.

Examples Creating a General Amplifier Block from File Data


This example uses the default data source, which is the nonlinear
amplifier in the file default.s2d. The file contains S-parameters for
frequencies from 1.0 to 2.9 GHz at intervals of 0.01 GHz, power data
at frequency 2.1 GHz, and active noise parameters. By default, the
General Amplifier block uses linear interpolation to model the network
described in the object.

1 On the Main tab, accept the default settings.

2-52
General Amplifier

2 On the Visualization tab, set the parameters as follows:

• In the Plot type list, select Z Smith chart.


• In the Y parameter1 list, select S22.

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.

See Also Output Port, S-Parameters Amplifier, Y-Parameters Amplifier,


Z-Parameters Amplifier
rfdata.data (RF Toolbox)
interp1 (MATLAB)

2-55
General Circuit Element

Purpose Model two-port network described by rfckt object

Library Black Box Elements sublibrary of the Physical library

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.

Dialog Main Tab


Box

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

For information about plotting, see “Create Plots”.

Examples Creating a General Circuit Element from an RF Toolbox Object


This example uses the rfckt.txline object, which describes a
transmission line.

1 On the Main tab, set the RFCKT object parameter to rfckt.txline.

Click Apply. This action applies the specified settings.

2-57
General Circuit Element

2 Set the General Circuit Element block parameters on the


Visualization tab as follows:
• In the Y parameter1 list, select S12.

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

See Also General Passive Network, S-Parameters Passive Network,


Y-Parameters Passive Network, Z-Parameters Passive Network
interp1 (MATLAB)

2-60
General Mixer

Purpose Model mixer and local oscillator described by rfdata object

Library Mixer sublibrary of the Physical library

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

⎡ b1 ( fin ) ⎤ ⎡ S11 S12 ⎤ ⎡ a1 ( fin ) ⎤


⎢b ( f ) ⎥ = ⎢ S S22 ⎥⎦ ⎢⎣ a2 ( fout ) ⎥⎦
⎣ 2 out ⎦ ⎣ 21

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.

The interpolated S21 parameter values describe the conversion gain as a


function of frequency, referred to the mixer input frequency.

Active Noise
You can specify active block noise in one of the following ways:

2-61
General Mixer

• Spot noise data in the data source.


• Spot noise data in the block dialog box.
• Spot noise data (rfdata.noise) object in the block dialog box.
• Noise figure, noise factor, or noise temperature value in the block
dialog box.
• Frequency-dependent noise figure data (rfdata.nf) object in the
block dialog box.

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:

1 Interpolating the specified phase noise level to determine the phase


noise values at the modeling frequencies.

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

• The output power at the 1-dB compression point ( P1dB,out ).

• The output power at saturation ( Psat,out ).


In addition, if you have specified Psat,out , the block uses the value for
the gain compression at saturation ( GCsat ). Otherwise, GCsat is not
used. You define each of these parameters in the block dialog box,
on the Nonlinearity Data tab.

2 The block calculates a corresponding input or output value for the


parameters you have specified. In units of dB and dBm,

2-63
General Mixer

Psat,out + GCsat = Psat,in + Glin


P1dB,out + 1 = P1dB,in + Glin
OIP 3 = IIP 3 + Glin

where Glin is c1 in units of dB.

3 The block formulates the coefficients c3 , c5 , and c7 , where


applicable, as the solutions to a system of one, two, or three linear
equations. The number of equations used is equal to the number
of parameters you provide. For example, if you specify all three
parameters, the block formulates the coefficients according to the
following equations:

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

FAM / AM (s) at the points ( Psat,in , Psat,out ) and

( P1dB,in , P1dB,out ) , expressed in linear units (such as W


or mW) and normalized to a 1-Ω impedance. The third equation is
the definition of the third-order intercept point.

The calculation omits higher-order terms according to the available


degrees of freedom of the system. If you specify only two of the
three parameters, the block does not use the equation involving the
parameter you did not specify, and eliminates any c7 terms from
the remaining equations. Similarly, if you provide only one of the
parameters, the block uses only the solution to the equation involving
that parameter and omits any c5 or c7 terms.

2-64
General Mixer

If you provide vectors of nonlinearity and frequency data, the block


calculates the polynomial coefficients using values for the parameters
interpolated at the center frequency.

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

Dialog Main Tab


Box

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.

Note If the data file contains an intermodulation table, the


General Mixer block ignores the table. Use RF Toolbox software
to ensure the cascade has no significant spurs in the frequency
band of interest before running a simulation.

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.

Note For a downconverting mixer, the local oscillator frequency


must satisfy the condition fin – flo ≥ 1/(2ts), where ts is the sample
time specified in the Input Port block. Otherwise, an error
appears.

2-68
General Mixer

Noise Data Tab

Phase noise frequency offset (Hz)


Vector specifying the frequency offset.
Phase noise level (dBc/Hz)
Vector specifying the phase noise level.

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

Nonlinearity Data Tab

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

(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

For information about plotting, see “Create Plots”. Use rftool or the
RF Toolbox plotting functions to plot other data.

2-74
General Mixer

Operating Conditions Tab

If the data source contains data at multiple operating conditions, the


Operating Conditions tab contains two columns. The Conditions
column shows the available conditions, and the Values column contains
a drop-down list of the available values for the corresponding condition.
Use the drop-down lists to specify the operating condition values to
use in simulation.

2-75
General Mixer

See Also Output Port, S-Parameters Mixer, Y-Parameters Mixer, Z-Parameters


Mixer
rfdata.data (RF Toolbox)

2-76
General Passive Network

Purpose Model two-port passive network described by rfdata object

Library Black Box Elements sublibrary of the Physical library

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.

Dialog Main Tab


Box

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

For information about plotting, see “Create Plots”.

Examples Creating a General Passive Network Block from File Data


This example creates a two-port passive network from the data in the
file passive.s2p. The file contains S-parameters for frequencies from
about 0.315 MHz to 6.0 GHz. The General Passive Network block uses
linear interpolation to model the network described in the object.

1 On the Main tab, accept the default settings.

2-79
General Passive Network

2 On the Visualization tab, set the parameters as follows:

• In the Plot type list, select Z Smith chart.

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

Purpose Standard highpass RF filters in baseband-equivalent complex form

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.

Design Method Description


Butterworth The magnitude response of a Butterworth
filter is maximally flat in the passband and
monotonic overall.
Chebyshev I The magnitude response of a Chebyshev I
filter is equiripple in the passband and
monotonic in the stopband.
Chebyshev II The magnitude response of a Chebyshev II
filter is monotonic in the passband and
equiripple in the stopband.
Elliptic The magnitude response of an elliptic filter
is equiripple in both the passband and the
stopband.
Bessel The delay of a Bessel filter is maximally flat
in the passband.

The block input must be a discrete-time complex signal.

Note This block assumes a nominal impedance of 1 ohm.

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.

Design Method Filter Design Parameters


Butterworth Order, passband edge frequency
Chebyshev I Order, passband edge frequency, passband
ripple
Chebyshev II Order, stopband edge frequency, stopband
attenuation
Elliptic Order, passband edge frequency, passband
ripple, stopband attenuation
Bessel Order, passband edge frequency

The Highpass RF Filter block designs the filters using the Signal
Processing Toolbox filter design functions buttap, cheb1ap, cheb2ap,
ellipap, and besselap.

Note Some RF blocks require the sample time to perform baseband


modeling calculations. To ensure the accuracy of these calculations, the
Input Port block, as well as the mathematical RF blocks, compare the
input sample time to the sample time you provide in the mask. If they
do not match, or if the input sample time is missing because the blocks
are not connected, an error message appears.

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.

See Also Amplifier, Bandpass RF Filter, Bandstop RF Filter, Lowpass RF Filter,


Mixer
buttap, cheb1ap, cheb2ap, ellipap, besselap (Signal Processing
Toolbox)

2-86
Input Port

Purpose Connection block from Simulink environment to RF physical blocks

Library Input/Output Ports sublibrary of the Physical library

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”.

Note Some RF blocks use the sample time to perform baseband


modeling calculations. To ensure the accuracy of these calculations, the
Input Port block, as well as the mathematical RF blocks, compare the
input sample time to the sample time you provide in the Input Port
mask. If they do not match, or if the input sample time is missing
because the blocks are not connected, an error message appears.

2-87
Input Port

Dialog
Box

Treat input Simulink signal as


Select one of the following options for interpreting the input
Simulink signal:
• Incident power wave — Interpret the input signal as the
incident power wave of the RF system described in the physical

2-88
Input Port

model to which it connects. When you select this option, the


output signal of the RF system is the transmitted power wave.
This is the most common RF modeling interpretation.
• Source voltage — Interpret the input signal as the source
voltage of the RF system described in the physical model to
which it connects. As a result, the baseband-equivalent model
includes the loss through the source impedance. When you
select this option, the output signal of the RF system is the
load voltage.

For more information about these options, see “Convert to and


from Simulink Signals”.
Source impedance (ohms)
Source impedance of the RF network described in the physical
model to which it connects.
Finite impulse response filter length
Desired length of the baseband-equivalent impulse response for
the physical model. The longer the FIR filter in the time domain,
the finer the frequency resolution in the frequency domain. The
frequency resolution is approximately equal to 1/ (Finite impulse
response filter length*Sample time (s)). For a graphical
representation of this parameter, see “Baseband-Equivalent
Modeling”.

Note The equivalent-baseband simulation algorithm uses the


next power of 2 greater than the specified filter length in its
calculations and then truncates the impulse response to the
specified length. As a result, you get different results when you
set the Finite impulse response filter length parameter to
a number that is not a power of 2. For more information, see
“Calculate the Baseband-Equivalent Impulse Response”.

2-89
Input Port

Fractional bandwidth of guard bands


Fraction of modeling bandwidth over which to taper the edges
of the transfer function of the system when creating the
baseband-equivalent model. This parameter defines the ratio of
the bandwidth of sections that are tapered using a Tukey, or
cosine-tapered, window to the bandwidth of the constant, or
untapered, sections.

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.

The blockset uses the Signal Processing Toolbox tukeywin


function to generate the window. The following figure shows
the resulting frequency-domain window for several values of the
Fractional bandwidth of guard bands parameter.

2-90
Input Port

See “Create a Complex Baseband-Equivalent Model” for


information about how the Input Port block applies this window
to reduce the Gibbs phenomenon (also known as ringing), and
other artifacts in the baseband-equivalent model of the system.
Modeling delay (samples)
Number of time samples by which to delay the impulse
response of the baseband-equivalent model to ensure that the
baseband-equivalent model has a causal response.

2-91
Input Port

See “Create a Complex Baseband-Equivalent Model” for


information on how the Input Port block applies this delay to
ensure a causal response.
Center frequency (Hz)
Center of the modeling frequencies. See the Output Port block
reference page for information about calculating the modeling
frequencies.
Sample time (s)
Time interval between consecutive samples of the input signal.

Note The Input Port block does not automatically inherit a


sample time from its input signal. The specified Sample time (s)
value must match the sample time of the input signal.

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.

See Also Output Port

2-92
LC Bandpass Pi

Purpose Model LC bandpass pi network

Library Ladder Filters sublibrary of the Physical library

Description The LC Bandpass Pi block models the LC bandpass pi 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 Pi 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 bandpass pi network object is a two-port network as shown
in the following circuit diagram.

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

Dialog Main Tab


Box

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

For information about plotting, see “Create Plots”.

Examples Using a Ladder Filter Block to Filter Gaussian Noise


This example provides complex random noise in Gaussian form as input
to an LC Bandpass Pi block. A DSP System Toolbox Spectrum Scope
block plots the filtered output.

2-95
LC Bandpass Pi

The DSP System Toolbox Random Source block produces frame-based


output at 512 samples per frame. Its Sample time parameter is set to
1.0e-9. This sample time must match the sample time for the physical
part of the model, which you provide in the Input Port block diagram.
The Input Port block specifies Finite impulse response filter length
as 256, Center frequency as 700.0e6 Hz, Sample time as 1.0e-9, and
Source impedance as 50 ohms.

2-96
LC Bandpass Pi

The LC Bandpass Pi block provides the inductances for three inductors,


in order from source to load, [1.4446e-9, 4.3949e-8, 1.4446e-9].
Similarly, it provides the capacitances for three capacitors [3.5785e-11,
1.1762e-12, 3.5785e-11].

2-97
LC Bandpass Pi

The following plot shows a sample of the baseband-equivalent RF signal


generated by this LC Bandpass Pi block. Zero (0) on the frequency axis
corresponds to the center frequency specified in the Input Port block.
The bandwidth of the frequency spectrum is 1/sample time. You specify
the Sample time parameter in the Input Port block.
The Axis Properties of the Spectrum Scope block have been adjusted
to show the frequencies above and below the carrier. The Minimum
Y-limit parameter is -90, and Maximum Y-limit is 0.

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.

See Also General Passive Network, LC Bandpass Tee, LC Bandstop Pi, LC


Bandstop Tee, LC Highpass Pi, LC Highpass Tee, LC Lowpass Pi, LC
Lowpass Tee, Series C, Series L, Series R, Series RLC, Shunt C, Shunt
L, Shunt R, Shunt RLC

2-99
LC Bandpass Tee

Purpose Model LC bandpass tee network

Library Ladder Filters sublibrary of the Physical library

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

Dialog Main Tab


Box

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

For information about plotting, see “Create Plots”.

Examples See the LC Bandpass Pi block for an example of an LC filter.

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.

See Also General Passive Network, LC Bandpass Pi, LC Bandstop Pi, LC


Bandstop Tee, LC Highpass Pi, LC Highpass Tee, LC Lowpass Pi, LC
Lowpass Tee, Series C, Series L, Series R, Series RLC, Shunt C, Shunt
L, Shunt R, Shunt RLC

2-102
LC Bandstop Pi

Purpose Model LC bandstop pi network

Library Ladder Filters sublibrary of the Physical library

Description The LC Bandstop Pi block models the LC bandstop pi 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 Pi 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 pi network object is a two-port network as shown
in the following circuit diagram.

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

Dialog Main Tab


Box

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

For information about plotting, see “Create Plots”.

Examples See the LC Bandpass Pi block for an example of an LC filter.

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.

See Also General Passive Network, LC Bandpass Pi, LC Bandpass Tee, LC


Bandstop Tee, LC Highpass Pi, LC Highpass Tee, LC Lowpass Pi, LC
Lowpass Tee, Series C, Series L, Series R, Series RLC, Shunt C, Shunt
L, Shunt R, Shunt RLC

2-105
LC Bandstop Tee

Purpose Model LC bandstop tee network

Library Ladder Filters sublibrary of the Physical library

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

Dialog Main Tab


Box

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

For information about plotting, see “Create Plots”.

Examples See the LC Bandpass Pi block for an example of an LC filter.

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.

See Also General Passive Network, LC Bandpass Pi, LC Bandpass Tee, LC


Bandstop Pi, LC Highpass Pi, LC Highpass Tee, LC Lowpass Pi, LC
Lowpass Tee, Series C, Series L, Series R, Series RLC, Shunt C, Shunt
L, Shunt R, Shunt RLC

2-108
LC Highpass Pi

Purpose Model LC highpass pi network

Library Ladder Filters sublibrary of the Physical library

Description The LC Highpass Pi block models the LC highpass pi 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 Pi 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 pi network object is a two-port network as shown
in the following circuit diagram.

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

Dialog Main Tab


Box

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

For information about plotting, see “Create Plots”.

Examples See the LC Bandpass Pi block for an example of an LC filter.

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.

See Also General Passive Network, LC Bandpass Pi, LC Bandpass Tee, LC


Bandstop Pi, LC Bandstop Tee, LC Highpass Tee, LC Lowpass Pi, LC
Lowpass Tee, Series C, Series L, Series R, Series RLC, Shunt C, Shunt
L, Shunt R, Shunt RLC

2-111
LC Highpass Tee

Purpose Model LC highpass tee network

Library Ladder Filters sublibrary of the Physical library

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

Dialog Main Tab


Box

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

For information about plotting, see “Create Plots”.

Examples See the LC Bandpass Pi block for an example of an LC filter.

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.

See Also General Passive Network, LC Bandpass Pi, LC Bandpass Tee, LC


Bandstop Pi, LC Bandstop Tee, LC Highpass Pi, LC Lowpass Pi, LC
Lowpass Tee, Series C, Series L, Series R, Series RLC, Shunt C, Shunt
L, Shunt R, Shunt RLC

2-114
LC Lowpass Pi

Purpose Model LC lowpass pi network

Library Ladder Filters sublibrary of the Physical library

Description The LC Lowpass Pi block models the LC lowpass pi 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 Pi 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 pi network object is a two-port network as shown in the
following circuit diagram.

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

Dialog Main Tab


Box

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

For information about plotting, see “Create Plots”.

Examples See the LC Bandpass Pi block for an example of an LC filter.

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.

See Also General Passive Network, LC Bandpass Pi, LC Bandpass Tee, LC


Bandstop Pi, LC Bandstop Tee, LC Highpass Pi, LC Highpass Tee, LC
Lowpass Tee, Series C, Series L, Series R, Series RLC, Shunt C, Shunt
L, Shunt R, Shunt RLC

2-117
LC Lowpass Tee

Purpose Model LC lowpass tee network

Library Ladders Filters sublibrary of the Physical library

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

Dialog Main Tab


Box

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

For information about plotting, see “Create Plots”.

Examples See the LC Bandpass Pi block for an example of an LC filter.

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.

See Also General Passive Network, LC Bandpass Pi, LC Bandpass Tee, LC


Bandstop Pi, LC Bandstop Tee, LC Highpass Pi, LC Highpass Tee, LC
Lowpass Pi, Series C, Series L, Series R, Series RLC, Shunt C, Shunt L,
Shunt R, Shunt RLC

2-120
Lowpass RF Filter

Purpose Standard lowpass RF filters in baseband-equivalent complex form

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.

Design Method Description


Butterworth The magnitude response of a Butterworth
filter is maximally flat in the passband and
monotonic overall.
Chebyshev I The magnitude response of a Chebyshev I filter
is equiripple in the passband and monotonic in
the stopband.
Chebyshev II The magnitude response of a Chebyshev II
filter is monotonic in the passband and
equiripple in the stopband.
Elliptic The magnitude response of an elliptic filter
is equiripple in both the passband and the
stopband.
Bessel The delay of a Bessel filter is maximally flat in
the passband.

The block input must be a discrete-time complex signal.

Note This block assumes a nominal impedance of 1 ohm.

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.

Design Method Filter Design Parameters


Butterworth Order, passband edge frequency
Chebyshev I Order, passband edge frequency, passband
ripple
Chebyshev II Order, stopband edge frequency, stopband
attenuation
Elliptic Order, passband edge frequency, passband
ripple, stopband attenuation
Bessel Order, passband edge frequency

The Lowpass RF Filter block designs the filters using the Signal
Processing Toolbox filter design functions buttap, cheb1ap, cheb2ap,
ellipap, and besselap.

Note Some RF blocks require the sample time to perform baseband


modeling calculations. To ensure the accuracy of these calculations, the
Input Port block, as well as the mathematical RF blocks, compare the
input sample time to the sample time you provide in the mask. If they
do not match, or if the input sample time is missing because the blocks
are not connected, an error message appears.

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.

See Also Amplifier, Bandpass RF Filter, Bandstop RF Filter, Highpass RF


Filter, Mixer
buttap, cheb1ap, cheb2ap, ellipap, besselap (Signal Processing
Toolbox)

2-124
Microstrip Transmission Line

Purpose Model microstrip transmission line

Library Transmission Lines sublibrary of the Physical library

Description The Microstrip Transmission Line block models the microstrip


transmission line described in the block dialog in terms of its
frequency-dependent S-parameters. 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 (ε).

The block lets you model the transmission line as a stub or as a stubless
line.

Stubless Transmission Line


If you model a microstrip transmission line as a stubless line,
the Microstrip Transmission Line block first calculates the
ABCD-parameters at each frequency contained in the modeling
frequencies vector. It then uses the abcd2s function to convert the
ABCD-parameters to S-parameters.
The block calculates the ABCD-parameters using the physical length
of the transmission line, d, and the complex propagation constant, k,
using the following equations:

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

Z0 and k are vectors whose elements correspond to the elements of f,


a vector of modeling frequencies. Both can be expressed in terms of
the specified conductor strip width, substrate height, conductor strip
thickness, relative permittivity constant, conductivity, and dielectric
loss tangent of the microstrip line, as described in [1].

Shunt and Series Stubs


If you model the transmission line as a shunt or series stub,
the Microstrip Transmission Line block first calculates the
ABCD-parameters at each frequency contained in the vector of
modeling frequencies. It then uses the abcd2s function to convert the
ABCD-parameters to S-parameters.

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

Zin is the input impedance of the shunt circuit. The ABCD-parameters


for the shunt stub are calculated as

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.

Zin is the input impedance of the series circuit. The ABCD-parameters


for the series stub are calculated as

2-127
Microstrip Transmission Line

A =1
B = Zin
C=0
D =1

Dialog Main Tab


Box

Strip width (m)


Width of the microstrip transmission line.
Substrate height (m)
Thickness of the dielectric on which the microstrip resides.
Strip thickness (m)
Physical thickness of the microstrip.
Relative permittivity constant
Relative permittivity of the dielectric expressed as the ratio of the
permittivity of the dielectric to permittivity in free space ε0.

2-128
Microstrip Transmission Line

Loss tangent in dielectric


Loss angle tangent of the dielectric.
Conductivity in conductor (S/m)
Conductivity of the conductor in siemens per meter.
Transmission line length (m)
Physical length of the transmission line.
Stub mode
Type of stub. 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

For information about plotting, see “Create Plots”.

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.

See Also Coaxial Transmission Line, Coplanar Waveguide Transmission


Line, General Passive Network, Transmission Line, Parallel-Plate
Transmission Line, Two-Wire Transmission Line

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

The Mixer block includes both the IF and RF signals as


complex-baseband equivalent signals. Both the IF and RF center
frequencies are represented as 0 hertz. The amplitude of the noise
spectrum is specified by the noise power contained in a 1-hertz
bandwidth offset from the carrier by a specified frequency.

Note This block assumes a nominal impedance of 1 ohm.

The block applies the phase noise to the signal as follows:

1 Generates additive white Gaussian noise (AWGN) and filters it with


a digital filter.

2 Adds the resulting phase noise to the angle component of the input
signal.

You can view the block’s implementation of phase noise by right-clicking


the block and selecting Look under mask from the pop-up menu. The
following figure shows the implementation.

2-131
Mixer (Idealized Baseband)

You can view the construction of the Noise Source subsystem by


double-clicking it.

Dialog
Box

You can change parameters that are marked as tunable in the following
descriptions while the model is running.

Conversion gain (dB)


Scalar specifying the conversion gain for the mixer. Use a
negative value to specify loss. Tunable.

2-132
Mixer (Idealized Baseband)

Phase noise level (dBc/Hz)


Scalar specifying the phase noise level in decibels relative to the
carrier, per hertz. Tunable.
Frequency offset (Hz)
Scalar specifying the frequency offset. Tunable.
Initial seed
Nonnegative integer specifying the initial seed for the random
number generator the block uses to generate noise.

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.

See Also Amplifier, Bandpass RF Filter, Bandstop RF Filter, Highpass RF Filter,


Lowpass RF Filter

2-133
Output Port

Purpose Connection block from RF physical blocks to Simulink environment

Library Input/Output Ports sublibrary of the Physical library

Description The Output Port block produces the baseband-equivalent time-domain


response of an input signal traveling through a series of RF physical
components. The Output Port block

1 Partitions the RF physical components into linear and nonlinear


subsystems.

2 Extracts the complex impulse response of the linear subsystem for


baseband-equivalent modeling of the RF linear system.

3 Extracts the nonlinear AMAM/AMPM modeling for RF nonlinearity.

The Output Port block also serves as a connecting port from an RF


physical part of the model to the Simulink, or mathematical, part of the
model. For more information about how the Output Port block converts
the physical modeling environment signals to mathematical Simulink
signals, see “Convert to and from Simulink Signals”.

Note Some RF blocks require the sample time to perform baseband


modeling calculations. To ensure the accuracy of these calculations, the
Input Port block, as well as the mathematical RF blocks, compare the
input sample time to the sample time you provide in the mask. If they
do not match, or if the input sample time is missing because the blocks
are not connected, an error message appears.

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

1 Determines the modeling frequencies f as an N-element vector. The


modeling frequencies are a function of the center frequency fc, the
sample time ts, and the finite impulse response filter length N, all of
which you specify in the Input Port block dialog box.

The nth element of f, fn, is given by

n −1
fn = fmin + n = 1,..., N
ts N

where

1
fmin = fc −
2ts

2 Calculates the passband transfer function for the frequency range as

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

Passband Spectrum of a Modulated RF Carrier

N is the number of sub-bands

Input Port Block Parameters


Df = 1/(ts*N)

Magnitude

fc

Frequency
fmin fn fmax

Bandwidth = 1/ts

3 Translates the passband transfer function to baseband as H(f – fc),


where fc is the specified center frequency.

The baseband transfer function is shown in the following figure.

2-137
Output Port

Baseband-Equivalent Spectrum

Magnitude

Centered at zero

Frequency
-1/2ts 0 1/2ts

1/ts

4 Obtains the baseband-equivalent impulse response by calculating the


inverse FFT of the baseband transfer function. For faster simulation,
the block calculates the IFFT using the next power of 2 greater than
the specified finite impulse response filter length. Then, it truncates
the impulse response to a length equal to the filter length specified.

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

The nonlinearities of AM/AM and AM/PM conversions are extracted


from the power data of an amplifier or mixer by the equations

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.

The following figure shows the original power data of an amplifier.

2-139
Output Port

This figure shows the extracted AM/AM nonlinear conversion.

2-140
Output Port

Dialog Main Tab


Box

Load impedance (ohms)


Load impedance of the RF network described in the physical
model to which it connects.

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.

For information about plotting, see “Create Plots”.

See Also Input Port


s2y (RF Toolbox)

2-142
Parallel-Plate Transmission Line

Purpose Model parallel-plate transmission line

Library Transmission Lines sublibrary of the Physical library

Description The Parallel-Plate Transmission Line block models the parallel-plate


transmission line described in the block dialog box in terms of its
frequency-dependent S-parameters. 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.

The block lets you model the transmission line as a stub or as a stubless
line.

Stubless Transmission Line


If you model a parallel-plate transmission line as a stubless line,
the Parallel-Plate Transmission Line block first calculates the
ABCD-parameters at each frequency contained in the modeling
frequencies vector. It then uses the abcd2s function to convert the
ABCD-parameters to S-parameters.
The block calculates the ABCD-parameters using the physical length
of the transmission line, d, and the complex propagation constant, k,
using the following equations:

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

Z0 and k are vectors whose elements correspond to the elements of f, a


vector of modeling frequencies. Both can be expressed in terms of the
resistance (R), inductance (L), conductance (G), and capacitance (C)
per unit length (meters) as follows:

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:

• σcond is the conductivity in the conductor.


• μ is the permeability of the dielectric.

2-144
Parallel-Plate Transmission Line

• ε 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 modeling frequencies determined by the Output Port
block.

Shunt and Series Stubs


If you model the transmission line as a shunt or series stub,
the Parallel-Plate Transmission Line block first calculates the
ABCD-parameters at each frequency contained in the vector of
modeling frequencies. It then uses the abcd2s function to convert the
ABCD-parameters to S-parameters.

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.

Zin is the input impedance of the shunt circuit. The ABCD-parameters


for the shunt stub are calculated as

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.

Zin is the input impedance of the series circuit. The ABCD-parameters


for the series stub are calculated as

A =1
B = Zin
C=0
D =1

2-146
Parallel-Plate Transmission Line

Dialog Main Tab


Box

Plate width (m)


Physical width of the parallel-plate transmission line.
Plate separation (m)
Thickness of the dielectric separating the plates.
Relative permeability constant
Relative permeability of the dielectric expressed as the ratio of the
permeability of the dielectric to permeability in free space μ0.
Relative permittivity constant
Relative permittivity of the dielectric expressed as the ratio of the
permittivity of the dielectric to permittivity in free space ε0.
Loss tangent of dielectric
Loss angle tangent of the dielectric.
Conductivity of conductor (S/m)
Conductivity of the conductor in siemens per meter.

2-147
Parallel-Plate Transmission Line

Transmission line length (m)


Physical length of the transmission line.
Stub mode
Type of stub. 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

For information about plotting, see “Create Plots”.

References [1] Pozar, David M. Microwave Engineering, John Wiley & Sons, Inc.,
2005.

2-148
Parallel-Plate Transmission Line

See Also Coaxial Transmission Line, Coplanar Waveguide Transmission Line,


General Passive Network, Transmission Line, Microstrip Transmission
Line, Two-Wire Transmission Line

2-149
RLCG Transmission Line

Purpose Model RLCG transmission line

Library Transmission Lines sublibrary of the Physical library

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.

Stubless Transmission Line


If you model an RLCG transmission line as a stubless line, the RLCG
Transmission Line block first calculates the ABCD-parameters at each
frequency contained in the modeling frequencies vector. It then uses
the abcd2s function to convert the ABCD-parameters to S-parameters.
The block calculates the ABCD-parameters using the physical length
of the transmission line, d, and the complex propagation constant, k,
using the following equations:

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

Z0 and k are vectors whose elements correspond to the elements of f, a


vector of modeling frequencies. Both can be expressed in terms of the
resistance (R), inductance (L), conductance (G), and capacitance (C)
per unit length (meters) as follows:

R + j ωL
Z0 =
G + j ωC
k = kr + jki = ( R + jωL)(G + jωC)

Shunt and Series Stubs


If you model the transmission line as a shunt or series stub, the RLCG
Transmission Line block first calculates the ABCD-parameters at each
frequency contained in the vector of modeling frequencies. It then uses
the abcd2s function to convert the ABCD-parameters to S-parameters.

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

Zin is the input impedance of the shunt circuit. The ABCD-parameters


for the shunt stub are calculated as

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.

Zin is the input impedance of the series circuit. The ABCD-parameters


for the series stub are calculated as

2-152
RLCG Transmission Line

A =1
B = Zin
C=0
D =1

Dialog Main Tab


Box

Resistance per length (ohms/m)


Vector of resistance values in ohms per meter.
Inductance per length (H/m)
Vector of inductance values in henries per meter.
Capacitance per length (F/m)
Vector of capacitance values in farads per meter.
Conductance per length (S/m)
Vector of conductance values in siemens per meter.
Frequency (Hz)
Vector of frequency values at which the resistance, inductance,
capacitance, and conductance values are known.

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

For information about plotting, see “Create Plots”.

2-154
RLCG Transmission Line

References [1] Pozar, David M. Microwave Engineering, John Wiley & Sons, Inc.,
2005.

See Also Coaxial Transmission Line, Coplanar Waveguide Transmission


Line, General Passive Network, Parallel-Plate Transmission Line,
Transmission Line, Microstrip Transmission Line, Two-Wire
Transmission Line

2-155
S-Parameters Amplifier

Purpose Model nonlinear amplifier using S-parameters

Library Amplifiers sublibrary of the Physical library

Description The S-Parameters Amplifier block models the nonlinear amplifier


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, and nonlinearity data.

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.

The S-Parameters Amplifier block interpolates the given S-parameters


to determine their values at the modeling frequencies. See “SimRF
Equivalent Baseband Algorithms” for more details.

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

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

• The output power at the 1-dB compression point ( P1dB,out ).

• The output power at saturation ( Psat,out ).


In addition, if you have specified Psat,out , the block uses the value for
the gain compression at saturation ( GCsat ). Otherwise, GCsat is not
used. You define each of these parameters in the block dialog box,
on the Nonlinearity Data tab.

2 The block calculates a corresponding input or output value for the


parameters you have specified. In units of dB and dBm,

Psat,out + GCsat = Psat,in + Glin


P1dB,out + 1 = P1dB,in + Glin
OIP 3 = IIP 3 + Glin

where Glin is c1 in units of dB.

2-157
S-Parameters Amplifier

3 The block formulates the coefficients c3 , c5 , and c7 , where


applicable, as the solutions to a system of one, two, or three linear
equations. The number of equations used is equal to the number
of parameters you provide. For example, if you specify all three
parameters, the block formulates the coefficients according to the
following equations:

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

FAM / AM (s) at the points ( Psat,in , Psat,out ) and

( P1dB,in , P1dB,out ) , expressed in linear units (such as W


or mW) and normalized to a 1-Ω impedance. The third equation is
the definition of the third-order intercept point.

The calculation omits higher-order terms according to the available


degrees of freedom of the system. If you specify only two of the
three parameters, the block does not use the equation involving the
parameter you did not specify, and eliminates any c7 terms from
the remaining equations. Similarly, if you provide only one of the
parameters, the block uses only the solution to the equation involving
that parameter and omits any c5 or c7 terms.

If you provide vectors of nonlinearity and frequency data, the block


calculates the polynomial coefficients using values for the parameters
interpolated at the center frequency.

Active Noise
You can specify active block noise in one of the following ways:

2-158
S-Parameters Amplifier

• Spot noise data in the S-Parameters Amplifier block dialog box.


• Noise figure, noise factor, or noise temperature value in the
S-Parameters Amplifier block dialog box.

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.

Dialog Main Tab


Box

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 Data Tab

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

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.
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-162
S-Parameters Amplifier

Nonlinearity Data Tab

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

(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

For information about plotting, see “Create Plots”.

2-165
S-Parameters Amplifier

Examples Plotting Parameters with the S-Parameters Amplifier Block


The following example specifies S-parameters [-.33+.71i, -.03i; 8.12-.02i,
-.37-.37i] and [0.16+.20i, -.03-.04i; 7.71-8.04i, -.70-.12i] at frequencies
2.0 GHz and 2.1 GHz respectively, with a reference impedance of 50
ohms. The example uses the MATLAB cat function to create the
2-by-2-by-2 S-parameters array.

cat(3,[-.33+0.71i, -.03i; 8.12-.02i, -.37-.37i],...


[ .16+0.20i, -.03-.04i; 7.71-8.04i, -.70-.12i])

1 Type the following command at the MATLAB prompt to create a


variable called sparams that stores the values of the S-parameters.

sparams = cat(3,...
[-.33+0.71i, -.03i; 8.12-.02i, -.37-.37i],...
[ .16+0.20i, -.03-.04i; 7.71-8.04i, -.70-.12i])

2 Set the S-Parameters Amplifier block parameters on the Main tab


as follows:
• Set the S-Parameters parameter to sparams.
• Set the Frequency (Hz) parameter to [2.0e9,2.1e9].

Click Apply. This action applies the specified settings.

2-166
S-Parameters Amplifier

3 Set the S-Parameters Amplifier block parameters on the


Visualization tab as follows:
• In the Plot type list, select X-Y plane.
• In the Y parameter1 list, select S11.

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

See Also General Amplifier, Output Port, Y-Parameters Amplifier, Z-Parameters


Amplifier
interp1 (MATLAB)

2-169
S-Parameters Mixer

Purpose Model mixer and local oscillator using S-parameters

Library Mixer sublibrary of the Physical library

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

⎡ b1 ( fin ) ⎤ ⎡ S11 S12 ⎤ ⎡ a1 ( fin ) ⎤


⎢b ( f ) ⎥ = ⎢ S S22 ⎥⎦ ⎢⎣ a2 ( fout ) ⎥⎦
⎣ 2 out ⎦ ⎣ 21

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.

The interpolated S21 parameter values describe the conversion gain as a


function of frequency, referred to the mixer input frequency.

2-170
S-Parameters Mixer

Active Noise
You can specify active block noise in one of the following ways:

• Spot noise data in the S-Parameters Mixer block dialog box.


• Noise figure, noise factor, or noise temperature value in the
S-Parameters Mixer block dialog box.

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:

1 Interpolating the specified phase noise level to determine the phase


noise values at the modeling frequencies.

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

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

• The output power at the 1-dB compression point ( P1dB,out ).

• The output power at saturation ( Psat,out ).


In addition, if you have specified Psat,out , the block uses the value for
the gain compression at saturation ( GCsat ). Otherwise, GCsat is not
used. You define each of these parameters in the block dialog box,
on the Nonlinearity Data tab.

2 The block calculates a corresponding input or output value for the


parameters you have specified. In units of dB and dBm,

Psat,out + GCsat = Psat,in + Glin


P1dB,out + 1 = P1dB,in + Glin
OIP 3 = IIP 3 + Glin

where Glin is c1 in units of dB.

2-172
S-Parameters Mixer

3 The block formulates the coefficients c3 , c5 , and c7 , where


applicable, as the solutions to a system of one, two, or three linear
equations. The number of equations used is equal to the number
of parameters you provide. For example, if you specify all three
parameters, the block formulates the coefficients according to the
following equations:

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

FAM / AM (s) at the points ( Psat,in , Psat,out ) and

( P1dB,in , P1dB,out ) , expressed in linear units (such as W


or mW) and normalized to a 1-Ω impedance. The third equation is
the definition of the third-order intercept point.

The calculation omits higher-order terms according to the available


degrees of freedom of the system. If you specify only two of the
three parameters, the block does not use the equation involving the
parameter you did not specify, and eliminates any c7 terms from
the remaining equations. Similarly, if you provide only one of the
parameters, the block uses only the solution to the equation involving
that parameter and omits any c5 or c7 terms.

If you provide vectors of nonlinearity and frequency data, the block


calculates the polynomial coefficients using values for the parameters
interpolated at the center frequency.

2-173
S-Parameters Mixer

Dialog Main Tab


Box

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

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

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

Note For a downconverting mixer, the local oscillator frequency


must satisfy the condition fin – flo ≥ 1/(2ts), where ts is the sample
time specified in the Input Port block. Otherwise, an error
appears.

Noise Data Tab

2-176
S-Parameters Mixer

Phase noise frequency offset (Hz)


Vector specifying the frequency offset.
Phase noise level (dBc/Hz)
Vector specifying the phase noise level.
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.

2-177
S-Parameters Mixer

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.
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-178
S-Parameters Mixer

Nonlinearity Data Tab

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

(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

For information about plotting, see “Create Plots”.

2-181
S-Parameters Mixer

See Also General Mixer, Output Port, Y-Parameters Mixer, Z-Parameters Mixer

2-182
S-Parameters Passive Network

Purpose Model passive network using S-parameters

Library Black Box Elements sublibrary of the Physical library

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.

The S-Parameters Passive Network block interpolates the given


S-parameters to determine their values at the modeling frequencies.
The modeling frequencies are determined by the Output Port block. See
“SimRF Equivalent Baseband Algorithms” for more details.

2-183
S-Parameters Passive Network

Dialog Main Tab


Box

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

For information about plotting, see “Create Plots”.

2-185
S-Parameters Passive Network

Examples Plotting Parameters with the S-Parameters Passive Network


Block
The following example specifies S-parameters [-.96-.23i, .03-.12i;
.03-.12i, -.96-.23i] and [-.96-.11i, .02-.21i; .02-.21i, -.96-.11i] at
frequencies 2.0 GHz and 2.1 GHz respectively. The example then plots
these parameters.
The example first uses the MATLAB cat function to create the
2-by-2-by-2 S-parameters array.

cat(3,[-.96-.23i, .03-.12i; .03-.12i, -.96-.23i],...


[-.96-.11i, .02-.21i; .02-.21i, -.96-.11i])

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)

1 Type the following command at the MATLAB prompt to create a


variable called sparams that stores the values of the S-parameters.

sparams = cat(3,...
[-.96-.23i, .03-.12i; .03-.12i, -.96-.23i],...
[-.96-.11i, .02-.21i; .02-.21i, -.96-.11i])

2 Set the S-Parameters Passive Network block parameters on the


Main tab as follows:
• Set the S-Parameters parameter to sparams.
• Set the Frequency (Hz) parameter to [2.0e9,2.1e9].

Click Apply. This action applies the specified settings.

2-186
S-Parameters Passive Network

3 Set the S-Parameters Passive Network block parameters on the


Visualization tab as follows:
• In the Source of frequency data list, select User-specified.
• Set the Frequency data (Hz) parameter to
[1.9e9:1.0e8:2.2e9].
• In the Y parameter1 list, select S21.

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

Purpose Model series capacitor

Library Ladders Filters sublibrary of the Physical library

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.

Dialog Main Tab


Box

2-190
Series C

Capacitance (F)
Scalar value for the capacitance. The value must be nonnegative.

Visualization Tab

For information about plotting, see “Create Plots”.

See Also General Passive Network, LC Bandpass Pi, LC Bandpass Tee, LC


Bandstop Pi, LC Bandstop Tee, LC Highpass Pi, LC Highpass Tee, LC
Lowpass Pi, LC Lowpass Tee, Series L, Series R, Series RLC, Shunt
C, Shunt L, Shunt R, Shunt RLC

2-191
Series L

Purpose Model series inductor

Library Ladders Filters sublibrary of the Physical library

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.

Dialog Main Tab


Box

2-192
Series L

Inductance (H)
Scalar value for the inductance. The value must be nonnegative.

Visualization Tab

For information about plotting, see “Create Plots”.

See Also General Passive Network, LC Bandpass Pi, LC Bandpass Tee, LC


Bandstop Pi, LC Bandstop Tee, LC Highpass Pi, LC Highpass Tee, LC
Lowpass Pi, LC Lowpass Tee, Series C, Series R, Series RLC, Shunt
C, Shunt L, Shunt R, Shunt RLC

2-193
Series R

Purpose Model series resistor

Library Ladders Filters sublibrary of the Physical library

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.

Dialog Main Tab


Box

2-194
Series R

Resistance (ohms)
Scalar value for the resistance. The value must be nonnegative.

Visualization Tab

For information about plotting, see “Create Plots”.

See Also General Passive Network, LC Bandpass Pi, LC Bandpass Tee, LC


Bandstop Pi, LC Bandstop Tee, LC Highpass Pi, LC Highpass Tee, LC
Lowpass Pi, LC Lowpass Tee, Series C, Series L, Series RLC, Shunt
C, Shunt L, Shunt R, Shunt RLC

2-195
Series RLC

Purpose Model series RLC network

Library Ladders Filters sublibrary of the Physical library

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

Dialog Main Tab


Box

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

For information about plotting, see “Create Plots”.

See Also General Passive Network, LC Bandpass Pi, LC Bandpass Tee, LC


Bandstop Pi, LC Bandstop Tee, LC Highpass Pi, LC Highpass Tee,
LC Lowpass Pi, LC Lowpass Tee, Series C, Series L, Series R, Shunt
C, Shunt L, Shunt R, Shunt RLC

2-198
Shunt C

Purpose Model shunt capacitor

Library Ladders Filters sublibrary of the Physical library

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.

Dialog Main Tab


Box

2-199
Shunt C

Capacitance (F)
Scalar value for the capacitance. The value must be nonnegative.

Visualization Tab

For information about plotting, see “Create Plots”.

See Also General Passive Network, LC Bandpass Pi, LC Bandpass Tee, LC


Bandstop Pi, LC Bandstop Tee, LC Highpass Pi, LC Highpass Tee,
LC Lowpass Pi, LC Lowpass Tee, Series C, Series L, Series R, Series
RLC, Shunt L, Shunt R, Shunt RLC

2-200
Shunt L

Purpose Model shunt inductor

Library Ladders Filters sublibrary of the Physical library

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.

Dialog Main Tab


Box

2-201
Shunt L

Inductance (H)
Scalar value for the inductance. The value must be nonnegative.

Visualization Tab

For information about plotting, see “Create Plots”.

See Also General Passive Network, LC Bandpass Pi, LC Bandpass Tee, LC


Bandstop Pi, LC Bandstop Tee, LC Highpass Pi, LC Highpass Tee,
LC Lowpass Pi, LC Lowpass Tee, Series C, Series L, Series R, Series
RLC, Shunt C, Shunt R, Shunt RLC

2-202
Shunt R

Purpose Model shunt resistor

Library Ladders Filters sublibrary of the Physical library

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.

Dialog Main Tab


Box

2-203
Shunt R

Resistance (ohms)
Scalar value for the resistance. The value must be nonnegative.

Visualization Tab

For information about plotting, see “Create Plots”.

See Also General Passive Network, LC Bandpass Pi, LC Bandpass Tee, LC


Bandstop Pi, LC Bandstop Tee, LC Highpass Pi, LC Highpass Tee,
LC Lowpass Pi, LC Lowpass Tee, Series C, Series L, Series R, Series
RLC, Shunt C, Shunt L, Shunt RLC

2-204
Shunt RLC

Purpose Model shunt RLC network

Library Ladders Filters sublibrary of the Physical library

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

Dialog Main Tab


Box

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

For information about plotting, see “Create Plots”.

See Also General Passive Network, LC Bandpass Pi, LC Bandpass Tee, LC


Bandstop Pi, LC Bandstop Tee, LC Highpass Pi, LC Highpass Tee,
LC Lowpass Pi, LC Lowpass Tee, Series C, Series L, Series R, Series
RLC, Shunt C, Shunt L, Shunt R

2-207
Transmission Line (Equivalent Baseband)

Purpose Model general transmission line

Library Transmission Lines sublibrary of the Physical library

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.

Stubless Transmission Line


If you model the transmission line as a stubless line, the Transmission
Line block first calculates the ABCD-parameters at each frequency
contained in the modeling frequencies vector. It then uses the abcd2s
function to convert the ABCD-parameters to S-parameters.
The block calculates the ABCD-parameters using the physical length
of the transmission line, d, and the complex propagation constant, k,
using the following equations:

ekd + e− kd
A=
2

B=
(
Z0 * ekd − e− kd )
2
kd − kd
e −e
C=
2 * Z0
ekd + e− kd
D=
2

Z0 is the specified characteristic impedance. k is a vector whose


elements correspond to the elements of the input vector freq. The block
calculates k from the specified parameters as k = αa + iβ, where αa is

2-208
Transmission Line (Equivalent Baseband)

the attenuation coefficient and β is the wave number. The attenuation


coefficient αa is related to the specified loss, α, by

 a = − ln (10 / 20 )

The wave number β is related to the specified phase velocity, Vp, by

2 f
 =
Vp

The phase velocity VP is also known as the wave propagation velocity.

Shunt and Series Stubs


If you model the transmission line as a shunt or series stub, the
Transmission Line block first calculates the ABCD-parameters at each
frequency contained in the vector of modeling frequencies. It then uses
the abcd2s function to convert the ABCD-parameters to S-parameters.

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.

Zin is the input impedance of the shunt circuit. The ABCD-parameters


for the shunt stub are calculated as

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.

Zin is the input impedance of the series circuit. The ABCD-parameters


for the series stub are calculated as

A =1
B = Zin
C=0
D =1

2-210
Transmission Line (Equivalent Baseband)

Dialog Main Tab


Box

Characteristic impedance (ohms)


Characteristic impedance of the transmission line. The value can
be complex.
Phase velocity (m/s)
Propagation velocity of a uniform plane wave on the transmission
line.
Loss (dB/m)
Reduction in strength of the signal as it travels over the
transmission line. Must be positive.
Frequency (Hz)
Vector of modeling frequencies. The block performs the
calculations listed in the Description section at each frequency
you provide.

2-211
Transmission Line (Equivalent Baseband)

Transmission line length (m)


Physical length of the transmission line.
Stub mode
Type of stub. 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

For information about plotting, see “Create Plots”.

References [1] Ludwig, Reinhold and Pavel Bretchko, RF Circuit Design: Theory
and Applications, Prentice-Hall, 2000.

2-212
Transmission Line (Equivalent Baseband)

See Also Coaxial Transmission Line, Coplanar Waveguide Transmission Line,


General Passive Network, Microstrip Transmission Line, Parallel-Plate
Transmission Line, Two-Wire Transmission Line

2-213
Two-Wire Transmission Line

Purpose Model two-wire transmission line

Library Transmission Lines sublibrary of the Physical library

Description The Two-Wire Transmission Line block models the two-wire


transmission line described in the block dialog box in terms of
its frequency-dependent S-parameters. 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. SimRF Equivalent
Baseband software assumes the relative permittivity and permeability
are uniform.

Wires

a
Dielectric

The block enables you to model the transmission line as a stub or as


a stubless line.

Stubless Transmission Line


If you model a two-wire transmission line as a stubless line,
the Two-Wire Transmission Line block first calculates the
ABCD-parameters at each frequency contained in the modeling
frequencies vector. It then uses the abcd2s function to convert the
ABCD-parameters to S-parameters.

2-214
Two-Wire Transmission Line

The block calculates the ABCD-parameters using the physical length


of the transmission line, d, and the complex propagation constant, k,
using the following equations:

ekd + e− kd
A=
2

B=
(
Z0 * ekd − e− kd )
2
kd − kd
e −e
C=
2 * Z0
ekd + e− kd
D=
2

Z0 and k are vectors whose elements correspond to the elements of f, a


vector of modeling frequencies. Both can be expressed in terms of the
resistance (R), inductance (L), conductance (G), and capacitance (C)
per unit length (meters) as follows:

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:

• σ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 modeling frequencies determined by the Output Port
block.

Shunt and Series Stubs


If you model the transmission line as a shunt or series stub,
the Two-Wire Transmission Line block first calculates the
ABCD-parameters at each frequency contained in the vector of

2-216
Two-Wire Transmission Line

modeling frequencies. It then uses the abcd2s function to convert the


ABCD-parameters to S-parameters.

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.

Zin is the input impedance of the shunt circuit. The ABCD-parameters


for the shunt stub are calculated as

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

Zin is the input impedance of the series circuit. The ABCD-parameters


for the series stub are calculated as

A =1
B = Zin
C=0
D =1

Dialog Main Tab


Box

2-218
Two-Wire Transmission Line

Wire radius (m)


Radius of the conducting wires of the two-wire transmission line.
Wire separation (m)
Physical distance between the wires.
Relative permeability constant
Relative permeability of the dielectric expressed as the ratio of the
permeability of the dielectric to permeability in free space μ0.
Relative permittivity constant
Relative permittivity of the dielectric expressed as the ratio of the
permittivity of the dielectric to permittivity in free space ε0.
Loss tangent of dielectric
Loss angle tangent of the dielectric.
Conductivity of conductor (S/m)
Conductivity of the conductor in siemens per meter.
Transmission line length (m)
Physical length of the transmission line.
Stub mode
Type of stub. 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.

2-219
Two-Wire Transmission Line

Visualization Tab

For information about plotting, see “Create Plots”.

References [1] Pozar, David M. Microwave Engineering, John Wiley & Sons, Inc.,
2005.

See Also Coaxial Transmission Line, Coplanar Waveguide Transmission Line,


General Passive Network, Transmission Line, Microstrip Transmission
Line, Parallel-Plate Transmission Line

2-220
Y-Parameters Amplifier

Purpose Model nonlinear amplifier using Y-parameters

Library Amplifiers sublibrary of the Physical library

Description The Y-Parameters Amplifier block models the nonlinear amplifier


described in the block dialog box, in terms of its frequency-dependent,
the frequencies of the Y-parameters, noise data, and nonlinearity data
Network Parameters
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 frequencies 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.

The Y-Parameters Amplifier 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.
Nonlinearity
You can introduce nonlinearities into your model by specifying
parameters in the Nonlinearity Data tab of the Y-Parameters

2-221
Y-Parameters Amplifier

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

• The output power at the 1-dB compression point ( P1dB,out ).

• The output power at saturation ( Psat,out ).


In addition, if you have specified Psat,out , the block uses the value for
the gain compression at saturation ( GCsat ). Otherwise, GCsat is not
used. You define each of these parameters in the block dialog box,
on the Nonlinearity Data tab.

2 The block calculates a corresponding input or output value for the


parameters you have specified. In units of dB and dBm,

Psat,out + GCsat = Psat,in + Glin


P1dB,out + 1 = P1dB,in + Glin
OIP 3 = IIP 3 + Glin

where Glin is c1 in units of dB.

2-222
Y-Parameters Amplifier

3 The block formulates the coefficients c3 , c5 , and c7 , where


applicable, as the solutions to a system of one, two, or three linear
equations. The number of equations used is equal to the number
of parameters you provide. For example, if you specify all three
parameters, the block formulates the coefficients according to the
following equations:

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

FAM / AM (s) at the points ( Psat,in , Psat,out ) and

( P1dB,in , P1dB,out ) , expressed in linear units (such as W


or mW) and normalized to a 1-Ω impedance. The third equation is
the definition of the third-order intercept point.

The calculation omits higher-order terms according to the available


degrees of freedom of the system. If you specify only two of the
three parameters, the block does not use the equation involving the
parameter you did not specify, and eliminates any c7 terms from
the remaining equations. Similarly, if you provide only one of the
parameters, the block uses only the solution to the equation involving
that parameter and omits any c5 or c7 terms.

If you provide vectors of nonlinearity and frequency data, the block


calculates the polynomial coefficients using values for the parameters
interpolated at the center frequency.

Active Noise
You can specify active block noise in one of the following ways:

2-223
Y-Parameters Amplifier

• Spot noise data in the Y-Parameters Amplifier block dialog box.


• Noise figure, noise factor, or noise temperature value in the
Y-Parameters Amplifier block dialog box.

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.

Dialog Main Tab


Box

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 Data Tab

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

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.
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-227
Y-Parameters Amplifier

Nonlinearity Data Tab

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

(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

For information about plotting, see “Create Plots”.

2-230
Y-Parameters Amplifier

Examples Plotting Parameters with the Y-Parameters Amplifier Block


The following example specifies Y-parameters [-.06+.58i, -.08i;
1.14-1.82i, -.07+.28i] and [.02-.21i, 0.03i; -.21+.72i, .03-.11i] at
frequencies 2.0 GHz and 2.1 GHz respectively. It uses the MATLAB cat
function to create the 2-by-2-by-2 Y-parameters array

cat(3,[-.06+.58i, -.08i; 1.14-1.82i, -.07+.28i],...


[ .02-.21i, 0.03i; -.21+.72i, .03-.11i])

1 Type the following command at the MATLAB prompt to create a


variable called yparams that stores the values of the Y-parameters.

yparams = cat(3,...
[-.06+.58i, -.08i; 1.14-1.82i, -.07+.28i],...
[ .02-.21i, 0.03i; -.21+.72i, .03-.11i])

2 Set the Y-Parameters Amplifier block parameters on the Main tab


as follows:
• Set the Y-Parameters parameter to yparams.
• Set the Frequency (Hz) parameter to [2.0e9,2.1e9].

Click Apply. This action applies the specified settings.

2-231
Y-Parameters Amplifier

3 Set the Y-Parameters Amplifier block parameters on the


Visualization tab as follows:
• In the Source of frequency data list, select User-specified.
• Set the Frequency data (Hz) parameter to
[1.8e9:1.0e8:2.3e9].
• In the Plot type list, select X-Y plane.
• In the Y parameter1 list, select S11.

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

See Also General Amplifier, Output Port, S-Parameters Amplifier, Z-Parameters


Amplifier
y2s (RF Toolbox)
interp1 (MATLAB)

2-234
Y-Parameters Mixer

Purpose Model mixer and local oscillator using Y-parameters

Library Mixer sublibrary of the Physical library

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

⎡ b1 ( fin ) ⎤ ⎡ S11 S12 ⎤ ⎡ a1 ( fin ) ⎤


⎢b ( f ) ⎥ = ⎢ S S22 ⎥⎦ ⎢⎣ a2 ( fout ) ⎥⎦
⎣ 2 out ⎦ ⎣ 21

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.

The interpolated S21 parameter values describe the conversion gain as a


function of frequency, referred to the mixer input frequency.
Active Noise
You can specify active block noise in one of the following ways:

2-235
Y-Parameters Mixer

• Spot noise data in the Y-Parameters Mixer block dialog box.


• Noise figure, noise factor, or noise temperature value in the
Y-Parameters Mixer block dialog box.

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:

1 Interpolating the specified phase noise level to determine the phase


noise values at the modeling frequencies.

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

• The output power at the 1-dB compression point ( P1dB,out ).

• The output power at saturation ( Psat,out ).


In addition, if you have specified Psat,out , the block uses the value for
the gain compression at saturation ( GCsat ). Otherwise, GCsat is not
used. You define each of these parameters in the block dialog box,
on the Nonlinearity Data tab.

2 The block calculates a corresponding input or output value for the


parameters you have specified. In units of dB and dBm,

Psat,out + GCsat = Psat,in + Glin


P1dB,out + 1 = P1dB,in + Glin
OIP 3 = IIP 3 + Glin

where Glin is c1 in units of dB.

3 The block formulates the coefficients c3 , c5 , and c7 , where


applicable, as the solutions to a system of one, two, or three linear
equations. The number of equations used is equal to the number
of parameters you provide. For example, if you specify all three

2-237
Y-Parameters Mixer

parameters, the block formulates the coefficients according to the


following equations:

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

FAM / AM (s) at the points ( Psat,in , Psat,out ) and

( P1dB,in , P1dB,out ) , expressed in linear units (such as W


or mW) and normalized to a 1-Ω impedance. The third equation is
the definition of the third-order intercept point.

The calculation omits higher-order terms according to the available


degrees of freedom of the system. If you specify only two of the
three parameters, the block does not use the equation involving the
parameter you did not specify, and eliminates any c7 terms from
the remaining equations. Similarly, if you provide only one of the
parameters, the block uses only the solution to the equation involving
that parameter and omits any c5 or c7 terms.

If you provide vectors of nonlinearity and frequency data, the block


calculates the polynomial coefficients using values for the parameters
interpolated at the center frequency.

2-238
Y-Parameters Mixer

Dialog Main Tab


Box

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

Note For a downconverting mixer, the local oscillator frequency


must satisfy the condition fin – flo ≥ 1/(2ts), where ts is the sample
time specified in the Input Port block. Otherwise, an error
appears.

Noise Data Tab

2-241
Y-Parameters Mixer

Phase noise frequency offset (Hz)


Vector specifying the frequency offset.
Phase noise level (dBc/Hz)
Vector specifying the phase noise level.
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.

2-242
Y-Parameters Mixer

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.
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-243
Y-Parameters Mixer

Nonlinearity Data Tab

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

(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

For information about plotting, see “Create Plots”.

2-246
Y-Parameters Mixer

See Also General Mixer, Output Port, S-Parameters Mixer, Z-Parameters Mixer

2-247
Y-Parameters Passive Network

Purpose Model passive network using Y-parameters

Library Black Box Elements sublibrary of the Physical library

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.

The Y-Parameters Passive Network 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. The modeling frequencies are determined by
the Output Port block. See “SimRF Equivalent Baseband Algorithms”
for more details.

2-248
Y-Parameters Passive Network

Dialog Main Tab


Box

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

For information about plotting, see “Create Plots”.

Examples Plotting Parameters with the Y-Parameters Passive Network


Block
The following example specifies Y-parameters [.23i, -.12i; -.12i, .23i]
and [.02-.13i, -.02+.25i; -.02+.25i, .02-.13i] at frequencies 2.0 GHz and

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

1 Type the following command at the MATLAB prompt to create a


variable called yparams that stores the values of the Y-parameters.

yparams = cat(3,[.23i,-.12i;-.12i,.23i],...
[.02-.13i,-.02+.25i;-.02+.25i, .02-.13i])

2 Set the Y-Parameters Passive Network block parameters on the


Main tab as follows:
• Set the Y-Parameters parameter to yparams.
• Set the Frequency (Hz) parameter to [2.0e9,2.1e9].

Click Apply. This action applies the specified settings.

2-251
Y-Parameters Passive Network

3 Set the Y-Parameters Passive Network block parameters on the


Visualization tab as follows:
• In the Source of frequency data list, select User-specified.
• Set the Frequency data (Hz) parameter to
[1.9e9:1.0e8:2.2e9].
• In the Plot type list, select Polar plane.

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

Purpose Model nonlinear amplifier using Z-parameters

Library Amplifiers sublibrary of the Physical library

Description The Z-Parameters Amplifier block models the nonlinear amplifier


described in the block dialog box, in terms of its frequency-dependent
Z-parameters, the frequencies of the Z-parameters, noise data, and
nonlinearity data

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.

The Z-Parameters Amplifier 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.

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

• The output power at the 1-dB compression point ( P1dB,out ).

• The output power at saturation ( Psat,out ).


In addition, if you have specified Psat,out , the block uses the value for
the gain compression at saturation ( GCsat ). Otherwise, GCsat is not
used. You define each of these parameters in the block dialog box,
on the Nonlinearity Data tab.

2 The block calculates a corresponding input or output value for the


parameters you have specified. In units of dB and dBm,

2-255
Z-Parameters Amplifier

Psat,out + GCsat = Psat,in + Glin


P1dB,out + 1 = P1dB,in + Glin
OIP 3 = IIP 3 + Glin

where Glin is c1 in units of dB.

3 The block formulates the coefficients c3 , c5 , and c7 , where


applicable, as the solutions to a system of one, two, or three linear
equations. The number of equations used is equal to the number
of parameters you provide. For example, if you specify all three
parameters, the block formulates the coefficients according to the
following equations:

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

FAM / AM (s) at the points ( Psat,in , Psat,out ) and

( P1dB,in , P1dB,out ) , expressed in linear units (such as W


or mW) and normalized to a 1-Ω impedance. The third equation is
the definition of the third-order intercept point.

The calculation omits higher-order terms according to the available


degrees of freedom of the system. If you specify only two of the
three parameters, the block does not use the equation involving the
parameter you did not specify, and eliminates any c7 terms from
the remaining equations. Similarly, if you provide only one of the
parameters, the block uses only the solution to the equation involving
that parameter and omits any c5 or c7 terms.

2-256
Z-Parameters Amplifier

If you provide vectors of nonlinearity and frequency data, the block


calculates the polynomial coefficients using values for the parameters
interpolated at the center frequency.

Active Noise
You can specify active block noise in one of the following ways:

• Spot noise data in the Z-Parameters Amplifier block dialog box.


• Noise figure, noise factor, or noise temperature value in the
Z-Parameters Amplifier block dialog box.

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

Dialog Main Tab


Box

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

Noise Data Tab

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

Nonlinearity Data Tab

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

(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

For information about plotting, see “Create Plots”.

2-264
Z-Parameters Amplifier

Examples Plotting Parameters with the Z-Parameters Amplifier Block


The following example specifies Z-parameters [12.60+3.80i, 3.77-0.17i;
80.02+54.68i, 26.02+3.84i] and [15.12+3.55i, 4.14-0.92i; 92.10+23.67i,
27.59+2.71i] at 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.

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

1 Type the following command at the MATLAB prompt to create a


variable called zparams that stores the values of the Z-parameters.

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 Set the Z-Parameters Amplifier block parameters on the Main tab


as follows:
• Set the Z-Parameters parameter to zparams.
• Set the Frequency (Hz) parameter to [2.0e9,2.1e9].

Click Apply. This action applies the specified settings.

2-265
Z-Parameters Amplifier

3 Set the Z-Parameters Amplifier block parameters on the


Visualization tab as follows:
• In the Source of frequency data list, select User-specified.
• Set the Frequency data (Hz) parameter to
[1.9e9:1.0e8:2.2e9].
• In the Plot type list, select X-Y plane.
• In the Y parameter1 list, select S11.

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

See Also General Amplifier, Output Port, S-Parameters Amplifier, Y-Parameters


Amplifier
z2s (RF Toolbox)
interp1 (MATLAB)

2-268
Z-Parameters Mixer

Purpose Model mixer and local oscillator using Z-parameters

Library Mixer sublibrary of the Physical library

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

⎡ b1 ( fin ) ⎤ ⎡ S11 S12 ⎤ ⎡ a1 ( fin ) ⎤


⎢b ( f ) ⎥ = ⎢ S S22 ⎥⎦ ⎢⎣ a2 ( fout ) ⎥⎦
⎣ 2 out ⎦ ⎣ 21

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.

The interpolated S21 parameter values describe the conversion gain as a


function of frequency, referred to the mixer input frequency.
Active Noise
You can specify active block noise in one of the following ways:

2-269
Z-Parameters Mixer

• Spot noise data in the Z-Parameters Mixer block dialog box.


• Noise figure, noise factor, or noise temperature value in the
Z-Parameters Mixer block dialog box.

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:

1 Interpolating the specified phase noise level to determine the phase


noise values at the modeling frequencies.

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

• The output power at the 1-dB compression point ( P1dB,out ).

• The output power at saturation ( Psat,out ).


In addition, if you have specified Psat,out , the block uses the value for
the gain compression at saturation ( GCsat ). Otherwise, GCsat is not
used. You define each of these parameters in the block dialog box,
on the Nonlinearity Data tab.

2 The block calculates a corresponding input or output value for the


parameters you have specified. In units of dB and dBm,

Psat,out + GCsat = Psat,in + Glin


P1dB,out + 1 = P1dB,in + Glin
OIP 3 = IIP 3 + Glin

where Glin is c1 in units of dB.

3 The block formulates the coefficients c3 , c5 , and c7 , where


applicable, as the solutions to a system of one, two, or three linear
equations. The number of equations used is equal to the number
of parameters you provide. For example, if you specify all three

2-271
Z-Parameters Mixer

parameters, the block formulates the coefficients according to the


following equations:

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

FAM / AM (s) at the points ( Psat,in , Psat,out ) and

( P1dB,in , P1dB,out ) , expressed in linear units (such as W


or mW) and normalized to a 1-Ω impedance. The third equation is
the definition of the third-order intercept point.

The calculation omits higher-order terms according to the available


degrees of freedom of the system. If you specify only two of the
three parameters, the block does not use the equation involving the
parameter you did not specify, and eliminates any c7 terms from
the remaining equations. Similarly, if you provide only one of the
parameters, the block uses only the solution to the equation involving
that parameter and omits any c5 or c7 terms.

If you provide vectors of nonlinearity and frequency data, the block


calculates the polynomial coefficients using values for the parameters
interpolated at the center frequency.

2-272
Z-Parameters Mixer

Dialog Main Tab


Box

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

Note For a downconverting mixer, the local oscillator frequency


must satisfy the condition fin – flo ≥ 1/(2ts), where ts is the sample
time specified in the Input Port block. Otherwise, an error
appears.

Noise Data Tab

2-275
Z-Parameters Mixer

Phase noise frequency offset (Hz)


Vector specifying the frequency offset.
Phase noise level (dBc/Hz)
Vector specifying the phase noise level.
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.

2-276
Z-Parameters Mixer

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.
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-277
Z-Parameters Mixer

Nonlinearity Data Tab

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

(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

For information about plotting, see “Create Plots”.

2-280
Z-Parameters Mixer

See Also General Mixer, Output Port, S-Parameters Mixer, Y-Parameters Mixer

2-281
Z-Parameters Passive Network

Purpose Model passive network using Z-parameters

Library Black Box Elements sublibrary of the Physical library

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.

The Z-Parameters Passive Network 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. The modeling frequencies are determined by
the Output Port block. See “SimRF Equivalent Baseband Algorithms”
for more details.

2-282
Z-Parameters Passive Network

Dialog Main Tab


Box

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

For information about plotting, see “Create Plots”.

Examples Plotting Parameters with the Z-Parameters Passive Network


Block
The following example specifies Z-parameters [0.13 - 5.93i, .03-3.16i;
0.03-3.16i, .13-5.93i] and [0.27-2.86i, -.09-5.41i; -.09-5.41i, .27-2.86i] at

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.

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

1 Type the following command at the MATLAB prompt to create a


variable called zparams that stores the values of the Z-parameters.

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 Set the Z-Parameters Passive Network block parameters on the


Main tab as follows:
• Set the Z-Parameters parameter to zparams.
• Set the Frequency (Hz) parameter to [2.0e9,2.1e9].

Click Apply. This action applies the specified settings.

2-285
Z-Parameters Passive Network

3 Set the Z-Parameters Passive Network block parameters on the


Visualization tab as follows:
• In the Source of frequency data list, select User-specified.
• Set the Frequency data (Hz) parameter to
[1.9e9:1.0e8:2.2e9].
• In the Y parameter1 list, select S12.

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

You might also like