RF Toolbox™ 2

User’s Guide
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.
RF Toolbox™ User’s Guide
© COPYRIGHT 2004–2010 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
June 2004 Online only New for Version 1.0 (Release 14)
August 2004 Online only Revised for Version 1.0.1 (Release 14+)
March 2005 Online only Revised for Version 1.1 (Release 14SP2)
September 2005 Online only Revised for Version 1.2 (Release 14SP3)
March 2006 Online only Revised for Version 1.3 (Release 2006a)
September 2006 Online only Revised for Version 2.0 (Release 2006b)
March 2007 Online only Revised for Version 2.1 (Release 2007a)
September 2007 Online only Revised for Version 2.2 (Release 2007b)
March 2008 Online only Revised for Version 2.3 (Release 2008a)
October 2008 Online only Revised for Version 2.4 (Release 2008b)
March 2009 Online only Revised for Version 2.5 (Release 2009a)
September 2009 Online only Revised for Version 2.6 (Release 2009b)
March 2010 Online only Revised for Version 2.7 (Release 2010a)
September 2010 Online only Revised for Version 2.8 (Release 2010b)
 Contents

Getting Started
1
Product Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2

Related Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4

Product Demos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5

RF Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7

S-Parameter Notation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9

Defining S-Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
Referring to S-Parameters Using Strings . . . . . . . . . . . . . . 1-10

Product Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12

Example — Modeling a Cascaded RF Network . . . . . . . . 1-14

Overview of Cascaded RF Network Example . . . . . . . . . . . 1-14
Creating RF Components . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-14
Specifying Component Data . . . . . . . . . . . . . . . . . . . . . . . . . 1-15
Validating RF Components . . . . . . . . . . . . . . . . . . . . . . . . . 1-15
Building and Simulating the Network . . . . . . . . . . . . . . . . . 1-17
Analyzing Simulation Results . . . . . . . . . . . . . . . . . . . . . . . 1-18

Example — Using a Rational Function Model to Analyze

a Transmission Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-22
Overview of Transmission Line Example . . . . . . . . . . . . . . 1-22
Building and Simulating the Transmission Line . . . . . . . . 1-22
Computing the Transmission Line Transfer Function and
Time-Domain Response . . . . . . . . . . . . . . . . . . . . . . . . . . 1-22
Exporting a Verilog-A Model . . . . . . . . . . . . . . . . . . . . . . . . 1-27

v
 Selecting an RF Object
2
RF Data Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Overview of RF Data Objects . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Types of Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Available Data Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Data Object Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3

RF Circuit Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

Overview of RF Circuit Objects . . . . . . . . . . . . . . . . . . . . . . 2-4
Components Versus Networks . . . . . . . . . . . . . . . . . . . . . . . 2-4
Available Components and Networks . . . . . . . . . . . . . . . . . 2-5
Circuit Object Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7

RF Model Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10

Overview of RF Model Objects . . . . . . . . . . . . . . . . . . . . . . . 2-10
Available Model Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
Model Object Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10

Modeling an RF Component
3
Creating RF Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Constructing a New Object . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Copying an Existing Object . . . . . . . . . . . . . . . . . . . . . . . . . 3-4

Specifying or Importing Component Data . . . . . . . . . . . . 3-5

RF Object Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
Setting Property Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
Importing Property Values from Data Files . . . . . . . . . . . . 3-8
Using Data Objects to Specify Circuit Properties . . . . . . . . 3-11
Retrieving Property Values . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
Direct Property Referencing Using Dot Notation . . . . . . . . 3-16

Specifying Operating Conditions . . . . . . . . . . . . . . . . . . . . 3-17

Available Operating Conditions . . . . . . . . . . . . . . . . . . . . . . 3-17
Setting Operating Conditions . . . . . . . . . . . . . . . . . . . . . . . . 3-17

vi Contents
 Displaying Available Operating Condition Values . . . . . . . 3-18

Processing File Data for Analysis . . . . . . . . . . . . . . . . . . . 3-19

Converting Single-Ended S-Parameters to Mixed-Mode
S-Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-19
Extracting M-Port S-Parameters from N-Port
S-Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-21
Cascading N-Port S-Parameters . . . . . . . . . . . . . . . . . . . . . 3-23

Analyzing and Plotting RF Components . . . . . . . . . . . . . 3-26

Analyzing Networks in the Frequency Domain . . . . . . . . . 3-26
Visualizing Component and Network Data . . . . . . . . . . . . . 3-27
Computing and Plotting Time-Domain Specifications . . . . 3-36

Exporting Component Data to a File . . . . . . . . . . . . . . . . 3-39

Available Export Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-39
How to Export Object Data . . . . . . . . . . . . . . . . . . . . . . . . . . 3-39
Example — Exporting Object Data . . . . . . . . . . . . . . . . . . . 3-40

Examples of Basic Operations with RF Objects . . . . . . . 3-42

Reading and Analyzing RF Data from a Touchstone Data
File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-42
De-Embedding S-Parameters . . . . . . . . . . . . . . . . . . . . . . . . 3-44

Exporting Verilog-A Models

4
Modeling RF Objects Using Verilog-A . . . . . . . . . . . . . . . . 4-2
Overview of Verilog-A Support . . . . . . . . . . . . . . . . . . . . . . . 4-2
Behavioral Modeling Using Verilog-A . . . . . . . . . . . . . . . . . 4-2
Supported Verilog-A Models . . . . . . . . . . . . . . . . . . . . . . . . . 4-3

How to Export a Verilog-A Model . . . . . . . . . . . . . . . . . . . 4-5

Representing a Circuit Object with a Model Object . . . . . . 4-5
Writing a Verilog-A Module . . . . . . . . . . . . . . . . . . . . . . . . . 4-7

vii
 RF Tool: An RF Analysis GUI
5
Introduction to RF Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
What Is RF Tool? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
Opening RF Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
RF Tool Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
RF Tool Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5

Creating and Importing Circuits . . . . . . . . . . . . . . . . . . . . 5-6

Circuits in RF Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6
Creating RF Components . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6
Creating RF Networks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10
Importing RF Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15

Modifying Component Data ........................ 5-19

Analyzing Circuits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-20

Exporting RF Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-23

Exporting Components and Networks . . . . . . . . . . . . . . . . . 5-23
Exporting to the Workspace . . . . . . . . . . . . . . . . . . . . . . . . . 5-23
Exporting to a File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25

Managing Circuits and Sessions . . . . . . . . . . . . . . . . . . . . 5-27

Working with Circuits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-27
Working with Sessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-28

Example — Modeling an RF Network Using RF Tool . . 5-31

Overview of RF Tool Example . . . . . . . . . . . . . . . . . . . . . . . 5-31
Starting RF Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-31
Creating the Amplifier Network . . . . . . . . . . . . . . . . . . . . . 5-31
Populating the Amplifier Network . . . . . . . . . . . . . . . . . . . . 5-34
Simulating the Amplifier Network . . . . . . . . . . . . . . . . . . . 5-38
Exporting the Network to the Workspace . . . . . . . . . . . . . . 5-39

viii Contents
 Object Reference
6
Circuit Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
Networks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3

Data Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4

Model Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5

Objects — Alphabetical List

7

Method Reference
8
Analysis .......................................... 8-2

Plots and Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2

Parameters and Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-3

Operating Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-3

Data I/O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-3

Data Access and Restoration ....................... 8-3

ix
 Methods — Alphabetical List
9

Function Reference
10
Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2

Data Visualization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-3

Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-3

Network Parameter Conversion .................... 10-3

GUI .............................................. 10-5

Functions — Alphabetical List

11

AMP File Format

A
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2

Denoting Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3

Data Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-4

Overview of Data Sections . . . . . . . . . . . . . . . . . . . . . . . . . . A-4
S, Y, or Z Network Parameters . . . . . . . . . . . . . . . . . . . . . . A-4
Noise Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-6
Noise Figure Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-8

x Contents
 Power Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-9
IP3 Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-12
Inconsistent Data Sections . . . . . . . . . . . . . . . . . . . . . . . . . . A-14

Examples
B
Modeling a Cascaded RF Network . . . . . . . . . . . . . . . . . . . B-2

Modeling a Transmission Line . . . . . . . . . . . . . . . . . . . . . . B-2

Working with Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-2

Exporting Object Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-2

Modeling an RF Network Using RF Tool . . . . . . . . . . . . . B-2

Index

xi
xii Contents
 1

Getting Started

• “Product Overview” on page 1-2

• “Related Products” on page 1-4
• “Product Demos” on page 1-5
• “RF Objects” on page 1-7
• “S-Parameter Notation” on page 1-9
• “Product Workflow” on page 1-12
• “Example — Modeling a Cascaded RF Network” on page 1-14
• “Example — Using a Rational Function Model to Analyze a Transmission
Line” on page 1-22
 1 Getting Started

Product Overview
RF Toolbox™ software extends the MATLAB® technical computing
environment with objects and functions for modeling RF circuits consisting of:

• Components such as RF filters, transmission lines, amplifiers, and mixers.

• Networks of interconnected components, such as cascaded, parallel, series,
or hybrid networks.

Note To use the toolbox, you must have MATLAB installed.

You use objects from the toolbox to represent the components of your RF
network. The toolbox provides several types of component representations
using network parameters (S, Y, Z, ABCD, H, and T format) and physical
properties.

You integrate the components to represent your RF network and analyze

the network at specified frequencies.

You then perform one or more of the following tasks:

• Visualize network data using plots and Smith® Charts.

• Compute the transfer function and time-domain response of a circuit.
• Export a Verilog-A description of a component or network for use in a
time-domain circuit simulator.

All toolbox features are accessible and executable interactively from the
MATLAB prompt or programmatically using M-code scripts.

The toolbox provides access to a subset of the command-line functionality

through a graphical user interface, RF Tool. Using RF Tool, you can perform
the following tasks:

• Design, analyze, and visualize RF components and networks.

• Export circuits to the MATLAB workspace, or to a file for use with toolbox
functions and other circuit objects.

1-2
 Product Overview

A validated model of an RF circuit can provide an executable specification for

verification in a system-level simulation.

1-3
 1 Getting Started

Related Products
Several MathWorks® products are especially relevant to the kinds of tasks
you can perform with RF Toolbox software. The following table summarizes
the related products and describes how they complement the features of the
toolbox.

Product Description
Communications Blockset™ Simulink® blocks for time-domain
simulation of modulation and
demodulation of a wireless
communications signal.
Communications Toolbox™ MATLAB functions for signal
modulation and demodulation.
Filter Design Toolbox™ MATLAB functions for filtering the
modulated communication signal.
SimRF™ Circuit-envelope simulation of RF
components in Simulink.
Signal Processing Toolbox™ MATLAB functions for filtering the
modulated communication signal.
Signal Processing Blockset™ Simulink blocks for time-domain
simulation of for filtering the
modulated communication signal.

1-4
 Product Demos

Product Demos
You can find interactive RF Toolbox demos in the MATLAB Help browser.

To open the RF Toolbox Demos page in the Help Browser:

1-5
 1 Getting Started

• Type demo 'toolbox' 'rf' at the MATLAB prompt.

• Expand the RF Toolbox section and click Demos.

To run an demo:

1 Browse to demo you want to run.

2 On the demo page, click Open this model in the upper-right corner of the
demo window to display the Simulink model for this demo.

3 In the model window, select Simulation > Start to run the demo
simulation.

1-6
 RF Objects

RF Objects
RF Toolbox software uses objects to represent RF components and networks.
You create an object using the object’s constructor. Every object has
predefined fields called properties. The properties define the characteristics of
the object. Each property associated with an object is assigned a value. Every
object has a set of methods, which are operations that you can perform on the
object. Methods are similar to functions except that they only act on an object.

The following table summarizes the types of objects that are available in
the toolbox and describes the uses of each one. For more information on a
particular type of object, including a list of the available objects and methods,
follow the link in the table to the documentation for that object type.

Object Type Name Description

“RF Data Objects” on page rfdata Stores data for use by other
2-2 RF objects or for plotting
and network parameter
conversion.
“RF Circuit Objects” on rfckt Represents RF components
page 2-4 and networks using
network parameters
and physical properties
for frequency-domain
simulation.
“RF Model Objects” on rfmodel Represents RF
page 2-10 components and networks
mathematically for
computing time-domain
behavior and exporting
models.

Each name in the preceding table is the prefix to the names of all object
constructors of that type. The constructors use dot notation that consists
of the object type, followed by a dot and then the component name. The
component name is also called the class. For information on how to construct
an RF object from the command line using dot notation, see “Creating RF
Objects” on page 3-2.

1-7
 1 Getting Started

You use a different form of dot notation to specify object properties, as

described in “Direct Property Referencing Using Dot Notation” on page 3-16.
This is just one way to define component data. For more information on object
properties, see “Specifying or Importing Component Data” on page 3-5.

You use object methods to perform frequency-domain analysis and visualize

the results. For more information, see “Analyzing and Plotting RF
Components” on page 3-26.

Note The toolbox also provides a graphical interface for creating and
analyzing circuit objects. For more information, see Chapter 5, “RF Tool:
An RF Analysis GUI”.

1-8
 S-Parameter Notation

S-Parameter Notation
In this section...
“Defining S-Parameters” on page 1-9
“Referring to S-Parameters Using Strings” on page 1-10

Defining S-Parameters
RF Toolbox software uses matrix notation to specify S-parameters. The
indices of an S-parameter matrix correspond to the port numbers of the
network that the data represent. For example, to define a matrix of 50-ohm,
2-port S-parameters, type:

s11 = 0.61*exp(j*165/180*pi);
s21 = 3.72*exp(j*59/180*pi);
s12 = 0.05*exp(j*42/180*pi);
s22 = 0.45*exp(j*(-48/180)*pi);
s_params = [s11 s12; s21 s22];

RF Toolbox functions that operate on s_params assume:

• s_params(1,1) corresponds to the reflection coefficient at port 1, S11.

• s_params(2,1) corresponds to the transmission coefficient from port 1 to
port 2, S21.
• s_params(1,2) corresponds to the transmission coefficient from port 2 to
port 1, S12.
• s_params(2,2) corresponds to the reflection coefficient at port 2, S22.

RF Toolbox software also supports three-dimensional arrays of S-parameters.

The third dimension of an S-parameter array corresponds to S-parameter
data at different frequencies. The following figure illustrates this convention.

1-9
 1 Getting Started

Referring to S-Parameters Using Strings

RF Toolbox software uses strings to refer to S-parameters in plotting and
calculation methods, such as plot. These strings have one of the following
two forms:

• 'Snm' — Use this syntax if n and m are both less than 10.
• 'Sn,m' — Use this syntax if one or both are greater than 10. 'Sn,m' is not
a valid syntax when both n and m are less than 10.

The indices n and m are the port numbers for the S-parameters.

Most toolbox objects only analyze 2-port S-parameters. The following objects
analyze S-parameters with more than two ports:

• rfckt.passive
• rfckt.datafile
• rfdata.data

You can get 2-port parameters from S-parameters with an arbitrary number
of ports using one or more of the following steps:

• Extract 2-port S-parameters from N-port S-parameters.

See “Extracting M-Port S-Parameters from N-Port S-Parameters” on page
3-21.
• Convert single-ended 4-port parameters to differential 2-port parameters.

1-10
 S-Parameter Notation

See “Converting Single-Ended S-Parameters to Mixed-Mode S-Parameters”

on page 3-19.

1-11
 1 Getting Started

Product Workflow
When you analyze an RF circuit using RF Toolbox software, your workflow
might include the following tasks:

1 Select RF circuit objects to represent the components of your RF network.

See Chapter 2, “Selecting an RF Object”.

2 Create the selected objects.

See “Creating RF Objects” on page 3-2.

3 Define component data by:

• Specifying network parameters or physical properties (see “Setting

Property Values” on page 3-5).
• Importing data from an industry-standard Touchstone® file, a
MathWorks AMP file, an Agilent® P2D or S2D file, or the MATLAB
workspace (see “Importing Property Values from Data Files” on page
3-8).
• Where applicable, selecting operating condition values (see “Specifying
Operating Conditions” on page 3-17).

4 Where applicable, perform network parameter conversions on imported

file data.

See “Processing File Data for Analysis” on page 3-19.

5 Integrate components to form a cascade, hybrid, parallel, or series network.

See “Constructing Networks of Specified Components” on page 3-7.

6 Analyze the network in the frequency domain.

See “Analyzing Networks in the Frequency Domain” on page 3-26.

7 Generate plots to gain insight into network behavior.

The following plots and charts are available in the toolbox:

• Rectangular plots

1-12
 Product Workflow

• Polar plots
• Smith Charts
• Budget plots (for cascaded S-parameters)

See “Visualizing Component and Network Data” on page 3-27.

8 Compute the network transfer function.

See “Computing the Network Transfer Function” on page 3-36.

9 Create an RF model object that describes the transfer function analytically.

See “Fitting a Model Object to Circuit Object Data” on page 3-37.

10 Plot the time-domain response.

See “Computing and Plotting the Time-Domain Response” on page 3-38.

11 Export a Verilog-A description of the network.

See Chapter 4, “Exporting Verilog-A Models”.

1-13
 1 Getting Started

Example — Modeling a Cascaded RF Network

In this section...
“Overview of Cascaded RF Network Example” on page 1-14
“Creating RF Components” on page 1-14
“Specifying Component Data” on page 1-15
“Validating RF Components” on page 1-15
“Building and Simulating the Network” on page 1-17
“Analyzing Simulation Results” on page 1-18

Overview of Cascaded RF Network Example

In this example, you use the RF Toolbox command-line interface to model the
gain and noise figure of a cascaded network. You analyze the network in the
frequency domain and plot the results.

Note To learn how to use RF Tool to perform these tasks, see “Example —
Modeling an RF Network Using RF Tool” on page 5-31.

The network that you use in this example consists of an amplifier and two
transmission lines. The toolbox represents RF components and RF networks
using RF circuit objects. You learn how to create and manipulate these
objects to analyze the cascaded amplifier network.

Creating RF Components
Type the following set of commands at the MATLAB prompt to create three
circuit (rfckt) objects with the default property values. These circuit objects
represent the two transmission lines and the amplifier:

FirstCkt = rfckt.txline;
SecondCkt = rfckt.amplifier;
ThirdCkt = rfckt.txline;

1-14
 Example — Modeling a Cascaded RF Network

Specifying Component Data

In this part of the example, you specify the following component properties:

• “Transmission Line Properties” on page 1-15

• “Amplifier Properties” on page 1-15

Transmission Line Properties

1 Type the following command at the MATLAB prompt to change the line
length of the first transmission line, FirstCkt, to 0.001:

set(FirstCkt,'LineLength',0.001)

2 Type the following command at the MATLAB prompt to change the line
length of the second transmission line, ThirdCkt, to 0.025 and to change
the phase velocity to 2.0e8:

set(ThirdCkt,'LineLength',0.025,'PV',2.0e8)

Amplifier Properties

1 Type the following command at the MATLAB prompt to import network

parameters, noise data, and power data from the default.amp file into
the amplifier, SecondCkt:

read(SecondCkt, 'default.amp');

2 Type the following command at the MATLAB prompt to change the

interpolation method of the amplifier, SecondCkt, to cubic:

set(SecondCkt,'IntpType','cubic')

The IntpType property tells the toolbox how to interpolate the network
parameters, noise data, and power data when you analyze the amplifier at
frequencies other than those specified in the file.

Validating RF Components
In this part of the example, you plot the network parameters and power data
(output power versus input power) to validate the behavior of the amplifier.

1-15
 1 Getting Started

1 Type the following set of commands at the MATLAB prompt to use the
smith command to plot the original S11 and S22 parameters of the amplifier
(SecondCkt) on a Z Smith Chart:

figure
lineseries1 = smith(SecondCkt,'S11','S22');
set(lineseries1(1), 'LineStyle','-', 'LineWidth', 1);
set(lineseries1(2), 'LineStyle',':', 'LineWidth', 1);
legend show

Note The plot shows the S-parameters over the frequency range for which
network data is specified in the default.amp file — from 1 GHz to 2.9 GHz.

1-16
 Example — Modeling a Cascaded RF Network

2 Type the following set of commands at the MATLAB prompt to use the RF
Toolbox plot command to plot the amplifier (SecondCkt) output power
(Pout) as a function of input power (Pin), both in decibels referenced to one
milliwatt (dBm), on an X-Y plane plot:

figure
plot(SecondCkt,'Pout','dBm');
legend show

Note The plot shows the power data at 2.1 GHz because this frequency is
the one for which power data is specified in the default.amp file.

Building and Simulating the Network

In this part of the example, you create a circuit object to represent the
cascaded amplifier and analyze the object in the frequency domain.

1-17
 1 Getting Started

1 Type the following command at the MATLAB prompt to cascade the three
circuit objects to form a new cascaded circuit object, CascadedCkt:

CascadedCkt = rfckt.cascade('Ckts',{FirstCkt,SecondCkt,...
ThirdCkt});

2 Type the following set of commands at the MATLAB prompt to define the
range of frequencies over which to analyze the cascaded circuit, and then
run the analysis:

f = 1.0e9:1e7:2.9e9;
analyze(CascadedCkt,f);

Analyzing Simulation Results

In this part of the example, you analyze the results of the simulation by
plotting data for the circuit object that represents the cascaded amplifier
network.

1-18
 Example — Modeling a Cascaded RF Network

1 Type the following set of commands at the MATLAB prompt to use the
smith command to plot the S11 and S22 parameters of the cascaded amplifier
network on a Z Smith Chart:

figure
lineseries2 = smith(CascadedCkt,'S11','S22','z');
set(lineseries2(1),'LineStyle','-','LineWidth',1);
set(lineseries2(2),'LineStyle',':','LineWidth',1);
legend show

1-19
 1 Getting Started

2 Type the following set of commands at the MATLAB prompt to use the
plot command to plot the S21 parameter of the cascaded network, which
represents the network gain, on an X-Y plane:

figure
plot(CascadedCkt,'S21','dB');
legend show

1-20
 Example — Modeling a Cascaded RF Network

3 Type the following set of commands at the MATLAB prompt to use the
plot command to create a budget plot of the S21 parameter and the noise
figure of the amplifier network:

figure
plot(CascadedCkt,'budget', 'S21','NF');
legend show

The budget plot shows parameters as a function of frequency by circuit

index. Components are indexed based on their position in the network.
In this example:
• Circuit index one corresponds to FirstCkt.
• Circuit index two corresponds to SecondCkt.
• Circuit index three corresponds to ThirdCkt.

The curve for each index represents the contributions of the RF components
up to and including the component at that index.

1-21
 1 Getting Started

Example — Using a Rational Function Model to Analyze a

Transmission Line
In this section...
“Overview of Transmission Line Example” on page 1-22
“Building and Simulating the Transmission Line” on page 1-22
“Computing the Transmission Line Transfer Function and Time-Domain
Response” on page 1-22
“Exporting a Verilog-A Model” on page 1-27

Overview of Transmission Line Example

In this example, you use the RF Toolbox command-line interface to model the
time-domain response of a parallel plate transmission line. You analyze the
network in the frequency domain, compute and plot the time-domain response
of the network, and export a Verilog-A model of the transmission line for use
in system-level simulations.

Building and Simulating the Transmission Line

1 Type the following command at the MATLAB prompt to create a circuit
(rfckt) object to represent the transmission line, which is 0.1 meters long
and 0.05 meters wide:

tline = rfckt.parallelplate('LineLength',0.1,'Width',0.05);

2 Type the following set of commands at the MATLAB prompt to define the
range of frequencies over which to analyze the transmission line and then
run the analysis:

f = [1.0e9:1e7:2.9e9];
analyze(tline,f);

Computing the Transmission Line Transfer Function

and Time-Domain Response
This part of the example illustrates how to perform the following tasks:

1-22
 Example — Using a Rational Function Model to Analyze a Transmission Line

• “Calculating the Transfer Function” on page 1-23

• “Fitting and Validating the Transfer Function Model” on page 1-23
• “Computing and Plotting the Time-Domain Response” on page 1-26

Calculating the Transfer Function

1 Type the following command at the MATLAB prompt to extract the

computed S-parameter values and the corresponding frequency values for
the transmission line:

[S_Params, Freq] = extract(tline,'S_Parameters');

2 Type the following command at the MATLAB prompt to compute the

transfer function from the frequency response data using the s2tf function:

TrFunc = s2tf(S_Params);

Fitting and Validating the Transfer Function Model

In this part of the example, you fit a rational function model to the transfer
function. The toolbox stores the fitting results in an rfmodel object. You use
the RF Toolbox freqresp method to validate the fit of the rational function
model.

1 Type the following command at the MATLAB prompt to fit a rational

function to the computed data and store the result in an rfmodel object:

RationalFunc = rationalfit(Freq,TrFunc)

2 Type the following command at the MATLAB prompt to compute the

frequency response of the fitted model data:

[fresp,freq]=freqresp(RationalFunc,Freq);

3 Type the following set of commands at the MATLAB prompt to plot the
amplitude of the frequency response of the fitted model data and that of
the computed data:

figure
plot(freq/1e9,db(fresp),freq/1e9,db(TrFunc));

1-23
 1 Getting Started

xlabel('Frequency, GHz')
ylabel('Amplitude, dB')
legend('Fitted Model Data','Computed Data')

Note The amplitude of the model data is very close to the amplitude of the
computed data. You can control the tradeoff between model accuracy and
model complexity by specifying the optional tolerance argument, tol, to
the rationalfit function, as described in “Representing a Circuit Object
with a Model Object” on page 4-5.

1-24
 Example — Using a Rational Function Model to Analyze a Transmission Line

4 Type the following set of commands at the MATLAB prompt to plot the
phase angle of the frequency response of the fitted model data and that of
the computed data:

figure
plot(freq/1e9,unwrap(angle(fresp)),...
freq/1e9,unwrap(angle(TrFunc)));
xlabel('Frequency, GHz')
ylabel('Phase Angle, radians')
legend('Fitted Data','Computed Data')

Note The phase angle of the model data is very close to the phase angle of
the computed data.

1-25
 1 Getting Started

Computing and Plotting the Time-Domain Response

In this part of the example, you compute and plot the time-domain response of
the transmission line.

1 Type the following set of commands at the MATLAB prompt to create a

random input signal and compute the time response, tresp, of the fitted
model data to the input signal:

SampleTime=1e-12;
NumberOfSamples=1e4;
OverSamplingFactor = 25;
InputTime = double((1:NumberOfSamples)')*SampleTime;
InputSignal = ...
sign(randn(1, ceil(NumberOfSamples/OverSamplingFactor)));
InputSignal = repmat(InputSignal, [OverSamplingFactor, 1]);
InputSignal = InputSignal(:);

[tresp,t]=timeresp(RationalFunc,InputSignal,SampleTime);

2 Type the following set of commands at the MATLAB prompt to plot the
time response of the fitted model data:

figure
plot(t,tresp);
xlabel('Time (seconds)')
ylabel('Response to Random Input Signal')

1-26
 Example — Using a Rational Function Model to Analyze a Transmission Line

Exporting a Verilog-A Model

In this part of the example, you export a Verilog-A model of the transmission
line. You can use this model in other simulation tools for detailed time-domain
analysis and system simulations.

The following code illustrates how to use the writeva method to write a
Verilog-A module for RationalFunc to the file tline.va. The module has one
input, tline_in, and one output, tline_out. The method returns a status of
True, if the operation is successful, and False if it is unsuccessful.

status = writeva(RationalFunc,'tline','tline_in','tline_out')

For more information on the writeva method and its arguments, see the
writeva reference page. For more information on Verilog-A models, see
Chapter 4, “Exporting Verilog-A Models”.

1-27
 1 Getting Started

1-28
 2

Selecting an RF Object

• “RF Data Objects” on page 2-2

• “RF Circuit Objects” on page 2-4
• “RF Model Objects” on page 2-10
 2 Selecting an RF Object

RF Data Objects
In this section...
“Overview of RF Data Objects” on page 2-2
“Types of Data” on page 2-2
“Available Data Objects” on page 2-2
“Data Object Methods” on page 2-3

Overview of RF Data Objects

RF Toolbox software uses data (rfdata) objects to store:

• Component data created from files or from information that you specify
in the MATLAB workspace.
• Analyzed data from a frequency-domain simulation of a circuit object.

You can perform basic tasks, such as plotting and network parameter
conversion, on the data stored in these objects. However, data objects are
primarily used to store data for use by other RF objects.

Types of Data
The toolbox uses RF data objects to store one or more of the following types
of data:

• Network parameters
• Spot noise
• Noise figure
• Third-order intercept point (IP3)
• Power out versus power in

Available Data Objects

The following table lists the available rfdata object constructors and
describes the data the corresponding objects represent. For more information

2-2
 RF Data Objects

on a particular object, follow the link in the table to the reference page for
that object.

Constructor Description
rfdata.data Data object containing network parameter data
rfdata.ip3 Data object containing IP3 information
rfdata.mixerspur Data object containing mixer spur information
from an intermodulation table
rfdata.network Data object containing network parameter
information
rfdata.nf Data object containing noise figure information
rfdata.noise Data object containing noise information
rfdata.power Data object containing power and phase
information

Data Object Methods

The following table lists the methods of the data objects, the types of objects
on which each can act, and the purpose of each method.

Method Types of Objects Purpose

extract rfdata.data, Extract specified network
rfdata.network parameters from a circuit or
data object and return the result in
an array
read rfdata.data Read RF data parameters from a file
to a new or existing data object.
write rfdata.data Write RF data from a data object to
a file.

2-3
 2 Selecting an RF Object

RF Circuit Objects
In this section...
“Overview of RF Circuit Objects” on page 2-4
“Components Versus Networks” on page 2-4
“Available Components and Networks” on page 2-5
“Circuit Object Methods” on page 2-7

Overview of RF Circuit Objects

RF Toolbox software uses circuit (rfckt) objects to represent the following
components:

• Circuit components such as amplifiers, transmission lines, and ladder

filters
• RLC network components
• Networks of RF components

The toolbox represents each type of component and network with a different
object. You use these objects to analyze components and networks in the
frequency domain.

Components Versus Networks

You define component behavior using network parameters and physical
properties.

To specify an individual RF component:

1 Construct a circuit object to represent the component.

2 Specify or import component data.

You define network behavior by specifying the components that make up the
network. These components can be either individual components (such as
amplifiers and transmission lines) or other networks.

2-4
 RF Circuit Objects

To specify an RF network:

1 Build circuit objects to represent the network components.

2 Construct a circuit object to represent the network.

Note This object defines how to connect the network components.

However, the network is empty until you specify the components that it
contains.

3 Specify, as the Ckts property of the object that represents the network, a
list of components that make up the network.

These procedures are illustrated by example in “Example — Modeling a

Cascaded RF Network” on page 1-14.

Available Components and Networks

To create circuit objects that represent components, you use constructors
whose names describe the components. To create circuit objects that represent
networks, you use constructors whose names describe how the components
are connected together.

The following table lists the available rfckt object constructors and describes
the components or networks the corresponding objects represent. For more
information on a particular object, follow the link in the table to the reference
page for that object.

Constructor Description
rfckt.amplifier Amplifier, described by an rfdata object
rfckt.cascade Cascaded network, described by the list of
components and networks that comprise it
rfckt.coaxial Coaxial transmission line, described by
dimensions and electrical characteristics

2-5
 2 Selecting an RF Object

Constructor Description
rfckt.cpw Coplanar waveguide transmission line,
described by dimensions and electrical
characteristics
rfckt.datafile General circuit, described by a data file
rfckt.delay Delay line, described by loss and delay
rfckt.hybrid Hybrid connected network, described by the list
of components and networks that comprise it
rfckt.hybridg Inverse hybrid connected network, described
by the list of components and networks that
comprise it
rfckt.lcbandpasspi LC bandpass pi network, described by LC
values
rfckt.lcbandpasstee LC bandpass tee network, described by LC
values
rfckt.lcbandstoppi LC bandstop pi network, described by LC values
rfckt.lcbandstoptee LC bandstop tee network, described by LC
values
rfckt.lchighpasspi LC highpass pi network, described by LC values
rfckt.lchighpasstee LC highpass tee network, described by LC
values
rfckt.lclowpasspi LC lowpass pi network, described by LC values
rfckt.lclowpasstee LC lowpass tee network, described by LC values
rfckt.microstrip Microstrip transmission line, described by
dimensions and electrical characteristics
rfckt.mixer Mixer, described by an rfdata object
rfckt.parallel Parallel connected network, described by the
list of components and networks that comprise
it
rfckt.parallelplate Parallel-plate transmission line, described by
dimensions and electrical characteristics

2-6
 RF Circuit Objects

Constructor Description
rfckt.passive Passive component, described by network
parameters
rfckt.rlcgline RLCG transmission line, described by RLCG
values
rfckt.series Series connected network, described by the list
of components and networks that comprise it
rfckt.seriesrlc Series RLC network, described by RLC values
rfckt.shuntrlc Shunt RLC network, described by RLC values
rfckt.twowire Two-wire transmission line, described by
dimensions and electrical characteristics
rfckt.txline General transmission line, described by
dimensions and electrical characteristics

Circuit Object Methods

The following table lists the methods of the circuit objects, the types of objects
on which each can act, and the purpose of each method.

Method Types of Objects Purpose

analyze All circuit objects Analyze a circuit object in the
frequency domain.
calculate All circuit objects Calculate specified parameters for
a circuit object.
copy All circuit objects Copy a circuit or data object.
extract All circuit objects Extract specified network
parameters from a circuit or data
object, and return the result in an
array.
getdata All circuit objects Get data object containing
analyzed result of a specified
circuit object.

2-7
 2 Selecting an RF Object

Method Types of Objects Purpose

getz0 rfckt.txline, Get characteristic impedance of a
rfckt.rlcgline, transmission line.
rfckt.twowire,
rfckt.parallelplate,
rfckt.coaxial,
rfdata.microstrip,
rfckt.cpw
listformat All circuit objects List valid formats for a specified
circuit object parameter.
listparam All circuit objects List valid parameters for a
specified circuit object.
loglog All circuit objects Plot specified circuit object
parameters using a log-log scale.
plot All circuit objects Plot the specified circuit object
parameters on an X-Y plane.
plotyy All circuit objects Plot the specified object
parameters with y-axes on
both the left and right sides.
polar All circuit objects Plot the specified circuit object
parameters on polar coordinates.
read rfckt.datafile, Read RF data from a file to a new
rfckt.passive, or existing circuit object.
rfckt.amplifier,
rfckt.mixer
restore rfckt.datafile, Restore data to original
rfckt.passive, frequencies of NetworkData
rfckt.amplifier, for plotting.
rfckt.mixer
semilogx All circuit objects Plot the specified circuit object
parameters using a log scale for
the X-axis

2-8
 RF Circuit Objects

Method Types of Objects Purpose

semilogy All circuit objects Plot the specified circuit object
parameters using a log scale for
the Y-axis
smith All circuit objects Plot the specified circuit object
parameters on a Smith chart.
write All circuit objects Write RF data from a circuit object
to a file.

2-9
 2 Selecting an RF Object

RF Model Objects
In this section...
“Overview of RF Model Objects” on page 2-10
“Available Model Objects” on page 2-10
“Model Object Methods” on page 2-10

Overview of RF Model Objects

RF Toolbox software uses model (rfmodel) objects to represent components
and measured data mathematically for computing information such
as time-domain response. Each type of model object uses a different
mathematical model to represent the component.

RF model objects provide a high-level component representation for use

after you perform detailed analysis using RF circuit objects. Use RF model
objects to:

• Compute time-domain figures of merit for RF components

• Export Verilog-A models of RF components

Available Model Objects

The following table lists the available rfmodel object constructors and
describes the model the corresponding objects use. For more information
on a particular object, follow the link in the table to the reference page for
that object.

Constructor Description
rfmodel.rational Rational function model

Model Object Methods

The following table lists the methods of the model objects, the types of objects
on which each can act, and the purpose of each method.

2-10
 RF Model Objects

Method Types of Objects Purpose

freqresp All model objects Compute the frequency response of a
model object.
timeresp All model objects Compute the time response of a
model object.
writeva All model objects Write data from a model object to a
file.

2-11
 2 Selecting an RF Object

2-12
 3

Modeling an RF Component

• “Creating RF Objects” on page 3-2

• “Specifying or Importing Component Data” on page 3-5
• “Specifying Operating Conditions” on page 3-17
• “Processing File Data for Analysis” on page 3-19
• “Analyzing and Plotting RF Components” on page 3-26
• “Exporting Component Data to a File” on page 3-39
• “Examples of Basic Operations with RF Objects” on page 3-42
 3 Modeling an RF Component

Creating RF Objects
In this section...
“Constructing a New Object” on page 3-2
“Copying an Existing Object” on page 3-4

Constructing a New Object

You can create any rfdata, rfckt or rfmodel object by calling the object
constructor. You can create an rfmodel object by fitting a rational function
to passive component data.

This section contains the following topics:

• “Calling the Object Constructor” on page 3-2

• “Fitting a Rational Function to Passive Component Data” on page 3-3

Calling the Object Constructor

To create a new RF object with default property values, you call the object
constructor without any arguments:

h = objecttype.objectname

where:

• h is the handle to the new object.

• objecttype is the object type (rfdata, rfckt, or rfmodel).
• objectname is the object name.

For example, to create an RLCG transmission line object, type:

h = rfckt.rlcgline

because the RLCG transmission line object is a circuit (rfckt) object named
rlcgline.

3-2
 Creating RF Objects

For a list of the available object constructors for each type of object, see
Chapter 2, “Selecting an RF Object”.

The following code illustrates how to call the object constructor to create a
microstrip transmission line object with default property values. The output
t1 is the handle of the newly created transmission line object.

t1 = rfckt.microstrip

RF Toolbox software lists the properties of the transmission line you created
along with the associated default property values.

t1 =
Name: 'Microstrip Transmission Line'
nPort: 2
AnalyzedResult: []
LineLength: 0.0100
StubMode: 'NotAStub'
Termination: 'NotApplicable'
Width: 6.0000e-004
Height: 6.3500e-004
Thickness: 5.0000e-006
EpsilonR: 9.8000
SigmaCond: Inf
LossTangent: 0

The rfckt.microstrip reference page describes these properties in detail.

Fitting a Rational Function to Passive Component Data

You can create a model object by fitting a rational function to passive
component data. You use this approach to create a model object that
represents one of the following using a rational function:

• A circuit object that you created and analyzed.

• Data that you imported from a file.

For more information, see “Fitting a Model Object to Circuit Object Data”
on page 3-37.

3-3
 3 Modeling an RF Component

Copying an Existing Object

You can create a new object with the same property values as an existing
object by using the copy function to copy the existing object. This function is
useful if you have an object that is similar to one you want to create.

For example,

t2 = copy(t1);

creates a new object, t2, which has the same property values as the microstrip
transmission line object, t1.

You can later change specific property values for this copy. For information
on modifying object properties, see “Specifying or Importing Component Data”
on page 3-5.

Note The syntax t2 = t1 copies only the object handle and does not create a
new object.

3-4
 Specifying or Importing Component Data

Specifying or Importing Component Data

In this section...
“RF Object Properties” on page 3-5
“Setting Property Values” on page 3-5
“Importing Property Values from Data Files” on page 3-8
“Using Data Objects to Specify Circuit Properties” on page 3-11
“Retrieving Property Values” on page 3-14
“Direct Property Referencing Using Dot Notation” on page 3-16

RF Object Properties
Object properties specify the behavior of an object. You can specify object
properties, or you can import them from a data file. To learn about properties
that are specific to a particular type of circuit, data, or model object, see the
reference page for that type of object.

Note The “RF Circuit Objects” on page 2-4, “RF Data Objects” on page
2-2,“RF Model Objects” on page 2-10 sections list the available types of objects
and provide links to their reference pages.

Setting Property Values

You can specify object property values when you construct an object or you
can modify the property values of an existing object.

This section contains the following topics:

• “Specifying Property Values at Construction” on page 3-5

• “Changing Property Values of an Existing Object” on page 3-7

Specifying Property Values at Construction

To set a property when you construct an object, include a comma-separated
list of one or more property/value pairs in the argument list of the object

3-5
 3 Modeling an RF Component

construction command. A property/value pair consists of the arguments

'PropertyName',PropertyValue, where:

• PropertyName is a string specifying the property name. The name is

case-insensitive. In addition, you need only type enough letters to uniquely
identify the property name. For example, 'st' is sufficient to refer to the
StubMode property.

Note You must use single quotation marks around the property name.

• PropertyValue is the value to assign to the property.

Include as many property names in the argument list as there are properties
you want to set. Any property values that you do not set retain their default
values. The circuit and data object reference pages list the valid values as
well as the default value for each property.

This section contains examples of how to perform the following tasks:

• “Constructing Components with Specified Properties” on page 3-6

• “Constructing Networks of Specified Components” on page 3-7

Constructing Components with Specified Properties. The following

code creates a coaxial transmission line circuit object to represent a coaxial
transmission line that is 0.05 meters long. Notice that the toolbox lists the
available properties and their values.

t1 = rfckt.coaxial('LineLength',0.05)

t1 =

Name: 'Coaxial Transmission Line'

nPort: 2
AnalyzedResult: []
LineLength: 0.0500
StubMode: 'NotAStub'
Termination: 'NotApplicable'
OuterRadius: 0.0026

3-6
 Specifying or Importing Component Data

InnerRadius: 7.2500e-004
MuR: 1
EpsilonR: 2.3000
LossTangent: 0
SigmaCond: Inf

Constructing Networks of Specified Components. To combine a set of

RF components and existing networks to form an RF network, you create a
network object with the Ckts property set to an array containing the handles
of all the circuit objects in the network.

Suppose you have the following RF components:

t1 = rfckt.coaxial('LineLength',0.05);
a1 = rfckt.amplifier;
t2 = rfckt.coaxial('LineLength',0.1);

The following code creates a cascaded network of these components:

casc_network = rfckt.cascade('Ckts',{t1,a1,t2});

Changing Property Values of an Existing Object

There are two ways to change the properties of an existing object:

• Using the set command

• Using structure-like assignments called dot notation

This section discusses the first option. For details on the second option, see
“Direct Property Referencing Using Dot Notation” on page 3-16.

To modify the properties of an existing object, use the set command with one
or more property/value pairs in the argument list. The general syntax of
the command is

set(h,Property1',value1,'Property2',value2,...)

where

• h is the handle of the object.

3-7
 3 Modeling an RF Component

• 'Property1',value1,'Property2',value2,... is the list of

property/value pairs.

For example, the following code creates a default coaxial transmission line
object and changes it to a series stub with open termination.

t1 = rfckt.coaxial;
set(t1,'StubMode','series','Termination','open')

Note You can use the set command without specifying any property/value
pairs to display a list of all properties you can set for a specific object. This
example lists the properties you can set for the coaxial transmission line t1:

set(t1)

ans =
LineLength: {}
StubMode: {}
Termination: {}
OuterRadius: {}
InnerRadius: {}
MuR: {}
EpsilonR: {}
LossTangent: {}
SigmaCond: {}

Importing Property Values from Data Files

RF Toolbox software lets you import industry-standard data files, MathWorks
AMP files, and Agilent P2D and S2D files into specific objects. This import
capability lets you simulate the behavior of measured components.

You can import the following file formats:

• Industry-standard file formats — Touchstone SNP, YNP, ZNP, HNP, and

GNP formats specify the network parameters and noise information for
measured and simulated data.

3-8
 Specifying or Importing Component Data

For more information on Touchstone files, see

www.vhdl.org/pub/ibis/connector/touchstone_spec11.pdf.
• Agilent P2D file format — Specifies amplifier and mixer large-signal,
power-dependent network parameters, noise data, and intermodulation
tables for several operating conditions, such as temperature and bias
values.
The P2D file format lets you import system-level verification models of
amplifiers and mixers.
• Agilent S2D file format — Specifies amplifier and mixer network
parameters with gain compression, power-dependent S21 parameters, noise
data, and intermodulation tables for several operating conditions.
The S2D file format lets you import system-level verification models of
amplifiers and mixers.
• MathWorks amplifier (AMP) file format — Specifies amplifier network
parameters, output power versus input power, noise data and third-order
intercept point.
For more information about .amp files, see Appendix A, “AMP File Format”.

This section contains the following topics:

• “Objects Used to Import Data from a File” on page 3-9

• “How to Import Data Files” on page 3-10

Objects Used to Import Data from a File

One data object and three circuit objects accept data from a file. The following
table lists the objects and any corresponding data format each supports.

Object Description Supported Format(s)

rfdata.data Data object containing Touchstone, AMP, P2D,
network parameter S2D
data, noise figure, and
third-order intercept
point
rfckt.amplifier Amplifier Touchstone, AMP, P2D,
S2D

3-9
 3 Modeling an RF Component

Object Description Supported Format(s)

rfckt.mixer Mixer Touchstone, AMP, P2D,
S2D
rfckt.passive Generic passive Touchstone
component

How to Import Data Files

To import file data into a circuit or data object at construction, use a read
command of the form:

obj = read(obj_type,'filename');

where

• obj is the handle of the circuit or data object.

• obj_type is the type of object in which to store the data, from the list of
objects that accept file data shown in “Objects Used to Import Data from
a File” on page 3-9.
• filename is the name of the file that contains the data.

For example,

ckt_obj=read(rfckt.amplifier, 'default.amp');

imports data from the file default.amp into an rfckt.amplifier object.

You can also import file data into an existing circuit object. The following
commands are equivalent to the previous command:

ckt_obj=rfckt.amplifier;
read(ckt_obj, 'default.amp');

Note When you import component data from a .p2d or .s2d file, properties
are defined for several operating conditions. You must select an operating
condition to specify the object behavior, as described in “Specifying Operating
Conditions” on page 3-17.

3-10
 Specifying or Importing Component Data

Using Data Objects to Specify Circuit Properties

To specify a circuit object property using a data object, use the set command
with the name of the data object as the value in the property/value pair.

For example, suppose you have the following rfckt.amplifier and

rfdata.nf objects:

amp = rfckt.amplifier
f = 2.0e9;
nf = 13.3244;
nfdata = rfdata.nf('Freq',f,'Data',nf)

The following command uses the rfdata.nf data object to specify the
rfckt.amplifier NoiseData property:

set(amp,'NoiseData',nfdata)

Example — Setting Circuit Object Properties Using Data Objects

In this example, you create a circuit object. Then, you create three data
objects and use them to update the properties of the circuit object.

1 Create an amplifier object. This circuit object, rfckt.amplifier, has

a network parameter, noise data, and nonlinear data properties. These
properties control the frequency response of the amplifier, which is stored
in the AnalyzedResult property. By default, all amplifier properties
contain values from the default.amp file. The NetworkData property is an
rfdata.network object that contains 50-ohm S-parameters. The NoiseData
property is an rfdata.noise object that contains frequency-dependent spot
noise data. The NonlinearData property is an rfdata.power object that
contains output power and phase information.

amp = rfckt.amplifier

3-11
 3 Modeling an RF Component

The toolbox displays the following output:

amp =

Name: 'Amplifier'
nPort: 2
AnalyzedResult: [1x1 rfdata.data]
IntpType: 'Linear'
NetworkData: [1x1 rfdata.network]
NoiseData: [1x1 rfdata.noise]
NonlinearData: [1x1 rfdata.power]

2 Create a data object that stores network data. Type the following set
of commands at the MATLAB prompt to create an rfdata.network object
that stores the 2-port Y-parameters at 2.08 GHz, 2.10 GHz, and 2.15 GHz.
Later in this example, you use this data object to update the NetworkData
property of the rfckt.amplifier object.

f = [2.08 2.10 2.15]*1.0e9;

y(:,:,1) = [-.0090-.0104i, .0013+.0018i; ...
-.2947+.2961i, .0252+.0075i];
y(:,:,2) = [-.0086-.0047i, .0014+.0019i; ...
-.3047+.3083i, .0251+.0086i];
y(:,:,3) = [-.0051+.0130i, .0017+.0020i; ...
-.3335+.3861i, .0282+.0110i];

netdata = rfdata.network('Type','Y_PARAMETERS',...
'Freq',f,'Data',y)

The toolbox displays the following output:

netdata =

Name: 'Network parameters'

Type: 'Y_PARAMETERS'
Freq: [3x1 double]
Data: [2x2x3 double]
Z0: 50

3-12
 Specifying or Importing Component Data

3 Create a data object that stores noise figure values. Type the
following set of commands at the MATLAB prompt to create a rfdata.nf
object that contains noise figure values, in dB, at seven different
frequencies. Later in this example, you use this data object to update the
NoiseData property of the rfckt.amplifier object.

f = [1.93 2.06 2.08 2.10 2.15 2.30 2.40]*1.0e9;

nf=[12.4521 13.2466 13.6853 14.0612 13.4111 12.9499 13.3244];

nfdata = rfdata.nf('Freq',f,'Data',nf)

The toolbox displays the following output:

nfdata =

Name: 'Noise figure'

Freq: [7x1 double]
Data: [7x1 double]

4 Create a data object that stores output third-order intercept

points. Type the following command at the MATLAB prompt to create a
rfdata.ip3 object that contains an output third-order intercept point of
8.45 watts, at 2.1 GHz. Later in this example, you use this data object to
update the NonlinearData property of the rfckt.amplifier object.

ip3data = rfdata.ip3('Type','OIP3','Freq',2.1e9,'Data',8.45)

The toolbox displays the following output:

ip3data =

Name: '3rd order intercept'

Type: 'OIP3'
Freq: 2.1000e+009
Data: 8.4500

3-13
 3 Modeling an RF Component

5 Update the properties of the amplifier object. Type the following

set of commands at the MATLAB prompt to update the NetworkData,
NoiseData, and NonlinearData properties of the amplifier object with the
data objects you created in the previous steps:

amp.NetworkData = netdata;
amp.NoiseData = nfdata;
amp.NonlinearData = ip3data;

Retrieving Property Values

You can retrieve one or more property values of an existing object using the
get command.

This section contains the following topics:

• “Retrieving Specified Property Values” on page 3-14

• “Retrieving All Property Values” on page 3-15

Retrieving Specified Property Values

To retrieve specific property values for an object, use the get command with
the following syntax:

PropertyValue = get(h,PropertyName)

where

• PropertyValue is the value assigned to the property.

• h is the handle of the object.
• PropertyName is a string specifying the property name.

For example, suppose you have the following coaxial transmission line:

h2 = rfckt.coaxial;

3-14
 Specifying or Importing Component Data

The following code retrieves the value of the inner radius and outer radius for
the coaxial transmission line:

ir = get(h2,'InnerRadius')
or = get(h2,'OuterRadius')

ir =
7.2500e-004

or =
0.0026

Retrieving All Property Values

To display a list of properties associated with a specific object as well as their
current values, use the get command without specifying a property name.

For example:

get(h2)
Name: 'Coaxial Transmission Line'
nPort: 2
AnalyzedResult: []
LineLength: 0.0100
StubMode: 'NotAStub'
Termination: 'NotApplicable'
OuterRadius: 0.0026
InnerRadius: 7.2500e-004
MuR: 1
EpsilonR: 2.3000
LossTangent: 0
SigmaCond: Inf

Note This list includes read-only properties that do not appear when you
type set(h2). For a coaxial transmission line object, the read-only properties
are Name, nPort, and AnalyzedResult. The Name and nPort properties are
fixed by the toolbox. The AnalyzedResult property value is calculated and
set by the toolbox when you analyze the component at specified frequencies.

3-15
 3 Modeling an RF Component

Direct Property Referencing Using Dot Notation

An alternative way to query for or modify property values is by structure-like
referencing. The field names for RF objects are the property names, so you
can retrieve or modify property values with the structure-like syntax.

• PropertyValue = rfobj.PropertyName stores the value of the

PropertyName property of the rfobj object in the PropertyValue
variable. This command is equivalent to PropertyValue =
get(rfobj,'PropertyName').
• rfobj.PropertyName = PropertyValue sets the value of the PropertyName
property to PropertyValue for the rfobj object. This command is
equivalent to set(rfobj,'PropertyName',PropertyValue).

For example, typing

ckt = rfckt.amplifier('IntpType','cubic');
ckt.IntpType

gives the value of the property IntpType for the circuit object ckt.

ans =
Cubic

Similarly,

ckt.IntpType = 'linear';

resets the interpolation method to linear.

You do not need to type the entire field name or use uppercase characters.
You only need to type the minimum number of characters sufficient to identify
the property name uniquely. Thus entering the commands

ckt = rfckt.amplifier('IntpType','cubic');
ckt.in

also produces

ans =
Cubic

3-16
 Specifying Operating Conditions

Specifying Operating Conditions

In this section...
“Available Operating Conditions” on page 3-17
“Setting Operating Conditions” on page 3-17
“Displaying Available Operating Condition Values” on page 3-18

Available Operating Conditions

Agilent P2D and S2D files contain simulation results at one or more operating
conditions. Operating conditions define the independent parameter settings
that are used when creating the file data. The specified conditions differ
from file to file.

When you import component data from a .p2d or .s2d file, the object contains
property values for several operating conditions. The available conditions
depend on the data in the file. By default, RF Toolbox software defines the
object behavior using the property 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.

Setting Operating Conditions

To set the operating conditions of a circuit or data object, use a setop
command of the form:

setop(,’Condition1’,value1,...,’ConditionN’,valueN,...)

where

• is the handle of the circuit or data object.

• Condition1,value1,...,ConditionN,valueN are the condition/value
pairs that specify the operating condition.

For example,

setop(myp2d, 'BiasL', 2, 'BiasU', 6.3)

3-17
 3 Modeling an RF Component

specifies an operating condition of BiasL = 2 and BiasU = 6.3 for myp2d.

Displaying Available Operating Condition Values

To display a list of available operating condition values for a circuit or data
object, use the setop method.

setop(obj)

displays the available values for all operating conditions of the object obj.

setop(obj,'Condition1')

displays the available values for Condition1.

3-18
 Processing File Data for Analysis

Processing File Data for Analysis

In this section...
“Converting Single-Ended S-Parameters to Mixed-Mode S-Parameters”
on page 3-19
“Extracting M-Port S-Parameters from N-Port S-Parameters” on page 3-21
“Cascading N-Port S-Parameters” on page 3-23

Converting Single-Ended S-Parameters to

Mixed-Mode S-Parameters
After you import file data (as described in “Importing Property Values
from Data Files” on page 3-8), you can convert a matrix of single-ended
S-parameter data to a matrix of mixed-mode S-parameters.

This section contains the following topics:

• “Functions for Converting S-Parameters” on page 3-19

• “Example — Converting S-Parameters” on page 3-20

Functions for Converting S-Parameters

To convert between 4-port single-ended S-parameter data and 2-port
differential-, common-, and cross-mode S-parameters, use one of these
functions:

• s2scc — Convert 4-port, single-ended S-parameters to 2-port,

common-mode S-parameters (Scc).
• s2scd — Convert 4-port, single-ended S-parameters to 2-port, cross-mode
S-parameters (Scd).
• s2sdc — Convert 4-port, single-ended S-parameters to cross-mode
S-parameters (Sdc).
• s2sdd — Convert 4-port, single-ended S-parameters to 2-port,
differential-mode S-parameters (Sdd).

3-19
 3 Modeling an RF Component

To perform the above conversions all at once, or to convert larger data sets,
use one of these functions:

• s2smm — Convert 4N-port, single-ended S-parameters to 2N-port,

mixed-mode S-parameters.
• smm2s — Convert 2N-port, mixed-mode S-parameters to 4N-port,
single-ended S-parameters.

Conversion functions support a variety of port orderings. For more

information on these functions, see the corresponding reference pages.

Example — Converting S-Parameters

In this example, use the toolbox to import 4-port single-ended S-parameter
data from a file, convert the data to 2-port differential S-parameter data, and
create a new rfckt object to store the converted data for analysis.

At the MATLAB prompt:

1 Type this command to import data from the file default.s4p:

SingleEnded4Port = read(rfdata.data,'default.s4p');

2 Type this command to convert 4-port single-ended S-parameters to 2-port

mixed-mode S-parameters:

DifferentialSParams = s2sdd(SingleEnded4Port.S_Parameters);

Note The S-parameters that you specify as input to the s2sdd function
are the ones the toolbox stores in the S_Parameters property of the
rfdata.data object.

3 Type this command to create an rfckt.passive object that stores the

2-port differential S-parameters for simulation:

DifferentialCkt = rfckt.passive('NetworkData', ...

rfdata.network('Data', DifferentialSParams, 'Freq', ...
SingleEnded4PortData.Freq));

3-20
 Processing File Data for Analysis

Extracting M-Port S-Parameters from N-Port

S-Parameters
After you import file data (as described in “Importing Property Values from
Data Files” on page 3-8), you can extract a set of data with a smaller number
of ports by terminating one or more ports with a specified impedance.

This section contains the following topics:

• “How To Extract S-Parameters” on page 3-21

• “Example — Extracting S-Parameters From Imported File Data” on page
3-22

How To Extract S-Parameters

To extract M-port S-parameters from N-port S-parameters, use the snp2smp
function with the following syntax:

s_params_mp = snp2smp(s_params_np, z0, n2m_index, zt)

where

• s_params_np is an array of N-port S-parameters with a reference

impedance z0.
• s_params_mp is an array of M-port S-parameters.
• n2m_index is a vector of length M specifying how the ports of the N-port
S-parameters map to the ports of the M-port S-parameters. n2m_index(i)
is the index of the port from s_params_np that is converted to the ith port
of s_params_mp.
• zt is the termination impedance of the ports.

The following figure illustrates how to specify the ports for the output data
and the termination of the remaining ports.

3-21
 3 Modeling an RF Component

M-Port

ZT{1} 1 N ZT{N}
N-Port M
ZT{2} 2 N-1 n2m_index(M)=N-1

. .
. .
. .

k ZT{k}
1 2
n2m_index(1)=i i j n2m_index(2)=j

For more details about the arguments to this function, see the snp2smp
reference page.

Example — Extracting S-Parameters From Imported File Data

In this example, use the toolbox to import 16-port S-parameter data from a
file, convert the data to 4-port S-parameter data by terminating the remaining
ports, and create a new rfckt object to store the extracted data for analysis.

At the MATLAB prompt:

1 Type this command to import data from the file default.s16p into an
rfdata.data object, SingleEnded16PortData:

SingleEnded16PortData = read(rfdata.data,'default.s16p');

2 Type this command to convert 16-port S-parameters to 4-port S-parameters

by using ports 1, 16, 2, and 15 as the first, second, third, and fourth ports,
and terminating the remaining 12 ports with an impedance of 50 ohms:

N2M_index = [1 16 2 15];
FourPortSParams = snp2smp(SingleEnded16PortData.S_Parameters, ...

3-22
 Processing File Data for Analysis

SingleEnded16PortData.Z0, N2M_index, 50);

Note The S-parameters that you specify as input to the snp2smp function
are the ones the toolbox stores in the S_Parameters property of the
rfdata.data object.

3 Type this command to create an rfckt.passive object that stores the

4-port S-parameters for simulation:

FourPortChannel = rfckt.passive('NetworkData', ...

rfdata.network('Data', FourPortSParams, 'Freq', ...
SingleEnded16PortData.Freq));

Cascading N-Port S-Parameters

After you import file data (as described in “Importing Property Values from
Data Files” on page 3-8), you can cascade two or more networks of N-port
S-parameters.

This section contains the following topics:

• “How To Cascade N-Port S-Parameters” on page 3-23

• “Example — Cascading N-Port S-Parameters” on page 3-24

How To Cascade N-Port S-Parameters

To cascade networks of N-port S-parameters, use the cascadesparams
function with the following syntax:

s_params = cascadesparams(s1_params,s2_params,...,sn_params,nconn)

where

• s_params is an array of cascaded S-parameters.

• s1_params,s2_params,...,sn_params are arrays of input S-parameters.
• nconn is a positive scalar or a vector of size n-1 specifying how many
connections to make between the ports of the input S-parameters.

3-23
 3 Modeling an RF Component

cascadesparams connects the last port(s) of one network to the first port(s)
of the next network.

For more details about the arguments to this function, see the
cascadesparams reference page.

Example — Cascading N-Port S-Parameters

In this example, use the toolbox to import 16-port and 4-port S-parameter file
data and cascade the two S-parameter networks by connecting the last three
ports of the 16-port network to the first three ports of the 4-port network.
Then, create a new rfckt object to store the resulting network for analysis.

At the MATLAB prompt:

1 Type these commands to import data from the files default.s16p and
default.s4p, and create the 16- and 4-port networks of S-parameters:

S_16Port = read(rfdata.data,'default.s16p');
S_4Port = read(rfdata.data,'default.s4p');freq = [2e9 2.1e9];
freq = [2e9 2.1e9];
analyze(S_16Port, freq);
analyze(S_4Port, freq);
sparams_16p = S_16Port.AnalyzedResult.S_Parameters;
sparams_4p = S_4Port.AnalyzedResult.S_Parameters;

2 Type this command to cascade 16-port S-parameters and 4-port

S-parameters by connecting ports 14, 15, and 16 of the 16-port network to
ports 1, 2, and 3 of the 4-port network:

sparams_cascaded = cascadesparams(sparams_16p, sparams_4p,3)

cascadesparams creates a 14-port network. Ports 1–13 are the first 13 ports
of the 16-port network. Port 14 is the fourth port of the 4-port network.

3 Type this command to create an rfckt.passive object that stores the

14-port S-parameters for simulation:

Ckt14 = rfckt.passive('NetworkData', ...

rfdata.network('Data', sparams_cascaded, 'Freq', ...
freq));

3-24
 Processing File Data for Analysis

For more examples of how to use this function, see the cascadesparams
reference page.

3-25
 3 Modeling an RF Component

Analyzing and Plotting RF Components

In this section...
“Analyzing Networks in the Frequency Domain” on page 3-26
“Visualizing Component and Network Data” on page 3-27
“Computing and Plotting Time-Domain Specifications” on page 3-36

Analyzing Networks in the Frequency Domain

RF Toolbox software lets you analyze RF components and networks in the
frequency domain. You use the analyze method to analyze a circuit object
over a specified set of frequencies.

For example, to analyze a coaxial transmission line from 1 GHz to 2.9 GHz in
increments of 10 MHz:

ckt = rfckt.coaxial;
f = [1.0e9:1e7:2.9e9];
analyze(ckt,f);

Note For all circuits objects except those that contain data from a file, you
must perform a frequency-domain analysis with the analyze method before
visualizing component and network data. For circuits that contain data from
a file, the toolbox performs a frequency-domain analysis when you use the
read method to import the data.

When you analyze a circuit object, the toolbox computes the circuit network
parameters, noise figure values, and output third-order intercept point (OIP3)
values at the specified frequencies and stores the result of the analysis in the
object’s AnalyzedResult property.

For more information, see the analyze reference page or the circuit object
reference page.

3-26
 Analyzing and Plotting RF Components

Visualizing Component and Network Data

The toolbox lets you validate the behavior of circuit objects that represent RF
components and networks by plotting the following data:

• Large- and small-signal S-parameters

• Noise figure
• Output third-order intercept point
• Power data
• Phase noise
• Voltage standing-wave ratio
• Power gain
• Group delay
• Reflection coefficients
• Stability data
• Transfer function

The following table summarizes the available plots and charts, along with the
methods you can use to create each one and a description of its contents.

Plot Type Methods Plot Contents

Rectangular Plot plot Parameters as a function of
frequency or, where applicable,
plotyy
operating condition. The
loglog available parameters include:
semilogx
• S-parameters
semilogy
• Noise figure
• Voltage standing-wave ratio
(VSWR)
• OIP3
Budget Plot (3-D) plot Parameters as a function of
frequency for each component

3-27
 3 Modeling an RF Component

Plot Type Methods Plot Contents

in a cascade, where the

curve for a given component
represents the cumulative
contribution of each RF
component up to and including
the parameter value of that
component.
Mixer Spur Plot plot Mixer spur power as a
function of frequency for an
rfckt.mixer object or an
rfckt.cascade object that
contains a mixer.
Polar Plot polar Magnitude and phase of
S-parameters as a function of
frequency.
Smith Chart smith Real and imaginary parts of
S-parameters as a function of
frequency, used for analyzing
the reflections caused by
impedance mismatch.

For each plot you create, you choose a parameter to plot and, optionally, a
format in which to plot that parameter. The plot format defines how the
toolbox displays the data on the plot. The available formats vary with the data
you select to plot. The data you can plot depends on the type of plot you create.

Note You can use the listparam method to list the parameters of a specified
circuit object that are available for plotting. You can use the listformat
method to list the available formats for a specified circuit object parameter.

The following topics describe the available plots:

• “Rectangular” on page 3-29

• “Budget” on page 3-29

3-28
 Analyzing and Plotting RF Components

• “Mixer Spur” on page 3-32

• “Polar Plots and Smith Charts” on page 3-35

Rectangular
You can plot any parameters that are relevant to your object on a rectangular
plot. You can plot parameters as a function of frequency for any object. When
you import object data from a .p2d or .s2d file, you can also plot parameters
as a function of any operating condition from the file that has numeric values,
such as bias. In addition, when you import object data from a .p2d file, you can
plot large-signal S-parameters as a function of input power or as a function of
frequency. These parameters are denoted LS11, LS12, LS21, and LS22.

The following table summarizes the methods that are available in the toolbox
for creating rectangular plots and describes the uses of each one. For more
information on a particular type of plot, follow the link in the table to the
documentation for that method.

Method Description
plot Plot of one or more object parameters
plotyy Plot of one or more object parameters with
y-axes on both the left and right sides
semilogx Plot of one or more object parameters using a
log scale for the X-axis
semilogy Plot of one or more object parameters using a
log scale for the Y-axis
loglog Plot of one or more object parameters using a
log-log scale

Budget
You use the link budget plot to understand the individual contribution of
each component to a plotted parameter value in a cascaded network with
multiple components.

3-29
 3 Modeling an RF Component

The budget plot is a three-dimensional plot that shows one or more curves of
parameter values as a function of frequency, ordered by the circuit index of
the cascaded network.

Consider the following cascaded network:

casc = rfckt.cascade('Ckts',...
{rfckt.amplifier,rfckt.lcbandpasspi,rfckt.txline})

The following figure shows how the circuit index is assigned to each
component in the cascade, based on its sequential position in the network.

rfckt.amplifier rfckt.lcbandpasspi rfckt.txline

object object object
(Index = 1) (Index = 2) (Index = 3)

You create a budget plot for this cascade using the plot method with the
second argument set to 'budget', as shown in the following command:

plot(casc,'budget','s21')

A curve on the link budget plot for each circuit index represents the
contributions to the parameter value of the RF components up to that index.
The following figure shows the budget plot.

3-30
 Analyzing and Plotting RF Components

Contributions to S21 Contributions to S21 Contributions to S21

from component 1 from components from components
1 and 2 1, 2, and 3

Example — Budget Plot

If you specify two or more parameters, the toolbox puts the parameters in a
single plot. You can only specify a single format for all the parameters.

3-31
 3 Modeling an RF Component

Mixer Spur
You use the mixer spur plot to understand how mixer nonlinearities
affect output power at the desired mixer output frequency and at the
intermodulation products that occur at the following frequencies:

fout = N ∗ fin + M ∗ f LO
where

• fin is the input frequency.

• f LO is the local oscillator frequency.

• N and M are integers.

The toolbox calculates the output power from the mixer intermodulation
table (IMT). These tables are described in detail in the Visualizing Mixer
Spurs demo.

The mixer spur plot shows power as a function of frequency for an

rfckt.mixer object or an rfckt.cascade object that contains a mixer. By
default, the plot is three-dimensional and shows a stem plot of power as a
function of frequency, ordered by the circuit index of the object. You can
create a two-dimensional stem plot of power as a function of frequency for a
single circuit index by specifying the index in the mixer spur plot command.

Consider the following cascaded network:

FirstCkt = rfckt.amplifier('NetworkData', ...

rfdata.network('Type', 'S', 'Freq', 2.1e9, ...
'Data', [0,0;10,0]), 'NoiseData', 0, 'NonlinearData', inf);
SecondCkt = read(rfckt.mixer, 'samplespur1.s2d');
ThirdCkt = rfckt.lcbandpasstee('L', [97.21 3.66 97.21]*1e-9, ...
'C', [1.63 43.25 1.63]*1.0e-12);
CascadedCkt = rfckt.cascade('Ckts', ...
{FirstCkt, SecondCkt, ThirdCkt});

The following figure shows how the circuit index is assigned to the components
in the cascade, based on its sequential position in the network.

3-32
 Analyzing and Plotting RF Components

LNA Mixer Filter

Circuit Index 0 Circuit Index 1 Circuit Index 2 Circuit Index 3

• Circuit index 0 corresponds to the cascade input.

• Circuit index 1 corresponds to the LNA output.
• Circuit index 2 corresponds to the mixer output.
• Circuit index 3 corresponds to the filter output.

You create a spur plot for this cascade using the plot method with the second
argument set to 'mixerspur', as shown in the following command:

plot(CascadedCkt,'mixerspur')

Within the three dimensional plot, the stem plot for each circuit index
represents the power at that circuit index. The following figure shows the
mixer spur plot.

3-33
 3 Modeling an RF Component

Input power Output power Output power Output power

of component 1 of component 1 of component 2 of component 3

Example — Mixer Spur Plot

For more information on mixer spur plots, see the plot reference page.

3-34
 Analyzing and Plotting RF Components

Polar Plots and Smith Charts

You can use the toolbox to generate Polar plots and Smith Charts. If you
specify two or more parameters, the toolbox puts the parameters in a single
plot.

The following table describes the Polar plot and Smith Chartt options, as well
as the available parameters.

Note LS11, LS12, LS21, and LS22 are large-signal S-parameters. You can plot
these parameters as a function of input power or as a function of frequency.

Plot Type Method Parameter

Polar plane polar S11, S12, S21, S22
LS11, LS12, LS21, LS22
(Objects with data from
a P2D file only)
Z Smith chart smith with type S11, S22
argument set to 'z'
LS11, LS22 (Objects
with data from a P2D
file only)
Y Smith chart smith with type S11, S22
argument set to 'y'
LS11, LS22 (Objects
with data from a P2D
file only)
ZY Smith chart smith with type S11, S22
argument set to 'zy'
LS11, LS22 (Objects
with data from a P2D
file only)

By default, the toolbox plots the parameter as a function of frequency. When

you import block data from a .p2d or .s2d file, you can also plot parameters
as a function of any operating condition from the file that has numeric values,
such as bias.

3-35
 3 Modeling an RF Component

Note The circle method lets you place circles on a Smith Chart to depict
stability regions and display constant gain, noise figure, reflection and
immittance circles. For more information about this method, see the circle
reference page or the two-part RF Toolbox demo about designing matching
networks.

For more information on a particular type of plot, follow the link in the table
to the documentation for that method.

Computing and Plotting Time-Domain Specifications

The toolbox lets you compute and plot time-domain characteristics for RF
components.

This section contains the following topics:

• “Computing the Network Transfer Function” on page 3-36

• “Fitting a Model Object to Circuit Object Data” on page 3-37
• “Computing and Plotting the Time-Domain Response” on page 3-38

Computing the Network Transfer Function

You use the s2tf function to convert 2-port S-parameters to a transfer
function. The function returns a vector of transfer function values that
represent the normalized voltage gain of a 2-port network.

The following code illustrates how to read file data into a passive circuit object,
extract the 2-port S-parameters from the object and compute the transfer
function of the data at the frequencies for which the data is specified. z0 is
the reference impedance of the S-parameters, zs is the source impedance, and
zl is the load impedance. See the s2tf reference page for more information
on how these impedances are used to define the gain.

PassiveCkt = rfckt.passive('File','passive.s2p')
z0=50; zs=50; zl=50;
[SParams, Freq] = extract(PassiveCkt, 'S Parameters', z0);
TransFunc = s2tf(SParams, z0, zs, zl);

3-36
 Analyzing and Plotting RF Components

Fitting a Model Object to Circuit Object Data

You use the rationalfit function to fit a rational function to the transfer
function of a passive component. The rationalfit function returns an
rfmodel object that represents the transfer function analytically.

The following code illustrates how to use the rationalfit function to create
an rfmodel.rational object that contains a rational function model of the
transfer function that you created in the previous example.

RationalFunc = rationalfit(Freq, TransFunc)

To find out how many poles the toolbox used to represent the data, look at the
length of the A vector of the RationalFunc model object.

nPoles = length(RationalFunc.A)

Note The number of poles is important if you plan to use the RF model object
to create a model for use in another simulator, because a large number of
poles can increase simulation time. For information on how to represent a
component accurately using a minimum number of poles, see “Representing a
Circuit Object with a Model Object” on page 4-5.

See the rationalfit reference page for more information.

Use the freqresp method to compute the frequency response of the fitted
data. To validate the model fit, plot the transfer function of the original data
and the frequency response of the fitted data.

Resp = freqresp(RationalFunc, Freq);

plot(Freq, 20*log10(abs(TransFunc)), 'r', ...
Freq, 20*log10(abs(Resp)), 'b--');
ylabel('Magnitude of H(s) (decibels)');
xlabel('Frequency (Hz)');
legend('Original', 'Fitting result');
title(['Rational fitting with ', int2str(nPoles), ' poles']);

3-37
 3 Modeling an RF Component

Computing and Plotting the Time-Domain Response

You use the timeresp method to compute the time-domain response of the
transfer function that RationalFunc represents.

The following code illustrates how to create a random input signal, compute
the time-domain response of RationalFunc to the input signal, and plot the
results.

SampleTime=1e-11;
NumberOfSamples=4750;
OverSamplingFactor = 25;
InputTime = double((1:NumberOfSamples)')*SampleTime;
InputSignal = ...
sign(randn(1, ceil(NumberOfSamples/OverSamplingFactor)));
InputSignal = repmat(InputSignal, [OverSamplingFactor, 1]);
InputSignal = InputSignal(:);

[tresp,t]=timeresp(RationalFunc,InputSignal,SampleTime);
plot(t*1e9,tresp);
title('Fitting Time-Domain Response', 'fonts', 12);
ylabel('Response to Random Input Signal');
xlabel('Time (ns)');

For more information about computing the time response of a model object,
see the timeresp reference page.

3-38
 Exporting Component Data to a File

Exporting Component Data to a File

In this section...
“Available Export Formats” on page 3-39
“How to Export Object Data” on page 3-39
“Example — Exporting Object Data” on page 3-40

Available Export Formats

RF Toolbox software lets you export data from any rfckt object or from an
rfdata.data object to industry-standard data files and MathWorks AMP
files. This export capability lets you store data for use in other simulations.

Note The toolbox also lets you export data from an rfmodel object to a
Verilog-A file. For information on how to do this, see Chapter 4, “Exporting
Verilog-A Models”.

You can export data to the following file formats:

• Industry-standard file formats — Touchstone SNP, YNP, ZNP, HNP, and

GNP formats specify the network parameters and noise information for
measured and simulated data.
For more information about Touchstone files, see
www.vhdl.org/pub/ibis/connector/touchstone_spec11.pdf.
• MathWorks amplifier (AMP) file format — Specifies amplifier network
parameters, output power versus input power, noise data and third-order
intercept point.
For more information about .amp files, see Appendix A, “AMP File Format”.

How to Export Object Data

To export data from a circuit or data object, use a write command of the form

status = write(obj,'filename');

3-39
 3 Modeling an RF Component

where

• status is a return value that indicates whether the write operation was
successful.
• obj is the handle of the circuit or rfdata.data object.
• filename is the name of the file that contains the data.

For example,

status = write(rfckt.amplifier, 'myamp.amp');

exports data from an rfckt.amplifier object to the file myamp.amp.

Example — Exporting Object Data

In this example, use the toolbox to create a vector of S-parameter data, store
it in an rfdata.data object, and export it to a Touchstone file.

At the MATLAB prompt:

1 Type the following to create a vector, s_vec, of S-parameter values at three

frequency values:

s_vec(:,:,1) = ...
[-0.724725-0.481324i, -0.685727+1.782660i; ...
0.000000+0.000000i, -0.074122-0.321568i];
s_vec(:,:,2) = ...
[-0.731774-0.471453i, -0.655990+1.798041i; ...
0.001399+0.000463i, -0.076091-0.319025i];
s_vec(:,:,3) = ...
[-0.738760-0.461585i, -0.626185+1.813092i; ...
0.002733+0.000887i, -0.077999-0.316488i];

2 Type the following to create an rfdata.data object called txdata with

the default property values:

txdata = rfdata.data;

3 Type the following to set the S-parameter values of txdata to the values
you specified in s_vec:

3-40
 Exporting Component Data to a File

txdata.S_Parameters = s_vec;

4 Type the following to set the frequency values of txdata to [1e9 2e9 3e9]:

txdata.Freq=1e9*[1 2 3];

5 Type the following to export the data in txdata to a Touchstone file called
test.s2p:

write(txdata,'test')

3-41
 3 Modeling an RF Component

Examples of Basic Operations with RF Objects

In this section...
“Reading and Analyzing RF Data from a Touchstone Data File” on page 3-42
“De-Embedding S-Parameters” on page 3-44

Reading and Analyzing RF Data from a Touchstone

Data File
In this example, you create an rfdata.data object by reading the
S-parameters of a 2-port passive network stored in the Touchstone format
data file, passive.s2p.

1 Read S-parameter data from a data file. Use the RF Toolbox read
command to read the Touchstone data file, passive.s2p. This file contains
50-ohm S-parameters at frequencies ranging from 315 kHz to 6 GHz. The
read command creates an rfdata.data object, data, and stores data from
the file in the object’s properties.

data = read(rfdata.data,'passive.s2p');

2 Extract the network parameters from the data object. Use the
extract command to convert the 50-ohm S-parameters in the rfdata.data
object, data, to 75-ohm S-parameters and save them in the variable
s_params. You also use the command to extract the Y-parameters from the
rfdata.data object and save them in the variable y_params.

freq = data.Freq;
s_params = extract(data,'S_PARAMETERS',75);
y_params = extract(data,'Y_PARAMETERS');

3-42
 Examples of Basic Operations with RF Objects

3 Plot the S11 parameters. Use the smithchart command to plot the
75-ohm S11 parameters on a Smith Chart:

s11 = s_params(1,1,:);
smithchart(s11(:));

4 View the 75-ohm S-parameters and Y-parameters at 6 GHz. Type

the following set of commands at the MATLAB prompt to display the four
75-ohm S-parameter values and the four Y-parameter values at 6 GHz.

f = freq(end)
s = s_params(:,:,end)
y = y_params(:,:,end)

3-43
 3 Modeling an RF Component

The toolbox displays the following output:

f =
6.0000e+009

s =
-0.0764 - 0.5401i 0.6087 - 0.3018i
0.6094 - 0.3020i -0.1211 - 0.5223i

y =
0.0210 + 0.0252i -0.0215 - 0.0184i
-0.0215 - 0.0185i 0.0224 + 0.0266i

For more information, see the rfdata.data, read, and extract reference
pages.

De-Embedding S-Parameters
The Touchstone data file samplebjt2.s2p contains S-parameter data
collected from a bipolar transistor in a test fixture. The input of the fixture
has a bond wire connected to a bond pad. The output of the fixture has a
bond pad connected to a bond wire.

The configuration of the bipolar transistor, which is the device under test
(DUT), and the fixture is shown in the following figure.

1nH 1 nH

100 fF DUT 100 fF

In this example, you remove the effects of the fixture and extract the
S-parameters of the DUT.

3-44
 Examples of Basic Operations with RF Objects

1 Create RF objects. Create a data object for the measured S-parameters

by reading the Touchstone data file samplebjt2.s2p. Then, create two
more circuit objects, one each for the input pad and output pad.

measured_data = read(rfdata.data,'samplebjt2.s2p');
input_pad = rfckt.cascade('Ckts',...
{rfckt.seriesrlc('L',1e-9), ...
rfckt.shuntrlc('C',100e-15)}); % L=1 nH, C=100 fF
output_pad = rfckt.cascade('Ckts',...
{rfckt.shuntrlc('C',100e-15),...
rfckt.seriesrlc('L',1e-9)}); % L=1 nH, C=100 fF

2 Analyze the input pad and output pad circuit objects. Analyze the
circuit objects at the frequencies at which the S-parameters are measured.

freq = measured_data.Freq;
analyze(input_pad,freq);
analyze(output_pad,freq);

3 De-embed the S-parameters. Extract the S-parameters of the DUT

from the measured S-parameters by removing the effects of the input and
output pads.

z0 = measured_data.Z0;

input_pad_sparams = extract(input_pad.AnalyzedResult,...
'S_Parameters',z0);
output_pad_sparams = extract(output_pad.AnalyzedResult,...
'S_Parameters',z0);

de_embedded_sparams = ...
deembedsparams(measured_data.S_Parameters,...
input_pad_sparams, output_pad_sparams);

4 Create a data object for the de-embedded S-parameters. In a later

step, you use this data object to plot the de-embedded S-parameters.

de_embedded_data = rfdata.data('Z0',z0,...
'S_Parameters',de_embedded_sparams,...
'Freq',freq);

3-45
 3 Modeling an RF Component

5 Plot the measured and de-embedded S11 parameters. Type the

following set of commands at the MATLAB prompt to plot both the
measured and the de-embedded S11 parameters on a Z Smith Chart:

hold off;
h = smith(measured_data,'S11');
set(h, 'Color', [1 0 0]);
hold on
i = smith(de_embedded_data,'S11');
set(i,'Color', [0 0 1],'LineStyle',':');
l = legend;
legend(l, {'Measured S_{11}', 'De-embedded S_{11}'});
legend show;

3-46
 Examples of Basic Operations with RF Objects

6 Plot the measured and de-embedded S22 parameters. Type the

following set of commands at the MATLAB prompt to plot the measured
and the de-embedded S22 parameters on a Z Smith Chart:

figure;
hold off;
h = smith(measured_data,'S22');
set(h, 'Color', [1 0 0]);
hold on
i = smith(de_embedded_data,'S22');
set(i,'Color', [0 0 1],'LineStyle',':');
l = legend;
legend(l, {'Measured S_{22}', 'De-embedded S_{22}'});
legend show;

3-47
 3 Modeling an RF Component

7 Plot the measured and de-embedded S21 parameters. Type the

following set of commands at the MATLAB prompt to plot the measured
and the de-embedded S21 parameters, in decibels, on an X-Y plane:

figure
hold off;
h = plot(measured_data,'S21', 'db');
set(h, 'Color', [1 0 0]);
hold on
i = plot(de_embedded_data,'S21','db');
set(i,'Color', [0 0 1],'LineStyle',':');
l = legend;
legend(l, {'Measured S_{21}', 'De-embedded S_{21}'});
legend show;
hold off;

3-48
 4

Exporting Verilog-A Models

• “Modeling RF Objects Using Verilog-A” on page 4-2

• “How to Export a Verilog-A Model” on page 4-5
 4 Exporting Verilog-A Models

Modeling RF Objects Using Verilog-A

In this section...
“Overview of Verilog-A Support” on page 4-2
“Behavioral Modeling Using Verilog-A” on page 4-2
“Supported Verilog-A Models” on page 4-3

Overview of Verilog-A Support

Verilog-A is a language for modeling the high-level behavior of analog
components and networks. Verilog-A describes components mathematically,
for fast and accurate simulation.

RF Toolbox software lets you export a Verilog-A description of your circuit.

You can create a Verilog-A model of any passive RF component or network
and use it as a behavioral model for transient analysis in a third-party circuit
simulator. This capability is useful in signal integrity engineering. For
example, you can import the measured four-port S-parameters of a backplane
into the toolbox, export a Verilog-A model of the backplane to a circuit
simulator, and use the model to determine the performance of your driver and
receiver circuitry when they are communicating across the backplane.

Behavioral Modeling Using Verilog-A

The Verilog-A language is a high-level language that uses modules to describe
the structure and behavior of analog systems and their components. A module
is a programming building block that forms an executable specification of
the system.

Verilog-A uses modules to capture high-level analog behavior of components

and systems. Modules describe circuit behavior in terms of

• Input and output nets characterized by predefined Verilog-A disciplines

that describe the attributes of the nets.
• Equations and module parameters that define the relationship between the
input and output nets mathematically.

4-2
 Modeling RF Objects Using Verilog-A

When you create a Verilog-A model of your circuit, the toolbox writes a
Verilog-A module that specifies circuit’s input and output nets and the
mathematical equations that describe how the circuit operates on the input
to produce the output.

For more information on the Verilog-A language, see the Verilog-A Reference
Manual.

Supported Verilog-A Models

RF Toolbox software lets you export a Verilog-A model of an rfmodel object.
The toolbox provides one rfmodel object, rfmodel.rational, that you can use
to represent any RF component or network for export to Verilog-A.

The rfmodel.rational object represents components as rational functions

in pole-residue form, as described in the rfmodel.rational reference page.
This representation can include complex poles and residues, which occur
in complex-conjugate pairs.

The toolbox implements each rfmodel.rational object as a series of Laplace

Transform S-domain filters in Verilog-A using the numerator-denominator
form of the Laplace transform filter:

M
∑ nk sk
k =0
H (s) = N
∑ dk sk
k =0

where

• M is the order of the numerator polynomial.

• M is the order of the denominator polynomial.
• nk is the coefficient of the kth power of s in the numerator.
• dk is the coefficient of the kth power of s in the denominator.

The number of poles in the rational function is related to the number

of Laplace transform filters in the Verilog-A module. However, there is

4-3
 4 Exporting Verilog-A Models

not a one-to-one correspondence between the two. The difference arises

because the toolbox combines each pair of complex-conjugate poles and the
corresponding residues in the rational function to form a Laplace transform
numerator and denominator with real coefficients. the toolbox converts the
real poles of the rational function directly to a Laplace transform filter in
numerator-denominator form.

4-4
 How to Export a Verilog-A Model

How to Export a Verilog-A Model

In this section...
“Representing a Circuit Object with a Model Object” on page 4-5
“Writing a Verilog-A Module” on page 4-7

Representing a Circuit Object with a Model Object

Before you can write a Verilog-A model of an RF circuit object, you need to
create an rfmodel.rational object to represent the component.

There are two ways to create an RF model object:

• You can fit a rational function model to the component data using the
rationalfit function.
• You can use the rfmodel.rational constructor to specify the pole-residue
representation of the component directly.

This section discusses using a rational function model. For more information
on using the constructor, see the rfmodel.rational reference page.

When you use the rationalfit function to create an rfmodel.rational

object that represents an RF component, the arguments you specify affect how
quickly the resulting Verilog-A model runs in a circuit simulator.

You can use the rationalfit function with only the two required arguments.
The syntax is:

model_obj = rationalfit(freq,data)

where

• model_obj is a handle to the rational function model object.

• freq is a vector of frequency values that correspond to the data values.
• data is a vector that contains the data to fit.

4-5
 4 Exporting Verilog-A Models

For faster simulation, create a model object with the smallest number of poles
required to accurately represent the component. To control the number of
poles, use the syntax:

model_obj = rationalfit(freq,data,tol,weight,delayfactor)

where

• tol — the relative error-fitting tolerance, in decibels. Specify the largest

acceptable tolerance for your application. Using tighter tolerance values
may force the rationalfit function to add more poles to the model to
achieve a better fit.
• weight — a vector that specifies the weighting of the fit at each frequency.
• delayfactor — a value that controls the amount of delay used to fit the
data. Delay introduces a phase shift in the frequency domain that may
require a large number of poles to fit using a rational function model. When
you specify the delay factor, the rationalfit function represents the delay
as an exponential phase shift. This phase shift allows the function to fit
the data using fewer poles.

These arguments are described in detail in the rationalfit function

reference page.

Note You can also specify the number of poles directly using the npoles
argument. The model accuracy is not guaranteed with approach, so you
should not specify npoles when accuracy is critical. For more information on
the npoles argument, see the rationalfit reference page.

If you plan to integrate the Verilog-A module into a large design for simulation
using detailed models, such as transistor-level circuit models, the simulation
time consumed by a Verilog-A module may have a trivial impact on the overall
simulation time. In this case, there is no reason to take the time to optimize
the rational function model of the component.

For more information on the rationalfit function arguments, see the

rationalfit reference page.

4-6
 How to Export a Verilog-A Model

Writing a Verilog-A Module

You use the writeva method to create a Verilog-A module that describes
the RF model object. This method writes the module to a specified file. Use
the syntax:

status = writeva(model_obj,'obj1',{'inp','inn'},{'outp','outn'})

to write a Verilog-A module for the model object model_obj to the file obj1.va.
The module has differential input nets, inp and inn, and differential output
nets, outp and outn. The method returns status, a logical value of true if
the operation is successful and false otherwise.

The writeva reference page describes the method arguments in detail.

An example of exporting a Verilog-A module appears in the RF Toolbox demo,

Modeling a High-Speed Backplane (Part 3: Rational Function Model to a
Verilog-A Module).

4-7
 4 Exporting Verilog-A Models

4-8
 5

RF Tool: An RF Analysis
GUI

• “Introduction to RF Tool” on page 5-2

• “Creating and Importing Circuits” on page 5-6
• “Modifying Component Data” on page 5-19
• “Analyzing Circuits” on page 5-20
• “Exporting RF Objects” on page 5-23
• “Managing Circuits and Sessions” on page 5-27
• “Example — Modeling an RF Network Using RF Tool” on page 5-31
 5 RF Tool: An RF Analysis GUI

Introduction to RF Tool
In this section...
“What Is RF Tool?” on page 5-2
“Opening RF Tool” on page 5-2
“RF Tool Window” on page 5-3
“RF Tool Workflow” on page 5-5

What Is RF Tool?
RF Tool is a GUI that provides a visual interface for creating and analyzing
RF components and networks. You can use RF Tool as a convenient
alternative to the command-line RF circuit design and analysis objects and
methods that come with RF Toolbox software.

RF Tool provides the ability to

• Create and import circuits.

• Set circuit parameters.
• Analyze circuits.
• Display circuit S-parameters in tabular form and on X-Y plots, polar plots,
and Smith Charts.
• Export circuit data to the MATLAB workspace and to data files.

Opening RF Tool
To open RF Tool, type the following at the MATLAB prompt:

rftool

For a description of the RF Tool GUI, see “RF Tool Window” on page 5-3. To
learn how to create and import circuits, see “Creating and Importing Circuits”
on page 5-6.

5-2
 Introduction to RF Tool

Note The work you do with this tool is organized into sessions. Each session
is a collection of independent RF circuits, which can be RF components or RF
networks. You can save sessions and then load them for later use. For more
information, see “Working with Sessions” on page 5-28.

RF Tool Window
The RF Tool window consists of the following three panes:

• RF Component List
Shows the components and networks in the session. The top-level node is
the session.
• Component Parameters
Displays options and settings pertaining to the node you selected in the
RF Component List pane.
• Analysis
Displays options and settings pertaining to the circuit analysis and results
display. After you analyze the circuit, this pane displays the analysis
results and provides an interface for you to view the S-parameter data and
modify the displayed plots.

5-3
 5 RF Tool: An RF Analysis GUI

The following figure shows the RF Tool window.

5-4
 Introduction to RF Tool

RF Tool Workflow
When you analyze a circuit using the RF Tool GUI, your workflow might
include the following tasks:

1 Build the circuit by

• Creating RF components and networks.

• Importing components and networks from the MATLAB workspace or
from a data file.

See “Creating and Importing Circuits” on page 5-6.

2 Specify component data.

See “Modifying Component Data” on page 5-19.

3 Analyze the circuit.

See “Analyzing Circuits” on page 5-20.

4 Export the circuit to the MATLAB workspace or to a file.

See “Exporting RF Objects” on page 5-23.

5-5
 5 RF Tool: An RF Analysis GUI

Creating and Importing Circuits

In this section...
“Circuits in RF Tool” on page 5-6
“Creating RF Components” on page 5-6
“Creating RF Networks” on page 5-10
“Importing RF Objects” on page 5-15

Circuits in RF Tool
In RF Tool, you can create circuits that include RF components and RF
networks. Networks can contain both components and other networks.

Note In the circuit object command line interface, you create networks by
building components and then connecting them together to form a network.
In contrast, you build networks in RF Tool by creating a network and then
populating it with components.

Creating RF Components
This section contains the following topics:

• “Available RF Components” on page 5-7

• “How to Add an RF Component to a Session” on page 5-8

5-6
 Creating and Importing Circuits

Available RF Components
The following table lists the RF components you can create using RF Tool and
the corresponding RF Toolbox object.

RF Component Corresponding RF Object

Data File rfckt.datafile
Delay Line rfckt.delay
Coaxial Transmission Line rfckt.coaxial
Coplanar Waveguide Transmission rfckt.cpw
Line
Microstrip Transmission Line rfckt.microstrip
Parallel-Plate Transmission Line rfckt.parallelplate
Transmission Line rfckt.txline
Two-Wire Transmission Line rfckt.twowire
Series RLC rfckt.seriesrlc
Shunt RLC rfckt.shuntrlc
LC Bandpass Pi rfckt.lcbandpasspi
LC Bandpass Tee rfckt.lcbandpasstee
LC Bandstop Pi rfckt.lcbandstoppi
LC Bandstop Tee rfckt.lcbandstoptee
LC Highpass Pi rfckt.lchighpasspi
LC Highpass Tee rfckt.lchighpasstee
LC Lowpass Pi rfckt.lclowpasspi
LC Lowpass Tee rfckt.lclowpasstee

5-7
 5 RF Tool: An RF Analysis GUI

How to Add an RF Component to a Session

1 In the RF Component List pane, click Add to open the Create Network
or Component dialog box.

2 In the Create Network or Component dialog box, select Component.

3 In the Component Name field, enter a name for the component. This
name is used to identify the component in the RF Component List pane.
For example, Microstrip Component.

5-8
 Creating and Importing Circuits

4 From the Component Type menu, select the type of RF component you
want to create. For example, Microstrip Transmission Line.

5 Adjust the parameter values as necessary.

Note You can accept the default values for some or all of the parameters
and then change them later. For information on modifying the parameter
values of an existing component, see “Modifying Component Data” on page
5-19.

5-9
 5 RF Tool: An RF Analysis GUI

6 Click OK.

RF Tool adds the component to your session.

Creating RF Networks
You create an RF network in RF Tool by adding a network to the session and
then adding components to the network.

This section contains the following topics:

• “Available RF Networks” on page 5-11

• “Adding an RF Network to a Session” on page 5-11
• “Populating an RF Network” on page 5-13
• “Reordering Circuits Within a Network” on page 5-14

5-10
 Creating and Importing Circuits

Available RF Networks
The following table lists the RF networks you can create using RF Tool.

Corresponding RF Toolbox
RF Network Object
Cascaded Network rfckt.cascade
Series Connected Network rfckt.series
Parallel Connected Network rfckt.parallel
Hybrid Connected Network rfckt.hybrid
Inverse Hybrid Connected Network rfckt.hybridg

Adding an RF Network to a Session

1 In the RF Component List pane, click Add to open the Create Network
or Component dialog box.

2 In the Create Network or Component dialog box, select the Network

option button.

5-11
 5 RF Tool: An RF Analysis GUI

3 In the Network Name field, enter a name for the component. This name
is used to identify the network in the RF Component List pane. For
example, Series1.

4 From the Network Type menu, select the type of RF network you want to
create. For example, Series Connected Network.

5 Click OK.

The RF Component List pane shows the new network.

5-12
 Creating and Importing Circuits

Populating an RF Network
After you create a network using RF Tool, you must populate it with RF
components and networks. You insert a component or network into a network
in much the same way you add one to a session.

To populate an RF network:

1 In the RF Component List pane, select the network component you want
to modify. Then, in the Component Parameters pane, click Insert.

The Insert Component or Network dialog box appears.

5-13
 5 RF Tool: An RF Analysis GUI

2 Click Component or Network in the Insert Component or Network dialog

box to add either a component or a network.

Enter the component or network name, and select the appropriate type. If
you are inserting a component, modify the parameter values as necessary.
See “How to Add an RF Component to a Session” on page 5-8 or “Adding an
RF Network to a Session” on page 5-11 for details.

As you insert components and networks into a network, they are reflected in
the RF Component List and Component Parameters panes. The figure
below shows an example of a cascaded network that contains two components
and a network. The subnetwork, in turn, contains two components.

Reordering Circuits Within a Network

To change the order of the components and networks within a network:

1 In the RF Component List pane, select the network whose circuits you
want to reorder.

2 In the Component Parameters pane, select the circuit whose position

you want to change.

3 Click Up or Down until the circuit is where you want it.

5-14
 Creating and Importing Circuits

To reverse the positions of Component1 and Network1 in the network shown

in the following figure:

1 Select Network in the RF Component List pane.

2 Select Component1 in the Component Parameters pane.

3 Click Down in the Component Parameters pane.

Importing RF Objects
RF Tool lets you import RF objects from your workspace and from files to the
top level of your session. You can import the following types of objects:

• Complex component and network objects that you created in your

workspace using RF Toolbox objects.
• Components and networks you exported into your workspace from another
RF Tool session.
For information on exporting components and networks from an RF Tool
session, see “Exporting RF Objects” on page 5-23.

After you have imported an object, you can change its name and work with
it as you would any other component or network.

This section contains the following topics:

• “Importing from the Workspace” on page 5-16

• “Importing from a File into a Session” on page 5-16
• “Importing from a File into a Network” on page 5-18

5-15
 5 RF Tool: An RF Analysis GUI

Importing from the Workspace

To import RF circuit objects from the MATLAB workspace into your RF Tool
session:

1 Select Import From Workspace from the File menu. The Import from
Workspace dialog box appears. This dialog box lists the handles of all RF
circuit (rfckt) objects in the workspace.

2 From the list of RF circuit objects, select the object you want to import,
and click OK.

The object is added to your session with the same name as the object
handle. If there is already a circuit by that name, RF Tool appends a
numeral, starting with 1, to the new circuit name.

Importing from a File into a Session

You can import RF components from the following types of files into the top
level of your session:

• S2P
• Y2P
• Z2P
• H2P

To import a component from one of these files:

5-16
 Creating and Importing Circuits

1 Select Import From File from the File menu. A file browser appears.

2 Select the file type you want to import.

3 Select the name of the file to import from the list of files in the browser.

4 Click Open to add the object to your session as a component.

The name of the component is the file name without the extension. If there
is already a component by that name, RF Tool appends a numeral, starting
with 1, to the new component name. The file name, including the extension,
appears as the value of the component’s File Name parameter. If the file
is not on the MATLAB path, the value of the File Name parameter also
contains the file path.

5-17
 5 RF Tool: An RF Analysis GUI

Importing from a File into a Network

You can import RF components from the following types of files into a network:

• S2P
• Y2P
• Z2P
• H2P

To import an RF component from a file into a network:

1 Insert a Data File component into the network.

For more information on how add a component to a network, see

“Populating an RF Network” on page 5-13.

2 Specify the name of the file from which to import the component in one
of two ways:
• Select the file name in the file name and type in the Import from File
dialog box, and click Open.
• Click Cancel to get out of the Import from File dialog box, and enter the
file name in the Value field across from the File Name parameter in
the Insert Component or Network dialog box.

“Example — Modeling an RF Network Using RF Tool” on page 5-31 shows

this process.

5-18
 Modifying Component Data

Modifying Component Data

You can change the values of component parameters that you create and
import. The component parameters in RF Tool correspond to the component
properties that you specify in the command line.

To modify these values:

1 Select the component in the RF Component List pane.

2 In the Component Parameters pane, select the value you want to

change, and enter the new value.

Valid values for component parameters are listed on the corresponding RF

Toolbox reference page. Use the links in “Available RF Components” on
page 5-7 and “Available RF Networks” on page 5-11 to access these pages.

3 Click Apply.

5-19
 5 RF Tool: An RF Analysis GUI

Analyzing Circuits
After you add your circuits, you can analyze them with RF Tool:

1 Select the component or network you want to analyze in the RF

Component List pane of RF Tool. For example, select the LC Bandpass
Pi component, as shown in the following figure.

2 In the Analysis pane:

• Enter [1e8:5e6:2e9], the analysis frequency range and step size in

hertz, in the Frequency field.
This value specifies an analysis from 0.1 GHz to 2 GHz in 5 MHz steps.
• Enter 50, the reference impedance in ohms, in the Reference
impedance field.

Note Alternately, you can specify the Frequency and Reference

impedance values as MATLAB workspace variables or as valid MATLAB
expressions.

5-20
 Analyzing Circuits

3 Click Analyze.

The Analysis pane displays a Smith Chart, an XY plot, and a polar plot of
the analyzed circuit.

4 Select or deselect the S-parameter check boxes at the bottom of each plot
to customize the parameters that the plot displays. Use the pull-downs at
the top of each plot to customize the plot options.

The plots automatically update as you change the check box and pull-down
options on the GUI.

5-21
 5 RF Tool: An RF Analysis GUI

5 Click Data in the upper-right corner of the Analysis pane to view the
data in tabular form. The following figure shows the analysis data for the
LC Bandpass Pi component at the frequencies and reference impedance
shown in step 2.

Note The magnitude, in decibels, of S11 is listed in the 20log10[S11]

column and the phase, in degrees, of S11 is listed in the <S11 column.

5-22
 Exporting RF Objects

Exporting RF Objects
In this section...
“Exporting Components and Networks” on page 5-23
“Exporting to the Workspace” on page 5-23
“Exporting to a File” on page 5-25

Exporting Components and Networks

You can export RF components and networks that you create and refine in
RF Tool to your MATLAB workspace or to files. You export circuits for the
following reasons:

• To perform additional analysis using RF Toolbox functions that are not

available in RF Tool.
• To incorporate them into larger RF systems.
• To import them into another session.

Exporting to the Workspace

RF Tool enables you to export components and networks to the MATLAB
workspace. In your workspace, you can use the resulting circuit (rfckt) object
as you would any other RF circuit object.

To export a component or network to the workspace:

5-23
 5 RF Tool: An RF Analysis GUI

1 Select the component or network to export in the RF Component List

pane of RF Tool.

2 Select Export to Workspace from the File menu.

3 Enter a name for the exported object’s handle in the Variable name field
and click OK. The default name is the name of the component or network
prefaced with the string 'rft_'.

5-24
 Exporting RF Objects

The component or network becomes accessible in the workspace via the

specified object handle.

Exporting to a File
RF Tool lets you export components and networks to files in S2P format.

Note You must analyze a component or network in RF Tool before you can
export it to a file. See “Analyzing Circuits” on page 5-20 for more information.

5-25
 5 RF Tool: An RF Analysis GUI

To export a component or network to a file:

1 Select the component or network to export in the RF Component List

pane of RF Tool.

2 Select Export To File from the File menu to open the file browser.

3 Browse to the appropriate directory. Enter the name you want to give the
file and click Save.

The default file name is the current name of the component or network
prefaced with the string 'rft_'. RF Tool also converts any characters that
are not alphanumeric to underscores (_).

5-26
 Managing Circuits and Sessions

Managing Circuits and Sessions

In this section...
“Working with Circuits” on page 5-27
“Working with Sessions” on page 5-28

Working with Circuits

In addition to building and specifying circuits, the RF Tool GUI allows you to
perform the following tasks:

• “Deleting Circuits” on page 5-27

• “Renaming Circuits” on page 5-28

Deleting Circuits
To delete a circuit from your session:

1 Select the circuit in the RF Component List pane.

2 Click Delete.

Note If the circuit you delete is a network, RF Tool deletes the network
everything in the network.

5-27
 5 RF Tool: An RF Analysis GUI

Renaming Circuits
To rename a component or a network:

1 Select the component or network in the RF Component List pane.

2 Type the new name in the Name field of the Component Parameters
pane.

3 Click Apply.

Working with Sessions

The work you do with RF Tool is organized into sessions. Each session is a
collection of independent RF circuits, which can be RF components or RF
networks.

This section contains the following topics:

• “Naming or Renaming a Session” on page 5-28

• “Saving a Session” on page 5-29
• “Opening an Existing Session” on page 5-30
• “Starting a New Session” on page 5-30

Naming or Renaming a Session

To name or rename an RF session:

1 Select the session, or top-level node, in the RF Component List pane.

(The session is selected by default when you open the RF Tool GUI.)

5-28
 Managing Circuits and Sessions

2 Type the desired name in the Name field of the Component Parameters
pane.

3 Click Apply.

Saving a Session
To save your session, select Save Session or Save Session As from the File
menu. The first time you save a session a browser opens, prompting you
for a file name.

Note The default file name is the session name with any characters that
are not alphanumeric converted to underscores (_). The name of the session
itself is unchanged.

For example, to save your session as Test.rf in your current working

directory, you would type Test in the File name field as shown above. RF
Tool adds the .rf extension automatically to all RF Tool sessions you save.

If the name of your session is gk's session, the default file name is
gk_s_session.rf.

5-29
 5 RF Tool: An RF Analysis GUI

Opening an Existing Session

You can load an existing session into RF Tool by selecting Open Session
from the File menu. A browser enables you to select from your previously
saved sessions.

Before opening the requested session, RF Tool prompts you to save your
current session.

Starting a New Session

To start a new session, select New Session from the File menu. A new
session opens in RF Tool. All its values are set to their defaults.

Before starting a new session, RF Tool prompts you to save your current
session.

5-30
 Example — Modeling an RF Network Using RF Tool

Example — Modeling an RF Network Using RF Tool

In this section...
“Overview of RF Tool Example” on page 5-31
“Starting RF Tool” on page 5-31
“Creating the Amplifier Network” on page 5-31
“Populating the Amplifier Network” on page 5-34
“Simulating the Amplifier Network” on page 5-38
“Exporting the Network to the Workspace” on page 5-39

Overview of RF Tool Example

In this example, you model the gain and noise figure of a cascaded network
and then analyze the network using RF Tool.

The network used in this example consists of an amplifier and two

transmission lines. Here, you learn how to create and analyze the network
using RF Tool.

Starting RF Tool
Type the following command at the MATLAB prompt to open the RF Tool
window:

rftool

For more information about this GUI, see “RF Tool Window” on page 5-3.

Creating the Amplifier Network

In this part of the example, you create a network to connect the amplifier
components in cascade.

5-31
 5 RF Tool: An RF Analysis GUI

1 In the RF Component List pane, click Add.

The Create Network or Component dialog box opens.

5-32
 Example — Modeling an RF Network Using RF Tool

2 In the Create Network or Component dialog box:

• Select the Network option button.

• In the Network Name field, enter Amplifier Network.
This name is used to identify the network in the RF Component List
pane.
• In the Network Type list, select Cascaded Network.
A Cascaded Network means that when you add components to the
network, RF Tool connects them in cascade.

5-33
 5 RF Tool: An RF Analysis GUI

3 Click OK to add the cascaded network to the session.

The network now appears in the RF Component List pane.

Populating the Amplifier Network

This part of the example shows how to add the following components to the
network:

• “Transmission Line 1” on page 5-34

• “Amplifier” on page 5-35
• “Transmission Line 2” on page 5-37

Transmission Line 1

1 In the Component Parameters pane, click Insert to open the Insert

Component or Network dialog box.

5-34
 Example — Modeling an RF Network Using RF Tool

2 In the Insert Component or Network dialog box:

• Select the Component option button.

• In the Component Name field, enter Short Transmission Line.
This name is used to identify the component in the RF Component
List pane.
• In the Component Type pull-down list, select Transmission Line.
• In the Value field across from the Line Length (m) parameter, enter
0.001.

3 Click OK to add the transmission line to the network.

Amplifier

1 In the Component Parameters pane, click Insert to open the Insert

Component or Network dialog box.

5-35
 5 RF Tool: An RF Analysis GUI

2 In the Insert Component or Network dialog box:

• Select the Component option button.

• In the Component Name field, enter Amplifier.
This name is used to identify the component in the RF Component
List pane.
• In the Component Type list, select Data File.
• In the Import from File dialog box that appears, click Cancel . You will
specify the name of the file from which to import data in a later step.
• In the Value field across from the Interpolation parameter, enter
cubic.
This value tells RF Tool to use cubic interpolation to determine the
behavior of the amplifier at frequency values that are not specified
explicitly in the data file.
• In the Value field across from the File Name parameter, enter
default.amp.

3 Click OK to add the amplifier to the network.

5-36
 Example — Modeling an RF Network Using RF Tool

Transmission Line 2

1 In the Component Parameters pane, click Insert to open the Insert

Component or Network dialog box.

2 In the Insert Component or Network dialog box, perform the following

actions:
• Select the Component option button.
• In the Component Name field, enter Long Transmission Line.
This name is used to identify the component in the RF Component
List pane.
• In the Component Type list, select Transmission Line.
• In the Value field across from the Line Length (m) parameter, enter
0.025.
• In the Value field across from the Phase Velocity (m/s) parameter,
enter 2.0e8.

5-37
 5 RF Tool: An RF Analysis GUI

3 Click OK to add the transmission line to the network.

Simulating the Amplifier Network

In this part of the example, you specify the range of frequencies over which to
analyze the amplifier network and then run the analysis.

1 In the Analysis pane, change the Frequency entry to [1.0e9:1e7:2.9e9].

This value specifies an analysis from 1 GHz to 2.9 GHz by 10 MHz.

In the Analysis pane, click Analyze to simulate the network at the specified
frequencies.

RF Tool displays a Smith Chart, an XY plot, and a polar plot of the analyzed
circuit.

5-38
 Example — Modeling an RF Network Using RF Tool

You can modify the plots by

• Selecting and deselecting the S-parameter check boxes at the bottom of

each plot to customize the parameters that the plot displays.
• Using the pull-downs at the top of each plot to customize the plot options.

Exporting the Network to the Workspace

RF Tool lets you export components and networks to the workspace as
circuit objects so you can use the RF Toolbox functions to perform additional
analysis. This part of the example shows how to export the amplifier network
to the workspace.

1 In the RF Tool window, select File > Export to Workspace.

2 In the Variable name field, enter CascadedCkt.

This name is the exported object’s handle.

3 Click OK.

RF Tool exports the amplifier network to an rfckt.cascade object, with

the specified object handle, in the MATLAB workspace.

5-39
 5 RF Tool: An RF Analysis GUI

5-40
 6

Object Reference

Circuit Objects (p. 6-2) Create objects that represent RF

components and networks for
frequency-domain simulation
Data Objects (p. 6-4) Create objects that store data
Model Objects (p. 6-5) Create objects that represent RF
components and networks for
computing time-domain behavior
and exporting models
 6 Object Reference

Circuit Objects
Components (p. 6-2) Represent individual RF components
Networks (p. 6-3) Represent networks of RF
components

Components

Active Components

rfckt.amplifier Model RF amplifier

rfckt.mixer Model 2-port object representing RF
mixer and its local oscillator

Ladder Filters

rfckt.lcbandpasspi Model bandpass pi filter

rfckt.lcbandpasstee Model bandpass tee filter
rfckt.lcbandstoppi Model bandstop pi filter
rfckt.lcbandstoptee Model bandstop tee filter
rfckt.lchighpasspi Model highpass pi filter
rfckt.lchighpasstee Model highpass tee filter
rfckt.lclowpasspi Model lowpass pi filter
rfckt.lclowpasstee Model lowpass tee filter

RLC Components

rfckt.seriesrlc Model series RLC component

rfckt.shuntrlc Model shunt RLC component

6-2
 Circuit Objects

Transmission Lines

rfckt.coaxial Model coaxial transmission line

rfckt.cpw Model coplanar waveguide
transmission line
rfckt.delay Model delay line
rfckt.microstrip Model microstrip transmission line
rfckt.parallelplate Model parallel-plate transmission
line
rfckt.rlcgline Model RLCG transmission line
rfckt.twowire Model two-wire transmission line
rfckt.txline Model general transmission line

Black Box Elements

rfckt.datafile Model component or network from

file data
rfckt.passive Model passive component or network

Networks
rfckt.cascade Model cascaded network
rfckt.hybrid Model hybrid connected network
rfckt.hybridg Model inverse hybrid connected
network
rfckt.parallel Model parallel connected network
rfckt.series Model series connected network

6-3
 6 Object Reference

Data Objects
rfdata.data Store result of circuit object analysis
rfdata.ip3 Store frequency-dependent,
third-order intercept points
rfdata.mixerspur Store data from intermodulation
table
rfdata.network Store frequency-dependent network
parameters
rfdata.nf Store frequency-dependent noise
figure data for amplifiers or mixers
rfdata.noise Store frequency-dependent spot
noise data for amplifiers or mixers
rfdata.power Store output power and phase
information for amplifiers or mixers

6-4
 Model Objects

Model Objects
rfmodel.rational Rational function model

6-5
 6 Object Reference

6-6
 7

Objects — Alphabetical List

rfckt.amplifier

Purpose Construct RF amplifier

Syntax h = rfckt.amplifier
h = rfckt.amplifier('Property1',value1,'Property2',value2,
...)

Description h = rfckt.amplifier returns an amplifier circuit object whose

properties all have their default values.
h =
rfckt.amplifier('Property1',value1,'Property2',value2,...)
returns a circuit object, h, based on the specified properties. Properties
that you do not specify retain their default values.
Use the read method to read the amplifier data from a data file in one
of the following formats:

• Touchstone
• Agilent P2D
• Agilent S2D
• AMP

See Appendix A, “AMP File Format” for information about the .amp
format.

7-2
 rfckt.amplifier class

Purpose Model RF amplifier

Description Use the amplifier class to represent RF amplifiers that are

characterized by network parameters, noise data, and nonlinearity data.

Construction rfckt.amplifier Construct RF amplifier

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
IntpType Interpolation method
Name Object name
NetworkData Network parameter information
NoiseData Noise information
NonlinearData Nonlinearity information
nPort Number of ports

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
extract Extract array of network
parameters from data object
getop Display operating conditions
listformat List valid formats for specified
circuit object parameter

7-3
rfckt.amplifier class

listparam List valid parameters for specified

circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
read Read RF data from file to new or
existing circuit or data object
restore Restore data to original
frequencies
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

Examples amp = rfckt.amplifier('IntpType','cubic')

amp =

Name: 'Amplifier'
nPort: 2

7-4
 rfckt.amplifier class

AnalyzedResult: [1x1 rfdata.data]

IntpType: 'Cubic'
NetworkData: [1x1 rfdata.network]
NoiseData: [1x1 rfdata.noise]
NonlinearData: [1x1 rfdata.power]

See Also rfckt.datafile

rfckt.mixer
rfckt.passive
rfdata.data
rfdata.ip3
rfdata.network
rfdata.nf
rfdata.noise
rfdata.power
EIA/IBIS Open Forum, Touchstone File
Format Specification, Rev. 1.1, 2002
(http://www.vhdl.org/pub/ibis/connector/touchstone_spec11.pdf).

7-5
rfckt.cascade

Purpose Construct cascaded network

Syntax h = rfckt.cascade
h = rfckt.cascade('Property1',value1,'Property2',value2,...)

Description h = rfckt.cascade returns a cascaded network object whose

properties all have their default values.
h =
rfckt.cascade('Property1',value1,'Property2',value2,...)
returns a cascaded network object, h, based on the specified properties.
Properties you do not specify retain their default values.

7-6
 rfckt.cascade class

Purpose Model cascaded network

Description Use the cascade class to represent cascaded networks of RF objects

that are characterized by the components that make up the network.

Construction rfckt.cascade Construct cascaded network

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
Ckts Circuit objects in network
Name Object name
nPort Number of ports

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane

7-7
rfckt.cascade class

plotyy Plot specified object parameters

with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

Examples amp = rfckt.amplifier('IntpType','cubic');

tx1 = rfckt.txline;
tx2 = rfckt.txline;
casc = rfckt.cascade('Ckts',{tx1,amp,tx2})

casc =

Name: 'Cascaded Network'

nPort: 2
AnalyzedResult: []
Ckts: {1x3 cell}

See Also rfckt.hybrid

rfckt.hybridg
rfckt.parallel
rfckt.series
Ludwig, R. and P. Bretchko, RF Circuit Design: Theory and
Applications, Prentice Hall, 2000.

7-8
 rfckt.coaxial

Purpose Construct coaxial transmission line

Syntax h = rfckt.coaxial
h = rfckt.coaxial('Property1',value1,'Property2',value2,...)

Description h = rfckt.coaxial returns a coaxial transmission line object whose

properties are set to their default values.
h =
rfckt.coaxial('Property1',value1,'Property2',value2,...)
returns a coaxial transmission line object, h, with the specified
properties. Properties that you do not specify retain their default values.

7-9
rfckt.coaxial class

Purpose Model coaxial transmission line

Description Use the coaxial class to represent coaxial transmission lines that are
characterized by line dimensions, stub type, and termination.
A coaxial transmission line is shown in cross-section in the following
figure. Its physical characteristics include the radius of the inner
conductor of the coaxial transmission line a, and the radius of the outer
conductor b.

Construction rfckt.coaxial Construct coaxial transmission

line

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
EpsilonR Relative permittivity of dielectric
InnerRadius Inner conductor radius
LineLength Transmission line length
LossTangent Tangent of loss angle

7-10
 rfckt.coaxial class

MuR Relative permeability of dielectric

Name Object name
nPort Number of ports
OuterRadius Outer conductor radius
SigmaCond Conductor conductivity
StubMode Type of stub
Termination Stub transmission line
termination

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
getz0 Characteristic impedance of
transmission line object
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides

7-11
rfckt.coaxial class

polar Plot specified circuit object

parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

Examples tx1=rfckt.coaxial('OuterRadius',0.0045)

tx1 =

Name: 'Coaxial Transmission Line'

nPort: 2
AnalyzedResult: []
LineLength: 0.0100
StubMode: 'NotAStub'
Termination: 'NotApplicable'
OuterRadius: 0.0045
InnerRadius: 7.2500e-004
MuR: 1
EpsilonR: 2.3000
LossTangent: 0
SigmaCond: Inf

See Also rfckt.cpw

rfckt.microstrip
rfckt.parallelplate
rfckt.rlcgline

7-12
 rfckt.coaxial class

rfckt.twowire
rfckt.txline
Pozar, David M. Microwave Engineering, John Wiley & Sons, Inc.,
2005.

7-13
rfckt.cpw

Purpose Construct coplanar waveguide transmission line

Syntax h = rfckt.cpw
h = rfckt.cpw('Property1',value1,'Property2',value2,...)

Description h = rfckt.cpw returns a coplanar waveguide transmission line object

whose properties are set to their default values.
h = rfckt.cpw('Property1',value1,'Property2',value2,...)
returns a coplanar waveguide transmission line object, h, with the
specified properties. Properties that you do not specify retain their
default values.

7-14
 rfckt.cpw class

Purpose Model coplanar waveguide transmission line

Description Use the cpw class to represent coplanar waveguide transmission lines
that are characterized by line dimensions, stub type, and termination.
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 permittivity constant (ε).

Construction rfckt.cpw Construct coplanar waveguide

transmission line

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
ConductorWidth Conductor width
EpsilonR Relative permittivity of dielectric
Height Dielectric thickness
LineLength Transmission line length
LossTangent Tangent of loss angle
Name Object name
nPort Number of ports
SigmaCond Conductor conductivity

7-15
rfckt.cpw class

SlotWidth Width of slot

StubMode Type of stub
Termination Stub transmission line
termination
Thickness Conductor thickness

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
getz0 Characteristic impedance of
transmission line object
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis

7-16
 rfckt.cpw class

semilogy Plot specified circuit object

parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

Examples tx1=rfckt.cpw('Thickness',0.0075e-6)

tx1 =

Name: 'Coplanar Waveguide Transmission Line'

nPort: 2
AnalyzedResult: []
LineLength: 0.0100
StubMode: 'NotAStub'
Termination: 'NotApplicable'
ConductorWidth: 6.0000e-004
SlotWidth: 2.0000e-004
Height: 6.3500e-004
Thickness: 7.5000e-009
EpsilonR: 9.8000
SigmaCond: Inf
LossTangent: 0

See Also rfckt.coaxial

rfckt.microstrip
rfckt.parallelplate
rfckt.rlcgline
rfckt.twowire
rfckt.txline
[1] Gupta, K. C., R. Garg, I. Bahl, and P. Bhartia, Microstrip Lines
and Slotlines, 2nd Edition, Artech House, Inc., Norwood, MA, 1996.

7-17
rfckt.datafile

Purpose Construct component or network from file data

Syntax h = rfckt.datafile
h = rfckt.datafile('Property1',value1,'Property2',value2,...)

Description h = rfckt.datafile returns a circuit object whose properties all have

their default values.
h =
rfckt.datafile('Property1',value1,'Property2',value2,...)
returns a circuit object, h, based on the specified properties. Properties
that you do not specify retain their default values.
Use the read method to read the data from a file in one of the following
formats:

• Touchstone
• Agilent P2D
• Agilent S2D
• AMP

See Appendix A, “AMP File Format” for information about the .amp
format.

7-18
 rfckt.datafile class

Purpose Model component or network from file data

Description Use the datafile class to represent RF components and networks that
are characterized by measured or simulated data in a file.

Construction rfckt.datafile Construct component or network

from file data

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
File File containing circuit data
IntpType Interpolation method
Name Object name
nPort Number of ports

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
extract Extract array of network
parameters from data object
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object

7-19
rfckt.datafile class

loglog Plot specified circuit object

parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
read Read RF data from file to new or
existing circuit or data object
restore Restore data to original
frequencies
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

Examples data=rfckt.datafile('File','default.s2p')

data =

Name: 'Data File'

nPort: 2
AnalyzedResult: [1x1 rfdata.data]
IntpType: 'Linear'

7-20
 rfckt.datafile class

File: 'default.s2p'

See Also rfckt.amplifier

rfckt.mixer
rfckt.passive
EIA/IBIS Open Forum, Touchstone File
Format Specification, Rev. 1.1, 2002
(http://www.vhdl.org/pub/ibis/connector/touchstone_spec11.pdf).

7-21
rfckt.delay

Purpose Construct delay line

Syntax h = rfckt.delay
h = rfckt.delay('Property1',value1,'Property2',value2,...)

Description h = rfckt.delay returns a delay line object whose properties are set to
their default values.
h = rfckt.delay('Property1',value1,'Property2',value2,...)
returns a delay line object, h, with the specified properties. Properties
that you do not specify retain their default values.

7-22
 rfckt.delay class

Purpose Model delay line

Description Use the delay class to represent delay lines that are characterized by
line loss and time delay.

Construction rfckt.delay Construct delay line

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
Loss Delay line loss
Name Object name
nPort Number of ports
TimeDelay Delay introduced by line
Z0 Characteristic impedance

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
getz0 Characteristic impedance of
transmission line object
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object

7-23
rfckt.delay class

loglog Plot specified circuit object

parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

Examples del=rfckt.delay('TimeDelay',1e-11)

del =

Name: 'Delay Line'

nPort: 2
AnalyzedResult: []
Z0: 50
Loss: 0
TimeDelay: 1.0000e-011

See Also rfckt.rlcgline

rfckt.txline

7-24
 rfckt.delay class

Ludwig, R. and P. Bretchko, RF Circuit Design: Theory and

Applications, Prentice-Hall, 2000.

7-25
rfckt.hybrid

Purpose Construct hybrid connected network

Syntax h = rfckt.hybrid
h = rfckt.hybrid('Property1',value1,'Property2',value2,...)

Description h = rfckt.hybrid returns a hybrid connected network object whose

properties all have their default values.
h = rfckt.hybrid('Property1',value1,'Property2',value2,...)
returns a hybrid connected network object, h, based on the specified
properties. Properties that you do not specify retain their default values.

7-26
 rfckt.hybrid class

Purpose Model hybrid connected network

Description Use the hybrid class to represent hybrid connected networks of linear
RF objects that are characterized by the components that make up the
network.

Construction rfckt.hybrid Construct hybrid connected

network

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
Ckts Circuit objects in network
Name Object name
nPort Number of ports

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale

7-27
rfckt.hybrid class

plot Plot specified circuit object

parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

Examples tx1 = rfckt.txline;

tx2 = rfckt.txline;
hyb = rfckt.hybrid('Ckts',{tx1,tx2})

hyb =

Name: 'Hybrid Connected Network'

nPort: 2
AnalyzedResult: []
Ckts: {1x2 cell}

See Also rfckt.cascade

rfckt.hybridg
rfckt.parallel
rfckt.series

7-28
 rfckt.hybrid class

Ludwig, R. and P. Bretchko, RF Circuit Design: Theory and

Applications, Prentice-Hall, 2000.

7-29
rfckt.hybridg

Purpose Construct inverse hybrid connected network

Syntax h = rfckt.hybridg
h = rfckt.hybridg('Property1',value1,'Property2',value2,...)

Description h = rfckt.hybridg returns an inverse hybrid connected network

object whose properties all have their default values.
h =
rfckt.hybridg('Property1',value1,'Property2',value2,...)
returns an inverse hybrid connected network object, h, based on the
specified properties. Properties that you do not specify retain
their default values.

7-30
 rfckt.hybridg class

Purpose Model inverse hybrid connected network

Description Use the hybridg class to represent inverse hybrid connected networks
of linear RF objects that are characterized by the components that
make up the network.

Construction rfckt.hybridg Construct inverse hybrid

connected network

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
Ckts Circuit objects in network
Name Object name
nPort Number of ports

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale

7-31
rfckt.hybridg class

plot Plot specified circuit object

parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

Examples tx1 = rfckt.txline;

tx2 = rfckt.txline;
invhyb = rfckt.hybridg('Ckts',{tx1,tx2})

invhyb =

Name: 'Hybrid G Connected Network'

nPort: 2
AnalyzedResult: []
Ckts: {1x2 cell}

See Also rfckt.cascade

rfckt.hybrid
rfckt.parallel
rfckt.series

7-32
 rfckt.hybridg class

Davis, A.M., Linear Circuit Analysis, PWS Publishing Company,

1998.

7-33
rfckt.lcbandpasspi

Purpose Construct bandpass pi filter

Syntax h = rfckt.lcbandpasspi
h = rfckt.lcbandpasspi('Property1',value1,'Property2',value2,
...)

Description h = rfckt.lcbandpasspi returns an LC bandpass pi network object

whose properties all have their default values.
h =
rfckt.lcbandpasspi('Property1',value1,'Property2',value2,...)
returns an LC bandpass pi network object, h, based on the
specified properties. Properties that you do not specify retain
their default values.

7-34
 rfckt.lcbandpasspi class

Purpose Model bandpass pi filter

Description Use the lcbandpasspi class to represent a bandpass pi filter as a

network of inductors and capacitors.
The LC bandpass pi network object is a 2-port network as shown in the
following circuit diagram.

L2 C2 L4 C4

L1 C1 L3 C3

In the diagram, [L1, L2, L3, L4, ...] is the value of the 'L' object property,
and [C1, C2, C3, C4, ...] is the value of the 'C' object property.

Construction rfckt.lcbandpasspi Construct bandpass pi filter

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
C Capacitance data
L Inductance data
Name Object name
nPort Number of ports

7-35
rfckt.lcbandpasspi class

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
extract Extract array of network
parameters from data object
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

7-36
 rfckt.lcbandpasspi class

Examples filter = rfckt.lcbandpasspi...

('C',[1e-12 4e-12],'L',[2e-9 2.5e-9])

filter =

Name: 'LC Bandpass Pi'

nPort: 2
AnalyzedResult: []
L: [2x1 double]
C: [2x1 double]

See Also rfckt.lcbandpasstee

rfckt.lcbandstoppi
rfckt.lcbandstoptee
rfckt.lchighpasspi
rfckt.lchighpasstee
rfckt.lclowpasspi
rfckt.lclowpasstee
Ludwig, R. and P. Bretchko, RF Circuit Design: Theory and
Applications, Prentice-Hall, 2000.
Zverev, A.I., Handbook of Filter Synthesis, John Wiley & Sons, 1967.

7-37
rfckt.lcbandpasstee

Purpose Construct bandpass tee filter

Syntax h = rfckt.lcbandpasstee
h = rfckt.lcbandpasstee('Property1',value1,'Property2',value2,
...)

Description h = rfckt.lcbandpasstee returns an LC bandpass tee network object

whose properties all have their default values.
h =
rfckt.lcbandpasstee('Property1',value1,'Property2',value2,...)
returns an LC bandpass tee network object, h, based on the
specified properties. Properties that you do not specify retain
their default values.

7-38
 rfckt.lcbandpasstee class

Purpose Model bandpass tee filter

Description Use the lcbandpasstee class to represent a bandpass tee filter as a

network of inductors and capacitors.
The LC bandpass tee network object is a 2-port network as shown in the
following circuit diagram.

L1 C1 L3 C3

L2 C2 L4 C4

In the diagram, [L1, L2, L3, L4, ...] is the value of the 'L' object property,
and [C1, C2, C3, C4, ...] is the value of the 'C' object property.

Construction rfckt.lcbandpasstee Construct bandpass tee filter

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
C Capacitance data
L Inductance data
Name Object name
nPort Number of ports

7-39
rfckt.lcbandpasstee class

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
extract Extract array of network
parameters from data object
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

7-40
 rfckt.lcbandpasstee class

Examples filter = rfckt.lcbandpasstee...

('C',[1e-12 4e-12],'L',[2e-9 2.5e-9])

filter =

Name: 'LC Bandpass Tee'

nPort: 2
AnalyzedResult: []
L: [2x1 double]
C: [2x1 double]

See Also rfckt.lcbandpasspi

rfckt.lcbandstoppi
rfckt.lcbandstoptee
rfckt.lchighpasspi
rfckt.lchighpasstee
rfckt.lclowpasspi
rfckt.lclowpasstee
Ludwig, R. and P. Bretchko, RF Circuit Design: Theory and
Applications, Prentice-Hall, 2000.
Zverev, A.I., Handbook of Filter Synthesis, John Wiley & Sons, 1967.

7-41
rfckt.lcbandstoppi

Purpose Construct bandstop pi filter

Syntax h = rfckt.lcbandstoppi
h = rfckt.lcbandstoppi('Property1',value1,'Property2',value2,
...)

Description h = rfckt.lcbandstoppi returns an LC bandstop pi network object

whose properties all have their default values.
h =
rfckt.lcbandstoppi('Property1',value1,'Property2',value2,...)
returns an LC bandstop pi network object, h, based on the
specified properties. Properties that you do not specify retain
their default values.

7-42
 rfckt.lcbandstoppi class

Purpose Model bandstop pi filter

Description Use the lcbandstoppi class to represent a bandstop pi filter as a

network of inductors and capacitors. The LC bandstop pi network object
is a 2-port network as shown in the following circuit diagram.

L2 L4

C2 C4

L1 L3

C1 C3

In the diagram, [L1, L2, L3, L4, ...] is the value of the 'L' object property,
and [C1, C2, C3, C4, ...] is the value of the 'C' object property.

Construction rfckt.lcbandstoppi Construct bandstop pi filter

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
C Capacitance data
L Inductance data
Name Object name
nPort Number of ports

7-43
rfckt.lcbandstoppi class

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
extract Extract array of network
parameters from data object
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

7-44
 rfckt.lcbandstoppi class

Examples filter = rfckt.lcbandstoppi...

('C',[1e-12 4e-12],'L',[2e-9 2.5e-9])

filter =

Name: 'LC Bandstop Pi'

nPort: 2
AnalyzedResult: []
L: [2x1 double]
C: [2x1 double]

See Also rfckt.lcbandpasspi

rfckt.lcbandpasstee
rfckt.lcbandstoptee
rfckt.lchighpasspi
rfckt.lchighpasstee
rfckt.lclowpasspi
rfckt.lclowpasstee
Ludwig, R. and P. Bretchko, RF Circuit Design: Theory and
Applications, Prentice-Hall, 2000.
Zverev, A.I., Handbook of Filter Synthesis, John Wiley & Sons, 1967.

7-45
rfckt.lcbandstoptee

Purpose Construct bandstop tee filter

Syntax h = rfckt.lcbandstoptee
h = rfckt.lcbandstoptee('Property1',value1,'Property2',value2,
...)

Description h = rfckt.lcbandstoptee returns an LC bandstop tee network object

whose properties all have their default values.
h =
rfckt.lcbandstoptee('Property1',value1,'Property2',value2,...)
returns an LC bandstop tee network object, h, based on the
specified properties. Properties that you do not specify retain
their default values.

7-46
 rfckt.lcbandstoptee class

Purpose Model bandstop tee filter

Description Use the lcbandstoptee class to represent a bandstop tee filter as a

network of inductors and capacitor. The LC bandstop tee network object
is a 2-port network as shown in the following circuit diagram.

L1 L3

C1 C3

L2 L4

C2 C4

In the diagram, [L1, L2, L3, L4, ...] is the value of the 'L' object property,
and [C1, C2, C3, C4, ...] is the value of the 'C' object property.

Construction rfckt.lcbandstoptee Construct bandstop tee filter

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
C Capacitance data
L Inductance data
Name Object name
nPort Number of ports

7-47
rfckt.lcbandstoptee class

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
extract Extract array of network
parameters from data object
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

7-48
 rfckt.lcbandstoptee class

Examples filter = rfckt.lcbandstoptee...

('C',[1e-12 4e-12],'L',[2e-9 2.5e-9])

filter =

Name: 'LC Bandstop Tee'

nPort: 2
AnalyzedResult: []
L: [2x1 double]
C: [2x1 double]

See Also rfckt.lcbandpasspi

rfckt.lcbandpasstee
rfckt.lcbandstoppi
rfckt.lchighpasspi
rfckt.lchighpasstee
rfckt.lclowpasspi
rfckt.lclowpasstee
Ludwig, R. and P. Bretchko, RF Circuit Design: Theory and
Applications, Prentice-Hall, 2000.
Zverev, A.I., Handbook of Filter Synthesis, John Wiley & Sons, 1967.

7-49
rfckt.lchighpasspi

Purpose Construct highpass pi filter

Syntax h = rfckt.lchighpasspi
h = rfckt.lchighpasspi('Property1',value1,'Property2',value2,
...)

Description h = rfckt.lchighpasspi returns an LC highpass pi network object

whose properties all have their default values.
h =
rfckt.lchighpasspi('Property1',value1,'Property2',value2,...)
returns an LC highpass pi network object, h, based on the specified
properties. Properties that you do not specify retain their default values.

7-50
 rfckt.lchighpasspi class

Purpose Model highpass pi filter

Description Use the lchighpasspi class to represent a highpass pi filter as a

network of inductors and capacitors.
The LC highpass pi network object is a 2-port network as shown in the
following circuit diagram.

C1 C2

L1 L2 L3

In the diagram, [L1, L2, L3, ...] is the value of the 'L' object property,
and [C1, C2, C3, ...] is the value of the 'C' object property.

Construction rfckt.lchighpasspi Construct highpass pi filter

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
C Capacitance data
L Inductance data
Name Object name
nPort Number of ports

7-51
rfckt.lchighpasspi class

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
extract Extract array of network
parameters from data object
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

7-52
 rfckt.lchighpasspi class

Examples filter = rfckt.lchighpasspi...

('C',[1e-12 4e-12],'L',[2e-9 2.5e-9])

filter =

Name: 'LC Highpass Pi'

nPort: 2
AnalyzedResult: []
L: [2x1 double]
C: [2x1 double]

See Also rfckt.lcbandpasspi

rfckt.lcbandpasstee
rfckt.lcbandstoppi
rfckt.lcbandstoptee
rfckt.lchighpasstee
rfckt.lclowpasspi
rfckt.lclowpasstee
Ludwig, R. and P. Bretchko, RF Circuit Design: Theory and
Applications, Prentice-Hall, 2000.
Zverev, A.I., Handbook of Filter Synthesis, John Wiley & Sons, 1967.

7-53
rfckt.lchighpasstee

Purpose Construct Model highpass tee filter

Syntax h = rfckt.lchighpasstee
h = rfckt.lchighpasstee('Property1',value1,'Property2',value2,
...)

Description h = rfckt.lchighpasstee returns an LC highpass tee network object

whose properties all have their default values.
h =
rfckt.lchighpasstee('Property1',value1,'Property2',value2,...)
returns an LC highpass tee network object, h, based on the
specified properties. Properties that you do not specify retain
their default values.

7-54
 rfckt.lchighpasstee class

Purpose Model highpass tee filter

Description Use the lchighpasstee class to represent a highpass tee filter as a

network of inductors and capacitors.
The LC highpass tee network object is a 2-port network as shown in the
following circuit diagram.

C1 C2 C3

L1 L2 L3

In the diagram, [L1, L2, L3, ...] is the value of the 'L' object property,
and [C1, C2, C3, ...] is the value of the 'C' object property.

Construction rfckt.lchighpasstee Construct Model highpass tee

filter

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
C Capacitance data
L Inductance data
Name Object name
nPort Number of ports

7-55
rfckt.lchighpasstee class

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
extract Extract array of network
parameters from data object
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

7-56
 rfckt.lchighpasstee class

Examples filter = rfckt.lchighpasstee...

('C',[1e-12 4e-12],'L',[2e-9 2.5e-9])

filter =

Name: 'LC Highpass Tee'

nPort: 2
AnalyzedResult: []
L: [2x1 double]
C: [2x1 double]

See Also rfckt.lcbandpasspi

rfckt.lcbandpasstee
rfckt.lcbandstoppi
rfckt.lcbandstoptee
rfckt.lchighpasspi
rfckt.lclowpasspi
rfckt.lclowpasstee
Ludwig, R. and P. Bretchko, RF Circuit Design: Theory and
Applications, Prentice-Hall, 2000.
Zverev, A.I., Handbook of Filter Synthesis, John Wiley & Sons, 1967.

7-57
rfckt.lclowpasspi

Purpose Construct lowpass pi filter

Syntax h = rfckt.lclowpasspi
h = rfckt.lclowpasspi('Property1',value1,'Property2',value2,
...)

Description h = rfckt.lclowpasspi returns an LC lowpass pi network object

whose properties all have their default values.
h =
rfckt.lclowpasspi('Property1',value1,'Property2',value2,...)
returns an LC lowpass pi network object, h, based on the specified
properties. Properties that you do not specify retain their default values.

7-58
 rfckt.lclowpasspi class

Purpose Model lowpass pi filter

Description Use the lclowpasspi class to represent a lowpass pi filter as a network

of inductors and capacitors.
The LC lowpass pi network object is a 2-port network as shown in the
following circuit diagram.

L1 L2

C1 C2 C3

In the diagram, [L1, L2, L3, ...] is the value of the 'L' object property,
and [C1, C2, C3, ...] is the value of the 'C' object property.

Construction rfckt.lclowpasspi Construct lowpass pi filter

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
C Capacitance data
L Inductance data
Name Object name
nPort Number of ports

7-59
rfckt.lclowpasspi class

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
extract Extract array of network
parameters from data object
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

7-60
 rfckt.lclowpasspi class

Examples filter = rfckt.lclowpasspi...

('C',[1e-12 4e-12],'L',[2e-9 2.5e-9])

filter =

Name: 'LC Lowpass Pi'

nPort: 2
AnalyzedResult: []
L: [2x1 double]
C: [2x1 double]

See Also rfckt.lcbandpasspi

rfckt.lcbandpasstee
rfckt.lcbandstoppi
rfckt.lcbandstoptee
rfckt.lchighpasspi
rfckt.lchighpasstee
rfckt.lclowpasstee
Ludwig, R. and P. Bretchko, RF Circuit Design: Theory and
Applications, Prentice-Hall, 2000.
Zverev, A.I., Handbook of Filter Synthesis, John Wiley & Sons, 1967.

7-61
rfckt.lclowpasstee

Purpose Construct lowpass tee filter

Syntax h = rfckt.lclowpasstee
h = rfckt.lclowpasstee('Property1',value1,'Property2',value2,
...)

Description h = rfckt.lclowpasstee returns an LC lowpass tee network object

whose properties all have their default values.
h =
rfckt.lclowpasstee('Property1',value1,'Property2',value2,...)
returns an LC lowpass tee network object, h, based on the specified
properties. Properties that you do not specify retain their default values.

7-62
 rfckt.lclowpasstee class

Purpose Model lowpass tee filter

Description Use the lclowpasstee class to represent a lowpass tee filter as a

network of inductors and capacitors.
The LC lowpass tee network object is a 2-port network as shown in the
following circuit diagram.

L1 L2 L3

C1 C2 C3

In the diagram, [L1, L2, L3, ...] is the value of the 'L' object property,
and [C1, C2, C3, ...] is the value of the 'C' object property.

Construction rfckt.lclowpasstee Construct lowpass tee filter

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
C Capacitance data
L Inductance data
Name Object name
nPort Number of ports

7-63
rfckt.lclowpasstee class

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
extract Extract array of network
parameters from data object
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

7-64
 rfckt.lclowpasstee class

Examples filter = rfckt.lclowpasstee...

('C',[1e-12 4e-12],'L',[2e-9 2.5e-9])

filter =

Name: 'LC Lowpass Tee

nPort: 2
AnalyzedResult: []
L: [2x1 double]
C: [2x1 double]

See Also rfckt.lcbandpasspi

rfckt.lcbandpasstee
rfckt.lcbandstoppi
rfckt.lcbandstoptee
rfckt.lchighpasspi
rfckt.lchighpasstee
rfckt.lclowpasspi
Ludwig, R. and P. Bretchko, RF Circuit Design: Theory and
Applications, Prentice-Hall, 2000.
Zverev, A.I., Handbook of Filter Synthesis, John Wiley & Sons, 1967.

7-65
rfckt.microstrip

Purpose Construct microstrip transmission line

Syntax h = rfckt.microstrip
h = rfckt.microstrip('Property1',value1,'Property2',value2,
...)

Description h = rfckt.microstrip returns a microstrip transmission line object

whose properties are set to their default values.
h =
rfckt.microstrip('Property1',value1,'Property2',value2,...)
returns a microstrip transmission line object, h, with the specified
properties. Properties that you do not specify retain their default values.

7-66
 rfckt.microstrip class

Purpose Model microstrip transmission line

Description Use the microstrip class to represent microstrip transmission lines

that are characterized by line dimensions and optional stub properties.
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 (ε).

Construction rfckt.microstrip Construct microstrip

transmission line

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
EpsilonR Relative permittivity of dielectric
Height Dielectric thickness
LineLength Microstrip line length
LossTangent Tangent of loss angle
Name Object name
nPort Number of ports
SigmaCond Conductor conductivity
StubMode Type of stub

7-67
rfckt.microstrip class

Termination Stub transmission line

termination
Thickness Microstrip thickness
Width Parallel-plate width

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
getz0 Characteristic impedance of
transmission line object
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis

7-68
 rfckt.microstrip class

semilogy Plot specified circuit object

parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

Examples tx1=rfckt.microstrip('Thickness',0.0075e-6)

tx1 =

Name: 'Microstrip Transmission Line'

nPort: 2
AnalyzedResult: []
LineLength: 0.0100
StubMode: 'NotAStub'
Termination: 'NotApplicable'
Width: 6.0000e-004
Height: 6.3500e-004
Thickness: 7.5000e-009
EpsilonR: 9.8000
SigmaCond: Inf
LossTangent: 0

See Also rfckt.coaxial

rfckt.cpw
rfckt.parallelplate
rfckt.rlcgline
rfckt.twowire
rfckt.txline
[1] Gupta, K. C., R. Garg, I. Bahl, and P. Bhartia, Microstrip Lines
and Slotlines, 2nd Edition, Artech House, Inc., Norwood, MA, 1996.

7-69
rfckt.mixer

Purpose Construct 2-port object representing RF mixer and its local oscillator

Syntax h = rfckt.mixer
h = rfckt.mixer('Property1',value1,'Property2',value2,...)

Description h = rfckt.mixer returns a mixer object whose properties all have

their default values.
h = rfckt.mixer('Property1',value1,'Property2',value2,...)
returns a circuit object, h, , that represents a mixer and its local
oscillator (LO) with two ports (RF and IF). Properties that you do not
specify retain their default values.
Use the read method to read the mixer data from a data file in one
of the following formats:

• Touchstone
• Agilent P2D
• Agilent S2D
• AMP

See Appendix A, “AMP File Format” for information about the .amp
format.

7-70
 rfckt.mixer class

Purpose Model 2-port object representing RF mixer and its local oscillator

Description Use the mixer class to represent RF mixers and their local oscillators
that are characterized by network parameters, noise data, nonlinearity
data, and local oscillator frequency.

Construction rfckt.mixer Construct 2-port object

representing RF mixer and
its local oscillator

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
FLO Local oscillator frequency
FreqOffset Frequency offset data
IntpType Interpolation method
MixerSpurData Data from mixer spur table
MixerType Type of mixer
Name Object name
NetworkData Network parameter information
NoiseData Noise information
NonlinearData Nonlinearity information
nPort Number of ports
PhaseNoiseLevel Phase noise data

7-71
rfckt.mixer class

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
extract Extract array of network
parameters from data object
getop Display operating conditions
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
read Read RF data from file to new or
existing circuit or data object
restore Restore data to original
frequencies
semilogx Plot specified circuit object
parameters using log scale for
x-axis

7-72
 rfckt.mixer class

semilogy Plot specified circuit object

parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

Examples mix1 = rfckt.mixer('IntpType','cubic')

mix1 =

Name: 'Mixer'
nPort: 2
AnalyzedResult: [1x1 rfdata.data]
IntpType: 'Cubic'
NetworkData: [1x1 rfdata.network]
NoiseData: [1x1 rfdata.noise]
NonlinearData: Inf
MixerSpurData: []
MixerType: 'Downconverter'
FLO: 1.0000e+009
FreqOffset: []
PhaseNoiseLevel: []

See Also rfckt.amplifier

rfckt.datafile
rfckt.passive
rfdata.data
rfdata.ip3
rfdata.mixerspur
rfdata.network
rfdata.nf
rfdata.noise

7-73
rfckt.mixer class

rfdata.power
EIA/IBIS Open Forum, Touchstone File
Format Specification, Rev. 1.1, 2002
(http://www.vhdl.org/pub/ibis/connector/touchstone_spec11.pdf).

7-74
 rfckt.parallel

Purpose Construct parallel connected network

Syntax h = rfckt.parallel
h = rfckt.parallel('Property1',value1,'Property2',value2,...)

Description h = rfckt.parallel returns a parallel connected network object

whose properties all have their default values.
h =
rfckt.parallel('Property1',value1,'Property2',value2,...)
returns a parallel connected network object, h, based on the
specified properties. Properties that you do not specify retain
their default values.

7-75
rfckt.parallel class

Purpose Model parallel connected network

Description Use the parallel class to represent networks of linear RF objects

connected in parallel that are characterized by the components that
make up the network.

Construction rfckt.parallel Construct parallel connected

network

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
Ckts Circuit objects in network
Name Object name
nPort Number of ports

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale

7-76
 rfckt.parallel class

plot Plot specified circuit object

parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

Examples tx1 = rfckt.txline;

tx2 = rfckt.txline;
plel = rfckt.parallel('Ckts',{tx1,tx2})

plel =

Name: 'Parallel Connected Network'

nPort: 2
AnalyzedResult: []
Ckts: {1x2 cell}

See Also rfckt.cascade

rfckt.hybrid
rfckt.hybridg
rfckt.series

7-77
rfckt.parallel class

Ludwig, R. and P. Bretchko, RF Circuit Design: Theory and

Applications, Prentice-Hall, 2000.

7-78
 rfckt.parallelplate

Purpose Construct parallel-plate transmission line

Syntax h = rfckt.parallelplate
h = rfckt.parallelplate('Property1',value1,'Property2',value2,
...)

Description h = rfckt.parallelplate returns a parallel-plate transmission line

object whose properties are set to their default values.
h =
rfckt.parallelplate('Property1',value1,'Property2',value2,...)
returns a parallel-plate transmission line object, h, with the
specified properties. Properties that you do not specify retain
their default values.

7-79
rfckt.parallelplate class

Purpose Model parallel-plate transmission line

Description Use the parallelplate class to represent parallel-plate transmission

lines that are characterized by line dimensions and optional stub
properties.
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.

Construction rfckt.parallelplate Construct parallel-plate

transmission line

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP, and group delay
values
EpsilonR Relative permittivity of dielectric
LineLength Parallel-plate line length
LossTangent Tangent of loss angle
MuR Relative permeability of dielectric
Name Object name
nPort Number of ports
Separation Distance between plates

7-80
 rfckt.parallelplate class

SigmaCond Conductor conductivity

StubMode Type of stub
Termination Stub transmission line
termination
Width Transmission line width

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
getz0 Characteristic impedance of
transmission line object
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis

7-81
rfckt.parallelplate class

semilogy Plot specified circuit object

parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

Examples tx1=rfckt.parallelplate('LineLength',0.045)

tx1 =

Name: 'Parallel-Plate Transmission Line'

nPort: 2
AnalyzedResult: []
LineLength: 0.0450
StubMode: 'NotAStub'
Termination: 'NotApplicable'
Width: 0.0050
Separation: 1.0000e-003
MuR: 1
EpsilonR: 2.3000
LossTangent: 0
SigmaCond: Inf

See Also rfckt.coaxial

rfckt.cpw
rfckt.microstrip
rfckt.rlcgline
rfckt.twowire
rfckt.txline
Pozar, David M. Microwave Engineering, John Wiley & Sons, Inc.,
2005.

7-82
 rfckt.passive

Purpose Construct passive component or network

Syntax h = rfckt.passive
h = rfckt.passive('Property1',value1,'Property2',value2,...)

Description h = rfckt.passive returns an amplifier circuit object whose properties

all have their default values.
h =
rfckt.passive('Property1',value1,'Property2',value2,...)
returns a circuit object, h, based on the specified properties. Properties
that you do not specify retain their default values.
Use the read method to read the passive object data from a Touchstone
data file.

7-83
rfckt.passive class

Purpose Model passive component or network

Description Use the passive class to represent passive RF components and

networks that are characterized by network parameter data.

Construction rfckt.passive Construct passive component or

network

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
IntpType Interpolation method
Name Object name
NetworkData Network parameter information
nPort Number of ports

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
extract Extract array of network
parameters from data object
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object

7-84
 rfckt.passive class

loglog Plot specified circuit object

parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
read Read RF data from file to new or
existing circuit or data object
restore Restore data to original
frequencies
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

Examples pas = rfckt.passive('IntpType','cubic')

pas =

Name: 'Passive'
nPort: 2
AnalyzedResult: [1x1 rfdata.data]
IntpType: 'Cubic'

7-85
rfckt.passive class

NetworkData: [1x1 rfdata.network]

See Also rfckt.amplifier

rfckt.datafile
rfckt.mixer
rfdata.data
rfdata.network
EIA/IBIS Open Forum, Touchstone File
Format Specification, Rev. 1.1, 2002
(http://www.vhdl.org/pub/ibis/connector/touchstone_spec11.pdf).

7-86
 rfckt.rlcgline

Purpose Construct RLCG transmission line

Syntax h = rfckt.rlcgline
h = rfckt.rlcgline('Property1',value1,'Property2',value2,...)

Description h = rfckt.rlcgline returns an RLCG transmission line object whose

properties are set to their default values.
h =
rfckt.rlcgline('Property1',value1,'Property2',value2,...)
returns an RLCG transmission line object, h, with the specified
properties. Properties that you do not specify retain their default values.

7-87
rfckt.rlcgline class

Purpose Model RLCG transmission line

Description Use the rlcgline class to represent RLCG transmission lines that are
characterized by line loss, line length, stub type, and termination.

Construction rfckt.rlcgline Construct RLCG transmission

line

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
C Capacitance data
Freq Frequency data
G Conductance data
IntpType Interpolation method
L Inductance data
LineLength Transmission line length
Name Object name
nPort Number of ports
R Resistance data
StubMode Type of stub
Termination Stub transmission line
termination

7-88
 rfckt.rlcgline class

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
getz0 Characteristic impedance of
transmission line object
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

7-89
rfckt.rlcgline class

Examples tx1=rfckt.rlcgline('R',0.002,'C',8.8542e-12,...
'L',1.2566e-6,'G',0.002')

tx1 =

Name: 'RLCG Transmission Line'

nPort: 2
AnalyzedResult: []
LineLength: 0.0100
StubMode: 'NotAStub'
Termination: 'NotApplicable'
Freq: 1.0000e+009
R: 0.0020
L: 1.2566e-006
C: 8.8542e-012
G: 0.0020
IntpType: 'Linear'

See Also rfckt.coaxial

rfckt.cpw
rfckt.microstrip
rfckt.parallelplate
rfckt.twowire
rfckt.txline
Ludwig, R. and P. Bretchko, RF Circuit Design: Theory and
Applications, Prentice-Hall, 2000.

7-90
 rfckt.series

Purpose Construct series connected network

Syntax h = rfckt.series
h = rfckt.series('Property1',value1,'Property2',value2,...)

Description h = rfckt.series returns a series connected network object whose

properties all have their default values.
h = rfckt.series('Property1',value1,'Property2',value2,...)
returns a series connected network object, h, based on the specified
properties. Properties that you do not specify retain their default values.

7-91
rfckt.series class

Purpose Model series connected network

Description Use the series class to represent networks of linear RF objects

connected in series that are characterized by the components that make
up the network.

Construction rfckt.series Construct series connected

network

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
Ckts Circuit objects in network
Name Object name
nPort Number of ports

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale

7-92
 rfckt.series class

plot Plot specified circuit object

parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

Examples tx1 = rfckt.txline;

tx2 = rfckt.txline;
ser = rfckt.series('Ckts',{tx1,tx2})

ser =

Name: 'Series Connected Network'

nPort: 2
AnalyzedResult: []
Ckts: {1x2 cell}

See Also rfckt.cascade

rfckt.hybrid
rfckt.hybridg
rfckt.parallel

7-93
rfckt.series class

Ludwig, Reinhold and Pavel Bretchko, RF Circuit Design: Theory

and Applications, Prentice-Hall, 2000.

7-94
 rfckt.seriesrlc

Purpose Construct series RLC component

Syntax h = rfckt.seriesrlc
h = rfckt.seriesrlc('R',Rvalue,'L',Lvalue,'C',Cvalue)

Description h = rfckt.seriesrlc returns a series RLC network object whose

properties all have their default values. The default object is equivalent
to a pass-through 2-port network, i.e., the resistor, inductor, and
capacitor are each replaced by a short circuit.
h = rfckt.seriesrlc('R',Rvalue,'L',Lvalue,'C',Cvalue) returns
a series RLC network object, h, based on the specified resistance (R),
inductance (L), and capacitance (C) values. Properties that you do not
specify retain their default values, allowing you to specify a network of
a single resistor, inductor, or capacitor.

7-95
rfckt.seriesrlc class

Purpose Model series RLC component

Description Use the seriesrlc class to represent a component as a resistor,

inductor, and capacitor connected in series.
The series RLC network object is a 2-port network as shown in the
following circuit diagram.

R L C

Construction rfckt.seriesrlc Construct series RLC component

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
C Capacitance value
L Inductance value
Name Object name
nPort Number of ports
R Resistance value

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart

7-96
 rfckt.seriesrlc class

extract Extract array of network

parameters from data object
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

Examples This example creates a series LC resonator and examines its frequency
response. It first creates the circuit object and then uses the analyze
method to calculate its frequency response. Finally, it plots the results
— first, the magnitude in decibels (dB):

h = rfckt.seriesrlc('L',4.7e-5,'C',2.2e-10);

7-97
rfckt.seriesrlc class

analyze(h,logspace(4,8,1000));
plot(h,'s21','dB')
set(gca,'Xscale','log')

The example then plots the phase, in degrees:

figure
plot(h,'s21','angle')
set(gca,'Xscale','log')

7-98
 rfckt.seriesrlc class

See Also rfckt.shuntrlc

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

7-99
rfckt.shuntrlc

Purpose Construct shunt RLC component

Syntax h = rfckt.shuntrlc
h = rfckt.shuntrlc('R',Rvalue,'L',Lvalue,'C',Cvalue)

Description h = rfckt.shuntrlc returns a shunt RLC network object whose

properties all have their default values. The default object is equivalent
to a pass-through 2-port network; i.e., the resistor, inductor, and
capacitor are each replaced by a short circuit.
h = rfckt.shuntrlc('R',Rvalue,'L',Lvalue,'C',Cvalue) returns
a shunt RLC network object, h, based on the specified resistance (R),
inductance (L), and capacitance (C) values. Properties that you do not
specify retain their default values, allowing you to specify a network of
a single resistor, inductor, or capacitor.

7-100
 rfckt.shuntrlc class

Purpose Model shunt RLC component

Description Use the shuntrlc class to represent a component as a resistor, inductor,

and capacitor connected in a shunt configuration.
The shunt RLC network object is a 2-port network as shown in the
following circuit diagram.

R L C

Construction rfckt.shuntrlc Construct shunt RLC component

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
C Capacitance value
L Inductance value
Name Object name
nPort Number of ports
R Resistance value

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object

7-101
rfckt.shuntrlc class

circle Draw circles on Smith chart

extract Extract array of network
parameters from data object
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

Examples This example creates a shunt LC resonator and examines its frequency
response. It first creates the circuit object and then uses the analyze
method to calculate its frequency response. Finally, it plots the results
— first, the magnitude in decibels (dB):

7-102
 rfckt.shuntrlc class

h = rfckt.shuntrlc('L',4.7e-5,'C',2.2e-10);
analyze(h,logspace(4,8,1000));
plot(h,'s21','dB')
set(gca,'Xscale','log')

The example then plots the phase, in degrees:

figure
plot(h,'s21','angle')
set(gca,'Xscale','log')

7-103
rfckt.shuntrlc class

See Also rfckt.seriesrlc

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

7-104
 rfckt.twowire

Purpose Construct two-wire transmission line

Syntax h = rfckt.twowire
h = rfckt.twowire('Property1',value1,'Property2',value2,...)

Description h = rfckt.twowire returns a two-wire transmission line object whose

properties are set to their default values.
h =
rfckt.twowire('Property1',value1,'Property2',value2,...)
returns a two-wire transmission line object, h, with the specified
properties. Properties that you do not specify retain their default values.

7-105
rfckt.twowire class

Purpose Model two-wire transmission line

Description Use the twowire class to represent two-wire transmission lines that are
characterized by line dimensions, stub type, and termination.
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. RF Toolbox software
assumes the relative permittivity and permeability are uniform.

Wires

a
Dielectric

Construction rfckt.twowire Construct two-wire transmission

line

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
EpsilonR Relative permittivity of dielectric
LineLength Transmission line length

7-106
 rfckt.twowire class

LossTangent Tangent of loss angle

MuR Relative permeability of dielectric
Name Object name
nPort Number of ports
Radius Wire radius
Separation Distance between wires
SigmaCond Conductor conductivity
StubMode Type of stub
Termination Stub transmission line
termination

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
getz0 Characteristic impedance of
transmission line object
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane

7-107
rfckt.twowire class

plotyy Plot specified object parameters

with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

Examples tx1=rfckt.twowire('Radius',7.5e-4)

tx1 =

Name: 'Two-Wire Transmission Line'

nPort: 2
AnalyzedResult: []
LineLength: 0.0100
StubMode: 'NotAStub'
Termination: 'NotApplicable'
Radius: 7.5000e-004
Separation: 0.0016
MuR: 1
EpsilonR: 2.3000
LossTangent: 0
SigmaCond: Inf

7-108
 rfckt.twowire class

See Also rfckt.coaxial

rfckt.cpw
rfckt.microstrip
rfckt.parallelplate
rfckt.rlcgline
rfckt.txline
Pozar, David M. Microwave Engineering, John Wiley & Sons, Inc.,
2005.

7-109
rfckt.txline

Purpose Construct general transmission line

Syntax h = rfckt.txline
h = rfckt.txline('Property1',value1,'Property2',value2,...)

Description h = rfckt.txline returns a transmission line object whose properties

are set to their default values.
h = rfckt.txline('Property1',value1,'Property2',value2,...)
returns a transmission line object, h, with the specified properties.
Properties that you do not specify retain their default values.

7-110
 rfckt.txline class

Purpose Model general transmission line

Description Use the txline class to represent transmission lines that are
characterized by line loss, line length, stub type, and termination.

Construction rfckt.txline Construct general transmission

line

Properties AnalyzedResult Computed S-parameters, noise

figure, OIP3, and group delay
values
Freq Frequency data
IntpType Interpolation method
LineLength Transmission line length
Loss Transmission line loss
Name Object name
nPort Number of ports
PV Phase velocity
StubMode Type of stub
Termination Stub transmission line
termination
Z0 Characteristic impedance

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object

7-111
rfckt.txline class

circle Draw circles on Smith chart

getz0 Characteristic impedance of
transmission line object
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for
x-axis
semilogy Plot specified circuit object
parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

Examples Construct a general transmission line, trl, with the default

characteristic impedance of 50 ohms, phase velocity of
299792458 meters per second, and line length of 0.01 meters. Then
perform frequency domain analysis from 1.0 GHz to 3.0 GHz. Plot the

7-112
 rfckt.txline class

resulting S21 network parameters, using the 'angle' format, on the

X-Y plane.

trl = rfckt.txline('Z0',75)

trl =

Name: 'Transmission Line'

nPort: 2
AnalyzedResult: []
LineLength: 0.0100
StubMode: 'NotAStub'
Termination: 'NotApplicable'
Freq: 1.0000e+009
Z0: 75
PV: 299792458
Loss: 0
IntpType: 'Linear'

f = [1e9:1.0e7:3e9]; % Simulation frequencies

analyze(trl,f); % Do frequency domain analysis
figure
plot(trl,'s21','angle'); % Plot magnitude of S21

7-113
rfckt.txline class

See Also rfckt.coaxial

rfckt.cpw
rfckt.microstrip
rfckt.parallelplate
rfckt.rlcgline
rfckt.twowire
Ludwig, R. and P. Bretchko, RF Circuit Design: Theory and
Applications, Prentice-Hall, 2000.

7-114
 rfdata.data

Purpose Construct container for object analysis result

Syntax h = rfdata.data
h = rfdata.data('Property1',value1,'Property2',value2,...)

Description h = rfdata.data returns a data object whose properties all have their
default values.
h = rfdata.data('Property1',value1,'Property2',value2,...)
returns a data object, h, based on the specified properties. Properties
that you do not specify retain their default values.
Use the read method to read data from a file.

7-115
rfdata.data class

Purpose Store result of circuit object analysis

Description Use the data class to store S-parameters, noise figure in decibels, and
frequency-dependent, third-order output (OIP3) intercept points.
There are three ways to create an rfdata.data object:

• You can construct it by specifying its properties from workspace data

using the rfdata.data constructor.
• You can create it from file data using the read method.
• You can perform frequency domain analysis of a circuit object using
the analyze method, and RF Toolbox software stores the results
in an rfdata.data object.

Construction rfdata.data Construct container for object

analysis result

Properties Freq Frequency data

GroupDelay Group delay data
IntpType Interpolation method
Name Object name
NF Noise figure
OIP3 Output third-order intercept
point
S_Parameters S-parameter data
Z0 Reference impedance
ZL Load impedance
ZS Source impedance

7-116
 rfdata.data class

Methods analyze Analyze circuit object in frequency

domain
calculate Calculate specified parameters
for circuit object
circle Draw circles on Smith chart
extract Extract array of network
parameters from data object
getop Display operating conditions
listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters
with y-axes on both left and right
sides
polar Plot specified circuit object
parameters on polar coordinates
read Read RF data from file to new or
existing circuit or data object
restore Restore data to original
frequencies
semilogx Plot specified circuit object
parameters using log scale for
x-axis

7-117
rfdata.data class

semilogy Plot specified circuit object

parameters using log scale for
x-axis
smith Plot specified circuit object
parameters on Smith chart
write Write RF data from circuit or
data object to file

Examples Construct an RF data object from a .s2p data file.

file = 'default.s2p';
h = read(rfdata.data,file); % Read file into data object.
figure
plot(h,'s21','db'); % Plot dB(S21) in XY plane.

7-118
 rfdata.data class

See Also rfdata.ip3

rfdata.mixerspur
rfdata.network
rfdata.nf
rfdata.noise
rfdata.power

7-119
rfdata.ip3

Purpose Construct container for frequency-dependent, third-order intercept

points

Syntax h = rfdata.ip3
h = rfdata.ip3('Type',value1,'Freq',value2,'Data',value3)

Description h = rfdata.ip3 returns a data object for the frequency-dependent IP3,

h, whose properties all have their default values.
h = rfdata.ip3('Type',value1,'Freq',value2,'Data',value3)
returns a data object for the frequency-dependent IP3, h, based on the
specified properties.

7-120
 rfdata.ip3 class

Purpose Store frequency-dependent, third-order intercept points

Description Use the ip3 class to store third-order intercept point specifications for
a circuit object.

Construction rfdata.ip3 Construct container for

frequency-dependent, third-order
intercept points

Properties Data Third-order intercept values

Freq Frequency data
Name Object name
Type Power reference type

Examples ip3data = rfdata.ip3...

('Type','OIP3','Freq',2.1e9,'Data',8.45)

ip3data =

Name: '3rd order intercept'

Type: 'OIP3'
Freq: 2.1000e+009
Data: 8.4500

See Also rfdata.data

rfdata.mixerspur
rfdata.network
rfdata.nf
rfdata.noise
rfdata.power

7-121
rfdata.mixerspur

Purpose Construct container for intermodulation table data

Syntax h = rfdata.mixerspur
h = rfdata.mixerspur('Data',value1,'PLORef',value2,'PinRef',
'value3)

Description Use the mixerspur class to store mixer spur power specifications for
a circuit object.
h = rfdata.mixerspur returns a data object that defines an
intermodulation table, h, whose properties all have their default values.
h =
rfdata.mixerspur('Data',value1,'PLORef',value2,'PinRef','value3)
returns a data object that defines an intermodulation table,
h, based on the specified properties.

7-122
 rfdata.mixerspur class

Purpose Store data from intermodulation table

Description Use the mixerspur class to store mixer spur power specifications for
a circuit object.

Construction rfdata.mixerspur Construct container for

intermodulation table data

Properties Data Mixer spur power values

Name Object name
PinRef Reference input power
PLORef Reference local oscillator power

Examples spurs = rfdata.mixerspur...

('Data',[2 5 3; 1 0 99; 10 99 99],...
'PinRef',3,'PLORef',5)

spurs =

Name: 'Intermodulation table'

PLORef: 5
PinRef: 3
Data: [3x3 double]

See Also rfdata.data

rfdata.ip3
rfdata.network
rfdata.nf
rfdata.noise
rfdata.power
Visualizing Mixer Spurs

7-123
rfdata.network

Purpose Construct container for frequency-dependent network parameters

Syntax h = rfdata.network
h = rfdata.network('Type',value1,'Freq',value2, Data',value3,
'Z0',value4)

Description h = rfdata.network returns a data object for the frequency-dependent

network parameters h, whose properties all have their default values.
h = rfdata.network('Type',value1,'Freq',value2,
Data',value3, 'Z0',value4) returns a data object for the
frequency-dependent network parameters, h, based on the specified
properties.

7-124
 rfdata.network class

Purpose Store frequency-dependent network parameters

Description Use the network class to store frequency-dependent S-, Y-, Z-, ABCD-,
H-, G-, or T-parameters for a circuit object.

Construction rfdata.network Construct container for

frequency-dependent network
parameters

Properties Data Network parameter data

Freq Frequency data
Name Object name
Type Type of network parameters.
Z0 Reference impedance

Examples f = [2.08 2.10 2.15]*1.0e9;

y(:,:,1) = [-.0090-.0104i, .0013+.0018i; ...
-.2947+.2961i, .0252+.0075i];
y(:,:,2) = [-.0086-.0047i, .0014+.0019i; ...
-.3047+.3083i, .0251+.0086i];
y(:,:,3) = [-.0051+.0130i, .0017+.0020i; ...
-.3335+.3861i, .0282+.0110i];

net = rfdata.network...
('Type','Y_PARAMETERS','Freq',f,'Data',y)

See Also rfdata.data

rfdata.ip3
rfdata.mixerspur
rfdata.nf
rfdata.noise

7-125
rfdata.network class

rfdata.power

7-126
 rfdata.nf

Purpose Construct container for amplifer or mixer frequency-dependent noise

figure data

Syntax h = rfdata.nf
h = rfdata.nf('Freq',value1,'Data',value2)

Description h = rfdata.nf returns a data object for the frequency-dependent noise

figure, h, whose properties all have their default values.
h = rfdata.nf('Freq',value1,'Data',value2) returns a data
object for the frequency-dependent noise figure, h, based on the specified
properties.

7-127
rfdata.nf class

Purpose Store frequency-dependent noise figure data for amplifiers or mixers

Description Use the nf class to store noise figure specifications for a circuit object.

Construction rfdata.nf Construct container for amplifer

or mixer frequency-dependent
noise figure data

Properties Data Noise figure values

Freq Frequency data
Name Object name

Examples f = 2.0e9;
nf = 13.3244;

nfdata = rfdata.nf('Freq',f,'Data',nf);

See Also rfdata.data

rfdata.ip3
rfdata.mixerspur
rfdata.network
rfdata.noise
rfdata.power

7-128
 rfdata.noise

Purpose Construct container for amplifier or mixer frequency-dependent spot

noise data

Syntax h = rfdata.noise
h = rfdata.noise('Freq',value1,'FMIN',value2,'GAMMAOPT',
value3,'RN',value4)

Description h = rfdata.noise returns a data object for the frequency-dependent

spot noise, h, whose properties all have their default values.
h = rfdata.noise('Freq',value1,'FMIN',value2,'GAMMAOPT',
value3,'RN',value4) returns a data object for the frequency-dependent
spot noise, h, based on the specified properties.

7-129
rfdata.noise class

Purpose Store frequency-dependent spot noise data for amplifiers or mixers

Description Use the noise class to store spot noise specifications for a circuit object.

Construction rfdata.noise Construct container for amplifier

or mixer frequency-dependent
spot noise data

Properties FMIN Minimum noise figure data

Freq Frequency data
GAMMAOPT Optimum source reflection
coefficients
Name Object name
RN Equivalent normalized noise
resistance data

Examples f = [2.08 2.10]*1.0e9;

fmin = [12.08 13.40];
gopt = [0.2484-1.2102j 1.0999-0.9295j];
rn = [0.26 0.45];

noisedata = rfdata.noise('Freq',f,'FMIN',fmin,...
'GAMMAOPT',gopt,'RN',rn);

See Also rfdata.data

rfdata.mixerspur
rfdata.network
rfdata.nf
rfdata.power

7-130
 rfdata.power

Purpose Construct container for amplifier or mixer output power and phase
information

Syntax h = rfdata.power
h = rfdata.power(`property1',value1,'property2',value2,...)

Description h = rfdata.power returns a data object for the Pin/Pout power data, h,
whose properties all have their default values.
h = rfdata.power(`property1',value1,'property2',value2,...)
returns a data object for the Pin/Pout power data, h, based on the
specified properties.

7-131
rfdata.power class

Purpose Store output power and phase information for amplifiers or mixers

Description Use the power class to store output power and phase specifications
for a circuit object.

Construction rfdata.power Construct container for amplifier

or mixer output power and phase
information

Properties Freq Frequency data

Name Object name
Phase Phase shift data
Pin Input power data
Pout Output power data

Examples f = [2.08 2.10]*1.0e9;

phase = {[27.1 35.3],[15.4 19.3 21.1]};
pin = {[0.001 0.002],[0.001 0.005 0.01]};
pout = {[0.0025 0.0031],[0.0025 0.0028 0.0028]};
powerdata = rfdata.power;
powerdata.Freq = f;
powerdata.Phase = phase;
powerdata.Pin = pin;
powerdata.Pout = pout;

See Also rfdata.data

rfdata.ip3
rfdata.mixerspur
rfdata.network
rfdata.nf
rfdata.noise

7-132
 rfmodel.rational

Purpose Construct rational function model

Syntax h = rfmodel.rational
h = rfmodel.rational('Property1',value1,'Property2',value2,
...)

Description h = rfmodel.rational returns a rational function model object whose

properties are set to their default values.
h = rfmodel.rational('Property1',value1,'Property2',value2,...)
returns a rational function model object, h, with the specified properties.
Properties that you do not specify retain their default values.

Examples Construct a rational function model, rat, with poles at -4 Mrad/s, -3

Grad/s, and -5 Grad/s and residues of 600 Mrad/s, 2 Grad/s and 4
Grad/s. Then, perform frequency-domain analysis from 1.0 MHz to 3.0
GHz. Plot the resulting frequency response in decibels on the X-Y plane.

rat=rfmodel.rational...
('A',[-5e9,-3e9,-4e6],...
'C',[6e8,2e9,4e9]); % Create model
f = [1e6:1.0e7:3e9]; % Simulation frequencies
[resp,freq]=freqresp(rat,f); % Compute frequency response
figure
plot(freq/1e9,db(resp)); % Plot frequency response
xlabel('Frequency (GHz)')
ylabel('Magnitude (dB)')

7-133
rfmodel.rational

7-134
 rfmodel.rational class

Purpose Rational function model

Description Use the rational class to represent RF components using a rational

function model of the form

⎛ n Ck ⎞
F (s) = ⎜ ∑ + D ⎟ e− sτ , s = j 2πf
⎜ ⎟
⎝ k=1 s − Ak ⎠ (7-1)

There are two ways to construct an rfmodel.rational object:

• You can fit a rational function model to the component data using
the rationalfit function.
• You can use the rfmodel.rational constructor to specify the
pole-residue representation of the component directly.

Construction rfmodel.rational Construct rational function model

Properties A Poles of rational function

C Residues of rational function
D Frequency response offset
Delay Frequency response time delay
Name Object name

Methods freqresp Calculate frequency response of

model object
ispassive Check passivity of model object
stepresp Calculate response of model
object to step signal

7-135
rfmodel.rational class

timeresp Calculate time response for model

object
writeva Write Verilog-A description of RF
model object

Examples orig_data=read(rfdata.data,'default.s2p');
freq=orig_data.Freq;
data=orig_data.S_Parameters(2,1,:);
fit_data=rationalfit(freq,data)

fit_data =

Name: 'Rational Function'

A: [2x1 double]
C: [2x1 double]
D: 0
Delay: 0

7-136
 rfckt.amplifier.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. The default is a 1-by-1
rfdata.data object that contains the S-parameters, noise figure, OIP3,
and group delay values that result from analyzing the values stored in
the default.amp file at the frequencies stored in this file.
The analyze method computes the AnalyzedResult property using the
data stored in the rfckt.amplifier object properties as follows:

• The analyze method uses the data stored in the 'NoiseData'

property of the rfckt.amplifier object to calculate the noise figure.
• The analyze method uses the data stored in the 'NonlinearData'
property of the rfckt.amplifier object to calculate OIP3.
If power data exists in the 'NonlinearData' property, the block
extracts the AM/AM and AM/PM nonlinearities from the power data.
If the 'NonlinearData' property contains only IP3 data, the method
computes and adds the nonlinearity by:
1 Using the third-order input intercept point value in dBm to
compute the factor, f, that scales the input signal before the
amplifier object applies the nonlinearity:

u3
FAM / AM (u) = u −
3

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.
4 Applying an AM/AM conversion to the amplifier gain, according
to the following cubic polynomial equation:

7-137
rfckt.amplifier.AnalyzedResult property

u3
FAM / AM (u) = u −
3
where u is the magnitude of the scaled input signal, which is a
unitless normalized input voltage.
• The analyze method uses the data stored in the 'NetworkData'
property of the rfckt.amplifier object to calculate the group delay
values of the amplifier at the frequencies specified in freq, as
described in the analyze reference page.
• The analyze method uses the data stored in the 'NetworkData'
property of the rfckt.amplifier object to calculate the S-parameter
values of the amplifier at the frequencies specified in freq. If the
'NetworkData' property contains network Y- or Z-parameters, the
analyze method first converts the parameters to S-parameters.
Using the interpolation method you specify with the 'IntpType'
property, the analyze method interpolates the S-parameter values to
determine their values at the specified frequencies.
Specifically, the analyze method orders the S-parameters according
to the ascending order of their frequencies, fn. It then interpolates
the S-parameters, using the MATLAB interp1 function. For
example, the curve in the following diagram illustrates the result of
interpolating the S11 parameters at five different frequencies.

Interpolated S11 parameter values

Original S11 parameter values

f1 f2 f4 f5 f3 Frequencies in ascending
order of magnitude
(fmin) (fmax)

7-138
 rfckt.amplifier.AnalyzedResult property

For more information, see “One-Dimensional Interpolation” and the

interp1 reference page in the MATLAB documentation.
As shown in the preceding diagram, the analyze method uses the
parameter values at fmin, the minimum input frequency, for all
frequencies smaller than fmin. It uses the parameters values at fmax,
the maximum input frequency, for all frequencies greater than fmax.
In both cases, the results may not be accurate, so you need to specify
network parameter values over a range of frequencies that is wide
enough to account for the amplifier behavior.

Examples amp = rfckt.amplifier;

amp.AnalyzedResult

ans =

Name: 'Data object'

Freq: [191x1 double]
S_Parameters: [2x2x191 double]
GroupDelay: [191x1 double]
NF: [191x1 double]
OIP3: [191x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-139
rfckt.amplifier.IntpType property

Purpose Interpolation method

Values 'Linear' (default), 'Spline', or 'Cubic'

Description The analyze method is flexible in that it does not require the
frequencies of the specified S-parameters to match the requested
analysis frequencies. If needed, analyze applies the interpolation and
extrapolation method specified in the IntpType property to the specified
data to create a new set of data at the requested analysis frequencies.
The following table lists the available interpolation methods and
describes each one.

Method Description
Linear (default) Linear interpolation
Spline Cubic spline interpolation
Cubic Piecewise cubic Hermite
interpolation

Examples amp = rfckt.amplifier;

amp.IntpType = 'cubic'

amp =

Name: 'Amplifier'
nPort: 2
AnalyzedResult: [1x1 rfdata.data]
IntpType: 'Cubic'
NetworkData: [1x1 rfdata.network]
NoiseData: [1x1 rfdata.noise]
NonlinearData: [1x1 rfdata.power]

7-140
 rfckt.amplifier.Name property

Purpose Object name

Values 'Amplifier'

Description Read-only string that contains the name of the object.

Examples amp = rfckt.amplifier;

amp.Name

ans =

Amplifier

7-141
rfckt.amplifier.NetworkData property

Purpose Network parameter information

Values rfdata.network object

Description An rfdata.network object that stores network parameter data. The

default network parameter values are taken from the 'default.amp'
data file.

Examples amp = rfckt.amplifier;

amp.NetworkData

ans =

Name: 'Network parameters'

Type: 'S_PARAMETERS'
Freq: [191x1 double]
Data: [2x2x191 double]
Z0: 50

7-142
 rfckt.amplifier.NoiseData property

Purpose Noise information

Values Scalar noise figure in decibels, rfdata.noise object or rfdata.nf object

Description A scalar value or object that stores noise data. The default is an
rfdata.noise object whose values are taken from the 'default.amp'
data file.

Examples amp = rfckt.amplifier;

amp.NoiseData

ans =

Name: 'Spot noise data'

Freq: [9x1 double]
FMIN: [9x1 double]
GAMMAOPT: [9x1 double]
RN: [9x1 double]

7-143
rfckt.amplifier.NonlinearData property

Purpose Nonlinearity information

Values Scalar OIP3 in decibels relative to one milliwatt, rfdata.power object

or rfdata.ip3 object

Description A scalar value or object that stores nonlinearity data. The default is an
rfdata.power object whose values are taken from the 'default.amp'
data file.

Examples amp = rfckt.amplifier;

amp.NonlinearData

ans =

Name: 'Power data'

Freq: 2.1000e+009
Pin: {[20x1 double]}
Pout: {[20x1 double]}
Phase: {[20x1 double]}

7-144
 rfckt.amplifier.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples amp = rfckt.amplifier;

amp.nPort

ans =

7-145
rfckt.cascade.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.
The analyze method computes the AnalyzedResult property using the
data stored in the Ckts property as follows:

• The analyze method starts calculating the ABCD-parameters of

the cascaded network by converting each component network’s
parameters to an ABCD-parameters matrix. The figure shows a
cascaded network consisting of two 2-port networks, each represented
by its ABCD matrix.
The analyze method then calculates the ABCD-parameter matrix
for the cascaded network by calculating the product of the ABCD
matrices of the individual networks.
The following figure shows a cascaded network consisting of two
2-port networks, each represented by its ABCD-parameters.

The following equation illustrates calculations of the

ABCD-parameters for two 2-port networks.

⎡A B ⎤ ⎡ A′ B′ ⎤ ⎡ A′′ B′′ ⎤
⎢C =
⎣ D ⎥⎦ ⎢⎣ C′ D′⎥⎦ ⎢⎣ C′′ D′′⎥⎦

Finally, analyze converts the ABCD-parameters of the cascaded

network to S-parameters at the frequencies specified in the analyze
input argument freq.

7-146
 rfckt.cascade.AnalyzedResult property

• The analyze method calculates the noise figure for an N-element

cascade. First, the method calculates noise correlation matrices CA’
and CA”, corresponding to the first two matrices in the cascade, using
the following equation:

⎡ NFmin − 1 ⎤
⎢ Rn − Rn Yopt∗ ⎥
CA = 2kT ⎢ 2 ⎥
⎢ NFmin − 1 − R Y Rn Yopt
2 ⎥
⎢⎣ 2
n opt ⎥⎦
where k is Boltzmann’s constant, and T is the noise temperature in
Kelvin.
The method combines CA’ and CA” into a single correlation matrix CA
using the equation

⎡ A ’ B ’ ⎤ ’’ ⎡ A ’ B ’ ⎤
C A = C’A + ⎢ ⎥ CA ⎢ C ’ D ’⎥
⎣ C ’ D ’⎦ ⎣ ⎦

By applying this equation recursively, the method obtains a noise

correlation matrix for the entire cascade. The method then calculates
the noise factor, F, from the noise correlation matrix of as follows:

z+ C A z
F =1+
2kT Re {ZS }
⎡ 1 ⎤
z = ⎢ *⎥
⎢⎣ ZS ⎥⎦

In the two preceding equations, ZS is the nominal impedance, which

is 50 ohms, and z+ is the Hermitian conjugation of z.
• The analyze method calculates the output power at the third-order
intercept point (OIP3) for an N-element cascade using the following
equation:

7-147
rfckt.cascade.AnalyzedResult property

1
OIP3 =
1 1 1
+ +…+
OIP3, N GN ⋅ OIP3, N −1 GN ⋅ GN −1 ⋅ …⋅ G2 ⋅ OIP3,1
where Gn is the gain of the nth element of the cascade and OIP3,N is
the OIP3 of the nth element.
• The analyze method uses the cascaded S-parameters to calculate the
group delay values at the frequencies specified in the analyze input
argument freq, as described in the analyze reference page.

Examples Analyze a cascade of three circuit objects:

amp = rfckt.amplifier('IntpType','cubic');
tx1 = rfckt.txline;
tx2 = rfckt.txline;
casc = rfckt.cascade('Ckts',{tx1,amp,tx2});
analyze(casc,[1e9:1e7:2e9]);
casc.AnalyzedResult

References Hillbrand, H. and P.H. Russer, “An Efficient Method for Computer
Aided Noise Analysis of Linear Amplifier Networks,” IEEE Transactions
on Circuits and Systems, Vol. CAS-23, Number 4, pp. 235–238, 1976.

7-148
 rfckt.cascade.Ckts property

Purpose Circuit objects in network

Values Cell

Description Cell array containing handles to all circuit objects in the network, in
order from source to load. All circuits must be 2-port. This property
is empty by default.

Examples amp = rfckt.amplifier('IntpType','cubic');

tx1 = rfckt.txline;
tx2 = rfckt.txline;
casc = rfckt.cascade;
casc.Ckts = {tx1,amp,tx2};
casc.Ckts

ans =

[1x1 rfckt.txline] [1x1 rfckt.amplifier] [1x1 rfckt.txline]

7-149
rfckt.cascade.Name property

Purpose Object name

Values 'Cascaded Network'

Description Read-only string that contains the name of the object.

Examples casc = rfckt.cascade;

casc.Name

ans =

Cascaded Network

7-150
 rfckt.cascade.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples casc = rfckt.cascade;

casc.nPort

ans =

7-151
rfckt.coaxial.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.
The analyze method treats the transmission line as a 2-port linear
network. It computes the AnalyzedResult property of a stub or as
a stubless line using the data stored in the rfckt.coaxial object
properties as follows:

• If you model the transmission line as a stubless line, the analyze

method 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 analyze method 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, the vector of frequencies specified in the analyze input argument
freq. Both can be expressed in terms of the resistance (R), inductance

7-152
 rfckt.coaxial.AnalyzedResult property

(L), conductance (G), and capacitance (C) per unit length (meters)
as follows:

R + j 2πfL
Z0 =
G + j 2πfC
k = kr + jki = ( R + j 2πfL)(G + j 2πFC)

where

1 ⎛1 1⎞
R= +
2 cond cond ⎜⎝ a b ⎟⎠
 ⎛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 EpsilonR property value.
• tan δ is the LossTangent property value.

7-153
rfckt.coaxial.AnalyzedResult property

- δcond is the skin depth of the conductor, which the method

calculates as 1 /  f  cond .
- f is a vector of modeling frequencies determined by the Output
Port block.
• If you model the transmission line as a shunt or series stub, the
analyze method first calculates the ABCD-parameters at the
specified frequencies. It then uses the abcd2s function to convert the
ABCD-parameters to S-parameters.
When you set the StubMode property to 'Shunt', the 2-port network
consists of a stub transmission line that you can terminate with either
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

When you set the StubMode property to 'Series', the 2-port network
consists of a series transmission line that you can terminate with
either a short circuit or an open circuit as shown in the following
figure.

7-154
 rfckt.coaxial.AnalyzedResult property

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

The analyze method uses the S-parameters to calculate the group delay
values at the frequencies specified in the analyze input argument freq,
as described in the analyze reference page.

Examples tx1 = rfckt.coaxial;

analyze(tx1,[1e9,2e9,3e9]);
tx1.AnalyzedResult

ans =

Name: 'Data object'

Freq: [3x1 double]
S_Parameters: [2x2x3 double]
GroupDelay: [3x1 double]
NF: [3x1 double]
OIP3: [3x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-155
rfckt.coaxial.EpsilonR property

Purpose Relative permittivity of dielectric

Values Scalar

Description The ratio of the permittivity of the dielectric, ε, to the permittivity of

free space, ε0. The default value is 2.3.

Examples Change the relative permittivity of the dielectric:

tx1=rfckt.coaxial;
tx1.EpsilonR=2.7;

7-156
 rfckt.coaxial.InnerRadius property

Purpose Inner conductor radius

Values Scalar

Description The radius of the inner conductor, in meters. The default is 7.25e-4.

Examples tx1=rfckt.coaxial;
tx1.InnerRadius=2.5e-4;

7-157
rfckt.coaxial.LineLength property

Purpose Transmission line length

Values Scalar

Description The physical length of the transmission line in meters. The default
is 0.01.

Examples tx1 = rfckt.coaxial;

tx1.LineLength = 0.001;

7-158
 rfckt.coaxial.LossTangent property

Purpose Tangent of loss angle

Values Scalar

Description The loss angle tangent of the dielectric. The default is 0.

Examples tx1=rfckt.coaxial;
tx1.LossTangent=0.002;

7-159
rfckt.coaxial.MuR property

Purpose Relative permeability of dielectric

Values Scalar

Description The ratio of the permeability of the dielectric, μ, to the permeability in

free space, μ0. The default value is 1.

Examples Change the relative permeability of the dielectric:

tx1=rfckt.coaxial;
tx1.MuR=0.8;

7-160
 rfckt.coaxial.Name property

Purpose Object name

Values 'Coaxial Transmission Line'

Description Read-only string that contains the name of the object.

Examples tx1 = rfckt.coaxial;

tx1.Name

ans =

Coaxial Transmission Line

7-161
rfckt.coaxial.OuterRadius property

Purpose Outer conductor radius

Values Scalar

Description The radius of the outer conductor, in meters. The default is 0.0026.

Examples tx1=rfckt.coaxial;
tx1.OuterRadius=0.0031;

7-162
 rfckt.coaxial.SigmaCond property

Purpose Conductor conductivity

Values Scalar

Description Conductivity, in Siemens per meter (S/m), of the conductor. The default
is Inf.

Examples tx1=rfckt.coaxial;
tx1.SigmaCond=5.81e7;

7-163
rfckt.coaxial.StubMode property

Purpose Type of stub

Values 'NotAStub' (default), 'Series', or 'Shunt'

Description String that specifies what type of stub, if any, to include in the
transmission line model.

Examples tx1 = rfckt.coaxial;

tx1.StubMode = 'Series';

7-164
 rfckt.coaxial.Termination property

Purpose Stub transmission line termination

Values 'NotApplicable' (default), 'Open', or 'Short'.

Description String that specifies what type of termination to use for 'Shunt' and
'Series' stub modes. Termination is ignored if the line has no stub.
Use 'NotApplicable' when StubMode is 'NotAStub'.

Examples tx1 = rfckt.coaxial;

tx1.StubMode = 'Series';
tx1.Termination = 'Short';

7-165
rfckt.coaxial.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples tx1 = rfckt.coaxial;

tx1.nPort

ans =

7-166
 rfckt.cpw.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.
The analyze method treats the transmission line as a 2-port linear
network. It computes the AnalyzedResult property of a stub or as a
stubless line using the data stored in the rfckt.cpw object properties
as follows:

• If you model the transmission line as a stubless line, the analyze

method 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 analyze method 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, the vector of frequencies specified in the analyze input argument
freq. Both can be expressed in terms of the specified conductor

7-167
rfckt.cpw.AnalyzedResult property

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].
• If you model the transmission line as a shunt or series stub, the
analyze method first calculates the ABCD-parameters at the
specified frequencies. It then uses the abcd2s function to convert the
ABCD-parameters to S-parameters.
When you set the StubMode property to 'Shunt', the 2-port network
consists of a stub transmission line that you can terminate with either
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

When you set the StubMode property to 'Series', the 2-port network
consists of a series transmission line that you can terminate with
either a short circuit or an open circuit as shown in the following
figure.

7-168
 rfckt.cpw.AnalyzedResult property

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

The analyze method uses the S-parameters to calculate the group delay
values at the frequencies specified in the analyze input argument freq,
as described in the analyze reference page.

Examples tx1 = rfckt.cpw;

analyze(tx1,[1e9,2e9,3e9]);
tx1.AnalyzedResult

ans =

Name: 'Data object'

Freq: [3x1 double]
S_Parameters: [2x2x3 double]
NF: [3x1 double]
GroupDelay: [3x1 double]
OIP3: [3x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-169
rfckt.cpw.ConductorWidth property

Purpose Conductor width

Values Scalar

Description Physical width, in meters, of the conductor. The default is 0.6e-4.

Examples tx1=rfckt.cpw;
tx1.ConductorWidth=0.001;

7-170
 rfckt.cpw.EpsilonR property

Purpose Relative permittivity of dielectric

Values Scalar

Description The ratio of the permittivity of the dielectric, ε, to the permittivity of

free space, ε0. The default value is 9.8.

Examples Change the relative permittivity of the dielectric:

tx1=rfckt.cpw;
tx1.EpsilonR=2.7;

7-171
rfckt.cpw.Height property

Purpose Dielectric thickness

Values Scalar

Description Physical height, in meters, of the dielectric on which the conductor

resides. The default is 0.635e-4.

Examples tx1=rfckt.cpw;
tx1.Height=0.001;

7-172
 rfckt.cpw.LineLength property

Purpose Transmission line length

Values Scalar

Description The physical length of the transmission line in meters. The default
is 0.01.

Examples tx1 = rfckt.cpw;

tx1.LineLength = 0.001;

7-173
rfckt.cpw.LossTangent property

Purpose Tangent of loss angle

Values Scalar

Description The loss angle tangent of the dielectric. The default is 0.

Examples tx1 = rfckt.cpw;

tx1.LossTangent

ans =

7-174
 rfckt.cpw.Name property

Purpose Object name

Values 'Coplanar Waveguide Transmission Line'

Description Read-only string that contains the name of the object.

Examples tx1 = rfckt.cpw;

tx1.Name

ans =

Coplanar Waveguide Transmission Line

7-175
rfckt.cpw.SigmaCond property

Purpose Conductor conductivity

Values Scalar

Description Conductivity, in Siemens per meter (S/m), of the conductor. The default
is Inf.

Examples tx1=rfckt.cpw;
tx1.SigmaCond=5.81e7;

7-176
 rfckt.cpw.SlotWidth property

Purpose Width of slot

Values Scalar

Description Physical width, in meters, of the slot. The default is 0.2e-4.

Examples tx1=rfckt.cpw;
tx1.SlotWidth=0.002;

7-177
rfckt.cpw.StubMode property

Purpose Type of stub

Values 'NotAStub' (default), 'Series', or 'Shunt'

Description String that specifies what type of stub, if any, to include in the
transmission line model.

Examples tx1 = rfckt.cpw;

tx1.StubMode = 'Series';

7-178
 rfckt.cpw.Termination property

Purpose Stub transmission line termination

Values 'NotApplicable' (default), 'Open', or 'Short'.

Description String that specifies what type of termination to use for 'Shunt'and
'Series' stub modes. Termination is ignored if the line has no stub.
Use 'NotApplicable' when StubMode is 'NotAStub'.

Examples tx1 = rfckt.cpw;

tx1.StubMode = 'Series';
tx1.Termination = 'Short';

7-179
rfckt.cpw.Thickness property

Purpose Conductor thickness

Values Scalar

Description Physical thickness, in meters, of the conductor. The default is 0.005e-6.

Examples tx1=rfckt.cpw;
tx1.Thickness=2e-5;

7-180
 rfckt.cpw.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples tx1 = rfckt.cpw;

tx1.nPort

ans =

7-181
rfckt.datafile.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. The default is a 1-by-1
rfdata.data object that contains the S-parameters, noise figure, OIP3,
and group delay values that are the result of analyzing the values
stored in the passive.s2p file at the frequencies stored in this file.
The analyze method computes the AnalyzedResult property using
the data stored in the File object property. If the file you specify
with this property contains network Y- or Z-parameters, analyze first
converts these parameters, as they exist in the rfckt.datafile object,
to S-parameters. Using the interpolation method you specify with
the 'IntpType' property, analyze interpolates the S-parameters to
determine the S-parameters at the specified frequencies. Specifically,
analyze orders the S-parameters according to the ascending order of
their frequencies, fn. It then interpolates the S-parameters, using the
MATLAB interp1 function. For example, the curve in the following
diagram illustrates the result of interpolating the S11 parameters at
five different frequencies.

Interpolated S11 parameter values

Original S11 parameter values

f1 f2 f4 f5 f3 Frequencies in ascending
order of magnitude
(fmin) (fmax)

7-182
 rfckt.datafile.AnalyzedResult property

For more information, see “One-Dimensional Interpolation” and the

interp1 reference page in the MATLAB documentation.
As shown in the preceding diagram, the analyze method uses the
parameter values at fmin, the minimum input frequency, for all
frequencies smaller than fmin. It uses the parameters values at fmax, the
maximum input frequency, for all frequencies greater than fmax. In both
cases, the results may not be accurate, so you need to specify network
parameter values over a range of frequencies that is wide enough to
account for the component behavior.
The analyze method uses the S-parameters to calculate the group delay
values at the frequencies specified in the analyze input argument freq,
as described in the analyze reference page.

Examples data = rfckt.datafile;

data.AnalyzedResult

ans =

Name: 'Data object'

Freq: [202x1 double]
S_Parameters: [2x2x202 double]
GroupDelay: [202x1 double]
NF: [202x1 double]
OIP3: [202x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-183
rfckt.datafile.File property

Purpose File containing circuit data

Values String

Description The name of the .snp, .ynp, .znp, or .hnp file describing the circuit,
where n is the number of ports. The default file name is 'passive.s2p'.

Examples data=rfckt.datafile;
data.File='default.s2p'

data =

Name: 'Data File'

nPort: 2
AnalyzedResult: [1x1 rfdata.data]
IntpType: 'Linear'
File: 'default.s2p'

7-184
 rfckt.datafile.IntpType property

Purpose Interpolation method

Values 'Linear' (default), 'Spline', or 'Cubic'

Description The analyze method is flexible in that it does not require the
frequencies of the specified S-parameters to match the requested
analysis frequencies. If needed, analyze applies the interpolation and
extrapolation method specified in the IntpType property to the specified
data to create a new set of data at the requested analysis frequencies.
The following table lists the available interpolation methods and
describes each one.

Method Description
Linear (default) Linear interpolation
Spline Cubic spline interpolation
Cubic Piecewise cubic Hermite
interpolation

Examples data = rfckt.datafile;

data.IntpType = 'cubic';

7-185
rfckt.datafile.Name property

Purpose Object name

Values 'Data object'

Description Read-only string that contains the name of the object.

Examples data = rfckt.datafile;

data.Name

ans =

Data object

7-186
 rfckt.datafile.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples data = rfckt.datafile;

data.nPort

ans =

7-187
rfckt.delay.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.
The analyze method treats the delay line, which can be lossy or
lossless, as a 2-port linear network. It computes the AnalyzedResult
property of the delay line using the data stored in the rfckt.delay
object properties by calculating the S-parameters for the specified
frequencies. This calculation is based on the values of the delay line’s
loss, α, and time delay, D.

⎧ S11 =0
⎪
⎪ S12 = e− p
⎨
⎪ S21 = e− p
⎪
⎩ S22 =0
Above, p = αa + iβ, where αa is the attenuation coefficient and β is the
wave number. The attenuation coefficient αa is related to the loss, α, by

 a = − ln (10 / 20 )
and the wave number β is related to the time delay, D, by

 = 2 fD
where f is the frequency range specified in the analyze input argument
freq.
The analyze method uses the S-parameters to calculate the group delay
values at the frequencies specified in the analyze input argument freq,
as described in the analyze reference page.

7-188
 rfckt.delay.AnalyzedResult property

Examples Compute S-parameters, noise figure, OIP3, and group delay values:

del = rfckt.delay;
analyze(del,[1e9,2e9,3e9]);
del.AnalyzedResult

7-189
rfckt.delay.Loss property

Purpose Delay line loss

Values Scalar

Description Line loss value, in decibels. Line loss is the reduction in strength of the
signal as it travels over the delay line and must be nonnegative. The
default is 0.

Examples del = rfckt.delay;

del.Loss = 10;

7-190
 rfckt.delay.Name property

Purpose Object name

Values 'Delay Line'

Description Read-only string that contains the name of the object.

Examples del = rfckt.delay;

del.Name

ans =

Delay Line

7-191
rfckt.delay.TimeDelay property

Purpose Delay introduced by line

Values Scalar

Description The amount of time delay, in seconds. The default is 1.0000e-012.

Examples del = rfckt.delay;

del.TimeDelay = 1e-9;

7-192
 rfckt.delay.Z0 property

Purpose Characteristic impedance

Values Scalar

Description The characteristic impedance, in ohms, of the delay line. The default
is 50 ohms.

Examples del = rfckt.delay;

del.Z0 = 75;

7-193
rfckt.delay.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples del = rfckt.delay;

del.nPort

ans =

7-194
 rfckt.hybrid.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.
The analyze method computes the S-parameters of the AnalyzedResult
property using the data stored in the Ckts property as follows:

• The analyze method first calculates the h matrix of the hybrid

network. It starts by converting each component network’s
parameters to an h matrix. The following figure shows a hybrid
connected network consisting of two 2-port networks, each
represented by its h matrix,

where

⎡h ′ h12′ ⎤
[ h′ ] = ⎢11 ⎥
⎢⎣ h21′ h22′ ⎥⎦
⎡ h ′′ h ′′ ⎤
[ h′′] = ⎢ 11 12 ⎥
⎣⎢ h21′′ h22′′ ⎥⎦

7-195
rfckt.hybrid.AnalyzedResult property

• The analyze method then calculates the h matrix for the hybrid
network by calculating the sum of the h matrices of the individual
networks. The following equation illustrates the calculations for two
2-port networks.

⎡ h ′ + h ′′ h12′ + h12′′ ⎤
[ h] = ⎢ 11 11
⎥
⎢ h ′ + h ′′ h22′ + h22′′ ⎥⎦
⎣ 21 21

• Finally, analyze converts the h matrix of the hybrid network to

S-parameters at the frequencies specified in the analyze input
argument freq.

The analyze method uses the hybrid S-parameters to calculate the

group delay values at the frequencies specified in the analyze input
argument freq, as described in the analyze reference page.

Examples tx1 = rfckt.txline;

tx2 = rfckt.txline;
hyb = rfckt.hybrid('Ckts',{tx1,tx2})
analyze(hyb,[1e9:1e7:2e9]);
hyb.AnalyzedResult

ans =

Name: 'Data object'

Freq: [101x1 double]
S_Parameters: [2x2x101 double]
GroupDelay: [101x1 double]
NF: [101x1 double]
OIP3: [101x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-196
 rfckt.hybrid.Ckts property

Purpose Circuit objects in network

Values Cell

Description Cell array containing handles to all circuit objects in the network. All
circuits must be 2-port and linear. This property is empty by default.

Examples tx1 = rfckt.txline;

tx2 = rfckt.txline;
hyb = rfckt.hybrid;
hyb.Ckts = {tx1,tx2};
hyb.Ckts

ans =

[1x1 rfckt.txline] [1x1 rfckt.txline]

7-197
rfckt.hybrid.Name property

Purpose Object name

Values 'Hybrid Connected Network'

Description Read-only string that contains the name of the object.

Examples hyb = rfckt.hybrid;

hyb.Name

ans =

Hybrid Connected Network

7-198
 rfckt.hybrid.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples hyb = rfckt.hybrid;

hyb.nPort

ans =

7-199
rfckt.hybridg.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.
The analyze method computes the S-parameters of the AnalyzedResult
property using the data stored in the Ckts property as follows:

1 The analyze method first calculates the g matrix of the inverse

hybrid network. It starts by converting each component network’s
parameters to a g matrix. The following figure shows an inverse
hybrid connected network consisting of two 2-port networks, each
represented by its g matrix,

where

⎡g ′ g12′ ⎤
[ g ′] = ⎢11 ⎥
⎢⎣ g21′ g22′ ⎥⎦
⎡ g ′′ g ′′ ⎤
[ g′′] = ⎢ 11 12 ⎥
⎢⎣ g21′′ g22′′ ⎥⎦

7-200
 rfckt.hybridg.AnalyzedResult property

2 The analyze method then calculates the g matrix for the inverse
hybrid network by calculating the sum of the g matrices of the
individual networks. The following equation illustrates the
calculations for two 2-port networks.

⎡ g ′ + g ′′ g12′ + g12′′ ⎤
[ g] = ⎢ 11 11
⎥
⎢ g ′ + g ′′ g22′ + g22′′ ⎥⎦
⎣ 21 21

3 Finally, analyze converts the g matrix of the inverse hybrid network

to S-parameters at the frequencies specified in the analyze input
argument freq.

The analyze method uses the inverse hybrid S-parameters to calculate

the group delay values at the frequencies specified in the analyze input
argument freq, as described in the analyze reference page.

Examples tx1 = rfckt.txline;

tx2 = rfckt.txline;
invhyb = rfckt.hybridg('Ckts',{tx1,tx2})
analyze(invhyb,[1e9:1e7:2e9]);
invhyb.AnalyzedResult

ans =

Name: 'Data object'

Freq: [101x1 double]
S_Parameters: [2x2x101 double]
GroupDelay: [101x1 double]
NF: [101x1 double]
OIP3: [101x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-201
rfckt.hybridg.Ckts property

Purpose Circuit objects in network

Values Cell

Description Cell array containing handles to all circuit objects in the network. All
circuits must be 2-port and linear. This property is empty by default.

Examples tx1 = rfckt.txline;

tx2 = rfckt.txline;
invhyb = rfckt.hybridg;
invhyb.Ckts = {tx1,tx2};
invhyb.Ckts

ans =

[1x1 rfckt.txline] [1x1 rfckt.txline]

7-202
 rfckt.hybridg.Name property

Purpose Object name

Values 'Hybrid G Connected Network'

Description Read-only string that contains the name of the object.

Examples invhyb = rfckt.hybridg;

invhyb.Name

ans =

Hybrid G Connected Network

7-203
rfckt.hybridg.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples invhyb = rfckt.hybridg;

invhyb.nPort

ans =

7-204
 rfckt.lcbandpasspi.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.

Examples filter = rfckt.lcbandpasspi;

analyze(filter,[1e9,2e9,3e9]);
filter.AnalyzedResult

ans =

Name: 'Data object'

Freq: [3x1 double]
S_Parameters: [2x2x3 double]
GroupDelay: [3x1 double]
NF: [3x1 double]
OIP3: [3x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-205
rfckt.lcbandpasspi.C property

Purpose Capacitance data

Values Vector

Description Capacitance values in farads, in order from source to load, of all

capacitors in the network. The length of the capacitance vector must
be equal to the length of the vector you provide for 'L'. All values
must be strictly positive. The default is [0.3579e-10, 0.0118e-10,
0.3579e-10].

Examples filter=rfckt.lcbandpasspi;
filter.C = [10.1 4.5 14.2]*1e-12;

7-206
 rfckt.lcbandpasspi.L property

Purpose Inductance data

Values Vector

Description Inductance values in henries, in order from source to load, of all

inductors in the network. The length of the inductance vector must be
equal to the length of the vector you provide for 'C'. All values must be
strictly positive. The default is [0.0144e-7, 0.4395e-7, 0.0144e-7].

Examples filter = rfckt.lcbandpasspi;

filter.L = [3.1 5.9 16.3]*1e-9;

7-207
rfckt.lcbandpasspi.Name property

Purpose Object name

Values 'LC Bandpass Pi'

Description Read-only string that contains the name of the object.

Examples filter = rfckt.lcbandpasspi;

filter.Name

ans =

LC Bandpass Pi

7-208
 rfckt.lcbandpasspi.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples filter = rfckt.lcbandpasspi;

filter.nPort

ans =

7-209
rfckt.lcbandpasstee.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.

Examples filter = rfckt.lcbandpasstee;

analyze(filter,[1e9,2e9,3e9]);
filter.AnalyzedResult

ans =

Name: 'Data object'

Freq: [3x1 double]
S_Parameters: [2x2x3 double]
GroupDelay: [3x1 double]
NF: [3x1 double]
OIP3: [3x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-210
 rfckt.lcbandpasstee.C property

Purpose Capacitance data

Values Vector

Description Capacitance values in farads, in order from source to load, of all

capacitors in the network. The length of the capacitance vector must
be equal to the length of the vector you provide for 'L'. All values
must be strictly positive. The default is [0.0186e-10, 0.1716e-10,
0.0186e-10].

Examples filter=rfckt.lcbandpasstee;
filter.C = [10.1 4.5 14.2]*1e-12;

7-211
rfckt.lcbandpasstee.L property

Purpose Inductance data

Values Vector

Description Inductance values in henries, in order from source to load, of all

inductors in the network. The length of the inductance vector must be
equal to the length of the vector you provide for 'C'. All values must be
strictly positive. The default is [0.2781e-7, 0.0301e-7, 0.2781e-7].

Examples filter = rfckt.lcbandpasstee;

filter.L = [3.1 5.9 16.3]*1e-9;

7-212
 rfckt.lcbandpasstee.Name property

Purpose Object name

Values 'LC Bandpass Tee'

Description Read-only string that contains the name of the object.

Examples filter = rfckt.lcbandpasstee;

filter.Name

ans =

LC Bandpass Tee

7-213
rfckt.lcbandpasstee.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples filter = rfckt.lcbandpasstee;

filter.nPort

ans =

7-214
 rfckt.lcbandstoppi.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.

Examples filter = rfckt.lcbandstoppi;

analyze(filter,[1e9,2e9,3e9]);
filter.AnalyzedResult

ans =

Name: 'Data object'

Freq: [3x1 double]
S_Parameters: [2x2x3 double]
GroupDelay: [3x1 double]
NF: [3x1 double]
OIP3: [3x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-215
rfckt.lcbandstoppi.C property

Purpose Capacitance data

Values Vector

Description Capacitance values in farads, in order from source to load, of all

capacitors in the network. The length of the capacitance vector must
be equal to the length of the vector you provide for 'L'. All values
must be strictly positive. The default is [0.0184e-10, 0.2287e-10,
0.0184e-10].

Examples filter=rfckt.lcbandstoppi;
filter.C = [10.1 4.5 14.2]*1e-12;

7-216
 rfckt.lcbandstoppi.L property

Purpose Inductance data

Values Vector

Description Inductance values in henries, in order from source to load, of all

inductors in the network. The length of the inductance vector must be
equal to the length of the vector you provide for 'C'. All values must be
strictly positive. The default is [0.2809e-7, 0.0226e-7, 0.2809e-7].

Examples filter = rfckt.lcbandstoppi;

filter.L = [3.1 5.9 16.3]*1e-9;

7-217
rfckt.lcbandstoppi.Name property

Purpose Object name

Values 'LC Bandstop Pi'

Description Read-only string that contains the name of the object.

Examples filter = rfckt.lcbandstoppi;

filter.Name

ans =

LC Bandstop Pi

7-218
 rfckt.lcbandstoppi.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples filter = rfckt.lcbandstoppi;

filter.nPort

ans =

7-219
rfckt.lcbandstoptee.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.

Examples filter = rfckt.lcbandstoptee;

analyze(filter,[1e9,2e9,3e9]);
filter.AnalyzedResult

ans =

Name: 'Data object'

Freq: [3x1 double]
S_Parameters: [2x2x3 double]
GroupDelay: [3x1 double]
NF: [3x1 double]
OIP3: [3x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-220
 rfckt.lcbandstoptee.C property

Purpose Capacitance data

Values Vector

Description Capacitance values in farads, in order from source to load, of all

capacitors in the network. The length of the capacitance vector must
be equal to the length of the vector you provide for 'L'. All values
must be strictly positive. The default is [0.1852e-10, 0.0105e-10,
0.1852e-10].

Examples filter=rfckt.lcbandstoptee;
filter.C = [10.1 4.5 14.2]*1e-12;

7-221
rfckt.lcbandstoptee.L property

Purpose Inductance data

Values Vector

Description Inductance values in henries, in order from source to load, of all

inductors in the network. The length of the inductance vector must be
equal to the length of the vector you provide for 'C'. All values must be
strictly positive. The default is [0.0279e-7, 0.4932e-7, 0.0279e-7].

Examples filter = rfckt.lcbandstoptee;

filter.L = [3.1 5.9 16.3]*1e-9;

7-222
 rfckt.lcbandstoptee.Name property

Purpose Object name

Values 'LC Bandstop Tee'

Description Read-only string that contains the name of the object.

Examples filter = rfckt.lcbandstoptee;

filter.Name

ans =

LC Bandstop Tee

7-223
rfckt.lcbandstoptee.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples filter = rfckt.lcbandstoptee;

filter.nPort

ans =

7-224
 rfckt.lchighpasspi.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.

Examples filter = rfckt.lchighpasspi;

analyze(filter,[1e9,2e9,3e9]);
filter.AnalyzedResult

ans =

Name: 'Data object'

Freq: [3x1 double]
S_Parameters: [2x2x3 double]
GroupDelay: [3x1 double]
NF: [3x1 double]
OIP3: [3x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-225
rfckt.lchighpasspi.C property

Purpose Capacitance data

Values Vector

Description Capacitance values in farads, in order from source to load, of all

capacitors in the network. The length of the capacitance vector must be
equal to the length of the vector you provide for 'L'. All values must be
strictly positive. The default is [0.1188e-5, 0.1188e-5].

Examples filter=rfckt.lchighpasspi;
filter.C = [10.1 4.5 14.2]*1e-12;

7-226
 rfckt.lchighpasspi.L property

Purpose Inductance data

Values Vector

Description Inductance values in henries, in order from source to load, of all

inductors in the network. The length of the inductance vector must be
equal to the length of the vector you provide for 'C'. All values must be
strictly positive. The default is [2.2363e-9].

Examples filter = rfckt.lchighpasspi;

filter.L = [3.1 5.9 16.3]*1e-9;

7-227
rfckt.lchighpasspi.Name property

Purpose Object name

Values 'LC Highpass Pi'

Description Read-only string that contains the name of the object.

Examples filter = rfckt.lchighpasspi;

filter.Name

ans =

LC Highpass Pi

7-228
 rfckt.lchighpasspi.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples filter = rfckt.lchighpasspi;

filter.nPort

ans =

7-229
rfckt.lchighpasstee.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.

Examples filter = rfckt.lchighpasstee;

analyze(filter,[1e9,2e9,3e9]);
filter.AnalyzedResult

ans =

Name: 'Data object'

Freq: [3x1 double]
S_Parameters: [2x2x3 double]
GroupDelay: [3x1 double]
NF: [3x1 double]
OIP3: [3x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-230
 rfckt.lchighpasstee.C property

Purpose Capacitance data

Values Vector

Description Capacitances values in farads, in order from source to load, of all

capacitors in the network. The length of the capacitance vector must be
equal to the length of the vector you provide for 'L'. All values must be
strictly positive. The default is [0.4752e-9, 0.4752e-9].

Examples filter=rfckt.lchighpasstee;
filter.C = [10.1 4.5 14.2]*1e-12;

7-231
rfckt.lchighpasstee.L property

Purpose Inductance data

Values Vector

Description Inductance values in henries, in order from source to load, of all

inductors in the network. The length of the inductance vector must be
equal to the length of the vector you provide for 'C'. All values must be
strictly positive. The default is [5.5907e-6].

Examples filter = rfckt.lchighpasstee;

filter.L = [3.1 5.9 16.3]*1e-9;

7-232
 rfckt.lchighpasstee.Name property

Purpose Object name

Values 'LC Highpass Tee'

Description Read-only string that contains the name of the object.

Examples filter = rfckt.lchighpasstee;

filter.Name

ans =

LC Highpass Tee

7-233
rfckt.lchighpasstee.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples filter = rfckt.lchighpasstee;

filter.nPort

ans =

7-234
 rfckt.lclowpasspi.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.

Examples filter = rfckt.lclowpasspi;

analyze(filter,[1e9,2e9,3e9]);
filter.AnalyzedResult

ans =

Name: 'Data object'

Freq: [3x1 double]
S_Parameters: [2x2x3 double]
GroupDelay: [3x1 double]
NF: [3x1 double]
OIP3: [3x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-235
rfckt.lclowpasspi.C property

Purpose Capacitance data

Values Vector

Description Capacitance values in farads, in order from source to load, of all

capacitors in the network. The length of the capacitance vector must
be equal to or one greater than the length of the vector you provide for
'L'. All values must be strictly positive. The default is [0.5330e-8,
0.5330e-8].

Examples filter=rfckt.lclowpasspi;
filter.C = [10.1 4.5 14.2]*1e-12;

7-236
 rfckt.lclowpasspi.L property

Purpose Inductance data

Values Vector

Description Inductance values in henries, in order from source to load, of all

inductors in the network. The length of the inductance vector must be
equal to or one less than the length of the vector you provide for 'C'. All
values must be strictly positive. The default is [2.8318e-6].

Examples filter = rfckt.lclowpasspi;

filter.L = [3.1 5.9 16.3]*1e-9;

7-237
rfckt.lclowpasspi.Name property

Purpose Object name

Values 'LC Lowpass Pi'

Description Read-only string that contains the name of the object.

Examples filter = rfckt.lclowpasspi;

filter.Name

ans =

LC Lowpass Pi

7-238
 rfckt.lclowpasspi.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples filter = rfckt.lclowpasspi;

filter.nPort

ans =

7-239
rfckt.lclowpasstee.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.

Examples filter = rfckt.lclowpasstee;

analyze(filter,[1e9,2e9,3e9]);
filter.AnalyzedResult

ans =

Name: 'Data object'

Freq: [3x1 double]
S_Parameters: [2x2x3 double]
GroupDelay: [3x1 double]
NF: [3x1 double]
OIP3: [3x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-240
 rfckt.lclowpasstee.C property

Purpose Capacitance data

Values Vector

Description Capacitance values in farads, in order from source to load, of all

capacitors in the network. The length of the capacitance vector must be
equal to or one less than the length of the vector you provide for 'L'. All
values must be strictly positive. The default is [1.1327e-9].

Examples filter=rfckt.lclowpasstee;
filter.C = [10.1 4.5 14.2]*1e-12;

7-241
rfckt.lclowpasstee.L property

Purpose Inductance data

Values Vector

Description Inductance values in henries, in order from source to load, of all

inductors in the network. The length of the inductance vector must be
equal to or one greater than the length of the vector you provide for
'C'. All values must be strictly positive. The default is [0.1332e-4,
0.1332e-4].

Examples filter = rfckt.lclowpasstee;

filter.L = [3.1 5.9 16.3]*1e-9;

7-242
 rfckt.lclowpasstee.Name property

Purpose Object name

Values 'LC Lowpass Tee'

Description Read-only string that contains the name of the object.

Examples filter = rfckt.lclowpasstee;

filter.Name

ans =

LC Lowpass Tee

7-243
rfckt.lclowpasstee.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples filter = rfckt.lclowpasstee;

filter.nPort

ans =

7-244
 rfckt.microstrip.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.
The analyze method treats the microstrip line as a 2-port linear
network and models the line as a transmission line with optional stubs.
The analyze method computes the AnalyzedResult property of the
transmission line using the data stored in the rfckt.microstrip object
properties as follows:

•
If you model the transmission line as a stubless line, the analyze
method 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 analyze method 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

7-245
rfckt.microstrip.AnalyzedResult property

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

f, the vector of frequencies specified in the analyze input argument
freq. 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].
• If you model the transmission line as a shunt or series stub, the
analyze method first calculates the ABCD-parameters at the
specified frequencies. It then uses the abcd2s function to convert the
ABCD-parameters to S-parameters.
When you set the StubMode property to 'Shunt', the 2-port network
consists of a stub transmission line that you can terminate with either
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

When you set the StubMode property to 'Series', the 2-port network
consists of a series transmission line that you can terminate with
either a short circuit or an open circuit as shown in the following
figure.

7-246
 rfckt.microstrip.AnalyzedResult property

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

The analyze method uses the S-parameters to calculate the group delay
values at the frequencies specified in the analyze input argument freq,
as described in the analyze reference page.

Examples tx1 = rfckt.microstrip;

analyze(tx1,[1e9,2e9,3e9]);
tx1.AnalyzedResult

ans =

Name: 'Data object'

Freq: [3x1 double]
S_Parameters: [2x2x3 double]
GroupDelay: [3x1 double]
NF: [3x1 double]
OIP3: [3x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-247
rfckt.microstrip.EpsilonR property

Purpose Relative permittivity of dielectric

Values Scalar

Description The ratio of the permittivity of the dielectric, ε, to the permittivity of

free space, ε0. The default value is 9.8.

Examples Change the relative permittivity of the dielectric:

tx1=rfckt.microstrip;
tx1.EpsilonR=2.7;

7-248
 rfckt.microstrip.Height property

Purpose Dielectric thickness

Values Scalar

Description Physical height, in meters, of the dielectric on which the microstrip

resides. The default is 6.35e-4.

Examples tx1=rfckt.microstrip;
tx1.Height=0.001;

7-249
rfckt.microstrip.LineLength property

Purpose Microstrip line length

Values Scalar

Description The physical length of the transmission line in meters. The default
is 0.01.

Examples tx1 = rfckt.microstrip;

tx1.LineLength = 0.001;

7-250
 rfckt.microstrip.LossTangent property

Purpose Tangent of loss angle

Values Scalar

Description The loss angle tangent of the dielectric. The default is 0.

Examples tx1 = rfckt.microstrip;

tx1.LossTangent

ans =

7-251
rfckt.microstrip.Name property

Purpose Object name

Values 'Micrstrip Waveguide Transmission Line'

Description Read-only string that contains the name of the object.

Examples tx1 = rfckt.microstrip;

tx1.Name

ans =

Microstrip Transmission Line

7-252
 rfckt.microstrip.SigmaCond property

Purpose Conductor conductivity

Values Scalar

Description Conductivity, in Siemens per meter (S/m), of the conductor. The default
is Inf.

Examples tx1=rfckt.microstrip;
tx1.SigmaCond=5.81e7;

7-253
rfckt.microstrip.StubMode property

Purpose Type of stub

Values 'NotAStub' (default), 'Series', or 'Shunt'

Description String that specifies what type of stub, if any, to include in the
transmission line model.

Examples tx1 = rfckt.microstrip;

tx1.StubMode = 'Series';

7-254
 rfckt.microstrip.Termination property

Purpose Stub transmission line termination

Values 'NotApplicable' (default), 'Open', or 'Short'.

Description String that specifies what type of termination to use for 'Shunt'and
'Series' stub modes. Termination is ignored if the line has no stub.
Use 'NotApplicable when StubMode is 'NotAStub'.

Examples tx1 = rfckt.microstrip;

tx1.StubMode = 'Series';
tx1.Termination = 'Short';

7-255
rfckt.microstrip.Thickness property

Purpose Microstrip thickness

Values Scalar

Description Physical thickness, in meters, of the microstrip. The default is 5.0e-6.

Examples tx1=rfckt.microstrip;
tx1.Thickness=2e-6;

7-256
 rfckt.microstrip.Width property

Purpose Parallel-plate width

Values Scalar

Description Physical width, in meters, of the parallel-plate. The default is 6.0e-4.

Examples tx1=rfckt.microstrip;
tx1.Thickness=2e-4;

7-257
rfckt.microstrip.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples tx1 = rfckt.microstrip;

tx1.nPort

ans =

7-258
 rfckt.mixer.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. The default is a 1-by-1
rfdata.data object that contains the S-parameters, noise figure, OIP3,
and group delay values that result from analyzing the values stored in
the default.amp file at the frequencies stored in this file.
The analyze method computes the AnalyzedResult property using the
data stored in the rfckt.mixer object properties as follows:

• The analyze method uses the data stored in the 'NoiseData'

property of the rfckt.mixer object to calculate the noise figure.
• The analyze method uses the data stored in the 'PhaseNoiseLevel'
property of the rfckt.mixer object to calculate phase noise. The
analyze method 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 method computes the digital filter by:
1 Interpolating the specified phase noise amplitude 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.
• The analyze method uses the data stored in the 'NonlinearData'
property of the rfckt.mixer object to calculate OIP3.
If power data exists in the 'NonlinearData' property, the block
extracts the AM/AM and AM/PM nonlinearities from the power data.
If the 'NonlinearData' property contains only IP3 data, the method
computes and adds the nonlinearity by:

7-259
rfckt.mixer.AnalyzedResult property

1 Using the third-order input intercept point value in dBm to

compute the factor, f, that scales the input signal before the mixer
object applies the nonlinearity:

u3
FAM / AM (u) = u −
3

2 Computing the scaled input signal by multiplying the mixer input

signal by f.
3 Limiting the scaled input signal to a maximum value of 1.
4 Applying an AM/AM conversion to the mixer 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 analyze method uses the data stored in the 'NetworkData'
property of the rfckt.mixer object to calculate the group delay
values of the mixer at the frequencies specified in freq, as described
in the analyze reference page.
• The analyze method uses the data stored in the 'NetworkData'
property of the rfckt.mixer object to calculate the S-parameter
values of the mixer at the frequencies specified in freq. If the
'NetworkData' property contains network Y- or Z-parameters, the
analyze method first converts the parameters to S-parameters.
Using the interpolation method you specify with the 'IntpType'
property, the analyze method interpolates the S-parameter values to
determine their values at the specified frequencies.
Specifically, the analyze method orders the S-parameters according
to the ascending order of their frequencies, fn. It then interpolates
the S-parameters, using the MATLAB interp1 function. For
example, the curve in the following diagram illustrates the result of
interpolating the S11 parameters at five different frequencies.

7-260
 rfckt.mixer.AnalyzedResult property

Interpolated S11 parameter values

Original S11 parameter values

f1 f2 f4 f5 f3 Frequencies in ascending
order of magnitude
(fmin) (fmax)
For more information, see “One-Dimensional Interpolation” and the
interp1 reference page in the MATLAB documentation.
As shown in the preceding diagram, the analyze method uses the
parameter values at fmin, the minimum input frequency, for all
frequencies smaller than fmin. It uses the parameters values at fmax,
the maximum input frequency, for all frequencies greater than fmax.
In both cases, the results may not be accurate, so you need to specify
network parameter values over a range of frequencies that is wide
enough to account for the mixer behavior.
RF Toolbox 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 fout 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.

7-261
rfckt.mixer.AnalyzedResult property

Examples mix1 = rfckt.mixer;

mix1.AnalyzedResult

ans =

Name: 'Data object'

Freq: [191x1 double]
S_Parameters: [2x2x191 double]
GroupDelay: [191x1 double]
NF: [191x1 double]
OIP3: [191x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-262
 rfckt.mixer.FLO property

Purpose Local oscillator frequency

Values Scalar

Description Frequency, in hertz, of the local oscillator. The default is 1.0e+9.

If the MixerType property is set to 'Downconverter', the mixer output
frequency is calculated as fout = fin – flo. If the MixerType property
is set to 'Upconverter', the mixer output frequency is calculated as
fout = fin + flo.

Examples mix1 = rfckt.mixer;

mix1.FLO = 1.6e9;

7-263
rfckt.mixer.FreqOffset property

Purpose Frequency offset data

Values Vector

Description Vector specifying the frequency offset values, in hertz, that correspond
to the phase noise level values specified by the PhaseNoiseLevel
property. This property is empty by default.

Examples mix1 = rfckt.mixer;

mix1.FreqOffset = [1.6e6, 2.1e6];

7-264
 rfckt.mixer.IntpType property

Purpose Interpolation method

Values 'Linear' (default), 'Spline', or 'Cubic'

Description The analyze method is flexible in that it does not require the
frequencies of the specified S-parameters to match the requested
analysis frequencies. If needed, analyze applies the interpolation and
extrapolation method specified in the IntpType property to the specified
data to create a new set of data at the requested analysis frequencies.
The following table lists the available interpolation methods and
describes each one.

Method Description
Linear (default) Linear interpolation
Spline Cubic spline interpolation
Cubic Piecewise cubic Hermite
interpolation

Examples mix1 = rfckt.mixer;

mix1.IntpType = 'cubic'

mix1 =

Name: 'Mixer'
nPort: 2
AnalyzedResult: [1x1 rfdata.data]
IntpType: 'Cubic'
NetworkData: [1x1 rfdata.network]
NoiseData: [1x1 rfdata.noise]
NonlinearData: Inf
MixerType: 'downconverter'
FLO: 1.0000e+009
FreqOffset: []
PhaseNoiseLevel: []

7-265
rfckt.mixer.MixerSpurData property

Purpose Data from mixer spur table

Values rfdata.mixerspur object

Description An rfdata.mixerspur object that stores data from an intermodulation

table. This property is empty by default.

Examples mix1 = rfckt.mixer;

mix1.MixerSpurData=rfdata.mixerspur('Data',[2 5; 1 0],...
'PinRef',3,'PLORef',5)
mix1 =

Name: 'Mixer'
nPort: 2
AnalyzedResult: [1x1 rfdata.data]
IntpType: 'Linear'
NetworkData: [1x1 rfdata.network]
NoiseData: [1x1 rfdata.noise]
NonlinearData: Inf
MixerSpurData: [1x1 rfdata.mixerspur]
MixerType: 'Downconverter'
FLO: 1.0000e+009
FreqOffset: []
PhaseNoiseLevel: []

7-266
 rfckt.mixer.MixerType property

Purpose Type of mixer

Values 'Downconverter' (default) or 'Upconverter'

Description String specifying whether the mixer downconverting or upconverting.

Examples mix1 = rfckt.mixer;

mix1.MixerType = 'Upconverter';

7-267
rfckt.mixer.Name property

Purpose Object name

Values 'Mixer'

Description Read-only string that contains the name of the object.

Examples mix1 = rfckt.mixer;

mix1.Name

ans =

Mixer

7-268
 rfckt.mixer.NetworkData property

Purpose Network parameter information

Values rfdata.network object

Description An rfdata.network object that stores network parameter data. The

default network parameter values are taken from the 'default.s2p'
data file.

Examples mix1 = rfckt.mixer;

mix1.NetworkData

ans =

Name: 'Network parameters'

Type: 'S_PARAMETERS'
Freq: [191x1 double]
Data: [2x2x191 double]
Z0: 50

7-269
rfckt.mixer.NoiseData property

Purpose Noise information

Values Scalar noise figure in decibels, rfdata.noise object or rfdata.nf object

Description A scalar value or object that stores noise data. The default is an
rfdata.noise object whose values are taken from the 'default.s2p'
data file.

Examples mix1 = rfckt.mixer;

mix1.NoiseData

ans =

Name: 'Spot noise data'

Freq: [9x1 double]
FMIN: [9x1 double]
GAMMAOPT: [9x1 double]
RN: [9x1 double]

7-270
 rfckt.mixer.NonlinearData property

Purpose Nonlinearity information

Values Scalar OIP3 in decibels relative to one milliwatt, rfdata.power object

or rfdata.ip3 object

Description A scalar value or object that stores nonlinearity data. The default is
an Inf.

Examples mix1 = rfckt.mixer;

mix1.NonlinearData

ans =

Inf

7-271
rfckt.mixer.PhaseNoiseLevel property

Purpose Phase noise data

Values Vector

Description Vector specifying the phase noise levels, in dBc/Hz, that correspond to
the frequency offset values specified by the FreqOffset property. This
property is empty by default.

Examples mix1 = rfckt.mixer;

mix1.PhaseNoiseLevel = [-75, -110];

7-272
 rfckt.mixer.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples mix1 = rfckt.mixer;

mix1.nPort

ans =

7-273
rfckt.parallel.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.
The analyze method computes the S-parameters of the AnalyzedResult
property using the data stored in the Ckts property as follows:

1 The analyze method first calculates the admittance matrix of the

parallel connected network. It starts by converting each component
network’s parameters to an admittance matrix. The following
figure shows a parallel connected network consisting of two 2-port
networks, each represented by its admittance matrix,

where

⎡Y ′ Y12′ ⎤
[ Y ′] = ⎢11 ⎥
⎢⎣Y21′ Y22′ ⎥⎦
⎡ Y ′′ Y ′′ ⎤
[Y ′′] = ⎢ 11 12 ⎥
⎢⎣Y21′′ Y22′′ ⎥⎦

7-274
 rfckt.parallel.AnalyzedResult property

2 The analyze method then calculates the admittance matrix for

the parallel network by calculating the sum of the individual
admittances. The following equation illustrates the calculations for
two 2-port circuits.

⎡ Y ′ + Y ′′ Y12′ + Y12′′ ⎤
[Y ] = [Y ′] + [Y ′′] = ⎢ 11 11
⎥
⎢Y ′ + Y ′′ Y22′ + Y22′′ ⎥⎦
⎣ 21 21

3 Finally, analyze converts the admittance matrix of the parallel

network to S-parameters at the frequencies specified in the analyze
input argument freq.

The analyze method uses the parallel S-parameters to calculate the

group delay values at the frequencies specified in the analyze input
argument freq, as described in the analyze reference page.

Examples tx1 = rfckt.txline;

tx2 = rfckt.txline;
plel = rfckt.parallel('Ckts',{tx1,tx2})
analyze(plel,[1e9:1e7:2e9]);
plel.AnalyzedResult

ans =

Name: 'Data object'

Freq: [101x1 double]
S_Parameters: [2x2x101 double]
GroupDelay: [101x1 double]
NF: [101x1 double]
OIP3: [101x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-275
rfckt.parallel.Ckts property

Purpose Circuit objects in network

Values Cell

Description Cell array containing handles to all circuit objects in the network. All
circuits must be 2-port and linear. This property is empty by default.

Examples tx1 = rfckt.txline;

tx2 = rfckt.txline;
plel = rfckt.parallel;
plel.Ckts = {tx1,tx2};
plel.Ckts

ans =

[1x1 rfckt.txline] [1x1 rfckt.txline]

7-276
 rfckt.parallel.Name property

Purpose Object name

Values 'Parallel Connected Network'

Description Read-only string that contains the name of the object.

Examples plel = rfckt.parallel;

plel.Name

ans =

Parallel Connected Network

7-277
rfckt.parallel.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples plel = rfckt.parallel;

plel.nPort

ans =

7-278
 rfckt.parallelplate.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters,

noise figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.
The analyze method treats the parallel-plate line as a 2-port linear
network and models the line as a transmission line with optional stubs.
The analyze method computes the AnalyzedResult property of the line
using the data stored in the rfckt.parallelplate object properties
as follows:

• If you model the transmission line as a stubless line, the analyze

method 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 analyze method 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, the vector of frequencies specified in the analyze input argument

7-279
rfckt.parallelplate.AnalyzedResult property

freq. 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 2πfL
Z0 =
G + j 2πfC
k = kr + jki = ( R + j 2πfL)(G + j 2πFC)

where

2
R=
w cond cond
d
L=
w
w
G =  ′′
d
w
C=
d

In these equations:
- w is the plate width.
- d is the plate separation.
- σ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 EpsilonR property value.
• tan δ is the LossTangent property value.

7-280
rfckt.parallelplate.AnalyzedResult property

- δ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.
• If you model the transmission line as a shunt or series stub, the
analyze method first calculates the ABCD-parameters at the
specified frequencies. It then uses the abcd2s function to convert the
ABCD-parameters to S-parameters.
When you set the StubMode property to 'Shunt', the 2-port network
consists of a stub transmission line that you can terminate with either
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

When you set the StubMode property to 'Series', the 2-port network
consists of a series transmission line that you can terminate with
either a short circuit or an open circuit as shown in the following
figure.

7-281
rfckt.parallelplate.AnalyzedResult property

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

The analyze method uses the S-parameters to calculate the group delay
values at the frequencies specified in the analyze input argument freq,
as described in the analyze reference page.

Examples tx1 = rfckt.parallelplate;

analyze(tx1,[1e9,2e9,3e9]);
tx1.AnalyzedResult

ans =

Name: 'Data object'

Freq: [3x1 double]
S_Parameters: [2x2x3 double]
GroupDelay: [3x1 double]
NF: [3x1 double]
OIP3: [3x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-282
 rfckt.parallelplate.EpsilonR property

Purpose Relative permittivity of dielectric

Values Scalar

Description The ratio of the permittivity of the dielectric, ε, to the permittivity of

free space, ε0. The default value is 2.3.

Examples tx1=rfckt.parallelplate;
tx1.EpsilonR=2.7;

7-283
rfckt.parallelplate.LineLength property

Purpose Parallel-plate line length

Values Scalar

Description The physical length of the parallel-plate transmission line in meters.

The default is 0.01.

Examples tx1 = rfckt.parallelplate;

tx1.LineLength = 0.001;

7-284
 rfckt.parallelplate.LossTangent property

Purpose Tangent of loss angle

Values Scalar

Description The loss angle tangent of the dielectric. The default is 0.

Examples tx1=rfckt.parallelplate;
tx1.LossTangent=0.002;

7-285
rfckt.parallelplate.MuR property

Purpose Relative permeability of dielectric

Values Scalar

Description The ratio of the permeability of the dielectric, μ, to the permeability of

free space, μ0. The default value is 1.

Examples Change the relative permeability of the dielectric:

tx1=rfckt.parallelplate;
tx1.MuR=0.8;

7-286
 rfckt.parallelplate.Name property

Purpose Object name

Values 'Parallel-Plate Transmission Line'

Description Read-only string that contains the name of the object.

Examples tx1 = rfckt.parallelplate;

tx1.Name

ans =

Parallel-Plate Transmission Line

7-287
rfckt.parallelplate.Separation property

Purpose Distance between plates

Values Scalar

Description Thickness, in meters, of the dielectric separating the plates. The default
is 1.0e-3..

Examples tx1=rfckt.parallelplate;
tx1.Separation=0.8e-3;

7-288
 rfckt.parallelplate.SigmaCond property

Purpose Conductor conductivity

Values Scalar

Description Conductivity, in Siemens per meter (S/m), of the conductor. The default
is Inf.

Examples tx1=rfckt.parallelplate;
tx1.SigmaCond=5.81e7;

7-289
rfckt.parallelplate.StubMode property

Purpose Type of stub

Values 'NotAStub' (default), 'Series', or 'Shunt'

Description String that specifies what type of stub, if any, to include in the
transmission line model.

Examples tx1 = rfckt.parallelplate;

tx1.StubMode = 'Series';

7-290
 rfckt.parallelplate.Termination property

Purpose Stub transmission line termination

Values 'NotApplicable' (default), 'Open', or 'Short'.

Description String that specifies what type of termination to use for 'Shunt'and
'Series' stub modes. Termination is ignored if the line has no stub.
Use 'NotApplicable' when StubMode is 'NotAStub'.

Examples tx1 = rfckt.parallelplate;

tx1.StubMode = 'Series';
tx1.Termination = 'Short';

7-291
rfckt.parallelplate.Width property

Purpose Transmission line width

Values Scalar

Description Physical width, in meters, of the parallel-plate transmission line. The

default is .005..

Examples tx1=rfckt.parallelplate;
tx1.Width=0.001;

7-292
 rfckt.parallelplate.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples tx1 = rfckt.parallelplate;

tx1.nPort

ans =

7-293
rfckt.passive.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. The default is a 1-by-1
rfdata.data object that contains the S-parameters, noise figure, OIP3,
and group delay values that result from analyzing the values stored in
the passive.s2p file at the frequencies stored in this file.
The analyze method computes the AnalyzedResult property as follows:
The analyze method uses the data stored in the 'NetworkData'
property of the rfckt.passive object to calculate the S-parameter
values of the passive component at the frequencies specified in freq. If
the 'NetworkData' property contains network Y- or Z-parameters, the
analyze method first converts the parameters to S-parameters. Using
the interpolation method you specify with the 'IntpType' property, the
analyze method interpolates the S-parameter values to determine their
values at the specified frequencies.
Specifically, the analyze method orders the S-parameters according to
the ascending order of their frequencies, fn. It then interpolates the
S-parameters, using the MATLAB interp1 function. For example, the
curve in the following diagram illustrates the result of interpolating the
S11 parameters at five different frequencies.

7-294
 rfckt.passive.AnalyzedResult property

Interpolated S11 parameter values

Original S11 parameter values

f1 f2 f4 f5 f3 Frequencies in ascending
order of magnitude
(fmin) (fmax)
For more information, see “One-Dimensional Interpolation” and the
interp1 reference page in the MATLAB documentation.
As shown in the preceding diagram, the analyze method uses the
parameter values at fmin, the minimum input frequency, for all
frequencies smaller than fmin. It uses the parameters values at fmax, the
maximum input frequency, for all frequencies greater than fmax. In both
cases, the results may not be accurate, so you need to specify network
parameter values over a range of frequencies that is wide enough to
account for the component behavior.
The analyze method uses the S-parameters to calculate the group delay
values at the frequencies specified in the analyze input argument freq,
as described in the analyze reference page.

Examples pas = rfckt.passive;

pas.AnalyzedResult

ans =

Name: 'Data object'

Freq: [202x1 double]
S_Parameters: [2x2x202 double]
GroupDelay: [202x1 double]
NF: [202x1 double]
OIP3: [202x1 double]

7-295
rfckt.passive.AnalyzedResult property

Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-296
 rfckt.passive.IntpType property

Purpose Interpolation method

Values 'Linear' (default), 'Spline', or 'Cubic'

Description The analyze method is flexible in that it does not require the
frequencies of the specified S-parameters to match the requested
analysis frequencies. If needed, analyze applies the interpolation and
extrapolation method specified in the IntpType property to the specified
data to create a new set of data at the requested analysis frequencies.
The following table lists the available interpolation methods and
describes each one.

Method Description
Linear (default) Linear interpolation
Spline Cubic spline interpolation
Cubic Piecewise cubic Hermite
interpolation

Examples pas = rfckt.passive;

pas.IntpType = 'cubic'

pas =

Name: 'Passive'
nPort: 2
AnalyzedResult: [1x1 rfdata.data]
IntpType: 'Cubic'
NetworkData: [1x1 rfdata.network]

7-297
rfckt.passive.Name property

Purpose Object name

Values 'Passive'

Description Read-only string that contains the name of the object.

Examples pas = rfckt.passive;

pas.Name

ans =

Passive

7-298
 rfckt.passive.NetworkData property

Purpose Network parameter information

Values rfdata.network object

Description An rfdata.network object that stores network parameter data. The

default network parameter values are taken from the 'passive.s2p'
data file.

Examples pas = rfckt.passive;

pas.NetworkData

ans =

Name: 'Network parameters'

Type: 'S_PARAMETERS'
Freq: [202x1 double]
Data: [2x2x202 double]
Z0: 50

7-299
rfckt.passive.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples pas = rfckt.passive;

pas.nPort

ans =

7-300
 rfckt.rlcgline.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.
The analyze method treats the transmission line, which can be lossy or
lossless, as a 2-port linear network. It uses the interpolation method
you specify in the IntpType property to find the R, L, C, and G values at
the frequencies you specify when you call analyze. Then, it calculates
the characteristic impedance, Z0, phase velocity, PV, and loss using
these interpolated values. It computes the AnalyzedResult property of
a stub or as a stubless line using the data stored in the rfckt.rlcgline
object properties as follows:

• If you model the transmission line as a stubless line, the analyze

method 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 analyze method 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

7-301
rfckt.rlcgline.AnalyzedResult property

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

f, the vector of frequencies specified in the analyze input argument
freq. 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 2πfL
Z0 =
G + j 2πfC
k = kr + jki = ( R + j 2πfL)(G + j 2πFC)

• If you model the transmission line as a shunt or series stub, the

analyze method first calculates the ABCD-parameters at the
specified frequencies. It then uses the abcd2s function to convert the
ABCD-parameters to S-parameters.
When you set the StubMode property to 'Shunt', the 2-port network
consists of a stub transmission line that you can terminate with either
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

When you set the StubMode property to 'Series', the 2-port network
consists of a series transmission line that you can terminate with

7-302
 rfckt.rlcgline.AnalyzedResult property

either a short circuit or an open circuit as shown in the following

figure.

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

The analyze method uses the S-parameters to calculate the group delay
values at the frequencies specified in the analyze input argument freq,
as described in the analyze reference page.

Examples tx1 = rfckt.rlcgline;

analyze(tx1,[1e9,2e9,3e9]);
tx1.AnalyzedResult

ans =

Name: 'Data object'

Freq: [3x1 double]
S_Parameters: [2x2x3 double]
GroupDelay: [3x1 double]
F: [3x1 double]
OIP3: [3x1 double]
Z0: 50

7-303
rfckt.rlcgline.AnalyzedResult property

ZS: 50
ZL: 50
IntpType: 'Linear'

7-304
 rfckt.rlcgline.C property

Purpose Capacitance data

Values Vector

Description Capacitance values per length, in farads per meter, that correspond
to the frequencies stored in the Freq property. All values must be
nonnegative. The default is 0.

Examples tx1=rfckt.rlcgline;
tx1.C = [10.1 4.5 14.2]*1e-12;

7-305
rfckt.rlcgline.Freq property

Purpose Frequency data

Values Vector

Description M-element vector of frequency values in hertz for the RLCG values.
The values must be positive, and the order of the frequencies must
correspond to the order of the RLCG values. The default is 1e9.

Examples f = [2.08 2.10]*1.0e9;

tx1 = rfckt.rlcgline;
tx1.Freq = f;

7-306
 rfckt.rlcgline.G property

Purpose Conductance data

Values Vector

Description Conductances per length, in Siemens per meter, that correspond

to the frequencies stored in the Freq property. All values must be
nonnegative. The default is 0.

Examples tx1=rfckt.rlcgline;
tx1.G = [10.1 4.5 14.2]*1e-3;

7-307
rfckt.rlcgline.IntpType property

Purpose Interpolation method

Values 'Linear' (default), 'Spline', or 'Cubic'

Description The analyze method is flexible in that it does not require the
frequencies of the specified S-parameters to match the requested
analysis frequencies. If needed, analyze applies the interpolation and
extrapolation method specified in the IntpType property to the specified
data to create a new set of data at the requested analysis frequencies.
The following table lists the available interpolation methods and
describes each one.

Method Description
Linear (default) Linear interpolation
Spline Cubic spline interpolation
Cubic Piecewise cubic Hermite
interpolation

Examples tx1 = rfckt.rlcgline;

tx1.IntpType = 'cubic';

7-308
 rfckt.rlcgline.L property

Purpose Inductance data

Values Vector

Description Inductance values per length, in henries per meter, that correspond
to the frequencies stored in the Freq property. All values must be
nonnegative. The default is 0.

Examples filter = rfckt.rlcgline;

filter.L = [3.1 5.9 16.3]*1e-9;

7-309
rfckt.rlcgline.LineLength property

Purpose Transmission line length

Values Scalar

Description The physical length of the transmission line in meters. The default
is 0.01.

Examples tx1 = rfckt.rlcgline;

tx1.LineLength = 0.001;

7-310
 rfckt.rlcgline.Name property

Purpose Object name

Values 'RLCG Transmission Line'

Description Read-only string that contains the name of the object.

Examples tx1 = rfckt.rlcgline;

tx1.Name

ans =

RLCG Transmission Line

7-311
rfckt.rlcgline.R property

Purpose Resistance data

Values Vector

Description Resistance per length, in ohms per meter, that correspond to the
frequencies stored in the Freq property. All values must be nonnegative.
The default is 0.

Examples filter = rfckt.rlcgline;

filter.R = [3.1 5.9 16.3]*1e-3;

7-312
 rfckt.rlcgline.StubMode property

Purpose Type of stub

Values 'NotAStub' (default), 'Series', or 'Shunt'

Description String that specifies what type of stub, if any, to include in the
transmission line model.

Examples tx1 = rfckt.rlcgline;

tx1.StubMode = 'Series';

7-313
rfckt.rlcgline.Termination property

Purpose Stub transmission line termination

Values 'NotApplicable' (default), 'Open', or 'Short'.

Description String that specifies what type of termination to use for 'Shunt'and
'Series' stub modes. Termination is ignored if the line has no stub.
Use 'NotApplicable' when StubMode is 'NotAStub'.

Examples tx1 = rfckt.rlcgline;

tx1.StubMode = 'Series';
tx1.Termination = 'Short';

7-314
 rfckt.rlcgline.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples tx1 = rfckt.rlcgline;

tx1.nPort

ans =

7-315
rfckt.series.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.
The analyze method computes the S-parameters of the AnalyzedResult
property using the data stored in the Ckts property as follows:

1 The analyze method first calculates the impedance matrix of the

series connected network. It starts by converting each component
network’s parameters to an impedance matrix. The following figure
shows a series connected network consisting of two 2-port networks,
each represented by its impedance matrix,

where

⎡Z ′ Z12′ ⎤
[ Z ′] = ⎢ 11 ⎥
⎢⎣ Z21′ Z22′ ⎥⎦
⎡ Z ′′ Z ′′ ⎤
[ Z ′′] = ⎢ 11 12 ⎥
⎣⎢ Z21′′ Z22′′ ⎥⎦

7-316
 rfckt.series.AnalyzedResult property

2 The analyze method then calculates the impedance matrix for the
series network by calculating the sum of the individual impedances.
The following equation illustrates the calculations for two 2-port
circuits.

⎡ Z ′ + Z ′′ Z12′ + Z12′′ ⎤
[ Z ] = [ Z ′] + [ Z ′′] = ⎢ 11 11
⎥
⎢ Z21′ + Z21′′ Z22′ + Z22′′ ⎥⎦
⎣

3 Finally, analyze converts the impedance matrix of the series network

to S-parameters at the frequencies specified in the analyze input
argument freq.

The analyze method uses the series S-parameters to calculate the

group delay values at the frequencies specified in the analyze input
argument freq, as described in the analyze reference page.

Examples tx1 = rfckt.txline;

tx2 = rfckt.txline;
ser = rfckt.series('Ckts',{tx1,tx2})
analyze(ser,[1e9:1e7:2e9]);
ser.AnalyzedResult

ans =

Name: 'Data object'

Freq: [101x1 double]
S_Parameters: [2x2x101 double]
GroupDelay: [101x1 double]
NF: [101x1 double]
OIP3: [101x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-317
rfckt.series.Ckts property

Purpose Circuit objects in network

Values Cell

Description Cell array containing handles to all circuit objects in the network. All
circuits must be 2-port and linear. This property is empty by default.

Examples tx1 = rfckt.txline;

tx2 = rfckt.txline;
ser = rfckt.series;
ser.Ckts = {tx1,tx2};
ser.Ckts

ans =

[1x1 rfckt.txline] [1x1 rfckt.txline]

7-318
 rfckt.series.Name property

Purpose Object name

Values 'Series Connected Network'

Description Read-only string that contains the name of the object.

Examples ser = rfckt.series;

ser.Name

ans =

Series Connected Network

7-319
rfckt.series.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples ser = rfckt.series;

ser.nPort

ans =

7-320
 rfckt.seriesrlc.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.
The analyze method computes the S-parameters of the AnalyzedResult
property using the data stored in the rfckt.seriesrlc object properties
by first calculating the ABCD-parameters for the circuit, and then
converting the ABCD-parameters to S-parameters using the abcd2s
function. For this circuit, A = 1, B = Z, C = 0, and D = 1, where

− LC 2 + jRC + 1
Z=
jC
and ω = 2πf.
The analyze method uses the S-parameters to calculate the group delay
values at the frequencies specified in the analyze input argument freq,
as described in the analyze reference page.

Examples rlc1 = rfckt.seriesrlc;

analyze(rlc1,[1e9,2e9,3e9]);
rlc1.AnalyzedResult

ans =

Name: 'Data object'

Freq: [3x1 double]
S_Parameters: [2x2x3 double]
GroupDelay: [3x1 double]
NF: [3x1 double]
OIP3: [3x1 double]
Z0: 50
ZS: 50

7-321
rfckt.seriesrlc.AnalyzedResult property

ZL: 50
IntpType: 'Linear'

7-322
 rfckt.seriesrlc.C property

Purpose Capacitance value

Values Scalar

Description Positive capacitance value in farads. The default is Inf.

Examples rlc1=rfckt.seriesrlc;
rlc1.C = 1e-12;

7-323
rfckt.seriesrlc.L property

Purpose Inductance value

Values Scalar

Description Positive inductance value in henries. The default is 0.

Examples rlc1 = rfckt.seriesrlc;

rlc1.L = 1e-9;

7-324
 rfckt.seriesrlc.Name property

Purpose Object name

Values 'Series RLC'

Description Read-only string that contains the name of the object.

Examples rlc1 = rfckt.seriesrlc;

rlc1.Name

ans =

Series RLC

7-325
rfckt.seriesrlc.R property

Purpose Resistance value

Values Scalar

Description Positive resistance in ohms. The default is 0.

Examples rlc1 = rfckt.seriesrlc;

rlc1.R = 10;

7-326
 rfckt.seriesrlc.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples filter = rfckt.seriesrlc;

filter.nPort

ans =

7-327
rfckt.shuntrlc.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.
The analyze method computes the S-parameters of the AnalyzedResult
property using the data stored in the rfckt.shuntrlc object properties
by first calculating the ABCD-parameters for the circuit, and then
converting the ABCD-parameters to S-parameters using the abcd2s
function. 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 analyze method uses the S-parameters to calculate the group delay
values at the frequencies specified in the analyze input argument freq,
as described in the analyze reference page.

Examples rlc1 = rfckt.shuntrlc;

analyze(rlc1,[1e9,2e9,3e9]);
rlc1.AnalyzedResult

ans =

Name: 'Data object'

Freq: [3x1 double]
S_Parameters: [2x2x3 double]
GroupDelay: [3x1 double]
NF: [3x1 double]
OIP3: [3x1 double]
Z0: 50

7-328
rfckt.shuntrlc.AnalyzedResult property

ZS: 50
ZL: 50
IntpType: 'Linear'

7-329
rfckt.shuntrlc.C property

Purpose Capacitance value

Values Scalar

Description Positive capacitance value in farads. The default is 0.

Examples rlc1=rfckt.shuntrlc;
rlc1.C = 1e-12;

7-330
 rfckt.shuntrlc.L property

Purpose Inductance value

Values Scalar

Description Positive inductance value in henries. The default is Inf.

Examples rlc1 = rfckt.shuntrlc;

rlc1.L = 1e-9;

7-331
rfckt.shuntrlc.Name property

Purpose Object name

Values 'Shunt RLC'

Description Read-only string that contains the name of the object.

Examples rlc1 = rfckt.shuntrlc;

rlc1.Name

ans =

Shunt RLC

7-332
 rfckt.shuntrlc.R property

Purpose Resistance value

Values Scalar

Description Positive resistance in ohms. The default is Inf.

Examples rlc1 = rfckt.shuntrlc;

rlc1.R = 10;

7-333
rfckt.shuntrlc.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples filter = rfckt.shuntrlc;

filter.nPort

ans =

7-334
 rfckt.twowire.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.
The analyze method treats the transmission line, which can be lossy or
lossless, as a 2-port linear network. It computes the AnalyzedResult
property of a stub or as a stubless line using the data stored in the
rfckt.twowire object properties as follows:

• If you model the transmission line as a stubless line, the analyze

method 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 analyze method 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, the vector of frequencies specified in the analyze input argument
freq. Both can be expressed in terms of the resistance (R), inductance

7-335
rfckt.twowire.AnalyzedResult property

(L), conductance (G), and capacitance (C) per unit length (meters)
as follows:

R + j 2πfL
Z0 =
G + j 2πfC
k = kr + jki = ( R + j 2πfL)(G + j 2πFC)

where

1
R=
 a cond cond
 ⎛ D⎞
L= a cosh ⎜ ⎟
 ⎝ 2a ⎠
 ′′
G=
⎛ D⎞
a cosh ⎜ ⎟
⎝ 2a ⎠

C=
⎛ D⎞
a cosh ⎜ ⎟
⎝ 2a ⎠

In these equations:
- w is the plate width.
- d is the plate separation.
- σ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 EpsilonR property value.
• tan δ is the LossTangent property value.

7-336
 rfckt.twowire.AnalyzedResult property

- δ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.
• If you model the transmission line as a shunt or series stub, the
analyze method first calculates the ABCD-parameters at the
specified frequencies. It then uses the abcd2s function to convert the
ABCD-parameters to S-parameters.
When you set the StubMode property to 'Shunt', the 2-port network
consists of a stub transmission line that you can terminate with either
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

When you set the StubMode property to 'Series', the 2-port network
consists of a series transmission line that you can terminate with
either a short circuit or an open circuit as shown in the following
figure.

7-337
rfckt.twowire.AnalyzedResult property

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

The analyze method uses the S-parameters to calculate the group delay
values at the frequencies specified in the analyze input argument freq,
as described in the analyze reference page.

Examples tx1 = rfckt.twowire;

analyze(tx1,[1e9,2e9,3e9]);
tx1.AnalyzedResult

ans =

Name: 'Data object'

Freq: [3x1 double]
S_Parameters: [2x2x3 double]
GroupDelay: [3x1 double]
NF: [3x1 double]
OIP3: [3x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-338
 rfckt.twowire.EpsilonR property

Purpose Relative permittivity of dielectric

Values Scalar

Description The ratio of the permittivity of the dielectric, ε, to the permittivity of

free space, ε0. The default value is 2.3.

Examples tx1=rfckt.twowire;
tx1.EpsilonR=2.7;

7-339
rfckt.twowire.LineLength property

Purpose Transmission line length

Values Scalar

Description The physical length of the transmission line in meters. The default
is 0.01.

Examples tx1 = rfckt.twowire;

tx1.LineLength = 0.001;

7-340
 rfckt.twowire.LossTangent property

Purpose Tangent of loss angle

Values Scalar

Description The loss angle tangent of the dielectric. The default is 0.

Examples tx1=rfckt.twowire;
tx1.LossTangent=0.002;

7-341
rfckt.twowire.MuR property

Purpose Relative permeability of dielectric

Values Scalar

Description The ratio of the permeability of the dielectric, μ, to the permeability of

free space, μ0. The default value is 1.

Examples Change the relative permeability of the dielectric:

tx1=rfckt.twowire;
tx1.MuR=0.8;

7-342
 rfckt.twowire.Name property

Purpose Object name

Values 'Two-Wire Transmission Line'

Description Read-only string that contains the name of the object.

Examples tx1 = rfckt.twowire;

tx1.Name

ans =

Two-Wire Transmission Line

7-343
rfckt.twowire.Radius property

Purpose Wire radius

Values Scalar

Description The radius of the conducting wires, in meters. The default is 6.7e-4.

Examples tx1=rfckt.twowire;
tx1.Radius=0.0031;

7-344
 rfckt.twowire.Separation property

Purpose Distance between wires

Values Scalar

Description Distance, in meters, separating the wire centers. The default is 0.0016.

Examples tx1=rfckt.twowire;
tx1.Separation=0.8e-3;

7-345
rfckt.twowire.SigmaCond property

Purpose Conductor conductivity

Values Scalar

Description Conductivity, in Siemens per meter (S/m), of the conductor. The default
is Inf.

Examples tx1=rfckt.twowire;
tx1.SigmaCond=5.81e7;

7-346
 rfckt.twowire.StubMode property

Purpose Type of stub

Values 'NotAStub' (default), 'Series', or 'Shunt'

Description String that specifies what type of stub, if any, to include in the
transmission line model.

Examples tx1 = rfckt.twowire;

tx1.StubMode = 'Series';

7-347
rfckt.twowire.Termination property

Purpose Stub transmission line termination

Values 'NotApplicable' (default), 'Open', or 'Short'.

Description String that specifies what type of termination to use for 'Shunt'and
'Series' stub modes. Termination is ignored if the line has no stub.
Use 'NotApplicable' when StubMode is 'NotAStub'.

Examples tx1 = rfckt.twowire;

tx1.StubMode = 'Series';
tx1.Termination = 'Short';

7-348
 rfckt.twowire.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples tx1 = rfckt.twowire;

tx1.nPort

ans =

7-349
rfckt.txline.AnalyzedResult property

Purpose Computed S-parameters, noise figure, OIP3, and group delay values

Values rfdata.data object

Description Handle to an rfdata.data object that contains the S-parameters, noise

figure, OIP3, and group delay values computed over the specified
frequency range using the analyze method. This property is empty
by default.
The analyze method treats the transmission line, which can be lossy or
lossless, as a 2-port linear network. It computes the AnalyzedResult
property of a stub or as a stubless line using the data stored in the
rfckt.txline object properties as follows:

• If you model the transmission line as a stubless line, the analyze

method 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 analyze method 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 analyze method calculates k from the specified properties as

7-350
 rfckt.txline.AnalyzedResult property

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
where f is the frequency range specified in the analyze input
argument freq. The phase velocity Vp is derived from the
rfckt.txline object properties. It is also known as the wave
propagation velocity.
• If you model the transmission line as a shunt or series stub, the
analyze method first calculates the ABCD-parameters at the
specified frequencies. It then uses the abcd2s function to convert the
ABCD-parameters to S-parameters.
When you set the StubMode property to 'Shunt', the 2-port network
consists of a stub transmission line that you can terminate with either
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:

7-351
rfckt.txline.AnalyzedResult property

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

When you set the StubMode property to 'Series', the 2-port network
consists of a series transmission line that you can terminate with
either a short circuit or an open circuit as shown in the following
figure.

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

The analyze method uses the S-parameters to calculate the group delay
values at the frequencies specified in the analyze input argument freq,
as described in the analyze reference page.

Examples tx1 = rfckt.txline;

analyze(tx1,[1e9,2e9,3e9]);
tx1.AnalyzedResult

ans =

7-352
rfckt.txline.AnalyzedResult property

Name: 'Data object'

Freq: [3x1 double]
S_Parameters: [2x2x3 double]
GroupDelay: [3x1 double]
NF: [3x1 double]
OIP3: [3x1 double]
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-353
rfckt.txline.Freq property

Purpose Frequency data

Values Vector

Description M-element vector of frequency values in hertz for the loss and phase
velocity values in the Loss and PV properties. The values must be
positive, and the order of the frequencies must correspond to the order
of the loss and phase velocity values. This property is empty by default.

Examples f = [2.08 2.10]*1.0e9;

tx1 = rfckt.txline;
tx1.Freq = f;

7-354
 rfckt.txline.IntpType property

Purpose Interpolation method

Values 'Linear' (default), 'Spline', or 'Cubic'

Description The analyze method is flexible in that it does not require the
frequencies of the specified S-parameters to match the requested
analysis frequencies. If needed, analyze applies the interpolation and
extrapolation method specified in the IntpType property to the specified
data to create a new set of data at the requested analysis frequencies.
The following table lists the available interpolation methods and
describes each one.

Method Description
Linear (default) Linear interpolation
Spline Cubic spline interpolation
Cubic Piecewise cubic Hermite
interpolation

Examples tx1 = rfckt.txline;

tx1.IntpType = 'cubic';

7-355
rfckt.txline.LineLength property

Purpose Transmission line length

Values Scalar

Description The physical length of the transmission line in meters. The default
is 0.01.

Examples tx1 = rfckt.txline;

tx1.LineLength = 0.001;

7-356
 rfckt.txline.Loss property

Purpose Transmission line loss

Values Vector

Description M-element vector of line loss values, in decibels per meter, that
correspond to the frequencies stored in the Freq property. Line loss is
the reduction in strength of the signal as it travels over the transmission
line, and must be nonnegative. The default is 0.

Examples tx1 = rfckt.txline;

tx1.Loss = [1.5 3.1]*1e-2;

7-357
rfckt.txline.Name property

Purpose Object name

Values 'Transmission Line'

Description Read-only string that contains the name of the object.

Examples tx1 = rfckt.txline;

tx1.Name

ans =

Transmission Line

7-358
 rfckt.txline.PV property

Purpose Phase velocity

Values Vector

Description M-element vector of phase velocity values, in meters per second, that
correspond to the frequencies stored in the Freq property. Propagation
velocity of a uniform plane wave on the transmission line. The default
is 299792458.

Examples tx1 = rfckt.txline;

tx1.PV = [1.5 3.1]*1e9;

7-359
rfckt.txline.StubMode property

Purpose Type of stub

Values 'NotAStub' (default), 'Series', or 'Shunt'

Description String that specifies what type of stub, if any, to include in the
transmission line model.

Examples tx1 = rfckt.txline;

tx1.StubMode = 'Series';

7-360
 rfckt.txline.Termination property

Purpose Stub transmission line termination

Values 'NotApplicable' (default), 'Open', or 'Short'.

Description String that specifies what type of termination to use for 'Shunt'and
'Series' stub modes. Termination is ignored if the line has no stub.
Use 'NotApplicable' when StubMode is 'NotAStub'.

Examples tx1 = rfckt.txline;

tx1.StubMode = 'Series';
tx1.Termination = 'Short';

7-361
rfckt.txline.Z0 property

Purpose Characteristic impedance

Values Vector

Description Vector of characteristic impedance values, in ohms, that correspond to

the frequencies stored in the Freq property. The default is 50 ohms.

Examples tx1 = rfckt.txline;

tx1.Z0 = 75;

7-362
 rfckt.txline.nPort property

Purpose Number of ports

Values 2

Description A read-only integer that indicates the object has two ports.

Examples tx1 = rfckt.txline;

tx1.nPort

ans =

7-363
rfdata.data.Freq property

Purpose Frequency data

Values Vector

Description M-element vector of frequency values in hertz for the S-parameters in

the S_Parameters property. The values must be positive, and the order
of the frequencies must correspond to the order of the S-parameters.
This property is empty by default.

Examples f = [2.08 2.10]*1.0e9;

txdata = rfdata.data;
txdata.Freq = f;

7-364
 rfdata.data.GroupDelay property

Purpose Group delay data

Values Vector

Description M-element vector of group delay values in seconds that the toolbox
calculates at each frequency in the Freq property when you call the
analyze method. This property is empty by default.

7-365
rfdata.data.IntpType property

Purpose Interpolation method

Values 'Linear' (default), 'Spline', or 'Cubic'

Description The analyze method is flexible in that it does not require the
frequencies of the specified S-parameters to match the requested
analysis frequencies. If needed, analyze applies the interpolation and
extrapolation method specified in the IntpType property to the specified
data to create a new set of data at the requested analysis frequencies.
The following table lists the available interpolation methods and
describes each one.

Method Description
Linear (default) Linear interpolation
Spline Cubic spline interpolation
Cubic Piecewise cubic Hermite
interpolation

Examples txdata = rfdata.data;

txdata.IntpType = 'cubic'

txdata =

Name: 'Data object'

Freq: []
S_Parameters: []
GroupDelay: []
NF: 0
OIP3: Inf
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Cubic'

7-366
 rfdata.data.NF property

Purpose Noise figure

Values Scalar

Description The amount of noise relative to a noise temperature of 290 degrees

kelvin, in decibels. The default value of zero indicates a noiseless
system.

Examples txdata = rfdata.data;

txdata.NF=3

txdata =

Name: 'Data object'

Freq: []
S_Parameters: []
GroupDelay: []
NF: 3
OIP3: Inf
Z0: 50
ZS: 50
ZL: 50
IntpType: 'Linear'

7-367
rfdata.data.Name property

Purpose Object name

Values 'Data object'

Description Read-only string that contains the name of the object.

Examples txdata = rfdata.data;

txdata.Name

ans =

Data object

7-368
 rfdata.data.OIP3 property

Purpose Output third-order intercept point

Values Scalar

Description Signal distortion in watts. This property represents the hypothetical

output signal level at which the third-order tones would reach the same
amplitude level as the desired input tones. The default is Inf.

Examples txdata = rfdata.data;

txdata.OIP3 = 30;

7-369
rfdata.data.S_Parameters property

Purpose S-parameter data

Values

Description 2-by-2-by-M array of S-parameters of the circuit described by the

rfdata.data object, where M is the number of frequencies at which
the network parameters are specified. The values correspond to the
frequencies stored in the Freq property. This property is empty by
default.

Examples s_vec(:,:,1) = ...

[-0.724725-0.481324i, -0.685727+1.782660i; ...
0.000000+0.000000i, -0.074122-0.321568i];
s_vec(:,:,2) = ...
[-0.731774-0.471453i, -0.655990+1.798041i; ...
0.001399+0.000463i, -0.076091-0.319025i];
s_vec(:,:,3) = ...
[-0.738760-0.461585i, -0.626185+1.813092i; ...
0.002733+0.000887i, -0.077999-0.316488i];
txdata = rfdata.data;
txdata.S_Parameters = s_vec;

7-370
 rfdata.data.Z0 property

Purpose Reference impedance

Values Scalar

Description Scalar reference impedance in ohms. The default is 50 ohms.

Examples txdata = rfdata.data;

txdata.Z0 = 75;

7-371
rfdata.data.ZL property

Purpose Load impedance

Values Scalar

Description Scalar load impedance in ohms. The default is 50 ohms.

Examples txdata = rfdata.data;

txdata.ZL = 75;

7-372
 rfdata.data.ZS property

Purpose Source impedance

Values Scalar

Description Scalar source impedance in ohms. The default is 50 ohms.

Examples txdata = rfdata.data;

txdata.ZS = 75;

7-373
rfdata.ip3.Data property

Purpose Third-order intercept values

Values Vector

Description M-element vector of IP3 data, in watts, that corresponds to the

frequencies stored in the Freq property. The default is Inf.

Examples ip3_vec = [-5.2 7.1];

ip3data = rfdata.ip3;
ip3data.Data = ip3_vec;

7-374
 rfdata.ip3.Freq property

Purpose Frequency data

Values Vector

Description M-element vector of frequency values in hertz for the IP3 data in
the Data property. The values must be positive, and the order of the
frequencies must correspond to the order of the IP3 values. This
property is empty by default.

Examples f = [2.08 2.10]*1.0e9;

ip3data = rfdata.ip3;
ip3data.Freq = f;

7-375
rfdata.ip3.Name property

Purpose Object name

Values '3rd order intercept'

Description Read-only string that contains the name of the object.

Examples ip3data = rfdata.ip3;

ip3data.Name

ans =

3rd order intercept

7-376
 rfdata.ip3.Type property

Purpose Power reference type

Values 'OIP3' (default) or 'IIP3'

Description String that indicates whether the specified IP3 data is output or input
IP3.

Examples ip3data = rfdata.ip3;

ip3data.Type

ans =

OIP3

7-377
rfdata.mixerspur.Data property

Purpose Mixer spur power values

Values Matrix

Description Matrix of values, in decibels, by which the mixer spur power is less
than the power at the fundamental output frequency. Values must be
between 0 and 99. This property is empty by default.

Examples spurs = rfdata.mixerspur...

('Data',[2 5 3; 1 0 99; 10 99 99],...
'PinRef',3,'PLORef',5)
spurs.data

ans =

2 5 3
1 0 99
10 99 99

7-378
 rfdata.mixerspur.Name property

Purpose Object name

Values 'Intermodulation table'

Description Read-only string that contains the name of the object.

Examples spurdata = rfdata.mixerspur;

spurdata.Name

ans =

Intermodulation table

7-379
rfdata.mixerspur.PLORef property

Purpose Reference local oscillator power

Values Scalar

Description Scalar local oscillator power reference, in decibels relative to one

milliwatt. The default is 0.

Examples spurs = rfdata.mixerspur...

('Data',[2 5 3; 1 0 99; 10 99 99],
'PinRef',3,'PLORef',5)
spurs.PLORef

ans =

7-380
 rfdata.mixerspur.PinRef property

Purpose Reference input power

Values Scalar

Description Scalar input power reference, in decibels relative to one milliwatt. The
default is 0.

Examples spurs = rfdata.mixerspur...

('Data',[2 5 3; 1 0 99; 10 99 99],...
'PinRef',3,'PLORef',5)
spurs.PinRef

ans =

7-381
rfdata.network.Data property

Purpose Network parameter data

Values Array

Description 2-by-2-by-M array of network parameters, where M is the number of

frequencies at which the network parameters are specified. The values
correspond to the frequencies stored in the Freq property. This property
is empty by default.

Examples y(:,:,1) = [-.0090-.0104i, .0013+.0018i; ...

-.2947+.2961i, .0252+.0075i];
y(:,:,2) = [-.0086-.0047i, .0014+.0019i; ...
-.3047+.3083i, .0251+.0086i];
y(:,:,3) = [-.0051+.0130i, .0017+.0020i; ...
-.3335+.3861i, .0282+.0110i];

netdata = rfdata.network;
netdata.Data=y;

7-382
 rfdata.network.Freq property

Purpose Frequency data

Values Vector

Description M-element vector of frequency values in hertz for the network

parameters in the Data property. The values must be positive, and the
order of the frequencies must correspond to the order of the network
parameters. This property is empty by default.

Examples f = [2.08 2.10]*1.0e9;

netdata = rfdata.network;
netdata.Freq=f;

7-383
rfdata.network.Name property

Purpose Object name

Values 'Network parameters'

Description Read-only string that contains the name of the object.

Examples netdata=rfdata.network;
netdata.Name

ans =

Network parameters

7-384
 rfdata.network.Type property

Purpose Type of network parameters.

Values 'S', 'Y', 'Z', 'ABCD', 'H', 'G', or 'T'

Description String that indicates whether the rfdata.network object .

Examples netdata=rfdata.network;
netdata.Type='Y';

7-385
rfdata.network.Z0 property

Purpose Reference impedance

Values Scalar

Description Scalar reference impedance in ohms. This property is only available

when the Type property is set to 'S'. The default is 50 ohms.

Examples netdata=rfdata.network;
netdata.z0=75;

7-386
 rfdata.nf.Data property

Purpose Noise figure values

Values Vector

Description M-element vector of noise figure data, in dB, that corresponds to the
frequencies stored in the Freq property. The default is 0.

Examples nf_vec = [1.2 3.1];

nfdata = rfdata.nf;
nfdata.Data = nf_vec;

7-387
rfdata.nf.Freq property

Purpose Frequency data

Values Vector

Description M-element vector of frequency values in hertz for the noise figure data
in the Data property. The values must be positive, and the order of the
frequencies must correspond to the order of the noise figure values.
This property is empty by default.

Examples f = [2.08 2.10]*1.0e9;

nfdata = rfdata.nf;
nfdata.Freq = f;

7-388
 rfdata.nf.Name property

Purpose Object name

Values 'Noise figure'

Description Read-only string that contains the name of the object.

Examples nfdata = rfdata.nf;

nfdata.Name

ans =

Noise figure

7-389
rfdata.noise.FMIN property

Purpose Minimum noise figure data

Values Vector

Description M-element vector of minimum noise figure values, in decibels, that

correspond to the frequencies stored in the Freq property. The default
is 1.

Examples fmin = [12.08 13.40];

noisedata = rfdata.noise;
noisedata.FMIN = fmin;

7-390
 rfdata.noise.Freq property

Purpose Frequency data

Values Vector

Description M-element vector of frequency values in hertz for the spot noise data
in the FMIN, GAMMAOPT, and RN properties. The values must be positive,
and the order of the frequencies must correspond to the order of the spot
noise values. This property is empty by default.

Examples f = [2.08 2.10]*1.0e9;

noisedata = rfdata.noise;
noisedata.Freq = f;

7-391
rfdata.noise.GAMMAOPT property

Purpose Optimum source reflection coefficients

Values Vector

Description M-element vector of optimum source reflection coefficients that

correspond to the frequencies stored in the Freq property. The default
is 1.

Examples gopt = [0.2484-1.2102j 1.0999-0.9295j];

noisedata = rfdata.noise;
noisedata.GAMMAOPT = gopt;

7-392
 rfdata.noise.Name property

Purpose Object name

Values 'Spot noise data'

Description Read-only string that contains the name of the object.

Examples noisedata = rfdata.noise;

noisedata.Name

ans =

Spot noise data

7-393
rfdata.noise.RN property

Purpose Equivalent normalized noise resistance data

Values Vector

Description M-element vector of equivalent normalized noise resistance values that

correspond to the frequencies stored in the Freq property. The default
is 1.

Examples rn = [0.26 0.45];

noisedata = rfdata.noise;
noisedata.RN = rn;

7-394
 rfdata.power.Freq property

Purpose Frequency data

Values Vector

Description M-element vector of frequency values in hertz for the power data in the
Phase, Pin, and Pout properties. The values must be positive, and the
order of the frequencies must correspond to the order of the phase and
power values. This property is empty by default.

Examples f = [2.08 2.10]*1.0e9;

powerdata = rfdata.power;
powerdata.Freq = f;

7-395
rfdata.power.Name property

Purpose Object name

Values 'Power data'

Description Read-only string that contains the name of the object.

Examples powerdata = rfdata.power;

powerdata.Name

ans =

Power data

7-396
 rfdata.power.Phase property

Purpose Phase shift data

Values Cell

Description M-element cell of phase shift values, in degrees, where each element
corresponds to a frequency stored in the Freq property. The values
within each element correspond to the input power values stored in
the Pin property. The default is 1.

Examples phase = {[27.1 35.3],[15.4 19.3 21.1]};

powerdata = rfdata.power;
powerdata.Phase = phase;

7-397
rfdata.power.Pin property

Purpose Input power data

Values Cell

Description M-element cell of input power values, in watts, where each element
corresponds to a frequency stored in the Freq property. For example,

Pin = {[A]; [B]; [C]};

where A, B, and C are column vectors that contain the Pin values at the
first three frequencies stored in the Freq property. The default is 1.

Examples pin = {[0.001 0.002],[0.001 0.005 0.01]};

powerdata = rfdata.power;
powerdata.Pin = pin;

7-398
 rfdata.power.Pout property

Purpose Output power data

Values Cell

Description M-element cell of output power values, in watts, where each element
corresponds to a frequency stored in the Freq property. The values
within each element correspond to the input power values stored in
the Pin property. The default is 1.

Examples pout = {[0.0025 0.0031],[0.0025 0.0028 0.0028]};

powerdata = rfdata.power;
powerdata.Pout = pout;

7-399
rfmodel.rational.A property

Purpose Poles of rational function

Values Vector

Description Complex vector containing poles of the rational function in radians per
second. Its length, shown in Equation 7-1 as n, must be equal to the
length of the vector you provide for 'C'. n is the number of poles in the
rational function model. This property is empty by default.

Examples rat = rfmodel.rational;

rat.A = [-0.0532 + 1.3166i; -0.0532 - 1.3166i]*1e10;

7-400
 rfmodel.rational.C property

Purpose Residues of rational function

Values Vector

Description Complex vector containing residues of the rational function in radians

per second. Its length, shown in Equation 7-1 as n, must be equal to the
length of the vector you provide for 'A'. n is the number of residues in
the rational function model. This property is empty by default.

Examples rat = rfmodel.rational;

rat.C = [4.4896 - 4.5025i; 4.4896 + 4.5025i]*1e9;

7-401
rfmodel.rational.D property

Purpose Frequency response offset

Values Scalar

Description Scalar value specifying the constant offset in the frequency response of
the rational function. The default is 0.

Examples rat = rfmodel.rational;

rat.D = 1e-3;

7-402
 rfmodel.rational.Delay property

Purpose Frequency response time delay

Values Scalar

Description Scalar value specifying the time delay, in seconds, in the frequency
response of the rational function. The default is 0.

Examples rat = rfmodel.rational;

rat.Delay = 1e-9;

7-403
rfmodel.rational.Name property

Purpose Object name

Values 'Rational Function'

Description Read-only string that contains the name of the object.

Examples rat = rfmodel.rational;

rat.Name

ans =

Rational Function

7-404
 8

Method Reference

Analysis (p. 8-2) Calculate parameters of circuit

objects, model objects, and networks
Plots and Charts (p. 8-2) Display circuit object parameters
Parameters and Formats (p. 8-3) List available parameters and
formats for plots
Operating Conditions (p. 8-3) Set or display operating condition
information
Data I/O (p. 8-3) Read or write data to or from circuit
or data objects
Data Access and Restoration (p. 8-3) Get object data in standard form or
revert to original data
 8 Method Reference

Analysis
analyze Analyze circuit object in frequency
domain
freqresp Calculate frequency response of
model object
ispassive Check passivity of model object
stepresp Calculate response of model object
to step signal
timeresp Calculate time response for model
object

Plots and Charts

circle Draw circles on Smith chart
loglog Plot specified circuit object
parameters using log-log scale
plot Plot specified circuit object
parameters on X-Y plane
plotyy Plot specified object parameters with
y-axes on both left and right sides
polar Plot specified circuit object
parameters on polar coordinates
semilogx Plot specified circuit object
parameters using log scale for x-axis
semilogy Plot specified circuit object
parameters using log scale for x-axis
smith Plot specified circuit object
parameters on Smith chart
table Display specified RF object
parameters in Variable Editor

8-2
 Parameters and Formats

Parameters and Formats

listformat List valid formats for specified
circuit object parameter
listparam List valid parameters for specified
circuit object

Operating Conditions
getop Display operating conditions
setop Set operating conditions

Data I/O
read Read RF data from file to new or
existing circuit or data object
write Write RF data from circuit or data
object to file
writeva Write Verilog-A description of RF
model object

Data Access and Restoration

calculate Calculate specified parameters for
circuit object
extract Extract array of network parameters
from data object

8-3
 8 Method Reference

getz0 Characteristic impedance of

transmission line object
restore Restore data to original frequencies

8-4
 9

Methods — Alphabetical
List
analyze

Purpose Analyze circuit object in frequency domain

Syntax analyze(h,freq)
analyze(h,freq,zl,zs,zo,aperture)
analyze(h,freq,'condition1',value1,...,'conditionm',valuem)

Description analyze(h,freq) calculates the following circuit data at the specified

frequency values:

• Circuit network parameters

• Noise figure
• Output third-order intercept point
• Power data
• Phase noise
• Voltage standing-wave ratio
• Power gain
• Group delay
• Reflection coefficients
• Stability data
• Transfer function

h is the handle of the circuit object to be analyzed. freq is a vector of

frequencies, specified in hertz, at which to analyze the circuit. OIP3 is
always infinite for passive circuits.
analyze(h,freq,zl,zs,zo,aperture) calculates the circuit data at
the specified frequency values. The arguments zl, zs, zo, and aperture
are optional. zl, zs, and zo represent the circuit load, circuit source,
and reference impedances of the S-parameters, respectively. The
default value of all these arguments is 50 ohms.

9-2
 analyze

Note When you specify impedance values, the analyze method

changes the object’s values to match your specification.

The aperture argument determines the two frequency points that the
analyze method uses to compute the group delay for each frequency in
freq. aperture can be a positive scalar or a vector of the same length
of as freq.

Note For rfckt.datafile, rfckt.passive, rfckt.amplifier, and

rfckt.mixer objects that contain measured S-parameter data, the
analyze method uses the two nearest measurement points to compute
the group delay, regardless of the value of aperture.

Group delay τg at each frequency point f is the negative slope of the

phase angle of S21 with respect to f:

Δφ arg ( S21 ( f+ ) ) − arg ( S21 ( f− ) )

τg (f ) = − =−
Δω 2π ( f+ − f− )
where:

• f+ is:
- f(1 + aperture/2) for aperture < 1.
- f + aperture/2 for aperture ≥ 1.
If f is the maximum value of freq, then f+ = f.
• f– is:
- f (1 – aperture/2) for aperture < 1.
- f – aperture/2 for aperture ≥ 1.
If f is the minimum value of freq, then f– = f.

9-3
analyze

The value of aperture affects the accuracy of the computed group

delay. If aperture is too large, the slope estimate may be not accurate.
If aperture is too small, the computer numerical error may affect the
accuracy of the group delay result.
analyze(h,freq,'condition1',value1,...,'conditionm',valuem)
calculates the circuit data at the specified frequency values
and operating conditions for the object h. The inputs
'condition1',value1,...,'conditionm',valuem are the
condition/value pairs at which to analyze the object. Use this syntax for
rfckt.amplifier, rfckt.mixer, and rfdata.data objects where the
condition/value pairs are operating conditions from a .p2d or .s2d file.

Note When you specify condition/value pairs, the analyze method

changes the object’s values to match your specification.

When you analyze a network that contains several objects, RF Toolbox

software does not issue an error or warning if the specified conditions
cannot be applied to all objects. For some networks, because there is
no error or warning, you can call the analyze method once to apply
the same set of operating conditions to any objects where operating
conditions are applicable. However, you may want to analyze a network
that contains one or more of the following:

• Several objects with different sets of operating conditions.

• Several objects with the same set of operating conditions that are
configured differently.

To analyze such a network, you should use the setop method to

configure the operating conditions of each individual object before
analyzing the network.

9-4
 analyze

Analysis of Circuit Objects

For most circuit objects, the AnalyzedResult property is empty until
the analyze method is applied to the circuit object. However, the
following four circuit objects are the exception to this rule:

• rfckt.datafile
• rfckt.passive
• rfckt.amplifier
• rfckt.mixer

By default, the AnalyzedResult property of rfckt.datafile objects

contains the S-parameter, noise figure, and group delay values that are
calculated over the network parameter frequencies in the passive.s2p
data file. OIP3 is ∞ by default because the data in passive.s2p is
passive.
By default, the AnalyzedResult property of rfckt.passive objects
contains the S-parameter, noise figure, and group delay values that are
the result of analyzing the values stored in the passive.s2p file at the
frequencies stored in this file. These frequency values are also stored
in the NetworkData property. OIP3 is always ∞ for rfckt.passive
objects because the data is passive.
By default, the AnalyzedResult property of rfckt.amplifier objects
contains the S-parameter, noise figure, OIP3, and group delay values
that result from analyzing the values stored in the default.amp file
at the frequencies stored in this file. These frequency values are also
stored in the NetworkData property.
By default, the AnalyzedResult property of rfckt.mixer objects
contains the S-parameter, noise figure, OIP3, and group delay values
that result from analyzing the values stored in the default.s2p file
at the frequencies stored in this file. These frequency values are also
stored in the NetworkData property.
For a detailed explanation of how the analyze method calculates
the network parameters, noise figure values, and OIP3 values for a

9-5
analyze

particular object, see the AnalyzedResult property on the reference

page for that object.

References http://www.microwaves101.com/encyclopedia/groupdelaymeasurements.cfm

See Also calculate

extract
getz0
listformat
listparam
loglog
plot
plotyy
polar
semilogx
semilogy
smith
read
restore
write

9-6
 calculate

Purpose Calculate specified parameters for circuit object

Syntax [data,params,freq] = calculate(h,'parameter1',...,'parametern',

'format')
[ydata,params,xdata] = calculate(h,'parameter1',...,
'parametern', 'format',xparameter,xformat, 'condition1',
value1,...,'conditionm',valuem, 'freq',freq,'pin',pin)

Description [data,params,freq] = calculate(h,'parameter1',...,'parametern',

'format') calculates the specified parameters for the object h and
returns them in the n-element cell array data.
The input h is the handle of a circuit object.
parameter1,..., parametern is the list of parameters to be calculated.
Use the listparam method to get a list of the valid parameters for a
circuit object.
format is the format of the output data. The format determines if RF
Toolbox software converts the parameter values to a new set of units, or
operates on the components of complex parameter values.
For example:

• Specify format as Real to compute the real part of the selected

parameter.
• Specify format as 'none' to return the parameter values unchanged.

Use the listformat method to get a list of the valid formats for a
particular parameter.
The output params is an n-element cell array containing the names, as
strings, of the parameters in data. freq is a vector of frequencies at
which the parameters are known.

Note Before calling calculate, you must use the analyze method to
perform a frequency domain analysis for the circuit object.

9-7
calculate

[ydata,params,xdata] = calculate(h,'parameter1',...,'parametern',
'format',xparameter,xformat,
'condition1',value1,...,'conditionm',valuem,
'freq',freq,'pin',pin) calculates the specified parameters at the
specified operating conditions for the object h.
xparameter is the independent parameter for which to calculate
the specified parameters. Several xparameter values are available
for all objects. When you import rfckt.amplifier, rfckt.mixer, or
rfdata.data object specifications from a .p2d or .s2d file, you can
also specify any operating conditions from the file that have numeric
values, such as bias.
The following table shows the most commonly available parameters and
the corresponding xparameter values. The default settings listed in the
table are used if xparameter is not specified.

Parameter Name xparameter values

Pout, Phase, LS11, LS12, LS21, Pin (default), Freq
LS22
S11, S12, S21, S22, NF, IIP3, Freq
OIP3, GroupDelay, VSWRIn,
VSWROut, GAMMAIn, GAMMAOut,
FMIN, GAMMAOPT, RN, TF1, TF2,
Gt, Ga, Gp, Gmag, Gmsg, GammaMS,
GammaML, K, Delta, Mu, MuPrime
AM/AM, AM/PM AM (default, and only available
value)

xformat is the format to use for the specified xparameter. No xformat

specification is needed when xparameter is an operating condition.
The following table shows the xformat values that are available for the
xparameter values listed in the preceding table, along with the default
settings that are used if xformat is not specified.

9-8
 calculate

xparameter values xformat values

Pin dBm (default), mW, W, dBW
Freq THz, GHz, MHz, KHz, Hz
By default, xformat is chosen to
provide the best scaling for the
given xparameter values.
AM Magnitude (decibels) (default),
Magnitude (linear)

condition1,value1,..., conditionm,valuem are the optional

condition/value pairs at which to calculate the specified parameters.
These pairs are usually operating conditions from a .p2d or .s2d file.
For some parameters, you can specify a set of frequency or input power
values at which to calculate the specified parameter.
For example:

• When you calculate large-signal S-parameters as a function of

input power, you can specify frequency points of interest using
condition/value pairs.
• When you calculate large-signal S-parameters as a function of
frequency, you can specify input power levels of interest using
condition/value pairs.
• When you calculate parameters as a function of an operating
condition, you can specify both frequency and input power values
using condition/value pairs.

freq is the optional frequency value at which to calculate the specified

parameters.
pin is the optional input power value at which to calculate the specified
parameters.

9-9
calculate

The method returns the following n-element cell arrays:

• ydata — The calculated values of the specified parameter.

• params — The names, as strings, of the parameters in xdata and
ydata.
• xdata — The xparameter values at which the specified parameters
are known.

Note For compatibility reasons, if xdata contains only one vector or

if all xdata values are equal, then xdata is a numeric vector rather
than a cell of a single vector.

If h has multiple operating conditions, such as from a .p2d or .s2d file,

the calculate method operates as follows:

• If you do not specify any operating conditions as arguments to the

calculate method, then the method returns the parameter values
based on the currently selected operating condition.
• If one or more operating conditions are specified, the calculate
method returns the parameter values based on those operating
conditions.
• When an operating condition is used for the xparameter input
argument, the xdata cell array returned by the calculate method
contains the operating condition values in ascending order.

Examples Analyze a general transmission line, trl, with the default characteristic
impedance of 50 ohms, phase velocity of 299792458 meters per second,
and line length of 0.01 meters for frequencies of 1.0 GHz to 3.0 GHz.
Then, calculate the S11 and S22 parameters in decibels.

trl = rfckt.txline;
f = [1e9:1.0e7:3e9];
analyze(trl,f);

9-10
 calculate

[data,params,freq] = calculate(trl,'S11','S22','dB')

data =
[201x1 double] [201x1 double]
params =
'S_{11}' 'S_{22}'

freq = 1.0e+009 *

1.0000
1.0100
1.0200
...

The params output is formatted so you can use it as a plot legend. The
first few elements of data{1} look like

ans =

1.0e+003 *

-6.4661
-0.3372
-0.3432
-0.3432
-0.3432
...

See Also analyze

extract
getz0
listformat
listparam
loglog

9-11
calculate

plot
plotyy
polar
semilogx

semilogy

smith

read
restore
write

9-12
 circle

Purpose Draw circles on Smith chart

Syntax [hlines, hsm] = circle(h, freq, type1, value1, ..., typen,

valuen, hsm)

Description [hlines, hsm] = circle(h, freq, type1, value1, ..., typen,

valuen, hsm) draws the specified circles on a Smith chart and returns
the following handles:

• hlines — A vector of handles to line objects, with one handle per

circle specification.
• hsm — The handle to the Smith chart.

The arguments to circle are:

• h — The handle to an rfckt object.

• freq — A single frequency point of interest.
• type1, value1, ..., typen, valuen — The type/value pairs that
specify the circles to plot.

The following table lists the supported circle type options and the
definition of each option.

type Definition
'Ga' Constant available power gain circle
'Gp' Constant operating power gain circle
'Gt' Constant transducer power gain circle
'Stab' Stability circle
'NF' Constant noise figure circle
'R' Constant resistance circle
'X' Constant reactance circle

9-13
circle

type Definition
'G' Constant conductance circle
'B' Constant susceptance circle
'Gamma' Constant reflection magnitude circle

The following table lists the available value options for the above types
of circles and the definition of each value.

value Definition
'Ga' Scalar or vector of gains in dB
'Gp' Scalar or vector of gains in dB
'Gt' Scalar or vector of gains in dB
'Stab' String 'in' or 'source' for input/source
stability circle; string 'out' or 'load' for
output/load stability circle
'NF' Scalar or vector of noise figures in dB
'R' Scalar or vector of normalized resistance
'X' Scalar or vector of normalized reactance
'G' Scalar or vector of normalized conductance
'B' Scalar or vector of normalized susceptance
'Gamma' Scalar or vector of non-negative reflection
magnitude

hsm is an optional input argument that you can use to place circles on
an existing Smith chart.

Examples For an example of how to use the circle method, see the RF Toolbox
demo Designing Matching Networks (Part 1: Networks with an LNA
and Lumped Elements).

9-14
 circle

See Also smith

9-15
extract

Purpose Extract array of network parameters from data object

Syntax [outmatrix, freq] = extract(h,outtype,z0)

Description [outmatrix, freq] = extract(h,outtype,z0) extracts the network

parameters of outtype from an rfckt, rfdata.data or rfdata.network
object, h, and returns them in outmatrix. freq is a vector of frequencies
that correspond to the network parameters.
outtype can be one of these case-insensitive strings 'ABCD_parameters',
'S_parameters', 'Y_parameters', 'Z_parameters', 'H_parameters',
'G_parameters', or 'T_parameters'. z0 is the reference impedance
for the S-parameters. The default is 50 ohms.

See Also analyze

calculate
getz0
listformat
listparam
loglog
plot
plotyy
polar
semilogx

semilogy

smith

read

9-16
 extract

restore
write

9-17
freqresp

Purpose Calculate frequency response of model object

Syntax [resp,outfreq] = freqresp(h,infreq)

Description [resp,outfreq] = freqresp(h,infreq) computes the frequency

response, resp, of the rfmodel object, h, at the frequencies specified
by freq.
The input h is the handle of a model object, and infreq is a vector
of positive frequencies, in Hz, over which the frequency response is
calculated.
The output argument outfreq is a vector that contains the same
frequencies as the input frequency vector, in order of increasing
frequency. The frequency response, resp, is a vector of frequency
response values corresponding to these frequencies. It is computed
using the analytical form of the rational function

⎛ n Ck ⎞
resp = ⎜ ∑ + D ⎟ e− s* Delay , s = j 2π * freq
⎜ ⎟
⎝ k=1 s − Ak ⎠

where A, C, D, and Delay are properties of the rfmodel object, h.

Examples The following example shows you how to compute the frequency
response of the data stored in the file default.s2p by reading it into an
rfdata object, fitting a rational function model to the data, and using
the freqresp method to compute the frequency response of the model.

orig_data=read(rfdata.data,'default.s2p')
freq=orig_data.Freq;
data=orig_data.S_Parameters(2,1,:);
fit_data=rationalfit(freq,data)

[resp,freq]=freqresp(fit_data,freq);

plot(freq/1e9,db(resp));
figure

9-18
 freqresp

plot(freq/1e9,unwrap(angle(resp)));

See Also rationalfit

rfmodel.rational
timeresp
writeva

9-19
getop

Purpose Display operating conditions

Syntax getop(h)

Description getop(h) displays the selected operating conditions for the circuit or
data object, h.
Information about operating conditions is available only when you
import the object specifications from a .p2d or .s2d file.

Examples Display the operating conditions of an object:

ckt1 = read(rfckt.amplifier, 'default.p2d');

getop(ckt1)

See Also setop

9-20
 getz0

Purpose Characteristic impedance of transmission line object

Syntax z0 = getz0(h)

Description z0 = getz0(h) returns a scalar or vector, z0, that represents

the characteristic impedance(s) of circuit object h. The object
h can be rfckt.txline, rfckt.rlcgline, rfckt.twowire,
rfckt.parallelplate, rfckt.coaxial, rfckt.microstrip, or
rfckt.cpw.

See Also analyze

calculate
extract
listformat
listparam
loglog
plot
plotyy
polar
semilogx

semilogy

smith

read
restore
write

9-21
impulse

Purpose Calculate impulse response for model object

Note impulse may be removed in a future release. Use timeresp

instead.

Syntax [resp,t] = impulse(h,ts,n)

Description [resp,t] = impulse(h,ts,n) computes the impulse response, resp, of

the rfmodel object, h, over the time period specified by ts and n.

Note While you can compute the output response for a rational
function model object by computing the impulse response of the object
and then convolving that response with the input signal, this approach
is not recommended. Instead, you should use the timeresp method to
perform this computation because it generally gives a more accurate
output signal for a given input signal.

The input h is the handle of a rational function model object. ts is a

positive scalar value that specifies the sample time of the computed
impulse response, and n is a positive integer that specifies the total
number of samples in the response.
The vector of time samples of the impulse response, t, is computed from
the inputs as t = [0,ts,2*ts,...,(n-1)*ts]. The impulse response,
resp, is an n-element vector of impulse response values corresponding
to these times. It is computed using the analytical form of the rational
function

M
resp = ∑ Ck e A (t− Delay)u(t − Delay) + Dδ(t − Delay)
k

k=1

where

9-22
 impulse

• A, C, D, and Delay are properties of the rfmodel object, h.

• M is the number of poles in the rational function model.

Examples The following example shows you how to compute the impulse response
of the data stored in the file default.s2p by fitting a rational function
model to the data and using the impulse method to compute the
impulse response of the model.

orig_data=read(rfdata.data,'default.s2p')
freq=orig_data.Freq;
data=orig_data.S_Parameters(2,1,:);
fit_data=rationalfit(freq,data)

[resp,t]=impulse(fit_data,1e-12,1e4);

plot(t,resp);

See Also freqresp

rationalfit
rfmodel.rational
writeva

9-23
ispassive

Purpose Check passivity of model object

Syntax result = ispassive(h)

Description result = ispassive(h) checks the passivity of the rfmodel object,

h, across all frequencies, and returns result, a logical value. If h is
passive, then result is 1. If h is not passive, then result is 0.

Examples Create a rational function object and check the passivity of the object:

% Read a Touchstone data file

ckt = read(rfckt.passive, 'passive.s2p');
% Fit the transfer function into a rational function object
TF = s2tf(ckt.AnalyzedResult.S_Parameters);
TF_Object = rationalfit(ckt.AnalyzedResult.Freq, TF);
% Check the passivity of the rational function object
Is_Passive = ispassive(TF_Object)

See Also rfmodel.rational

rationalfit

9-24
 listformat

Purpose List valid formats for specified circuit object parameter

Syntax list = listformat(h,'parameter')

Description list = listformat(h,'parameter') lists the allowable formats for

the specified network parameter. The first listed format is the default
format for the specified parameter.
In these lists, 'Abs' and 'Mag' are the same as 'Magnitude (linear)',
and 'Angle' is the same as 'Angle (degrees)'.
When you plot phase information as a function of frequency, RF Toolbox
software unwraps the phase data using the MATLAB unwrap function.
The resulting plot is only meaningful if the phase data varies smoothly
as a function of frequency, as described in the unwrap reference page. If
your data does not meet this requirement, you must obtain data on a
finer frequency grid.
Use the listparam method to get the valid parameters of a circuit
object.

Note Before calling listformat, you must use the analyze method to
perform a frequency domain analysis for the circuit object.

Examples trl = rfckt.txline;

f = [1e9:1.0e7:3e9];
analyze(trl,f);
list = listformat(trl,'S11')

list =
'dB'
'Magnitude (decibels)'
'Abs'
'Mag'
'Magnitude (linear)'
'Angle'

9-25
listformat

'Angle (degrees)'
'Angle (radians)'
'Real'
'Imag'
'Imaginary'

See Also analyze

calculate
extract
getz0
listparam
loglog
plot
plotyy
polar
semilogx

semilogy

smith

read
restore
write

9-26
 listparam

Purpose List valid parameters for specified circuit object

Syntax list = listparam(h)

Description list = listparam(h) lists the valid parameters for the specified
circuit object h.

Note Before calling listparam, you must use the analyze method to
perform a frequency domain analysis for the circuit object.

Several parameters are available for all objects. When you import
rfckt.amplifier, rfckt.mixer, or rfdata.data object specifications
from a .p2d or .s2d file, the list of valid parameters also includes any
operating conditions from the file that have numeric values, such as
bias.
The following table describes the most commonly available parameters.

Parameter Description
S11, S12, S21, S22 S-parameters
LS11, LS12, LS21, LS22 (Amplifier
and mixer objects with multiple
operating conditions only)
GroupDelay Group delay
GammaIn, GammaOut Input and output reflection
coefficients
VSWRIn, VSWROut Input and output voltage
standing-wave ratio
IIP3, OIP3 (Amplifier and mixer Third-order intercept point
objects only)
NF Noise figure

9-27
listparam

Parameter Description
TF1 Ratio of the load voltage to the
output voltage of the source
when the input port is conjugate
matched
TF2 Ratio of load voltage to the source
voltage
• Gt • Transducer power gain
• Ga • Available power gain
• Gp • Operating power gain
• Gmag • Maximum available power
gain
• Gmsg
• Maximum stable gain
GammaMS, GammaML Source and load reflection
coefficients for simultaneous
conjugate match
K, Mu, MuPrime Stability factor
Delta Stability condition

Examples The following examples show you how to list the parameters for a
transmission line object.

trl = rfckt.txline;
f = [1e9:1.0e7:3e9];
analyze(trl,f);
list = listparam(trl)

See Also analyze

calculate

9-28
 listparam

extract
getz0
listformat
loglog
plot
plotyy
polar
semilogx
semilogy
smith
read
restore
write

9-29
loglog

Purpose Plot specified circuit object parameters using log-log scale

Syntax lineseries = loglog(h,parameter)

lineseries = loglog(h,parameter1,...,parametern)
lineseries = loglog(h,parameter1,...,parametern,format)
lineseries = loglog(h,'parameter1',...,'parametern', format,
xparameter,xformat,'condition1',value1,..., 'conditionm',
valuem,'freq',freq,'pin',pin)

Description lineseries = loglog(h,parameter) plots the specified parameter in

the default format using a log-log scale. h is the handle of a circuit
(rfckt) object.
Type listparam(h) to get a list of valid parameters for a circuit object,
h. Type listformat(h,parameter) to see the legitimate formats for
a specified parameter. The first listed format is the default for the
specified parameter.
The loglog method returns a column vector of handles to lineseries
objects, one handle per line. This output is the same as the output
returned by the MATLAB loglog method.
lineseries = loglog(h,parameter1,...,parametern) plots the
parameters parameter1,..., parametern from the object h on an X-Y
plane using logarithmic scales for both the x- and y- axes.
lineseries = loglog(h,parameter1,...,parametern,format)
plots the parameters parameter1,..., parametern in the specified
format. format is the format of the data to be plotted, e.g.
'Magnitude (decibels)'.

Note For all circuit objects except those that contain data from a data
file, you must perform a frequency domain analysis with the analyze
method before calling loglog.

Use the Property Editor (propertyeditor) or the MATLAB set

function to change lineseries properties. The reference pages for

9-30
 loglog

MATLAB functions such as figure, axes, and text also list available
properties and provide links to more complete property descriptions.

Note Use the MATLAB loglog function to create a log-log scale plot of
parameters that are specified as vector data and are not part of a circuit
(rfckt) object or data (rfdata) object.

lineseries = loglog(h,'parameter1',...,'parametern',
format,xparameter,xformat,'condition1',value1,...,
'conditionm',valuem,'freq',freq,'pin',pin) plots the specified
parameters at the specified operating conditions for the object h.
xparameter is the independent variable to use in plotting the specified
parameters. Several xparameter values are available for all objects.
When you import rfckt.amplifier, rfckt.mixer, or rfdata.data
object specifications from a .p2d or .s2d file, you can also specify any
operating conditions from the file that have numeric values, such as
bias.
The following table shows the most commonly available parameters and
the corresponding xparameter values. The default settings listed in the
table are used if xparameter is not specified.

Parameter Name xparameter values

Pout, Phase, LS11, LS12, LS21, Pin (default), Freq
LS22
S11, S12, S21, S22, NF, IIP3, Freq
OIP3, GroupDelay, VSWRIn,
VSWROut, GAMMAIn, GAMMAOut,
FMIN, GAMMAOPT, RN, TF1, TF2,
Gt, Ga, Gp, Gmag, Gmsg, GammaMS,
GammaML, K, Delta, Mu, MuPrime
AM/AM, AM/PM AM

9-31
loglog

xformat is the format to use for the specified xparameter. No xformat

specification is needed when xparameter is an operating condition.
The following table shows the xformat values that are available for the
xparameter values listed in the preceding table, along with the default
settings that are used if xformat is not specified.

xparameter values xformat values

Pin dBm (default), mW, W, dBW
Freq THz, GHz, MHz, KHz, Hz
By default, xformat is chosen to
provide the best scaling for the
given xparameter values.
AM Magnitude (decibels) (default),
Magnitude (linear)

condition1,value1,..., conditionm,valuem are the optional

condition/value pairs at which to plot the specified parameters. These
pairs are usually operating conditions from a .p2d or .s2d file. For
some parameters, you can specify a set of frequency or input power
values at which to plot the specified parameter.
For example:

• When plotting large-signal S-parameters as a function of input power,

you can specify frequency points of interest using condition/value
pairs.
• When plotting large-signal S-parameters as a function of frequency,
you can specify input power levels of interest using condition/value
pairs.
• When plotting parameters as a function of an operating condition,
you can specify both frequency and input power values using
condition/value pairs.

9-32
 loglog

freq is the optional frequency value, in hertz, at which to plot the

specified parameters.
pin is the optional input power value, in dBm, at which to plot the
specified parameters.
If h has multiple operating conditions, such as from a .p2d or .s2d file,
the loglog method operates as follows:

• If you do not specify any operating conditions as arguments to the

loglog method, then the method plots the parameter values based
on the currently selected operating condition.
• If you specify one or more operating conditions, the loglog method
plots the parameter values based on those operating conditions.
• When you use an operating condition for the xparameter input
argument, the method plots the parameters for all operating
condition values.

See Also analyze

calculate
extract
getz0
listformat
listparam
plot
plotyy
polar
read
restore
semilogx
semilogy

9-33
loglog

smith
write

9-34
 plot

Purpose Plot specified circuit object parameters on X-Y plane

Syntax lineseries = plot(h,parameter)

lineseries = plot(h,parameter1,...,parametern)
lineseries = plot(h,parameter1,...,parametern,format)
lineseries = plot(h,'parameter1',...,'parametern', format,
xparameter,xformat, 'condition1',value1,..., 'conditionm',
valuem,'freq',freq,'pin',pin)
lineseries = plot(h,'budget',...)
lineseries = plot(h,'mixerspur',k,pin,fin)

Description lineseries = plot(h,parameter) plots the specified parameter on

an X-Y plane in the default format. h is the handle of a circuit (rfckt)
object. Use the listparam method to get a list of the valid parameters
for a particular circuit object, h.
The plot method returns a column vector of handles to lineseries
objects, one handle per line. This output is the same as the output
returned by the MATLAB plot function.
lineseries = plot(h,parameter1,...,parametern) plots the
specified parameters parameter1,..., parametern from the object
h on an X-Y plane.
lineseries = plot(h,parameter1,...,parametern,format) plots
the specified parameters parameter1,..., parametern in the specified
format. The format determines if RF Toolbox software converts the
parameter values to a new set of units, or operates on the components
of complex parameter values. For example:

• Specify format as Real to plot the real part of the selected parameter.
• Specify format as 'none' to plot the parameter values unchanged.

Use the listformat method to get a list of the valid formats for a
particular parameter.

9-35
plot

lineseries = plot(h,'parameter1',...,'parametern',
format,xparameter,xformat, 'condition1',value1,...,
'conditionm',valuem,'freq',freq,'pin',pin) plots the specified
parameters at the specified operating conditions for the object h.
xparameter is the independent variable to use in plotting the specified
parameters. Several xparameter values are available for all objects.
When you import rfckt.amplifier, rfckt.mixer, or rfdata.data
object specifications from a .p2d or .s2d file, you can also specify any
operating conditions from the file that have numeric values, such as
bias.
The following table shows the most commonly available parameters and
the corresponding xparameter values. The default settings listed in the
table are used if xparameter is not specified.

Parameter Name xparameter values

Pout, Phase, LS11, LS12, LS21, Pin (default), Freq
LS22
S11, S12, S21, S22, NF, IIP3, Freq
OIP3, GroupDelay, VSWRIn,
VSWROut, GAMMAIn, GAMMAOut,
FMIN, GAMMAOPT, RN, TF1, TF2,
Gt, Ga, Gp, Gmag, Gmsg, GammaMS,
GammaML, K, Delta, Mu, MuPrime
AM/AM, AM/PM AM

xformat is the format to use for the specified xparameter. No xformat

specification is needed when xparameter is an operating condition.
The following table shows the xformat values that are available for the
xparameter values listed in the preceding table, along with the default
settings that are used if xformat is not specified.

9-36
 plot

xparameter values xformat values

Pin dBm (default), mW, W, dBW
Freq THz, GHz, MHz, KHz, Hz
By default, xformat is chosen to
provide the best scaling for the
given xparameter values.
AM Magnitude (decibels) (default),
Magnitude (linear)

condition1,value1,..., conditionm,valuem are the optional

condition/value pairs at which to plot the specified parameters. These
pairs are usually operating conditions from a .p2d or .s2d file. For
some parameters, you can specify a set of frequency or input power
values at which to plot the specified parameter.
For example:

• When plotting large-signal S-parameters as a function of input power,

you can specify frequency points of interest using condition/value
pairs.
• When plotting large-signal S-parameters as a function of frequency,
you can specify input power levels of interest using condition/value
pairs.
• When plotting parameters as a function of an operating condition,
you can specify both frequency and input power values using
condition/value pairs.

freq is the optional frequency value, in hertz, at which to plot the

specified parameters.
pin is the optional input power value, in dBm, at which to plot the
specified parameters.
If h has multiple operating conditions, such as from a .p2d or .s2d file,
the plot method operates as follows:

9-37
plot

• If you do not specify any operating conditions as arguments to the

plot method, then the method plots the parameter values based on
the currently selected operating condition.
• If you specify one or more operating conditions, the plot method
plots the parameter values based on those operating conditions.
• When you use an operating condition for the xparameter input
argument, the method plots the parameters for all operating
condition values.

lineseries = plot(h,'budget',...) plots budget data for

the specified parameters parameter1,..., parametern from the
rfckt.cascade object h.
The following table summarizes the parameters and formats that are
available for a budget plot.

Parameter Format
S11, S12, S21, S22 Magnitude (decibels)
Magnitude (linear)
Angle (degrees)
Real
Imaginary
OIP3 dBm
dBW
W
mW
NF Magnitude (decibels)
Magnitude (linear)

lineseries = plot(h,'mixerspur',k,pin,fin) plots spur power of

an rfckt.mixer object or an rfckt.cascade object that contains one
or more mixers.
k is the index of the circuit object for which to plot spur power. Its
value can be an integer or 'all'. The default is 'all'. This value

9-38
 plot

creates a budget plot of the spur power for h. Use 0 to plot the power at
the input of h.
pin is the optional scalar input power value, in dBm, at which to plot
the spur power. The default is 0 dBm. When you create a spur plot for
an object, the previous input power value is used for subsequent plots
until you specify a different value.
fin is the optional scalar input frequency value, in hertz, at which to
plot the spur power. If h is an rfckt.mixer object, the default value of
fin is the input frequency at which the magnitude of the S21 parameter
of the mixer, in decibels, is highest. If h is an rfckt.cascde object, the
default value of fin is the input frequency at which the magnitude of
the S21 parameter of the first mixer in the cascade is highest. When you
create a spur plot for an object, the previous input frequency value is
used for subsequent plots until you specify a different value.
For more information on plotting mixer spur power, see the Visualizing
Mixer Spurs demo.

Note For all circuit objects except those that contain data from a data
file, you must perform a frequency domain analysis with the analyze
method before calling plot.

Use the Property Editor (propertyeditor) or the MATLAB set

function to change lineseries properties. The reference pages for
MATLAB functions such as figure, axes, and text also list available
properties and provide links to more complete property descriptions.

Note Use the MATLAB plot function to plot network parameters

that are specified as vector data and are not part of a circuit (rfckt)
object or data (rfdata) object.

9-39
plot

See Also analyze

calculate
extract
getz0
listformat
listparam
loglog
plotyy
polar
read
restore
semilogx
semilogy
smith
write

9-40
 plotyy

Purpose Plot specified object parameters with y-axes on both left and right sides

Syntax [ax,hlines1,hlines2] = plotyy(h,parameter)

[ax,hlines1,hlines2] = plotyy(h,parameter1,...,parametern)
[ax,hlines1,hlines2] = plotyy(h,parameter,format1,format2)
[ax,hlines1,hlines2] = plotyy(h, parameter1, ..., parametern,
format1, format2)
[ax,hlines1,hlines2] = plotyy(h,parameter1_1,...,
parameter1_n1, format1,parameter2_1,...,parameter2_n2,
format2)
[ax,hlines1,hlines2] = plotyy(h,parameter1_1,...,parameter1_n1,
format1,parameter2_1,...,parameter2_n2,format2,xparameter,
xformat,'condition1',value1,...,'conditionm',valuem,
'freq',freq,'pin',pin)

Description [ax,hlines1,hlines2] = plotyy(h,parameter) plots the specified

parameter using the predefined primary and secondary formats for the
left and right y-axes, respectively. The formats define how RF Toolbox
software displays the data on the plot. h is the handle of a circuit
(rfckt) or an rfdata.data object.

• See “Determining Formats” on page 9-45 for a table that shows the
predefined primary and secondary formats for the parameters for all
circuit and data objects.
• Type listparam(h) to get a list of valid parameters for a circuit
object, h. Type listformat(h,parameter) to see the legitimate
formats for a specified parameter. The first listed format is the
default for the specified parameter.

The plotyy method returns the handles to the two axes created in ax
and the handles to two lineseries objects in hlines1 and hlines2.

• ax(1) is the left axes.

• ax(2) is the right axes.
• hlines1 is the lineseries object for the left y-axis.

9-41
plotyy

• hlines2 is the lineseries object for the right y-axis.

Note For all circuit objects except those that contain data from a data
file, you must perform a frequency domain analysis with the analyze
method before calling plotyy.

Use the Property Editor (propertyeditor) or the MATLAB set

function to change lineseries properties. The reference pages for
MATLAB functions such as figure, axes, and text also list available
properties and provide links to more complete property descriptions.

Note Use the MATLAB plotyy function to plot parameters on two

y-axes that are specified as vector data and are not part of a circuit
(rfckt) object or data (rfdata) object.

[ax,hlines1,hlines2] = plotyy(h,parameter1,...,parametern)
plots the parameters parameter1,..., parametern. plotyy determines
the formats for the left and right y-axes based on the predefined primary
and secondary formats for the specified parameters, as described in
“Determining Formats” on page 9-45.
[ax,hlines1,hlines2] = plotyy(h,parameter,format1,format2)
plots the specified parameter using format1 for the left y-axis and
format2 for the right y-axis.
[ax,hlines1,hlines2] = plotyy(h, parameter1,
..., parametern, format1, format2) plots the
parametersparameter1,..., parametern on an X-Y plane
using format1 for the left y-axis and format2 for the right y-axis.
[ax,hlines1,hlines2] =
plotyy(h,parameter1_1,...,parameter1_n1,

9-42
 plotyy

format1,parameter2_1,...,parameter2_n2,format2) plots the

following data:

• Parameters parameter1_1,..., parameter1_n1 using format1 for

the left y-axis.
• Parameters parameter2_1,..., parameter2_n2 using format2 for
the right y-axis.

[ax,hlines1,hlines2] = plotyy(h,parameter1_1,...,parameter1_n1,
format1,parameter2_1,...,parameter2_n2,format2,xparameter,
xformat,'condition1',value1,...,'conditionm',valuem,
'freq',freq,'pin',pin) plots the specified parameters at the
specified operating conditions for the object h.
xparameter is the independent variable to use in plotting the specified
parameters. Several xparameter values are available for all objects.
When you import rfckt.amplifier, rfckt.mixer, or rfdata.data
object specifications from a .p2d or .s2d file, you can also specify any
operating conditions from the file that have numeric values, such as
bias.
The following table shows the most commonly available parameters and
the corresponding xparameter values. The default settings listed in the
table are used if xparameter is not specified.

Parameter Name xparameter values

Pout, Phase, LS11, LS12, LS21, Pin (default), Freq
LS22
S11, S12, S21, S22, NF, IIP3, Freq
OIP3, GroupDelay, VSWRIn,
VSWROut, GAMMAIn, GAMMAOut,
FMIN, GAMMAOPT, RN, TF1, TF2,
Gt, Ga, Gp, Gmag, Gmsg, GammaMS,
GammaML, K, Delta, Mu, MuPrime
AM/AM, AM/PM AM

9-43
plotyy

xformat is the format to use for the specified xparameter. No xformat

specification is needed when xparameter is an operating condition.
The following table shows the xformat values that are available for the
xparameter values listed in the preceding table, along with the default
settings that are used if xformat is not specified.

xparameter values xformat values

Pin dBm (default), mW, W, dBW
Freq THz, GHz, MHz, KHz, Hz
By default, xformat is chosen to
provide the best scaling for the
given xparameter values.
AM Magnitude (decibels) (default),
Magnitude (linear)

condition1,value1,..., conditionm,valuem are the optional

condition/value pairs at which to plot the specified parameters. These
pairs are usually operating conditions from a .p2d or .s2d file. For
some parameters, you can specify a set of frequency or input power
values at which to plot the specified parameter.
For example:

• When plotting large-signal S-parameters as a function of input power,

you can specify frequency points of interest using condition/value
pairs.
• When plotting large-signal S-parameters as a function of frequency,
you can specify input power levels of interest using condition/value
pairs.
• When plotting parameters as a function of an operating condition,
you can specify both frequency and input power values using
condition/value pairs.

9-44
 plotyy

freq is the optional frequency value, in hertz, at which to plot the

specified parameters.
pin is the optional input power value, in dBm, at which to plot the
specified parameters.
If h has multiple operating conditions, such as from a .p2d or .s2d file,
the plotyy method operates as follows:

• If you do not specify any operating conditions as arguments to the

plotyy method, then the method plots the parameter values based
on the currently selected operating condition.
• If you specify one or more operating conditions, the plotyy method
plots the parameter values based on those operating conditions.
• When you use an operating condition for the xparameter input
argument, the method plots the parameters for all operating
condition values.

Determining When you call plotyy without specifying the plot formats for the left
Formats and right y-axes, plotyy determines the formats from the predefined
primary and secondary formats for the one or more specified parameters.
This section contains the following topics:

• “Primary and Secondary Formats” on page 9-45

• “Determining Formats for One Parameter” on page 9-47
• “Determining Formats for Multiple Parameters” on page 9-47

Primary and Secondary Formats

The following table shows the primary and secondary formats for the
parameters for all circuit and data objects.

9-45
plotyy

Parameter Primary Format Secondary Format

S11, S12, S21, S22 Magnitude Angle (Degrees)
(decibels)
LS11, LS12, LS21, Magnitude Angle (Degrees)
LS22 (decibels)
NF Magnitude
(decibels)
OIP3 dBm W
POUT dBm W
Phase Angle (Degrees)
AM/AM Magnitude
(decibels)
AM/PM Angle (Degrees)
GAMMAIn, GAMMAOut Magnitude Angle (Degrees)
(decibels)
Gt, Ga, Gp, Gmag, Gmsg Magnitude
(decibels)
Delta Magnitude Angle (Degrees)
(decibels)
TF1, TF2 Magnitude Angle (Degrees)
(decibels)
GammaMS, GammaML Magnitude Angle (Degrees)
(decibels)
VSWRIn, VSWROut Magnitude
(decibels)
GroupDelay Time (ns)
FMIN Magnitude
(decibels)

9-46
 plotyy

Parameter Primary Format Secondary Format

GAMMAOPT Magnitude Angle (Degrees)
(decibels)
K, Mu, MuPrime None
RN None
PhaseNoise dBc/Hz
NTemp K
NFactor None

Determining Formats for One Parameter

When you specify only one parameter for plotting, plotyy creates the
plot as follows:

• The predefined primary format is the format for the left y-axis.
• The predefined secondary format is the format for the right y-axis.

If the specified parameter does not have the predefined secondary

format, plotyy behaves the same way as plot, and does not add a
second y-axis to the plot.

Determining Formats for Multiple Parameters

To plot multiple parameters on two y-axes, plotyy tries to find two
formats from the predefined primary and secondary formats for the
specified parameters. To be used in the plot, the formats must meet
the following criteria:

• Each format must be a valid format for at least one parameter.

• Each parameter must be plotted at least on one y-axis.

If plotyy cannot meet this criteria it issues an error message.

The function uses the following algorithm to determine the two
parameters:

9-47
plotyy

1 Look up the primary and secondary formats for the specified

parameters.

2 If one or more pairs of primary-secondary formats meets the

preceding criteria for all parameters:
• Select the pair that applies to the most parameters.
• Use these formats to create the plot.
Otherwise, proceed to the next step.

3 If no pairs of primary-secondary formats meet the criteria for all

parameters, try to find one or more pairs of primary-primary formats
that meets the criteria. If one or more pairs of primary-primary
formats meets the preceding criteria for all parameters:
• Select the pair that applies to the most parameters.
• Use these formats to create the plot.
Otherwise, proceed to the next step.

4 If the preceding steps fail to produce a plot, try to find one format
from the predefined primary formats. If a primary format is valid for
all parameters, use this format to create the plot with the MATLAB
plot function.

If this is not successful, issue an error message.

The following example shows how plotyy applies this criteria to create
plots.
Example — Determining Formats for Multiple Parameters
At the MATLAB prompt:

1 Type this command to create an rfckt object called amp:

amp = rfckt.amplifier;

2 Type this command to plot the S11 and S21 parameters of amp on
two y-axes:

9-48
 plotyy

plotyy(amp, 'S11', 'S21')

The primary and secondary formats for both S11 and S21 are
Magnitude (decibels) and Angle (Degrees), respectively, so
plotyy uses this primary-secondary format pair to create the plot.

3 Type this command to plot the S11 and NF parameters of amp on two
y-axes:

plotyy(amp, 'S11', 'NF')

9-49
plotyy

The primary and secondary formats for S11 are Magnitude

(decibels) and Angle (Degrees), respectively.
• Magnitude (decibels) is a valid format for both S11 and NF
• Angle (Degrees) is a valid format for S11.
These formats both meet the preceding criteria, so the function uses
this primary-secondary format pair to create the plot.

4 Type this command to plot the NF, S21 and GroupDelay parameters
of amp on two y-axes:

plotyy(amp, 'NF', 'S21', 'GroupDelay')

9-50
 plotyy

The primary and secondary formats for S21 are Magnitude

(decibels) and Angle (Degrees), respectively. Both NF and
GroupDelay have only a primary format.
• Magnitude (decibels) is the primary format for NF.
• ns is the primary format for GroupDelay.
There is no primary-secondary format pair that meets the preceding
criteria, so plotyy tries to find a pair of primary formats that meet
the criteria. plotyy creates the plot using:
• Magnitude (decibels) for the left y-axis.
This format is valid for both NF and S21.
• ns for the right y-axis.
This format is valid for GroupDelay .
These formats meet the criteria.

9-51
plotyy

5 Type this command to plot the NFactor and K parameters of amp

on two y-axes:

plotyy(amp, 'NFactor', 'K')

Both NFactor and K have only a primary format,None, so plotyy

calls the plot command to create a plot with a single y-axis whose
format is None.

6 Type this command to plot the NTemp, S21 and NFactor parameters
of amp on two y-axes:

plotyy(amp, 'NTemp', 'S21', 'NFactor')

??? Error using ==> rfdata.data.plotyyprocess at 97

No format specified for input parameters and cannot reconcile
default formats. Try reducing the number of parameters to plotyy
and explicitly specifying formats.

9-52
 plotyy

The primary and secondary formats for S21 are Magnitude

(decibels) and Angle (Degrees), respectively. Both NTemp and
NFactor have only a primary format.
• Kelvin is the primary format for NTemp.
• None is the primary format for NFactor.
These parameters have no formats in common, so no formats meet
the criteria and plotyy issues an error message.

See Also analyze

calculate
extract
getz0
listformat
listparam
loglog
plot
polar
read
restore
semilogx
semilogy
smith
write

9-53
polar

Purpose Plot specified circuit object parameters on polar coordinates

Syntax lineseries = polar(h,'parameter1',...,'parametern')

lineseries = polar(h,'parameter1',...,'parametern', xparameter,
xformat,'condition1',value1,..., 'conditionm',valuem,
'freq',freq,'pin',pin)

Description lineseries = polar(h,'parameter1',...,'parametern') plots the

parameters parameter1,..., parametern from the object h on polar
coordinates. h is the handle of a circuit (rfckt) object.
polar returns a column vector of handles to lineseries objects,
one handle per line. This is the same as the output returned by the
MATLAB polar function.
Type listparam(h) to get a list of valid parameters for a circuit object h.

Note For all circuit objects except those that contain data from a data
file, you must use the analyze method to perform a frequency domain
analysis before calling polar.

Use the Property Editor (propertyeditor) or the MATLAB set

function to change the lineseries properties. The reference pages
for MATLAB functions such as figure, axes, and text list available
properties and provide links to more complete descriptions.

Note Use the MATLAB polar function to plot parameters that are not
part of a circuit (rfckt) object, but are specified as vector data.

lineseries = polar(h,'parameter1',...,'parametern',
xparameter,xformat,'condition1',value1,...,
'conditionm',valuem, 'freq',freq,'pin',pin) plots the
specified parameters at the specified operating conditions for the object
h.

9-54
 polar

xparameter is the independent variable to use in plotting the specified

parameters. Several xparameter values are available for all objects.
When you import rfckt.amplifier, rfckt.mixer, or rfdata.data
object specifications from a .p2d or .s2d file, you can also specify any
operating conditions from the file that have numeric values, such as
bias.
The following table shows the most commonly available parameters and
the corresponding xparameter values. The default settings listed in the
table are used if xparameter is not specified.

Parameter Name xparameter values

Pout, Phase, LS11, LS12, LS21, Pin (default), Freq
LS22
S11, S12, S21, S22, NF, OIP3, Freq
VSWRIn, VSWROut, GAMMAIn,
GAMMAOut, FMIN, GAMMAOPT, RN
AM/AM, AM/PM AM

xformat is the format to use for the specified xparameter. No xformat

specification is needed when xparameter is an operating condition.
The following table shows the xformat values that are available for the
xparameter values listed in the preceding table, along with the default
settings that are used if xformat is not specified.

xparameter values xformat values

Pin dBm (default), mW, W, dBW
Freq THz, GHz, MHz, KHz, Hz
By default, xformat is chosen to
provide the best scaling for the
given xparameter values.
AM Magnitude (decibels) (default),
Magnitude (linear)

9-55
polar

condition1,value1,..., conditionm,valuem are the optional

condition/value pairs at which to plot the specified parameters. These
pairs are usually operating conditions from a .p2d or .s2d file. For
some parameters, you can specify a set of frequency or input power
values at which to plot the specified parameter.
For example:

• When plotting large-signal S-parameters as a function of input power,

you can specify frequency points of interest using condition/value
pairs.
• When plotting large-signal S-parameters as a function of frequency,
you can specify input power levels of interest using condition/value
pairs.
• When plotting parameters as a function of an operating condition,
you can specify both frequency and input power values using
condition/value pairs.

freq is the optional frequency value, in hertz, at which to plot the

specified parameters.
pin is the optional input power value, in dBm, at which to plot the
specified parameters.
If h has multiple operating conditions, such as from a .p2d or .s2d file,
the polar method operates as follows:

• If you do not specify any operating conditions as arguments to the

polar method, then the method plots the parameter values based on
the currently selected operating condition.
• If you specify one or more operating conditions, the polar method
plots the parameter values based on those operating conditions.
• When you use an operating condition for the xparameter input
argument, the method plots the parameters for all operating
condition values.

9-56
 polar

See Also analyze

calculate
extract
getz0
listformat
listparam
loglog
plot
plotyy
read
restore
semilogx
semilogy
smith
write

9-57
read

Purpose Read RF data from file to new or existing circuit or data object

Syntax h = read(h)
h = read(h,filename)
h = read(rfckt.datafile,filename)
h = read(rfckt.passive,filename)
h = read(rfckt.amplifier,filename)
h = read(rfckt.mixer,filename)
h = read(rfdata.data,filename)

Description h = read(h) prompts you to select a file and then reads the data from
that file into the circuit or data object, h. You can read data from an
.snp, .ynp, .znp, .hnp, .gnp, or .amp file, where n is the number of
ports. If h is an rfckt.amplifier, rfckt.mixer, or rfdata.data object,
you can also read data from .p2d and .s2d files.
For more information on reading data from a file, see “Importing
Property Values from Data Files” on page 3-8. For a demonstration
of how to use RF Toolbox software to read data from a .s2d file, see
Visualizing Mixer Spurs. For information about the .amp format, see
Appendix A, “AMP File Format”.
h = read(h,filename) updates h with data from the specified file.
In this syntax, h can be a circuit or data object. filename is a string,
representing the filename of a .snp, .ynp, .znp, .hnp, .gnp, or .amp
file. If h is an rfckt.amplifier, rfckt.mixer, or rfdata.data object,
filename can also represent a .p2d or .s2d file. For all files, the
filename must include the file extension.
h = read(rfckt.datafile,filename) creates an rfckt.datafile
object h, reads the RF data from the specified file, and stores it in h.
h = read(rfckt.passive,filename) creates an rfckt.passive object
h, reads the RF data from the specified file, and stores it in h.
h = read(rfckt.amplifier,filename) creates an rfckt.amplifier
object h, reads the RF data from the specified file, and stores it in h.
h = read(rfckt.mixer,filename) creates an rfckt.mixer object h,
reads the RF data from the specified file, and stores it in h.

9-58
 read

h = read(rfdata.data,filename) creates an rfdata.data object h,

reads the RF data from the specified file, and stores it in h.

Examples The following example shows you how to import data from the file
default.amp into an rfckt.amplifier object.

ckt_obj=read(rfckt.amplifier, 'default.amp');

References EIA/IBIS Open Forum, “Touchstone File

Format Specification,” Rev. 1.1, 2002
(http://www.vhdl.org/pub/ibis/connector/touchstone_spec11.pdf).

See Also analyze

calculate
extract
getz0
listformat
listparam
loglog
plot
plotyy
polar
restore
semilogx
semilogy
smith
write

9-59
restore

Purpose Restore data to original frequencies

Syntax h = restore(h)

Description h = restore(h) restores data in h to the original frequencies

of NetworkData for plotting. Here, h can be rfckt.datafile,
rfckt.passive, rfckt.amplifier, or rfckt.mixer.

See Also analyze

calculate
extract
getz0
listformat
listparam
loglog
plot
plotyy
polar
semilogx
semilogy
smith
read
write

9-60
 semilogx

Purpose Plot specified circuit object parameters using log scale for x-axis

Syntax lineseries = semilogx(h,parameter)

lineseries = semilogx(h,parameter1,...,parametern)
lineseries = semilogx(h,parameter1,...,parametern,format)
lineseries = semilogx(h,'parameter1',...,'parametern', format,
xparameter,xformat,'condition1',value1,..., 'conditionm',
valuem, 'freq',freq,'pin',pin)

Description lineseries = semilogx(h,parameter) plots the specified parameter

in the default format using a logarithmic scale for the x-axis. h is the
handle of a circuit (rfckt) object.
Type listparam(h) to get a list of valid parameters for a circuit object,
h. Type listformat(h,parameter) to see the legitimate formats for
a specified parameter. The first listed format is the default for the
specified parameter.
The semilogx method returns a column vector of handles to lineseries
objects, one handle per line. This output is the same as the output
returned by the MATLAB semilogx function.
lineseries = semilogx(h,parameter1,...,parametern) plots the
parameters parameter1,..., parametern from the object h on an X-Y
plane using a logarithmic scale for the x-axis.
lineseries = semilogx(h,parameter1,...,parametern,format)
plots the parameters parameter1,..., parametern in the specified
format. format is the format of the data to be plotted, e.g.
'Magnitude (decibels)'.

Note For all circuit objects except those that contain data from a data
file, you must perform a frequency domain analysis with the analyze
method before calling semilogx.

Use the Property Editor (propertyeditor) or the MATLAB set

function to change lineseries properties. The reference pages for

9-61
semilogx

MATLAB functions such as figure, axes, and text also list available
properties and provide links to more complete property descriptions.

Note Use the MATLAB semilogx function to create a semi-log scale

plot of network parameters that are specified as vector data and are not
part of a circuit (rfckt) object or data (rfdata) object.

lineseries = semilogx(h,'parameter1',...,'parametern',
format,xparameter,xformat,'condition1',value1,...,
'conditionm',valuem, 'freq',freq,'pin',pin) plots the specified
parameters at the specified operating conditions for the object h.
xparameter is the independent variable to use in plotting the specified
parameters. Several xparameter values are available for all objects.
When you import rfckt.amplifier, rfckt.mixer, or rfdata.data
object specifications from a .p2d or .s2d file, you can also specify any
operating conditions from the file that have numeric values, such as
bias.
The following table shows the most commonly available parameters and
the corresponding xparameter values. The default settings listed in the
table are used if xparameter is not specified.

Parameter Name xparameter values

Pout, Phase, LS11, LS12, LS21, Pin (default), Freq
LS22
S11, S12, S21, S22, NF, IIP3, Freq
OIP3, GroupDelay, VSWRIn,
VSWROut, GAMMAIn, GAMMAOut,
FMIN, GAMMAOPT, RN, TF1, TF2,
Gt, Ga, Gp, Gmag, Gmsg, GammaMS,
GammaML, K, Delta, Mu, MuPrime
AM/AM, AM/PM AM

9-62
 semilogx

xformat is the format to use for the specified xparameter. No xformat

specification is needed when xparameter is an operating condition.
The following table shows the xformat values that are available for the
xparameter values listed in the preceding table, along with the default
settings that are used if xformat is not specified.

xparameter values xformat values

Pin dBm (default), mW, W, dBW
Freq THz, GHz, MHz, KHz, Hz
By default, xformat is chosen to
provide the best scaling for the
given xparameter values.
AM Magnitude (decibels) (default),
Magnitude (linear)

condition1,value1,..., conditionm,valuem are the optional

condition/value pairs at which to plot the specified parameters. These
pairs are usually operating conditions from a .p2d or .s2d file. For
some parameters, you can specify a set of frequency or input power
values at which to plot the specified parameter.
For example:

• When plotting large-signal S-parameters as a function of input power,

you can specify frequency points of interest using condition/value
pairs.
• When plotting large-signal S-parameters as a function of frequency,
you can specify input power levels of interest using condition/value
pairs.
• When plotting parameters as a function of an operating condition,
you can specify both frequency and input power values using
condition/value pairs.

9-63
semilogx

freq is the optional frequency value, in hertz, at which to plot the

specified parameters.
pin is the optional input power value, in dBm, at which to plot the
specified parameters.
If h has multiple operating conditions, such as from a .p2d or .s2d file,
the semilogx method operates as follows:

• If you do not specify any operating conditions as arguments to the

semilogx method, then the method plots the parameter values based
on the currently selected operating condition.
• If you specify one or more operating conditions, the semilogx method
plots the parameter values based on those operating conditions.
• When you use an operating condition for the xparameter input
argument, the method plots the parameters for all operating
condition values.

See Also analyze

calculate
extract
getz0
listformat
listparam
loglog
plot
plotyy
polar
read
restore
semilogy

9-64
 semilogx

smith
write

9-65
semilogy

Purpose Plot specified circuit object parameters using log scale for x-axis

Syntax lineseries = semilogy(h,parameter)

lineseries = semilogy(h,parameter1,...,parametern)
lineseries = semilogy(h,parameter1,...,parametern,format)
lineseries = semilogy(h,'parameter1',...,'parametern', format,
xparameter,xformat,'condition1',value1,..., 'conditionm',
valuem, 'freq',freq,'pin',pin)

Description lineseries = semilogy(h,parameter) plots the specified parameter

in the default format using a logarithmic scale for the y-axis. h is the
handle of a circuit (rfckt) object.
Type listparam(h) to get a list of valid parameters for a circuit object,
h. Type listformat(h,parameter) to see the legitimate formats for
a specified parameter. The first listed format is the default for the
specified parameter.
The semilogy method returns a column vector of handles to lineseries
objects, one handle per line. This output is the same as the output
returned by the MATLAB semilogy function.
lineseries = semilogy(h,parameter1,...,parametern) plots the
parameters parameter1,..., parametern from the object h on an X-Y
plane using a logarithmic scale for the y-axis.
lineseries = semilogy(h,parameter1,...,parametern,format)
plots the parameters parameter1,..., parametern in the specified
format. format is the format of the data to be plotted, e.g.
'Magnitude (decibels)'.

Note For all circuit objects except those that contain data from a data
file, you must perform a frequency domain analysis with the analyze
method before calling semilogy.

Use the Property Editor (propertyeditor) or the MATLAB set

function to change lineseries properties. The reference pages for

9-66
 semilogy

MATLAB functions such as figure, axes, and text also list available
properties and provide links to more complete property descriptions.

Note Use the MATLAB semilogy function to create a semi-log scale

plot of parameters that are specified as vector data and are not part of a
circuit (rfckt) object or data (rfdata) object.

lineseries = semilogy(h,'parameter1',...,'parametern',
format,xparameter,xformat,'condition1',value1,...,
'conditionm',valuem, 'freq',freq,'pin',pin) plots the specified
parameters at the specified operating conditions for the object h.
xparameter is the independent variable to use in plotting the specified
parameters. Several xparameter values are available for all objects.
When you import rfckt.amplifier, rfckt.mixer, or rfdata.data
object specifications from a .p2d or .s2d file, you can also specify any
operating conditions from the file that have numeric values, such as
bias.
The following table shows the most commonly available parameters and
the corresponding xparameter values. The default settings listed in the
table are used if xparameter is not specified.

Parameter Name xparameter values

Pout, Phase, LS11, LS12, LS21, Pin (default), Freq
LS22
S11, S12, S21, S22, NF, IIP3, Freq
OIP3, GroupDelay, VSWRIn,
VSWROut, GAMMAIn, GAMMAOut,
FMIN, GAMMAOPT, RN, TF1, TF2,
Gt, Ga, Gp, Gmag, Gmsg, GammaMS,
GammaML, K, Delta, Mu, MuPrime
AM/AM, AM/PM AM

9-67
semilogy

xformat is the format to use for the specified xparameter. No xformat

specification is needed when xparameter is an operating condition.
The following table shows the xformat values that are available for the
xparameter values listed in the preceding table, along with the default
settings that are used if xformat is not specified.

xparameter values xformat values

Pin dBm (default), mW, W, dBW
Freq THz, GHz, MHz, KHz, Hz
By default, xformat is chosen to
provide the best scaling for the
given xparameter values.
AM Magnitude (decibels) (default),
Magnitude (linear)

condition1,value1,..., conditionm,valuem are the optional

condition/value pairs at which to plot the specified parameters. These
pairs are usually operating conditions from a .p2d or .s2d file. For
some parameters, you can specify a set of frequency or input power
values at which to plot the specified parameter.
For example:

• When plotting large-signal S-parameters as a function of input power,

you can specify frequency points of interest using condition/value
pairs.
• When plotting large-signal S-parameters as a function of frequency,
you can specify input power levels of interest using condition/value
pairs.
• When plotting parameters as a function of an operating condition,
you can specify both frequency and input power values using
condition/value pairs.

9-68
 semilogy

freq is the optional frequency value, in hertz, at which to plot the

specified parameters.
pin is the optional input power value, in dBm, at which to plot the
specified parameters.
If h has multiple operating conditions, such as from a .p2d or .s2d file,
the semilogy method operates as follows:

• If you do not specify any operating conditions as arguments to the

semilogy method, then the method plots the parameter values based
on the currently selected operating condition.
• If you specify one or more operating conditions, the semilogy method
plots the parameter values based on those operating conditions.
• When you use an operating condition for the xparameter input
argument, the method plots the parameters for all operating
condition values.

See Also analyze

calculate
extract
getz0
listformat
listparam
loglog
plot
plotyy
polar
read
restore
semilogx

9-69
semilogy

smith
write

9-70
 setop

Purpose Set operating conditions

Syntax setop(h)
setop(h,'Condition1')
setop(h,'Condition1',value1,'Condition2',value2,...)

Description setop(h) lists the available values for all operating conditions of the
object h. Operating conditions only apply to objects you import from a
.p2d or .s2d file. To import these types of data into an object, use the
read method. Operating conditions are not listed with other properties
of an object.
setop(h,'Condition1') lists the available values for the specified
operating condition 'Condition1'.
setop(h,'Condition1',value1,'Condition2',value2,...) changes
the operating conditions of the circuit or data object, h, to those specified
by the condition/value pairs. Conditions you do not specify retain
their original values. The method ignores any conditions that are not
applicable to the specified object. Ignoring these conditions lets you
apply the same set of operating conditions to an entire network where
different conditions exist for different components.
When you set the operating conditions for a network that contains
several objects, the software does not issue an error or warning if
the specified conditions cannot be applied to all objects. For some
networks, this lack of error or warning lets you call the setop method
once to apply the same set of operating conditions to any objects where
operating conditions are applicable. However, you may want to specify
a network that contains one or more of the following:

• Several objects with different sets of operating conditions.

• Several objects with the same set of operating conditions that are
configured differently.

To specify operating conditions one of these types of networks, use a

separate call to the setop method for each object.

9-71
setop

Examples List the possible operating conditions of an object:

ckt1 = read(rfckt.amplifier, 'default.p2d');

setop(ckt1)

Analyze an object under specific operating conditions:

ckt1 = read(rfckt.amplifier, 'default.p2d');

freq = ckt1.AnalyzedResult.Freq;
setop(ckt1, 'Bias', '1.5');
result1 = analyze(ckt1, freq)

See Also getop

9-72
 smith

Purpose Plot specified circuit object parameters on Smith chart

Syntax [lineseries,hsm] = smith(h,parameter1,...,parametern,type)

[lineseries,hsm] = smith(h,'parameter1',...,'parametern', type,
xparameter,xformat,'condition1',value1,..., 'conditionm',
valuem, 'freq',freq,'pin',pin)

Description [lineseries,hsm] = smith(h,parameter1,...,parametern,type)

plots the network parameters parameter1,..., parametern from the
object h on a Smith chart. h is the handle of a circuit (rfckt) or data
(rfdata) object that contains n-port network parameter data. type is a
string that specifies the type of Smith chart:

• 'z' (default)
• 'y'
• 'zy'

Type listparam(h) to get a list of valid parameters for a circuit object h.

Note For all circuit objects except those that contain data from a data
file, you must use the analyze method to perform a frequency domain
analysis before calling smith.

[lineseries,hsm] = smith(h,'parameter1',...,'parametern',
type,xparameter,xformat,'condition1',value1,...,
'conditionm',valuem, 'freq',freq,'pin',pin) plots the specified
parameters at the specified operating conditions for the object h.
xparameter is the independent variable to use in plotting the
specified parameters. Several xparameter values are available for all
objects. When you import 2-port rfckt.amplifier, rfckt.mixer, or
rfdata.data object specifications from a .p2d or .s2d file, you can
also specify any operating conditions from the file that have numeric
values, such as bias.

9-73
smith

The following table shows the most commonly available parameters and
the corresponding xparameter values. The default settings listed in the
table are used if xparameter is not specified.

Parameter Name xparameter values

Pout, Phase, LS11, LS12, LS21, Pin (default), Freq
LS22
S11, S12, S21, S22, NF, IIP3, Freq
OIP3, VSWRIn, VSWROut, GAMMAIn,
GAMMAOut, FMIN, GAMMAOPT, RN
AM/AM, AM/PM AM

xformat is the format to use for the specified xparameter. No xformat

specification is needed when xparameter is an operating condition.
The following table shows the xformat values that are available for the
xparameter values listed in the preceding table, along with the default
settings that are used if xformat is not specified.

xparameter values xformat values

Pin dBm (default), mW, W, dBW
Freq THz, GHz, MHz, KHz, Hz
By default, xformat is chosen to
provide the best scaling for the
given xparameter values.
AM Magnitude (decibels) (default),
Magnitude (linear)

condition1,value1,..., conditionm,valuem are the optional

condition/value pairs at which to plot the specified parameters. These
pairs are usually operating conditions from a .p2d or .s2d file. For
some parameters, you can specify a set of frequency or input power
values at which to plot the specified parameter.
For example:

9-74
 smith

• When plotting large-signal S-parameters as a function of input power,

you can specify frequency points of interest using condition/value
pairs.
• When plotting large-signal S-parameters as a function of frequency,
you can specify input power levels of interest using condition/value
pairs.
• When plotting parameters as a function of an operating condition,
you can specify both frequency and input power values using
condition/value pairs.

freq is the optional frequency value, in hertz, at which to plot the

specified parameters.
pin is the optional input power value, in dBm, at which to plot the
specified parameters.
If h has multiple operating conditions, such as from a .p2d or .s2d file,
the smith method operates as follows:

• If you do not specify any operating conditions as arguments to the

smith method, then the method plots the parameter values based on
the currently selected operating condition.
• If you specify one or more operating conditions, the smith method
plots the parameter values based on those operating conditions.
• When you use an operating condition for the xparameter input
argument, the method plots the parameters for all operating
condition values.

Note Use the smithchart function to plot network parameters that

are not part of a circuit (rfckt) or data (rfdata) object, but are specified
as vector data.

9-75
smith

Changing Properties of the Plotted Lines

The smith method returns lineseries, a column vector of handles to
lineseries objects, one handle per plotted line. Use the MATLAB
lineseries properties function to change the properties of these
lines.

Changing Properties of the Smith Chart

The smith method returns the handle hsm of the Smith chart. Use the
properties listed below to change the properties of the chart itself.

Properties smith creates the plot using the default property values of a Smith
chart. Use set(hsm,'PropertyName1',PropertyValue1,...) to
change the property values of the chart. Use get(hsm) to get the
property values.
This table lists all properties you can specify for a Smith chart object
along with units, valid values, and a descriptions of their use.

Property Name Description Units, Values

Color Line color for a Z or ColorSpec. Default
Y Smith chart. For a is [0.4 0.4 0.4]
ZY Smith chart, the Z (dark gray).
line color.
LabelColor Color of the line ColorSpec. Default
labels. is [0 0 0] (black).
LabelSize Size of the line labels. FontSize. Default
is 10. See the
Annotation Textbox
Properties reference
page for more
information on
specifying font size.
LabelVisible Visibility of the line 'on' (default) or
labels. 'off'

9-76
 smith

Property Name Description Units, Values

LineType Line spec for a Z or LineSpec. Default is
Y Smith chart. For a '-' (solid line).
ZY Smith chart, the Z
line spec.
LineWidth Line width for a Z or Number of points.
Y Smith chart. For a Default is 0.5.
ZY Smith chart, the Z
line width.
SubColor The Y line color for a ColorSpec. Default
ZY Smith chart. is [0.8 0.8 0.8]
(medium gray).
SubLineType The Y line spec for a LineSpec. Default is
ZY Smith chart. ':' (dotted line).
SubLineWidth The Y line width for a Number of points.
ZY Smith chart. Default is 0.5.
Type Type of Smith chart. 'z' (default), 'y', or
'zy'
Value Two-row matrix. 2-by-n matrix.
Row 1 specifies the Default is [0.2000
values of the constant 0.5000 1.0000
resistance and 2.0000 5.0000;
reactance lines that 1.0000 2.0000
appear on the chart. 5.0000 5.0000
For the constant 30.0000]
resistance/reactance
lines, each element in
Row 2 specifies the
value of the constant
reactance/resistance
line at which the
corresponding line

9-77
smith

Property Name Description Units, Values

specified in Row 1
ends.

See Also analyze

calculate
circle
getz0
listformat
listparam
loglog
plot
plotyy
polar
read
restore
semilogx
semilogy
write

9-78
 stepresp

Purpose Calculate response of model object to step signal

Syntax [yout,tout] = stepresp(h, ts, n, trise)

Description [yout,tout] = stepresp(h, ts, n, trise) calculates the

time-domain response of a rational function object, h, to a step signal,
defined as:

⎧U (kts ) = kts / trise , 0 ≤ k < ( trise / ts )

⎨
⎩U (kts ) = 1, ( trise / ts ) ≤ k ≤ N
The variable ts is the sample time, ts; N is the number of samples, n;
and trise is the time, trise, that it takes for the step signal to reach
its maximum value. The variable k is an integer between 0 and N,
referring to the index of the samples.
The following figure illustrates the construction of this signal.

The output yout is the response of the step signal at time tout.

9-79
stepresp

Examples Calculate the step response of a rational function object:

% Read a .S2P data file

h = read(rfckt.passive, 'passive.s2p')
% Get the S11 parameters
S11 = h.AnalyzedResult.S_Parameters(1,1,:);
Freq = h.AnalyzedResult.Freq;
% Fit S11 to a rational function object
RationalModelS11 = rationalfit(Freq, S11);
% Define parameters for a step signal
Ts = 1.0e-11; N = 10000; Trise = 1.0e-10;
% Calculate the step response for TDR and plot it
[TDR, Time1] = stepresp(RationalModelS11, Ts, N, Trise);
figure(1)
plot(Time1*1e9, TDR);
ylabel('TDR'); xlabel('Time (ns)');
% Calculate TDT and plot it
S21 = h.AnalyzedResult.S_Parameters(2,1,:);
RationalModelS21 = rationalfit(Freq, S21);
[TDT, Time2] = stepresp(RationalModelS21, Ts, N, Trise);
figure(2)
plot(Time2*1e9, TDT);
ylabel('TDT'); xlabel('Time (ns)');

See Also freqresp

rationalfit
rfmodel.rational
timeresp

9-80
 table

Purpose Display specified RF object parameters in Variable Editor

Syntax table(h,param1,format1,..., paramn,formatn)

table(h,'budget',param1,format1,...,paramn,formatn)

Description table(h,param1,format1,..., paramn,formatn) displays the

specified parameters param1 through paramn, with units format1
through formatn, in the Variable Editor. The input h is a function
handle to an rfckt object.
The method creates a structure in the MATLAB workspace and
constructs the name of the structure from the names of the object and
parameters you provide. Specify parameters and formats in pairs. If
you do not specify a format, the method uses the default format for
that parameter.
To list valid parameters and parameter formats for h, use the listparam
and listformat methods.
table(h,'budget',param1,format1,...,paramn,formatn) specified
budget parameters of an rfckt.cascade object h.

Examples Analyze an RF cascade and display the link budget in a table:

% Construct a cascaded RFCKT object

Cascaded_Ckt = rfckt.cascade('Ckts', ...
{rfckt.txline('LineLength', .001), ...
rfckt.amplifier, rfckt.txline( ...
'LineLength', 0.025, 'PV', 2.0e8)})
% Do frequency domain analysis at the given frequency
freq = 2.1e9;
analyze(Cascaded_Ckt,freq);
% Plot the Budget S21 and NF
plot(Cascaded_Ckt, 'budget', 'S21', 'NF');
% Display the Budget S21 and NF in a table
table(Cascaded_Ckt, 'budget', 'S21', 'NF');

9-81
table

See Also openvar

plot

9-82
 timeresp

Purpose Calculate time response for model object

Syntax [y,t] = timeresp(h,u,ts)

Description [y,t] = timeresp(h,u,ts) computes the output signal, y, that the

rfmodel object, h, produces in response to the given input signal, u.
The input h is the handle of a model object. ts is a positive scalar value
that specifies the sample time of the input signal.
The output y is the output signal. RF Toolbox software computes
the value of the signal at the time samples in the vector t using the
following equation.

Y (n) = sum(C. * X (n − Delay / ts)) + D * U (n − Delay / ts)

where

X (n + 1) = F * X (n) + G * U (n)
X (1) = 0
F = exp( A * ts)
G = ( F − 1). / A
and A, C, D, and Delay are properties of the rfmodel.rational object, h.

Examples The following example shows you how to compute the time response of
the data stored in the file default.s2p by fitting a rational function
model to the data and using the timeresp method to compute the time
response of the model.

% Define the input signal

SampleTime = 2e-11;
OverSamplingFactor = 25;
TotalSampleNumber = 2^12;
InputTime = double((1:TotalSampleNumber)')*SampleTime;
InputSignal = sign(randn(1, ...
ceil(TotalSampleNumber/OverSamplingFactor)));
InputSignal = repmat(InputSignal, [OverSamplingFactor, 1]);

9-83
timeresp

InputSignal = InputSignal(:);

% Create a rational function model

orig_data=read(rfdata.data,'default.s2p');
freq=orig_data.Freq;
data=orig_data.S_Parameters(2,1,:);
fit_data=rationalfit(freq,data);

% Compute the time response

[y,t]=timeresp(fit_data,InputSignal,SampleTime);

See Also freqresp

rationalfit
rfmodel.rational
writeva

9-84
 write

Purpose Write RF data from circuit or data object to file

Syntax status = write(data,filename,dataformat,funit,printformat,

freqformat)

Description status =
write(data,filename,dataformat,funit,printformat,freqformat)
writes information from data to the specified file. data is a circuit
object or rfdata.data object that contains sufficient information to
write the specified file. filename is a string representing the filename
of a .snp, .ynp, .znp, .hnp, or .amp file, where n is the number of ports.
The default filename extension is .snp. See Appendix A, “AMP File
Format” for information about the .amp format. write returns True if
the operation is successful and returns False otherwise.
dataformat specifies the format of the data to be written. It must be
one of the case-insensitive strings in the following table.

Format Description
'DB' Data is given in (dB-magnitude, angle) pairs with
angle in degrees.
'MA' Data is given in (magnitude, angle) pairs with angle
in degrees.
'RI' Data is given in (real, imaginary) pairs (default).

funit specifies the frequency units of the data to be written. It must be

'GHz', 'MHz', 'KHz', or 'Hz'. If you do not specify funit, its value is
taken from the object data. All values are case-insensitive.
The printformat string that specifies the precision of the network and
noise parameters. The default value is %22.10f. This value means the
method writes the data using fixed-point notation with a precision of 10
digits. The minimum positive value the write method can express by
default is 1e-10. For greater precision, specify a different printformat.
See the Format String specification for fprintf.

9-85
write

The freqformat string that specifies the precision of the frequency.

The default value is %-22.10f. See the Format String specification
for fprintf.

Note The method only writes property values from data that the
specified output file supports. For example, Touchstone files, which
have the .snp, .ynp, .znp, or .hnp extension, do not support noise
figure or output third-order intercept point. Consequently, the write
method does not write these property values to these such files.

Examples The following example shows you how to analyze the data stored in the
file default.s2p for a different set of frequency values, and use the
write method to store the results in a file called test.s2p.

orig_data=read(rfdata.data,'default.s2p')
freq=[1:.1:2]*1e9;
analyze(orig_data,freq);
write(orig_data,'test.s2p');

References EIA/IBIS Open Forum, “Touchstone File

Format Specification,” Rev. 1.1, 2002
(http://www.vhdl.org/pub/ibis/connector/touchstone_spec11.pdf).

See Also analyze

calculate
extract
getz0
listformat
listparam
loglog

9-86
 write

plot
plotyy
polar
semilogx
semilogy
smith
read
restore

9-87
writeva

Purpose Write Verilog-A description of RF model object

Syntax status = writeva(h,filename,innets,outnets, ...

printformat,discipline,filestoinclude)

Description status = writeva(h,filename,innets,outnets,printformat,

discipline,filestoinclude) writes a Verilog-A module that
describes an rfmodel object h to the file specified by filename. The
method implements the object in Verilog-A using Laplace Transform
S-domain filters. It returns a status of True, if the operation is
successful, and False if it is unsuccessful.
h is the handle to the rfmodel.rational object. Typically, the
rationalfit function creates this object when you fit a rational
function to a set of data.
filename is a string representing the name of the Verilog-A file to
which to write the module. The filename can be specified with or
without a path name and extension. The default extension, .va, is
added automatically if filename does not end in this extension. The
module name that is used in the file is the part of the filename that
remains when the path name and extension are removed.
innets is a string or a cell of two strings that specifies the name of each
of the module’s input nets. The default is 'in'.
outnets is a string or a cell of two strings that specifies the name of
each of the module’s output nets. The default is 'out'.
printformat is a string that specifies the precision of the following
Verilog-A module parameters using the C language conversion
specifications:

• The numerator and denominator coefficients of the Verilog-A filter.

• The module’s delay value and constant offset (or direct feedthrough),
which are taken directly from the rfmodel object.

The default is '%15.10e'. For more information on how to specify

printformat, see the Format String specification for fprintf.

9-88
 writeva

discipline is a string that specifies the predefined Verilog-A discipline

of the nets. The discipline defines attributes and characteristics
associated with the nets. The default is 'electrical'.
filestoinclude is a cell of strings that specifies a list of header files
to include in the module using Verilog-A '`include' statements. By
default, filestoinclude is set to '`include discipline.vams'.
For more information on Verilog-A, see the Verilog-A Reference Manual.

See Also freqresp

rationalfit
rfmodel.rational
timeresp

9-89
writeva

9-90
 10

Function Reference

Calculations (p. 10-2) Calculate parameters of circuit

objects, model objects, and networks
Data Visualization (p. 10-3) Display circuit object parameters
Utilities (p. 10-3) Calculate intermediate results
Network Parameter Conversion Convert network parameters
(p. 10-3) between formats
GUI (p. 10-5) Open the RF Analysis Tool
 10 Function Reference

Calculations
cascadesparams Cascade S-parameters to form
cascaded network
deembedsparams De-embed 2-port S-parameters
gamma2z Convert reflection coefficient to
impedance
gammain Calculate input reflection coefficient
of 2-port network
gammaml Calculate load reflection coefficient
of 2-port network for simultaneous
conjugate match
gammams Calculate source reflection coefficient
of 2-port network required for
simultaneous conjugate match
ispassive Check passivity of N-port
S-parameters
makepassive Enforce passivity of S-parameters
powergain Calculate power gain of 2-port
network
rationalfit Fit rational function to broadband
data
s2tf Convert S-parameters of 2-port
network to voltage or power-wave
transfer function
stabilityk Calculate stability factor K of 2-port
network
stabilitymu Calculate stability factor μ of 2-port
network
vswr Calculate VSWR at given reflection
coefficient Γ
z2gamma Convert impedance to reflection
coefficient

10-2
 Data Visualization

Data Visualization
smithchart Plot complex vector on Smith chart

Utilities
copy Copy circuit or data object
getdata Data object containing analyzed
result of specified circuit object

Network Parameter Conversion

abcd2h Convert ABCD-parameters to hybrid
h-parameters
abcd2s Convert ABCD-parameters to
S-parameters
abcd2y Convert ABCD-parameters to
Y-parameters
h2abcd Convert hybrid h-parameters to
ABCD-parameters
h2g Convert hybrid h-parameters to
hybrid g-parameters
h2s Convert hybrid h-parameters to
S-parameters
h2y Convert hybrid h-parameters to
Y-parameters
h2z Convert hybrid h-parameters to
Z-parameters

10-3
 10 Function Reference

s2abcd Convert S-parameters to

ABCD-parameters
s2h Convert S-parameters to hybrid
h-parameters
s2s Convert S-parameters to
S-parameters with different
impedance
s2scc Convert 4-port, single-ended
S-parameters to 2-port,
common-mode S-parameters
(S)
s2scd Convert 4-port, single-ended
S-parameters to 2-port, cross-mode
S-parameters (S)
s2sdc Convert 4-port, single-ended
S-parameters to 2-port, cross-mode
S-parameters (S)
s2sdd Convert 4-port, single-ended
S-parameters to 2-port,
differential-mode S-parameters
(S)
s2smm Convert single-ended 4N-port
S-parameters to mixed-mode
2N-port S-parameters
s2t Convert S-parameters to
T-parameters
s2y Convert S-parameters to
Y-parameters
s2z Convert S-parameters to
Z-parameters
smm2s Convert mixed-mode 2N-port
S-parameters to single-ended
4N-port S-parameters

10-4
 GUI

snp2smp Convert single-ended N-port

S-parameters to single-ended M-port
S-parameters
t2s Convert T-parameters to
S-parameters
y2abcd Convert Y-parameters to
ABCD-parameters
y2h Convert Y-parameters to hybrid
h-parameters
y2s Convert Y-parameters to
S-parameters
y2z Convert Y-parameters to
Z-parameters
z2abcd Convert Z-parameters to
ABCD-parameters
z2h Convert Z-parameters to hybrid
h-parameters
z2s Convert Z-parameters to
S-parameters
z2y Convert Z-parameters to
Y-parameters

GUI
rftool Open RF Analysis Tool (RF Tool)

10-5
 10 Function Reference

10-6
 11

Functions — Alphabetical
List
abcd2h

Purpose Convert ABCD-parameters to hybrid h-parameters

Syntax h_params = abcd2h(abcd_params)

Description h_params = abcd2h(abcd_params) converts the ABCD-parameters

abcd_params into the hybrid parameters h_params. The abcd_params
input is a complex 2-by-2-by-M array, representing M 2-port
ABCD-parameters. h_params is a complex 2-by-2-by-M array,
representing M 2-port hybrid h-parameters.

Examples Convert ABCD-parameters to h-parameters:

%Define a matrix of ABCD-parameters.

A = 0.999884396265344 + 0.000129274757618717i;
B = 0.314079483671772 + 2.51935878310427i;
C = -6.56176712108866e-007 + 6.67455405306704e-006i;
D = 0.999806365547959 + 0.000247230611054075i;
abcd_params = [A,B; C,D];
%Convert to h-parameters
h_params = abcd2h(abcd_params);

See Also abcd2s | abcd2y | abcd2z | h2abcd | s2h | y2h | z2h

11-2
 abcd2s

Purpose Convert ABCD-parameters to S-parameters

Syntax s_params = abcd2s(abcd_params,z0)

Description s_params = abcd2s(abcd_params,z0) converts the ABCD-parameters

abcd_params into the scattering parameters s_params. The
abcd_params input is a complex 2-by-2-by-M array, representing M
2-port ABCD-parameters. z0 is the reference impedance; its default is
50 ohms. s_params is a complex 2-by-2-by-M array, representing M
2-port S-parameters.

Examples Convert ABCD-parameters to S-parameters:

%Define a matrix of ABCD-parameters.

A = 0.999884396265344 + 0.000129274757618717i;
B = 0.314079483671772 + 2.51935878310427i;
C = -6.56176712108866e-007 + 6.67455405306704e-006i;
D = 0.999806365547959 + 0.000247230611054075i;
abcd_params = [A,B; C,D];
%Convert to S-parameters
s_params = abcd2s(abcd_params);

See Also abcd2h | abcd2y | abcd2z | s2abcd | s2h | y2h | z2h

11-3
abcd2y

Purpose Convert ABCD-parameters to Y-parameters

Syntax y_params = abcd2y(abcd_params)

Description y_params = abcd2y(abcd_params) converts the ABCD-parameters

abcd_params into the admittance parameters y_params. The
abcd_params input is a complex 2-by-2-by-M array, representing M
2-port ABCD-parameters. y_params is a complex 2-by-2-by-M array,
representing M 2-port Y-parameters.

Examples Convert ABCD-parameters to Y-parameters:

%Define a matrix of ABCD-parameters.

A = 0.999884396265344 + 0.000129274757618717i;
B = 0.314079483671772 + 2.51935878310427i;
C = -6.56176712108866e-007 + 6.67455405306704e-006i;
D = 0.999806365547959 + 0.000247230611054075i;
abcd_params = [A,B; C,D];
%Convert to Y-parameters
y_params = abcd2y(abcd_params);

See Also abcd2h | abcd2s | abcd2z | h2y | s2y | y2abcd | z2y

11-4
 abcd2z

Purpose Convert ABCD-parameters to Z-parameters

Syntax z_params = abcd2z(abcd_params)

Description z_params = abcd2z(abcd_params) converts the ABCD-parameters

abcd_params into the impedance parameters z_params. The
abcd_params input is a complex 2-by-2-by-M array, representing M
2-port ABCD-parameters. z_params is a complex 2-by-2-by-M array,
representing M 2-port Z-parameters.

Examples Convert ABCD-parameters to Z-parameters:

%Define a matrix of ABCD-parameters.

A = 0.999884396265344 + 0.000129274757618717i;
B = 0.314079483671772 + 2.51935878310427i;
C = -6.56176712108866e-007 + 6.67455405306704e-006i;
D = 0.999806365547959 + 0.000247230611054075i;
abcd_params = [A,B; C,D];
%Convert to Z-parameters
z_params = abcd2z(abcd_params);

See Also abcd2h | abcd2s | abcd2y | h2y | y2abcd | z2abcd

11-5
cascadesparams

Purpose Cascade S-parameters to form cascaded network

Syntax s_params = cascadesparams(s1_params,s2_params,...,sn_params)

s_params = cascadesparams(s1_params,s2_params,...,sn_params,
Nconn)

Description s_params =
cascadesparams(s1_params,s2_params,...,sn_params) cascades the
scattering parameters of the N input networks described by the
S-parameters s1_params through sn_params. The function stores the
S-parameters of the cascade in s_params. Each of the input networks
must be a 2N-port network described by a 2N-by-2N-by-M array of
S-parameters. All networks must have the same reference impedance.
cascadesparams assumes that you are using the port ordering given in
the following illustration.

1 N+1

N 2N

Based on this ordering, the function connects ports N + 1 through 2N of

the first network to ports 1 through N of the second network. Therefore,
when you use this syntax:

• Each network has an even number of ports

• Every network in the cascade has the same number of ports.

To use this function for S-parameters with different port arrangements,

use the snp2smp function to reorder the port indices before cascading
the networks.
s_params =
cascadesparams(s1_params,s2_params,...,sn_params,Nconn)
cascades the scattering parameters of the N input networks described

11-6
 cascadesparams

by the S-parameters s1_params through sn_params. The function

creates a cascaded network based on the number of cascade
connections between networks, specified by Nconn. Nconn must be a
positive scalar or vector of size N – 1.

• If Nconn is a scalar, cascadesparams makes the same number of

connections between each pair of consecutive networks.
• If Nconn is a vector, the ith element of Nconn specifies the number of
connections between the ith and the i+1th networks.

cascadesparams always connects the last Nconn(i) ports of the ith

network and the first Nconn(i) ports of the i+1th network. The ports
of the entire cascaded network represent the unconnected ports of
each individual network, taken in order from the first network to the
nth network.
Additionally, when you specify Nconn:

• Each network can have either an even or odd number of ports.

• Every network in the cascade can have a different number of ports.

Examples Assemble a 2-port cascaded network from two sets of 2-port

S-parameters:
%Create two sets of 2-port S-parameters
ckt1 = read(rfckt.amplifier, 'default.s2p');
ckt2 = read(rfckt.passive, 'passive.s2p');
freq = [2e9 2.1e9];
analyze(ckt1, freq);
analyze(ckt2, freq);
sparams_2p_1 = ckt1.AnalyzedResult.S_Parameters;
sparams_2p_2 = ckt2.AnalyzedResult.S_Parameters;
%Cascade the S-parameters
sparams_cascaded_2p = ...
cascadesparams(sparams_2p_1, sparams_2p_2)

11-7
cascadesparams

Assemble a 3-port cascaded network from a set of 3-port S-parameters

and a set of 2-port S-parameters:
% Create one set of 3-port S-parameters
% and one set of 2-port S-parameters
ckt1 = read(rfckt.passive, 'default.s3p');
ckt2 = read(rfckt.amplifier, 'default.s2p');
freq = [2e9 2.1e9];
analyze(ckt1, freq);
analyze(ckt2, freq);
sparams_3p = ckt1.AnalyzedResult.S_Parameters;
sparams_2p = ckt2.AnalyzedResult.S_Parameters;
%Cascade the two sets by connecting one port between them
Nconn = 1
sparams_cascaded_3p = ...
cascadesparams(sparams_3p, sparams_2p, Nconn)

2
1 1 1 2 3
sparams_3p 3 sparams_2p

sparams_cascaded_3p

Assemble a 3-port cascaded network from a set of 3-port S-parameters

and a set of 2-port S-parameters, connecting the second port of the
3-port network to the first port of the 2-port network:

ckt1 = read(rfckt.passive, 'default.s3p');

ckt2 = read(rfckt.amplifier, 'default.s2p');
freq = [2e9 2.1e9];
analyze(ckt1, freq);
analyze(ckt2, freq);
sparams_3p = ckt1.AnalyzedResult.S_Parameters;

11-8
 cascadesparams

sparams_2p = ckt2.AnalyzedResult.S_Parameters;
%Reorder the second and third ports of the 3-port network
sparams_3p_2 = snp2smp(sparams_3p, 50, [1 3 2])
%Cascade the two sets by connecting one port between them
Nconn = 1
sparams_cascaded_3p_2 = cascadesparams(sparams_3p_2,...
sparams_2p, Nconn)

Assemble a 3-port cascaded network from a set of 3-port S-parameters

and two sets of 2-port S-parameters:

ckt1 = read(rfckt.passive, 'default.s3p');

ckt2 = read(rfckt.amplifier, 'default.s2p');
ckt3 = read(rfckt.passive, 'passive.s2p');
freq = [2e9 2.1e9];
analyze(ckt1, freq);
analyze(ckt2, freq);
analyze(ckt3, freq);
sparams_3p = ckt1.AnalyzedResult.S_Parameters;
sparams_2p_1 = ckt2.AnalyzedResult.S_Parameters;
sparams_2p_2 = ckt3.AnalyzedResult.S_Parameters;
%Connect one port between each set of adjacent networks
Nconn = [1 1]
sparams_cascaded_3p_3 = cascadesparams(sparams_3p,...
sparams_2p_1, sparams_2p_2, Nconn)

11-9
cascadesparams

2
1 1 1 2 1 sparams_2p_2 2 3
sparams_3p 3 sparams_2p_1

sparams_cascaded_3p

Assemble a 3-port cascaded network from a set of 3-port S-parameters

and two sets of 2-port S-parameters, connecting the 3-port network to
both 2-port networks:

ckt1 = read(rfckt.passive, 'default.s3p');

ckt2 = read(rfckt.amplifier, 'default.s2p');
ckt3 = read(rfckt.passive, 'passive.s2p');
freq = [2e9 2.1e9];
analyze(ckt1, freq);
analyze(ckt2, freq);
analyze(ckt3, freq);
sparams_3p = ckt1.AnalyzedResult.S_Parameters;
sparams_2p_1 = ckt2.AnalyzedResult.S_Parameters;
sparams_2p_2 = ckt3.AnalyzedResult.S_Parameters;
%Cascade sparams_3p and sparams_2p_1
%by connecting one port between them
Nconn = 1
sparams_cascaded_3p = cascadesparams(...
sparams_3p, ...
sparams_2p_1, ...
Nconn)
%Reorder the second and third ports of the 3-port network
sparams_cascaded_3p_3 = snp2smp(...
sparams_cascaded_3p, ...
50, ...

11-10
 cascadesparams

[1 3 2])
%Cascade sparams_3p and sparams_2p_2
%by connecting one port between them
sparams_cascaded_3p_4 = cascadesparams(...
sparams_cascaded_3p_3, ...
sparams_2p_2, ...
Nconn)

2 2 2

2
1 1 1 1 3 3 1 sparams_2p_2 2 3
sparams_3p 3 1 sparams_2p_1 2

sparams_cascaded_3p

sparams_cascaded_3p_3

sparams_cascaded_3p_4

See Also deembedsparams | rfckt.cascade | s2t | t2s

11-11
copy

Purpose Copy circuit or data object

Syntax h2 = copy(h)

Description h2 = copy(h) returns a copy of the circuit or data object h.

The syntax h2 = h copies only the object handle and does not create a
new object.

See Also analyze

11-12
 deembedsparams

Purpose De-embed 2-port S-parameters

Syntax s2_params = deembedsparams(s_params,s1_params,s3_params)

Description s2_params = deembedsparams(s_params,s1_params,s3_params)

derives the s2_params from the cascaded S-parameters s_params, by
removing the effects of s1_params, and s3_params. s2_params is a
2-by-2-by-Q array containing the de-embedded S-parameters. This
function is ideal for situations in which the S-parameters of a Device
Under Test (DUT) must be de-embedded from S-parameters obtained
through measurement.
The function assumes the configuration of the cascade shown in the
following illustration.

Each of the input networks is a 2-port network described by a

2-by-2-by-Q array of S-parameters. The function assumes that all
networks in the cascade have the same reference impedance.

See Also cascadesparams | rfckt.cascade

11-13
g2h

Purpose Convert hybrid g-parameters to hybrid h-parameters

Syntax h_params = g2h(g_params)

Description h_params = g2h(g_params) converts the hybrid g-parameters,

g_params, into the hybrid h-parameters, h_params. The g_params input
is a complex 2-by-2-by-M array, representing M 2-port g-parameters.
h_params is a complex 2-by-2-by-M array, representing M 2-port
h-parameters.

Examples Convert g-parameters to h-parameters:

%Define a matrix of g-parameters.

g_11 = -6.55389515512306e-007 + 6.67541048071651e-006i;
g_12 = -0.999823389146385 - 0.000246785162909241i;
g_21 = 1.00011560038266 - 0.000129304649930592i;
g_22 = 0.314441556185771 + 2.51960941000598i;
g_params = [g_11,g_12; g_21,g_22];
%Convert to h-parameters
h_params = g2h(g_params);

See Also h2g

11-14
 gamma2z

Purpose Convert reflection coefficient to impedance

Syntax z = gamma2z(gamma)
z = gamma2z(gamma,z0)

Description z = gamma2z(gamma) converts the reflection coefficient gamma to the

impedance z using a reference impedance Z0 of 50 ohms.
z = gamma2z(gamma,z0) converts the reflection coefficient gamma to
the impedance z by:

• Computing the normalized impedance.

• Multiplying the normalized impedance by the reference impedance
Z 0.

Algorithm The following equation shows this conversion:

⎛1+ Γ ⎞
Z = Z0 * ⎜ ⎟
⎝1− Γ ⎠

Examples Calculate impedance from given reference impedence and reflection

coefficient values:

z0 = 50;
gamma = 1/3;
z = gamma2z(gamma,z0)

See Also gammain | gammaout | z2gamma

11-15
gammain

Purpose Calculate input reflection coefficient of 2-port network

Syntax coefficient = gammain(s_params,z0,zl)

Description coefficient = gammain(s_params,z0,zl) calculates the input

reflection coefficient of a 2-port network. s_params is a complex
2-by-2-by-M array, representing M 2-port S-parameters. z0 is the
reference impedance Z0; its default value is 50 ohms. zl is the load
impedance Zl; its default value is also 50 ohms. coefficient is an
M-element complex vector.

Algorithm gammain uses the formula

( S12 S21 )Γ L
Γin = S11 +
1 − S22 Γ L

where

Zl − Z0
ΓL =
Zl + Z0

Examples Calculate the input reflection coefficients at each index of an

S-parameter array:

ckt = read(rfckt.amplifier, 'default.s2p');

s_params = ckt.NetworkData.Data;
z0 = ckt.NetworkData.Z0;
zl = 100;
coefficient = gammain(s_params,z0,zl);

See Also gamma2z | gammaml | gammams | gammaout | vswr

11-16
 gammaml

Purpose Calculate load reflection coefficient of 2-port network for simultaneous

conjugate match

Syntax coefficient = gammaml(s_params)

Description coefficient = gammaml(s_params) calculates the load reflection

coefficient of a 2-port network.
s_params is a complex 2-by-2-by-M array, representing M 2-port
S-parameters, Sij. coefficient is an M-element complex vector.

Algorithm The function calculates coefficient using the equation

B2 ± B22 − 4 C22
Γ ML =
2C2

where

B2 = 1 − S112 + S222 − Δ 2
*
C2 = S22 − Δ ⋅ S11
Δ = S11 S22 − S12 S21
Examples Calculate the load reflection coefficient using network data from a file:

ckt = read(rfckt.amplifier, 'default.s2p');

s_params = ckt.NetworkData.Data;
coefficient = gammaml(s_params);

See Also gammain | gammams | gammaout | stabilityk

11-17
gammams

Purpose Calculate source reflection coefficient of 2-port network required for

simultaneous conjugate match

Syntax coefficient = gammams(s_params)

Description coefficient = gammams(s_params) calculates the source reflection

coefficient of a 2-port network.
s_params is a complex 2-by-2-by-M array, representing M 2-port
S-parameters. coefficient is an M-element complex vector.

Algorithm The function calculates coefficient using the equation

B1 ± B12 − 4 C12
Γ MS =
2C1

where

B1 = 1 + S112 − S222 − Δ 2
*
C1 = S11 − Δ ⋅ S22
Δ = S11 S22 − S12 S21
Examples Calculate the source reflection coefficient using network data from a file:

ckt = read(rfckt.amplifier, 'default.s2p');

s_params = ckt.NetworkData.Data;
coefficient = gammams(s_params);

See Also gammain | gammaml | gammaout | stabilityk

11-18
 gammaout

Purpose Calculate output reflection coefficient of 2-port network

Syntax coefficient = gammaout(s_params,z0,zs)

Description coefficient = gammaout(s_params,z0,zs) calculates the output

reflection coefficient of a 2-port network.
s_params is a complex 2-by-2-by-M array, representing M 2-port
S-parameters. z0 is the reference impedance Z0; its default is 50 ohms.
zs is the source impedance Zs; its default is also 50 ohms. coefficient
is an M-element complex vector.

Algorithm The function calculates coefficient using the equation

S12 S21Γ S
Γ out = S22 +
1 − S11Γ S

where

Zs − Z0
ΓS =
Zs + Z0

Examples Calculate the output reflection coefficient using network data from a
file:

ckt = read(rfckt.amplifier, 'default.s2p');

s_params = ckt.NetworkData.Data;
z0 = ckt.NetworkData.Z0;
zs = 100;
coefficient = gammaout(s_params, z0, zs);

See Also gamma2z | gammain | gammaml | gammams | vswr

11-19
getdata

Purpose Data object containing analyzed result of specified circuit object

Syntax hd = getdata(h)

Description hd = getdata(h) returns a handle, hd, to the rfdata.data object

containing the analysis data, if any, for circuit (rfckt) object h. If there
is no analysis data, getdata displays an error message.

Note Before calling getdata, use the analyze function to perform a

frequency domain analysis for the circuit (rfckt) object. Perform this
action for all circuit objects except rfckt.amplifier, rfckt.datafile,
and rfckt.mixer. When you create an rfckt.amplifier,
rfckt.datafile, or rfckt.mixer object by reading data from a file, RF
Toolbox software automatically creates an rfdata.data object. RF
Toolbox stores data from the file as properties of the data object. You
can use the getdata function, without first calling analyze, to retrieve
the handle of the rfdata.data object.

11-20
 h2abcd

Purpose Convert hybrid h-parameters to ABCD-parameters

Syntax abcd_params = h2abcd(h_params)

Description abcd_params = h2abcd(h_params) converts the hybrid parameters

h_params into the ABCD-parameters abcd_params. The h_params
input is a complex 2-by-2-by-M array, representing M 2-port
hybrid h-parameters. abcd_params is a complex 2-by-2-by-M array,
representing M 2-port ABCD-parameters.

Examples Convert h-parameters to ABCD-parameters:

%Define a matrix of h-parameters.

h_11 = 0.314441556185771 + 2.51960941000598i;
h_12 = 0.999823389146385 - 0.000246785162909241i;
h_21 = -1.000115600382660 - 0.000129304649930592i;
h_22 = -6.55389515512306e-007 + 6.67541048071651e-006i;
h_params = [h_11,h_12; h_21,h_22];
%Convert to ABCD-parameters
abcd_params = h2abcd(h_params);

See Also abcd2h | h2s | h2y | h2z | s2abcd | y2abcd | z2abcd

11-21
h2g

Purpose Convert hybrid h-parameters to hybrid g-parameters

Syntax g_params = h2g(h_params,z0)

Description g_params = h2g(h_params,z0) converts the hybrid parameters

h_params into the hybrid g-parameters g_params. The h_params input
is a complex 2-by-2-by-M array, representing M 2-port h-parameters.
g_params is a complex 2-by-2-by-M array, representing M 2-port
g-parameters.

Examples Convert h-parameters to g-parameters:

%Define a matrix of h-parameters.

h_11 = 0.314441556185771 + 2.51960941000598i;
h_12 = 0.999823389146385 - 0.000246785162909241i;
h_21 = -1.000115600382660 - 0.000129304649930592i;
h_22 = -6.55389515512306e-007 + 6.67541048071651e-006i;
h_params = [h_11,h_12; h_21,h_22];
%Convert to g-parameters
g_params = h2g(h_params);

See Also g2h | h2abcd | h2s | h2y | h2z

11-22
 h2s

Purpose Convert hybrid h-parameters to S-parameters

Syntax s_params = h2s(h_params,z0)

Description s_params = h2s(h_params,z0) converts the hybrid parameters

h_params into the scattering parameters s_params. The h_params
input is a complex 2-by-2-by-M array, representing M 2-port hybrid
h-parameters. z0 is the reference impedance; its default is 50 ohms.
s_params is a complex 2-by-2-by-M array, representing M 2-port
S-parameters.

Examples Convert h-parameters to S-parameters:

%Define a matrix of h-parameters.

h_11 = 0.314441556185771 + 2.51960941000598i;
h_12 = 0.999823389146385 - 0.000246785162909241i;
h_21 = -1.000115600382660 - 0.000129304649930592i;
h_22 = -6.55389515512306e-007 + 6.67541048071651e-006i;
h_params = [h_11,h_12; h_21,h_22];
%Convert to S-parameters
s_params = h2s(h_params);

See Also abcd2s | h2abcd | h2y | h2z | y2s | z2s

11-23
h2y

Purpose Convert hybrid h-parameters to Y-parameters

Syntax y_params = h2y(h_params)

Description y_params = h2y(h_params) converts the hybrid parameters h_params

into the admittance parameters y_params. The h_params input is a
complex 2-by-2-by-M array, representing M 2-port hybrid h-parameters.
y_params is a complex 2-by-2-by-M array, representing M 2-port
Y-parameters.

Examples Convert h-parameters to Y-parameters:

%Define a matrix of h-parameters.

h_11 = 0.314441556185771 + 2.51960941000598i;
h_12 = 0.999823389146385 - 0.000246785162909241i;
h_21 = -1.000115600382660 - 0.000129304649930592i;
h_22 = -6.55389515512306e-007 + 6.67541048071651e-006i;
h_params = [h_11,h_12; h_21,h_22];
%Convert to Y-parameters
y_params = h2y(h_params);

See Also abcd2z | h2abcd | h2s | h2y | h2y | s2z | y2z | z2h

11-24
 h2z

Purpose Convert hybrid h-parameters to Z-parameters

Syntax z_params = h2z(h_params)

Description z_params = h2z(h_params) converts the hybrid parameters h_params

into the impedance parameters z_params. The h_params input is a
complex 2-by-2-by-M array, representing M 2-port hybrid h-parameters.
z_params is a complex 2-by-2-by-M array, representing M 2-port
Z-parameters.

Examples Convert h-parameters to Z-parameters:

%Define a matrix of h-parameters.

h_11 = 0.314441556185771 + 2.51960941000598i;
h_12 = 0.999823389146385 - 0.000246785162909241i;
h_21 = -1.000115600382660 - 0.000129304649930592i;
h_22 = -6.55389515512306e-007 + 6.67541048071651e-006i;
h_params = [h_11,h_12; h_21,h_22];
%Convert to Z-parameters
z_params = h2z(h_params);

See Also abcd2z | h2abcd | h2s | h2y | s2z | y2z | z2h

11-25
ispassive

Purpose Check passivity of N-port S-parameters

Syntax [flag, index_non_passive] = ispassive(s_params)

Description [flag, index_non_passive] = ispassive(s_params) checks the

passivity of sparams, an array of N-port S-parameters. If all the
S-parameters are passive, ispassive sets flag equal to 1 (true).
Otherwise, flag is equal to 0 (false). index_non_passive is a vector
of indices corresponding to the non-passive S-parameters in sparams.
If flag is true, index_non_passive is empty.

Examples Check the passivity of an S-parameters array; separate non-passive

S-parameters into a new array:

%Read a Touchstone data file

ckt = read(rfckt.passive, 'passive.s2p')
%Check the passivity
data = ckt.AnalyzedResult
[result, index] = ispassive(data.S_Parameters);
%Get the non-passive S-parameters
if ~(result)
AllNonPassiveSparams = data.S_Parameters(:,:,index);
FirstNonPassiveSparams = AllNonPassiveSparams(:,:,1)
end

See Also rationalfit | rfmodel.rational.ispassive | s2tf | snp2smp

11-26
 makepassive

Purpose Enforce passivity of S-parameters

Syntax sparams_passive = makepassive(sparams)

Description sparams_passive = makepassive(sparams) makes an array of

S-parameters passive. Both sparams and sparams_passive are
N-by-N-by-M arrays representing M N-port S-parameters.
The makepassive function enforces the following conditions on sparams:

S(− j ) = S* ( j )
S( j ) 2
≤1

The notation S 2 represents the 2-norm, or singular-value

decomposition, of S.

Input sparams
Arguments sparams can represent either an active network or a passive
network. To check if sparams is passive, use the ispassive
function.

Output sparams_passive
Arguments The makepassive function uses a purely mathematical
method to calculate sparams_passive. As a result, the array
sparams_passive does not represent the same network as
sparams. sparams and sparams_passive do not represent the
same network unless sparams and sparams_passive are equal.
The more closely sparams represents a passive network, the
better the approximation sparams_passive is to that network.
Therefore, makepassive generates the most realistic results when
sparams is active only due to small numerical errors.

Examples Enforce passivity of the S-parameters that represent a passive network:

ckt = read(rfckt.passive, 'passive.s2p');

11-27
makepassive

sparams = ckt.NetworkData.Data;
Is_Passive = ispassive(sparams)
sparams_new = makepassive(sparams);
Is_Passive = ispassive(sparams_new)
ckt.NetworkData.Data = sparams_new;

See Also ispassive

11-28
 powergain

Purpose Calculate power gain of 2-port network

Syntax g = powergain(s_params, z0, zs, zl, 'Gt')

g = powergain(s_params, z0, zs, 'Ga')
g = powergain(s_params, z0, zl, 'Gp')
g = powergain(s_params, type)

Description g = powergain(s_params, z0, zs, zl, 'Gt') calculates the

transducer power gain of a 2-port network. The input arguments are
as follows:

• s_params is a complex 2-by-2-by-m array, representing m 2-port

S-parameters.
• z0 is the reference impedance of the S-parameters. The default is
50 ohms.
• zs is the source impedance. The default is 50 ohms.
• zl is the load impedance. The default is 50 ohms.

g = powergain(s_params, z0, zs, 'Ga') calculates the available

power gain of a 2-port network.
g = powergain(s_params, z0, zl, 'Gp') calculates the operating
power gain of a 2-port network.
g = powergain(s_params, type) calculates one of two maximum gain
values, determined by the type argument:

• If type is 'Gmag', powergain calculates the maximum available

power gain.
• If type is 'Gmsg', powergain calculates the maximum stable gain.

The output g is a unitless power gain value. To obtain power gain in

decibels, use 10*log10(g).
If the specified type of power gain is undefined for one or more of the
specified S-parameter values in s_params, the powergain function

11-29
powergain

returns NaN. As a result, g is either NaN or a vector that contains one

or more NaN entries.

Examples Calculate power gains for a sample 2-port network:

s11 = 0.61*exp(j*165/180*pi);
s21 = 3.72*exp(j*59/180*pi);
s12 = 0.05*exp(j*42/180*pi);
s22 = 0.45*exp(j*(-48/180)*pi);
sparam = [s11 s12; s21 s22];
z0 = 50;
zs = 10 + j*20;
zl = 30 - j*40;
%Calculate the transducer power gain of the network
Gt = powergain(sparam, z0, zs, zl, 'Gt')
%Calculate the available power gain of the network
Ga = powergain(sparam, z0, zs, 'Ga')
%Calculate the operating power gain of the network
Gp = powergain(sparam, z0, zl, 'Gp')
%Calculate the maximum available power gain of the network
Gmag = powergain(sparam, 'Gmag')
%Calculate the maximum stable power gain of the network
Gmsg = powergain(sparam, 'Gmsg')

See Also s2tf

11-30
 rationalfit

Purpose Fit rational function to broadband data

Syntax h = rationalfit(freq,data)
h = rationalfit(freq,data,arguments)

Description h = rationalfit(freq,data) fits a rational function model of the form

n
C
F (s) = ∑ s − kA , s = j 2 f
k=1 k

to the complex vector of passive values in data over the frequency

values in the positive vector freq. The function returns a handle to the
rational function model object, h, with properties A, C, D, and Delay.
h = rationalfit(freq,data,arguments) fits a rational function

⎛ n Ck ⎞
F (s) = ⎜ ∑ + D ⎟ e− sτ , s = j 2πf
⎜ ⎟
⎝ k=1 s − Ak ⎠
to the data using optional arguments tol, weight, delayfactor,
tendstozero, npoles, iterationlimit, and showbar, which control
the data fitting.
To see how well the model fits the original data, use the freqresp
function to compute the frequency response of the model. Then, plot
the original data and the frequency response of the rational function
model. For more information, see the freqresp reference page or the
examples in the next section.

Input freq
Arguments freq is a vector of frequencies over which the function fits a
rational model.
data
data is a vector of passive S-parameter data values.
tol

11-31
rationalfit

tol is a scalar that specifies the relative error-fitting tolerance in

decibels. The error-fitting equation is

n
∑ F0 { fk } − F (s)
2

k=1
ε≥
n
∑ F0 { fk }
2

k=1
where

• ε is the specified value of tol.

• F0 is the value of the original data (data) at the specified
frequency fk (freq).
• F is the value of the rational function at s = j2πf.

rationalfit computes the relative error as a vector containing

the dependent values of the fit data. If the model does not fit the
original data within the specified tolerance, a warning message
appears.

Default: -10

weight
weight is a vector that specifies the weighting of the fit at each
frequency. You can increase the weight at a particular frequency
to improve the model fitting at that frequency. The length of
weight must be equal to the length of freq. The weight vector is
empty, by default.

Default: []

delayfactor
delayfactor is a scaling factor between 0 and 1 that controls the
amount of delay to fit the data. The Delay parameter, τ, of the

11-32
 rationalfit

rational function object is equal to delayfactor times the ratio of

the phase difference of the data across the specified frequencies to
the difference between the maximum and minimum frequencies.
A value of 0 prevents loss of fitting accuracy due to overestimation
of the delay. However, increasing delayfactor might allow
rationalfit to fit the data accurately with a lower-order model
(with fewer poles).

Default: 0

tendstozero
tendstozero is a logical value that determines the behavior of the
rational function as the frequency approaches infinity. When this
argument is true, the resulting rational function variable D is
zero. A value of 0 indicates that D is nonzero. A rational function
that tends to zero is appropriate for almost every set of data.
However, if rationalfit has trouble fitting the data to a rational
function, try changing the value of tendstozero.

Default: true

npoles
npoles is an even integer or a two-element vector [M,N] of even
integers.

• If npoles is an integer, it specifies the number of poles that

rationalfit uses to fit the rational function to the data.
• If npoles is a vector, it specifies a range of values of the number
of poles, k, to fit the data. rationalfit first tries to fit the data
using M poles. If the fit error using M poles is greater than tol,
rationalfit increases the number of poles in the fit until the
error is less than tol or the number of poles reaches N.

11-33
rationalfit

Specify a value of npoles greater than or equal to twice the

number of observable peaks on a plot of the data in the frequency
domain.

Default: [0,min(256,length(freq)/4)]

iterationlimit
Control the number of iterations that rationalfit performs
for each value of npoles by specifying an integer value for
iterationlimit.

Default: 12

showbar
Set this parameter to true to show the graphical wait bar while
rationalfit computes a rational function fit. Set this parameter
to false to hide the wait bar.

Default: false

Examples Fit a rational function model to passive data, plot, and compare results:

orig_data = read(rfdata.data,'passive.s2p')
freq = orig_data.Freq;
data = orig_data.S_Parameters(1,1,:);
fit_data = rationalfit(freq,data)
[resp,freq] = freqresp(fit_data,freq);

plot(orig_data,'S11','dB');
hold on
plot(freq/1e9,db(resp));

figure

plot(orig_data,'S11','Angle (radians)');
hold on

11-34
 rationalfit

plot(freq/1e9,unwrap(angle(resp)));

References B. Gustavsen and A. Semlyen, “Rational approximation of frequency

domain responses by vector fitting,” IEEE Trans. Power Delivery,
Vol. 14, No. 3, pp. 1052–1061, July 1999.
R. Zeng and J. Sinsky, “Modified Rational Function Modeling Technique
for High Speed Circuits,” IEEE MTT-S Int. Microwave Symp. Dig., San
Francisco, CA, June 11–16, 2006.

See Also freqresp | rfmodel.rational | s2tf | timeresp | writeva

11-35
rftool

Purpose Open RF Analysis Tool (RF Tool)

Syntax rftool

Description rftool = opens the RF Tool interface.

rftool opens the RF Tool interface. Use this tool to:

• Create circuit components and set their parameters.

• Analyze components over a specified frequency range and step size.
• Plot the analysis results.
• Import component objects to and export them from the MATLAB
workspace.
• Save RF Tool sessions for later use.

For more information see Chapter 5, “RF Tool: An RF Analysis GUI” .

The following figure shows the RF Tool in its default state.

11-36
rftool

11-37
s2abcd

Purpose Convert S-parameters to ABCD-parameters

Syntax abcd_params = s2abcd(s_params,z0)

Description abcd_params = s2abcd(s_params,z0) converts the scattering

parameters s_params into the ABCD-parameters abcd_params. The
s_params input is a complex 2-by-2-by-M array, representing M2-port
S-parameters. z0 is the reference impedance; its default is 50 ohms.
abcd_params is a complex 2-by-2-by-M array, representing M 2-port
ABCD-parameters.

Examples Convert S-parameters to ABCD-parameters:

%Define a matrix of S-parameters

s_11 = 0.61*exp(j*165/180*pi);
s_21 = 3.72*exp(j*59/180*pi);
s_12 = 0.05*exp(j*42/180*pi);
s_22 = 0.45*exp(j*(-48/180)*pi);
s_params = [s11 s12; s21 s22];
z0 = 50;
%Convert to ABCD-parameters
abcd_params = s2abcd(s_params, z0)

See Also abcd2s | h2abcd | s2h | s2y | s2z | y2abcd | z2abcd

11-38
 s2h

Purpose Convert S-parameters to hybrid h-parameters

Syntax h_params = s2h(s_params,z0)

Description h_params = s2h(s_params,z0) converts the scattering parameters

s_params into the hybrid parameters h_params. The s_params input is
a complex 2-by-2-by-M array, representing M 2-port S-parameters. z0 is
the reference impedance; its default is 50 ohms. h_params is a complex
2-by-2-by-M array, representing M 2-port hybrid h-parameters.

Examples Convert S-parameters to h-parameters:

%Define a matrix of S-parameters

s_11 = 0.61*exp(j*165/180*pi);
s_21 = 3.72*exp(j*59/180*pi);
s_12 = 0.05*exp(j*42/180*pi);
s_22 = 0.45*exp(j*(-48/180)*pi);
s_params = [s11 s12; s21 s22];
z0 = 50;
%Convert to h-parameters
h_params = s2h(s_params, z0)

See Also h2s

11-39
s2s

Purpose Convert S-parameters to S-parameters with different impedance

Syntax s_params_new = s2s(s_params,z0)

s_params_new = s2s(s_params,z0,z0_new)

Description s_params_new = s2s(s_params,z0) converts the scattering

parameters s_params with reference impedance z0 into the scattering
parameters s_params_new with a default reference impedance of 50
ohms. Both s_params and s_params_new are complex N-by-N-by-M
arrays, representing M N-port S-parameters.
s_params_new = s2s(s_params,z0,z0_new) converts the scattering
parameters s_params with reference impedance z0 into the scattering
parameters s_params_new with reference impedance z0_new.

Examples Convert S-parameters from one reference impedance to another

reference impedance:

%Define a matrix of S-parameters

s_11 = 0.61*exp(j*165/180*pi);
s_21 = 3.72*exp(j*59/180*pi);
s_12 = 0.05*exp(j*42/180*pi);
s_22 = 0.45*exp(j*(-48/180)*pi);
s_params = [s11 s12; s21 s22];
z0 = 50;
z0_new = 40;
%Convert to new reference impedance
s_params_new = s2s(s_params, z0, z0_new)

See Also abcd2s | h2s | s2abcd | s2h | s2y | s2z | y2s | z2s

11-40
 s2scc

Purpose Convert 4-port, single-ended S-parameters to 2-port, common-mode

S-parameters (Scc)

Syntax scc_params = s2scc(s_params,option)

Description scc_params = s2scc(s_params,option) converts the 4-port,

single-ended S-parameters, s_params, to 2-port, common-mode
S-parameters, scc_params. scc_params is a complex 2-by-2-by-M array
that represents M 2-port S-parameters. The optional option argument
indicates the port-numbering convention that the S-parameters use.

Input s_params
Arguments s_params is a complex 4-by-4-by-M array that represents M 4-port
S-parameters.
option
option is an integer equal to 1, 2, or 3. The value of option
determines how the function orders the ports:

• 1 — Single-ended ports 1 and 3 pair together to become

common-mode port 1. Ports 2 and 4 become common-mode
port 2.

• 2— Ports 1 and 2 become common-mode port 1. Ports 3 and 4

become common-mode port 2.

11-41
s2scc

• 3 — Ports 1 and 2 become common-mode port 1. Ports 4 and 3

become common-mode port 2.

Default: 1

Examples Convert network data to common-mode S-parameters using the default

port ordering:

ckt = read(rfckt.passive, 'default.s4p');

s4p = ckt.NetworkData.Data;
s_cc = s2scc(s4p);

References Fan, W., A. C. W. Lu, L. L. Wai, and B. K. Lok. “Mixed-Mode

S-Parameter Characterization of Differential Structures.” Electronic
Packaging Technology Conference, pp. 533–537, 2003.

See Also s2scd | s2sdc | s2sdd | s2smm | smm2s

11-42
 s2scd

Purpose Convert 4-port, single-ended S-parameters to 2-port, cross-mode

S-parameters (Scd)

Syntax scd_params = s2scd(s_params,option)

Description scd_params = s2scd(s_params,option) converts the 4-port,

single-ended S-parameters, s_params, to 2-port, cross-mode
S-parameters, scd_params. scd_params is a complex 2-by-2-by-M array
that represents M 2-port cross-mode S-parameters (Scd). The optional
option argument indicates the port numbering convention that the
S-parameters use.

Input s_params
Arguments s_params is a complex 4-by-4-by-M array that represents M 4-port
S-parameters.
option
option is an integer equal to 1, 2, or 3. The value of option
determines how the function orders the ports:

• 1 — Single-ended ports 1 and 3 pair together to become

cross-mode port 1. Ports 2 and 4 become cross-mode port 2.

• 2 — Ports 1 and 2 become cross-mode port 1. Ports 3 and 4

become cross-mode port 2.

11-43
s2scd

• 3 — Ports 1 and 2 become cross-mode port 1. Ports 4 and 3

become cross-mode port 2.

Default: 1

Examples Convert network data to cross-mode S-parameters using the default

port ordering:

ckt = read(rfckt.passive, 'default.s4p');

s4p = ckt.NetworkData.Data;
s_cd = s2scd(s4p);

References Fan, W., A. C. W. Lu, L. L. Wai, and B. K. Lok. “Mixed-Mode

S-Parameter Characterization of Differential Structures.” Electronic
Packaging Technology Conference, pp. 533–537, 2003.

See Also s2scc | s2sdc | s2sdd | s2smm | smm2s

11-44
 s2sdc

Purpose Convert 4-port, single-ended S-parameters to 2-port, cross-mode

S-parameters (Sdc)

Syntax sdc_params = s2sdc(s_params,option)

Description sdc_params = s2sdc(s_params,option) converts the 4-port,

single-ended S-parameters, s_params, to 2-port, cross-mode
S-parameters, sdc_params. sdc_params is a complex 2-by-2-by-M array
that represents M 2-port cross-mode S-parameters (Sdc). The optional
option argument indicates the port numbering convention that the
S-parameters use.

Input s_params
Arguments s_params is a complex 4-by-4-by-M array that represents M 4-port
S-parameters.
option
option is an integer equal to 1, 2, or 3. The value of option
determines how the function orders the ports:

• 1 — Single-ended ports 1 and 3 pair together to become

cross-mode port 1. Ports 2 and 4 become cross-mode port 2.

• 2 — Ports 1 and 2 become cross-mode port 1. Ports 3 and 4

become cross-mode port 2.

11-45
s2sdc

• 3 — Ports 1 and 2 become cross-mode port 1. Ports 4 and 3

become cross-mode port 2.

Default: 1

Examples Convert network data to cross-mode S-parameters using the default

port ordering:

ckt = read(rfckt.passive, 'default.s4p');

s4p = ckt.NetworkData.Data;
s_dc = s2sdc(s4p);

References Fan, W., A. C. W. Lu, L. L. Wai, and B. K. Lok. “Mixed-Mode

S-Parameter Characterization of Differential Structures.” Electronic
Packaging Technology Conference, pp. 533–537, 2003.

See Also s2scc | s2scd | s2sdd | s2smm | smm2s

11-46
 s2sdd

Purpose Convert 4-port, single-ended S-parameters to 2-port, differential-mode

S-parameters (Sdd)

Syntax sdd_params = s2sdd(s_params, option)

Description sdd_params = s2sdd(s_params, option) converts the 4-port,

single-ended S-parameters, s_params, to 2-port, differential-mode
S-parameters, sdd_params. sdd_params is a complex 2-by-2-by-M array
that represents M 2-port differential-mode S-parameters. The optional
option argument indicates the port numbering convention that the
S-parameters use.

Input s_params
Arguments s_params is a complex 4-by-4-by-M array that represents M 4-port
S-parameters.
option
option is an integer equal to 1, 2, or 3. The value of option
determines how the function orders the ports:

• 1 — Single-ended ports 1 and 3 pair together to become

differential-mode port 1. Ports 2 and 4 become differential-mode
port 2.

• 2 — Ports 1 and 2 become differential-mode port 1. Ports 3 and

4 become differential-mode port 2.

11-47
s2sdd

• 3 — Ports 1 and 2 become differential-mode port 1. Ports 4 and

3 become differential-mode port 2.

Default: 1

Examples Convert network data to differential-mode S-parameters using the

default port ordering:

ckt = read(rfckt.passive, 'default.s4p');

s4p = ckt.NetworkData.Data;
s_dd = s2sdd(s4p);

References Fan, W., A. C. W. Lu, L. L. Wai, and B. K. Lok. “Mixed-Mode

S-Parameter Characterization of Differential Structures.” Electronic
Packaging Technology Conference, pp. 533–537, 2003.

See Also s2scc | s2scd | s2sdc | s2smm | smm2s

11-48
 s2smm

Purpose Convert single-ended 4N-port S-parameters to mixed-mode 2N-port

S-parameters

Syntax [s_cc, s_cd, s_dc, s_dd] = s2smm(s_params)

[s_cc, s_cd, s_dc, s_dd] = s2smm(s_params, option)

Description [s_cc, s_cd, s_dc, s_dd] = s2smm(s_params) converts

single-ended, 4N-port S-parameters, s_params, into mixed-mode,
2N-port S-parameters. s2smm forms the mixed-mode ports by grouping
the single-ended ports in pairs by port number, grouping odd-numbered
ports first, followed by even-numbered ports.
[s_cc, s_cd, s_dc, s_dd] = s2smm(s_params, option) converts
the S-parameter data according the port-numbering convention
specified by option. You can also reorder the ports in s_params using
the snp2smp function.

Input s_params
Arguments s_params is a complex 4N-by-4N-by-K array representing K
single-ended, 4N-port S-parameters.
option
option is an integer equal to 1, 2, or 3. The value of option
determines how the function orders the ports:

• 1 — s2smm pairs the odd-numbered ports together first, followed

by the even-numbered ports. For example, in a single-ended,
8-port network:
- Ports 1 and 3 become mixed-mode port 1.
- Ports 5 and 7 become mixed-mode port 2.
- Ports 2 and 4 become mixed-mode port 3.
- Ports 6 and 8 become mixed-mode port 4.

11-49
s2smm

• 2 — s2smm pairs the input and output ports in ascending order.

For example, in a single-ended, 8-port network:
- Ports 1 and 2 become mixed-mode port 1.
- Ports 3 and 4 become mixed-mode port 2.
- Ports 5 and 6 become mixed-mode port 3.
- Ports 7 and 8 become mixed-mode port 4.

• 3 — s2smm pairs the input ports in ascending order and

the output ports in descending order. For example, in a
single-ended, 8-port network:
- Ports 1 and 2 become mixed-mode port 1.
- Ports 3 and 4 become mixed-mode port 2.
- Ports 8 and 7 become mixed-mode port 3.
- Ports 6 and 5 become mixed-mode port 4.

11-50
 s2smm

Default: 1

Output s_cc
Arguments s_cc is a complex 2N-by-2N-by-K array containing K matrices of
common-mode, 2N-port S-parameters (Scc).
s_cd
s_cd is a complex 2N-by-2N-by-K array containing K matrices of
cross-mode, 2N-port S-parameters (Scd).
s_dc
s_dc is a complex 2N-by-2N-by-K array containing K matrices of
cross-mode, 2N-port S-parameters (Sdc).
s_dd
s_dd is a complex 2N-by-2N-by-K array containing K matrices of
differential-mode, 2N-port S-parameters (Sdd).

Examples Convert 4-port S-parameters s4p to 2-port mixed-mode S-parameters:

ckt = read(rfckt.passive, 'default.s4p');

s4p = ckt.NetworkData.Data;
[s_cc, s_cd, s_dc, s_dd] = s2smm(s4p);

References Granberg, T., Handbook of Digital Techniques for High-Speed

Design.Upper Saddle River, NJ: Prentice Hall, 2004.

11-51
s2smm

See Also s2scc | s2scd | s2sdc | s2sdd | smm2s | snp2smp

11-52
 s2t

Purpose Convert S-parameters to T-parameters

Syntax t_params = s2t(s_params)

Description t_params = s2t(s_params) converts the scattering parameters

s_params into the chain scattering parameters t_params. The
s_params input is a complex 2-by-2-by-M array, representing M 2-port
S-parameters. t_params is a complex 2-by-2-by-M array, representing
M 2-port T-parameters.
This function uses the following definition for T-parameters:

⎡ a1 ⎤ ⎡ T11 T12 ⎤ ⎡ b2 ⎤
⎢ b ⎥ = ⎢T T22 ⎥⎦ ⎢⎣ a2 ⎥⎦
,
⎣ 1 ⎦ ⎣ 21
where:

• a1 is the incident wave at the first port.

• b1 is the reflected wave at the first port.
• a2 is the incident wave at the second port.
• b2 is the reflected wave at the second port.

Examples Convert S-parameters to T-parameters:

%Define a matrix of S-parameters

s11 = 0.61*exp(j*165/180*pi);
s21 = 3.72*exp(j*59/180*pi);
s12 = 0.05*exp(j*42/180*pi);
s22 = 0.45*exp(j*(-48/180)*pi);
s_params = [s11 s12; s21 s22];
%Convert to T-parameters
t_params = s2t(s_params)

References Gonzalez, Guillermo, Microwave Transistor Amplifiers: Analysis and

Design, 2nd edition. Prentice-Hall, 1997, p. 25.

11-53
s2t

See Also s2abcd | s2h | s2y | s2z | t2s

11-54
 s2tf

Purpose Convert S-parameters of 2-port network to voltage or power-wave

transfer function

Syntax tf = s2tf(s_params)
tf = s2tf(s_params, z0, zs, zl)
tf = s2tf(s_params, z0, zs, zl, option)

Description tf = s2tf(s_params) converts the scattering parameters, s_params,

of a 2-port network into the voltage transfer function of the network.
tf = s2tf(s_params, z0, zs, zl) calculates the voltage transfer
function using the reference impedance z0, source impedance zs, and
load impedance zl.
tf = s2tf(s_params, z0, zs, zl, option) calculates the voltage or
power-wave transfer function using the method specified by option.

Algorithm The following figure shows the setup for computing the transfer
function, along with the impedences, voltages, and the power waves
used to determine the gain.

The function uses the following voltages and power waves for
calculations:

• Vl is the output voltage across the load impedance.

• Vs is the source voltage.
• Vin is the input voltage of the 2-port network.

11-55
s2tf

Vs
• a p1 is the incident power wave, equal to .
2 Re( Zs )

Re( Zl )
• bp2 is the transmitted power wave, equal to Vl .
Zl
Input s_params
Arguments s_params is a complex 2-by-2-by-M array that represents M 2-port
S-parameters.
z0
z0 is the reference impedance, in ohms, of the S-parameters.

Default: 50

zs
zs is the source impedance, in ohms, of the S-parameters.

Default: 50

zl
zl is the load impedance, in ohms, of the S-parameters.

Default: 50

option
The optional option argument is an integer equal to 1, 2, or 3.
The value of option specifies the transfer function type:

• 1 — The transfer function is the gain from the incident

voltage, Va, to the output voltage for arbitrary source and load
impedances:

11-56
 s2tf

Vl
tf =
Va
The following figure shows how to compute Va from the source
voltage Vs:

IFor the S-parameters and impedance values, the transfer

function is:

( Zs + Zs* ) S21 (1 + Γ l ) (1 − Γ s )
tf =
Zs* 2 (1 − S22 Γ l ) (1 − Γin Γ s )
where:

Zl − Zo
Γl =
Zl + Zo
Zs − Zo
Γs =
Zs + Zo
⎛ Γl ⎞
Γin = S11 + ⎜ S12 S21 ⎟
⎜ (1 − S22Γ l ) ⎠⎟
⎝

The following equation shows how the preceding transfer

function is related to the transducer gain computed by the
powergain function:

2
2 Re( Zl ) Zs
GT = tf 2
Zl Re( Zs )

11-57
s2tf

Zs 2
Notice that if Zl and ZS are real, GT = tf .
Zl
• 2 — The transfer function is the gain from the source voltage to
the output voltage for arbitrary source and load impedances:

Vl S21 (1 + Γ l ) (1 − Γ s )
tf = =
Vs 2 (1 − S22 Γ l ) (1 − Γin Γ s )

VL
You can use this option to compute the transfer function V
by setting zs to 0. This setting means that Γs = –1 and Vin =inVs.
• 3 — The transfer function is the power-wave gain from the
incident power wave at the first port to the transmitted power
wave at the second port:

bp2 Re( Zl ) Re( Zs ) S21 (1 + Γ l )(1 − Γ s )

tf = =
a p1 Zl (1 − S22 Γ l )(1 − Γin Γ s )

Default: 1

Examples Calculate the voltage transfer function of an S-parameter array:

ckt = read(rfckt.passive, 'passive.s2p');

sparams = ckt.NetworkData.Data;
tf = s2tf(sparams)

See Also powergain | rationalfit | s2scc | s2scd | s2sdc | s2sdd | snp2smp

11-58
 s2y

Purpose Convert S-parameters to Y-parameters

Syntax y_params = s2y(s_params,z0)

Description y_params = s2y(s_params,z0) converts the scattering parameters

s_params into the admittance parameters y_params. The s_params
input is a complex N-by-N-by-M array, representing M N-port
S-parameters. z0 is the reference impedance; its default is 50 ohms.
y_params is a complex N-by-N-by-M array, representing M N-port
Y-parameters.

Examples Convert S-parameters to Y-parameters:

%Define a matrix of S-parameters

s_11 = 0.61*exp(j*165/180*pi);
s_21 = 3.72*exp(j*59/180*pi);
s_12 = 0.05*exp(j*42/180*pi);
s_22 = 0.45*exp(j*(-48/180)*pi);
s_params = [s11 s12; s21 s22];
z0 = 50;
%Convert to Y-parameters
y_params = s2y(s_params, z0)

See Also abcd2y | h2y | s2abcd | s2h | s2z | y2s | z2y

11-59
s2z

Purpose Convert S-parameters to Z-parameters

Syntax z_params = s2z(s_params,z0)

Description z_params = s2z(s_params,z0) converts the scattering parameters

s_params into the impedance parameters z_params. The s_params
input is a complex N-by-N-by-M array, representing M N-port
S-parameters. z0 is the reference impedance; its default is 50 ohms.
z_params is a complex N-by-N-by-M array, representing M N-port
Z-parameters.

Examples Convert S-parameters to Z-parameters:

%Define a matrix of S-parameters

s_11 = 0.61*exp(j*165/180*pi);
s_21 = 3.72*exp(j*59/180*pi);
s_12 = 0.05*exp(j*42/180*pi);
s_22 = 0.45*exp(j*(-48/180)*pi);
s_params = [s11 s12; s21 s22];
z0 = 50;
%Convert to Z-parameters
z_params = s2z(s_params, z0)

See Also abcd2z | h2z | s2abcd | s2h | s2y | y2z | z2s

11-60
 smithchart

Purpose Plot complex vector on Smith chart

Syntax [lineseries,hsm] = smithchart(y)

hsm = smithchart

Description [lineseries,hsm] = smithchart(y) plots the complex vector y on a

Smith chart. hsm is the handle of the Smith chart object. lineseries
is a column vector of handles to lineseries objects, one handle per
plotted line.
To plot network parameters from a circuit (rfckt) or data (rfdata)
object on a Smith chart, use the smith function.
hsm = smithchart draws a blank Smith chart and returns the handle,
hsm, of the Smith chart object.

Output lineseries
Arguments You change the properties of the plotted lines by changing the
lineseries properties.
hsm
hsm = smithchart creates the plot using
default property values of a Smith chart. Use
set(h,'PropertyName1',PropertyValue1,...) to change the
property values. Use get(h) to get the property values.
This table lists all properties you can specify for smithchart
objects along with units, valid values, and descriptions of their
use.

11-61
smithchart

Property
Name Description Units and Values
Color Line color for a Z or Y ColorSpec. Default
Smith chart. For a ZY is [0.4 0.4 0.4]
Smith chart, the Z line (dark gray).
color.
LabelColor Color of the line labels. ColorSpec. Default
is [0 0 0] (black).
LabelSize Size of the line labels. FontSize. Default
is 10. See the
Annotation
Textbox
Properties
reference page for
more information
on specifying font
size.
LabelVisible Visibility of the line 'on' (default) or
labels. 'off'
LineType Line spec for a Z or Y LineSpec. Default
Smith chart. For a ZY is '-' (solid line).
Smith chart, the Z line
spec.
LineWidth Line width for a Z or Y Number of points.
Smith chart. For a ZY Default is 0.5.
Smith chart, the Z line
width.
SubColor The Y line color for a ZY ColorSpec. Default
Smith chart. is [0.8 0.8 0.8]
(medium gray).
SubLineType The Y line spec for a ZY LineSpec. Default
Smith chart. is ':' (dotted line).

11-62
 smithchart

Property
Name Description Units and Values
SubLineWidth The Y line width for a Number of points.
ZY Smith chart. Default is 0.5.
Type Type of Smith chart. 'z' (default), 'y',
or 'zy'
Value Two-row matrix. Row 1 2-by-n matrix.
specifies the values of Default is [0.2000
the constant resistance 0.5000 1.0000
and reactance lines 2.0000 5.0000;
in the chart. For the 1.0000 2.0000
constant resistance 5.0000 5.0000
and reactance lines, 30.0000]
each element in Row 2
specifies the value at
which the corresponding
line in Row 1 ends.

Examples Plot multiple sets of data on a Smith chart:

[lineseries1,hsm] = smithchart(y)
hold on
lineseries2 = smithchart(z)

See Also get | set | smith

11-63
smm2s

Purpose Convert mixed-mode 2N-port S-parameters to single-ended 4N-port

S-parameters

Syntax s_params = smm2s(s_dd, s_dc, s_cd, s_cc)

s_params = smm2s(s_dd, s_dc, s_cd, s_cc, option)

Description s_params = smm2s(s_dd, s_dc, s_cd, s_cc) converts mixed-mode,

2N-port S-parameters into single-ended, 4N-port S-parameters,
s_params. smm2s maps the first half of the mixed-mode ports to the
odd-numbered pairs of single-ended ports and maps the second half to
the even-numbered pairs.
s_params = smm2s(s_dd, s_dc, s_cd, s_cc, option) converts the
S-parameter data using the optional argument option. You can also
reorder the ports in s_params using the snp2smp function.

Input s_cc
Arguments s_cc is a complex 2N-by-2N-by-K array containing K matrices of
common-mode, 2N-port S-parameters (Scc).
s_cd
s_cd is a complex 2N-by-2N-by-K array containing K matrices of
cross-mode, 2N-port S-parameters (Scd).
s_dc
s_dc is a complex 2N-by-2N-by-K array containing K matrices of
cross-mode, 2N-port S-parameters (Sdc).
s_dd
s_dd is a complex 2N-by-2N-by-K array containing K matrices of
differential-mode, 2N-port S-parameters (Sdd).
option
option is an integer equal to 1, 2, or 3. The value of option
determines how the function orders the ports:

11-64
 smm2s

• 1 — smm2s maps the first half of the mixed-mode ports to

odd-numbered pairs of single-ended ports and maps the second
half to even-numbered pairs. For example, in a mixed-mode,
4-port network:
- Port 1 becomes single-ended ports 1 and 3.
- Port 2 becomes single-ended ports 5 and 7.
- Port 3 becomes single-ended ports 2 and 4.
- Port 4 becomes single-ended ports 6 and 8.

• 2 — smm2s maps the first half of the mixed-mode ports to

single-ended ports in ascending numerical order, followed by
the second half, also in ascending order. For example, in a
mixed-mode, 4-port network:
- Port 1 becomes single-ended ports 1 and 2.
- Port 2 becomes single-ended ports 3 and 4.
- Port 3 becomes single-ended ports 5 and 6.
- Port 4 becomes single-ended ports 7 and 8.

11-65
smm2s

• 3 — smm2s maps the first half of the mixed-mode ports to

single-ended ports in ascending numerical order. The function
maps the second half to pairs of ports in descending order. For
example, in a mixed-mode, 4-port network:
- Port 1 becomes single-ended ports 1 and 2.
- Port 2 becomes single-ended ports 3 and 4.
- Port 3 becomes single-ended ports 8 and 7.
- Port 4 becomes single-ended ports 6 and 5.

Default: 1

Output s_params
Arguments s_params is a complex 4N-by-4N-by-K array representing K
single-ended, 4N-port S-parameters.

11-66
 smm2s

Examples Perform conversions between mixed-mode and single-ended

S-parameters:

% Create mixed-mode S-parameters:

ckt = read(rfckt.passive, 'default.s4p');
s4p = ckt.NetworkData.Data;
[sdd, scd, sdc, scc] = s2smm(s4p);
% Convert them back to 4-port, single-ended S-parameters:
s4p_converted_back = smm2s(sdd, scd, sdc, scc);

References Granberg, T., Handbook of Digital Techniques for High-Speed

Design.Upper Saddle River, NJ: Prentice Hall, 2004.

See Also s2scc | s2scd | s2sdc | s2sdd | s2smm | snp2smp

11-67
snp2smp

Purpose Convert single-ended N-port S-parameters to single-ended M-port

S-parameters

Syntax s_params_mp = snp2smp(s_params_np)

s_params_mp = snp2smp(s_params_np, Z0, n2m_index, ZT)

Description s_params_mp = snp2smp(s_params_np) converts the single-ended

N-port S-parameters, s_params_np, into the single-ended M-port
S-parameters, s_params_mp. M must be less than or equal to N.
s_params_mp = snp2smp(s_params_np, Z0, n2m_index, ZT)
converts the S-parameter data using the optional arguments Z0,
n2m_index, and ZT that control the conversion.
The following figure illustrates how to use the optional input arguments
to specify the ports for the output data and the termination of the
remaining ports.

M-Port

ZT{1} 1 N ZT{N}
N-Port M
ZT{2} 2 N-1 n2m_index(M)=N-1

. .
. .
. .

k ZT{k}
1 2
n2m_index(1)=i i j n2m_index(2)=j

11-68
 snp2smp

Input s_params_np
Arguments s_params_np is a complex N-by-N-by-K array representing K
N-port S-parameters.
Z0
Z0 is the reference impedance, in ohms, of s_params_np and
s_params_mp.

Default: 50

n2m_index
n2m_index is a vector of length M specifying how the ports of the
N-port S-parameters map to the ports of the M-port S-parameters.
n2m_index(i) is the index of the port from s_params_np that the
function converts to the ith port of s_params_mp. For example,
the setting [1, 2] means that M is 2, and the first two ports
of the N-port S-parameters become the ports of the M-port
parameters. The function terminates any additional ports with
the impedances specified by ZT.

Default: [1, 2]

ZT
ZT is a scalar, vector, or cell array specifying the termination
impedance of the ports. If M is less than N, snp2smp terminates
the N–M ports not listed in n2m_index using the values in ZT. If
ZT is a scalar, the function terminates all N–M ports not listed in
n2m_index by the same impedance ZT. If ZT is a vector of length
K, ZT[i] is the impedance that terminates all N–M ports of the
ith frequency point not listed in n2m_index. If ZT is a cell array
of length N, ZT{j} is the impedance that terminates the jth port
of the N-port S-parameters. The function ignores impedances
related to the ports listed in n2m_index. Each ZT{j} can be a
scalar or a vector of length K.

11-69
snp2smp

The following figure illustrates how to use the optional input

arguments to specify the ports for the output data and the
termination of the remaining ports.

M-Port

ZT{1} 1 N ZT{N}
N-Port M
ZT{2} 2 N-1 n2m_index(M)=N-1

. .
. .
. .

k ZT{k}
1 2
n2m_index(1)=i i j n2m_index(2)=j

Default: Z0

Examples Convert 3-port S-parameters to 3-port S-parameters with port indices

swapped from [1 2 3] to [2 3 1]:

ckt = read(rfckt.passive, 'default.s3p');

%default.s3p represents a real counterclockwise circulator
s3p = ckt.NetworkData.Data;
Z0 = ckt.NetworkData.Z0;
s3p_new = snp2smp(s3p, Z0, [2 3 1])

Convert 3-port S-parameters to 2-port S-parameters by terminating

port 3 with an impedance of Z0:

ckt = read(rfckt.passive, 'default.s3p');

11-70
 snp2smp

s3p = ckt.NetworkData.Data;
Z0 = ckt.NetworkData.Z0;
s2p = snp2smp(s3p, Z0);

Convert 16-port S-parameters to 4-port S-parameters by using ports 1,

16, 2, and 15 as the first, second, third, and fourth ports; terminate the
remaining 12 ports with an impedance of Z0:

ckt = read(rfckt.passive, 'default.s16p');

s16p = ckt.NetworkData.Data;
Z0 = ckt.NetworkData.Z0;
s4p = snp2smp(s16p, Z0, [1 16 2 15], Z0)

Convert 16-port S-parameters to 4-port S-parameters by using ports 1,

16, 2, and 15 as the first, second, third, and fourth ports; terminate
port 4 with an impedance of 100 ohms and terminate the remaining 11
ports with an impedance of 50 ohms:

ckt = read(rfckt.passive, 'default.s16p');

s16p = ckt.NetworkData.Data;
Z0 = ckt.NetworkData.Z0;
ZT = {};
ZT(1:16) = {50};
ZT{4} = 100;
s4p = snp2smp(s16p, Z0, [1 16 2 15], ZT)

See Also freqresp | rfmodel.rational | s2tf | timeresp | writeva

11-71
stabilityk

Purpose Calculate stability factor K of 2-port network

Syntax [k,b1,b2,delta] = stabilityk(s_params)

Description [k,b1,b2,delta] = stabilityk(s_params) calculates and returns

the stability factor, k, and the conditions b1, b2, and delta for the
2-port network. The input s_params is a complex 2-by-2-by-M array,
representing M 2-port S-parameters.
Necessary and sufficient conditions for stability are k>1 and
abs(delta)<1.

Algorithm stabilityk calculates the outputs using the equations;

2
2 2 Δ
K = 1 − S11 − S22 +
2 S12 S21
2 2 2
B1 = 1 + S11 − S22 −Δ
2 2 2
B2 = 1 − S11 + S22 −Δ

where:

• S11, S12, S21, and S22 are S-parameters from the input argument
s_params.
• Δ is a vector whose members are the determinants of the M 2-port
S-parameter matrices:

Δ = S11 S22 − S12 S21

The function performs these calculations element-wise for each of the M

S-parameter matrices in s_params.

Examples Examine the stability of network data from a file:

% Calculate stability factor and conditions

11-72
 stabilityk

ckt = read(rfckt.passive, 'passive.s2p');

s_params = ckt.NetworkData.Data;
freq = ckt.NetworkData.Freq;
[k b1 b2 delta] = stabilityk(s_params);
% Check stability criteria
stability_index = (k>1)&(abs(delta)<1);
is_stable = all(is_stable_idx)
% List frequencies with unstable S-parameters
freq_unstable = freq(~stability_index);

References Gonzalez, Guillermo, Microwave Transistor Amplifiers: Analysis and

Design, 2nd edition. Prentice-Hall, 1997, pp. 217–228.

See Also gammaml | gammams | stabilitymu

11-73
stabilitymu

Purpose Calculate stability factor μ of 2-port network

Syntax [mu,muprime] = stabilitymu(s_params)

Description [mu,muprime] = stabilitymu(s_params) calculates and returns the

stability factors μ and μ′ of a 2-port network. The input s_params is a
complex 2-by-2-by-M array, representing M 2-port S-parameters.
The stability factor, μ, defines the minimum distance between the
center of the unit Smith chart and the unstable region in the load plane.
The function assumes that port 2 is the load.
The stability factor, μ′, defines the minimum distance between the
center of the unit Smith chart and the unstable region in the source
plane. The function assumes that port 1 is the source.
Having μ > 1 or μ′ > 1 is the necessary and sufficient condition for the
2-port linear network to be unconditionally stable, as described by the
S-parameters.

Algorithm stabilitymu calculates the stability factors using the equations

2
1 − S11
=
*
S22 − S11 Δ + S21 S12
2
1 − S22
′ =
*
S11 − S22 Δ + S21 S12

where:

• S11, S12, S21, and S22 are S-parameters, from the input argument
s_params.
• Δ is a vector whose members are the determinants of the M 2-port
S-parameter matrices:

Δ = S11 S22 − S12 S21

11-74
 stabilitymu

• S* is the complex conjugate of the corresponding S-parameter.

The function performs these calculations element-wise for each of the M

S-parameter matrices in s_params.

Examples Examine the stability of network data from a file:

% Calculate stability factor and conditions

ckt = read(rfckt.passive, 'passive.s2p');
s_params = ckt.NetworkData.Data;
freq = ckt.NetworkData.Freq;
[mu muprime] = stabilitymu(s_params);
% Check stability criteria
stability_index = (mu>1)|(muprime>1);
is_stable = all(is_stable_idx)
% List frequencies with unstable S-parameters
freq_unstable = freq(~stability_index);

References Edwards, Marion Lee, and Jeffrey H. Sinsky, “A New Criterion

for Linear 2-Port Stability Using a Single Geometrically Derived
Parameter,” IEEE Transactions on Microwave Theory and Techniques,
Vol. 40, No. 12, pp. 2303-2311, December 1992.

See Also stabilityk

11-75
t2s

Purpose Convert T-parameters to S-parameters

Syntax s_params = t2s(t_params)

Description s_params = t2s(t_params) converts the chain scattering parameters

t_params into the scattering parameters s_params. The t_params input
is a complex 2-by-2-by-M array, representing M 2-port T-parameters.
s_params is a complex 2-by-2-by-M array, representing M 2-port
S-parameters.
This function defines the T-parameters as

⎡ a1 ⎤ ⎡ T11 T12 ⎤ ⎡ b2 ⎤
⎢ b ⎥ = ⎢T T22 ⎥⎦ ⎢⎣ a2 ⎥⎦
,
⎣ 1 ⎦ ⎣ 21
where:

• a1 is the incident wave at the first port.

• b1 is the reflected wave at the first port.
• a2 is the incident wave at the second port.
• b2 is the reflected wave at the second port.

Examples Convert T-parameters to S-parameters:

%Define a matrix of T-parameters

t11 = 0.138451095405929 - 0.230421317393041i;
t21 = -0.0451985986689165 + 0.157626245839348i;
t12 = 0.0353675449261375 + 0.115682026931012i;
t22 = -0.00194567217559662 - 0.0291212122613417i;
t_params = [t11 t12; t21 t22];
%Convert to S-parameters
s_params = t2s(s_params)

References Gonzalez, Guillermo, Microwave Transistor Amplifiers: Analysis and

Design, 2nd edition. Prentice-Hall, 1997, p. 25.

11-76
 t2s

See Also abcd2s | h2s | s2t | y2s | z2s

11-77
vswr

Purpose Calculate VSWR at given reflection coefficient Γ

Syntax ratio = vswr(gamma)

Description ratio = vswr(gamma) calculates the voltage standing-wave ratio

VSWR at the given reflection coefficientΓ as

1+ Γ
VSWR =
1− Γ

The input gamma is a complex vector. The output ratio is a real vector
of the same length as gamma.

Examples Calculate the VSWR for a given reflection coefficient:

gamma = 1/3;
ratio = vswr(gamma)

See Also gamma2z | gammain | gammaout

11-78
 y2abcd

Purpose Convert Y-parameters to ABCD-parameters

Syntax abcd_params = y2abcd(y_params)

Description abcd_params = y2abcd(y_params) converts the admittance

parameters y_params into the ABCD-parameters abcd_params. The
y_params input is a complex 2-by-2-by-M array, representing M
2-port Y-parameters. abcd_params is a complex 2-by-2-by-M array,
representing M 2-port ABCD-parameters.

Examples Convert Y-parameters to ABCD-parameters:

%Define a matrix of Y-parameters.

Y11 = 0.0488133074245012 - 0.390764155450191i;
Y12 = -0.0488588365420561 + 0.390719345880018i;
Y21 = -0.0487261119282660 + 0.390851884427087i;
Y22 = 0.0487710062903760 - 0.390800401433241i;
y_params = [Y11,Y12; Y21,Y22];
%Convert to ABCD-parameters
abcd_params = y2abcd(y_params);

See Also abcd2y | h2abcd | s2abcd | y2h | y2s | y2z | z2abcd

11-79
y2h

Purpose Convert Y-parameters to hybrid h-parameters

Syntax h_params = y2h(y_params)

Description h_params = y2h(y_params) converts the admittance parameters

y_params into the hybrid parameters h_params. The y_params input
is a complex 2-by-2-by-M array, representing M 2-port Y-parameters.
h_params is a complex 2-by-2-by-M array, representing M 2-port hybrid
h-parameters.

Examples Convert Y-parameters to h-parameters:

%Define a matrix of Y-parameters.

Y11 = 0.0488133074245012 - 0.390764155450191i;
Y12 = -0.0488588365420561 + 0.390719345880018i;
Y21 = -0.0487261119282660 + 0.390851884427087i;
Y22 = 0.0487710062903760 - 0.390800401433241i;
y_params = [Y11,Y12; Y21,Y22];
%Convert to h-parameters
h_params = y2h(y_params);

See Also abcd2h | h2y | s2h | y2abcd | y2s | y2z | z2h

11-80
 y2s

Purpose Convert Y-parameters to S-parameters

Syntax s_params = y2s(y_params,z0)

Description s_params = y2s(y_params,z0) converts the admittance parameters

y_params into the scattering parameters s_params. The y_params input
is a complex N-by-N-by-M array, representing M N-port Y-parameters.
z0 is the reference impedance. The default value of is z0 50 ohms.
s_params is a complex N-by-N-by-M array, representing M N-port
S-parameters.

Examples Convert Y-parameters to S-parameters:

%Define a matrix of Y-parameters.

Y11 = 0.0488133074245012 - 0.390764155450191i;
Y12 = -0.0488588365420561 + 0.390719345880018i;
Y21 = -0.0487261119282660 + 0.390851884427087i;
Y22 = 0.0487710062903760 - 0.390800401433241i;
y_params = [Y11,Y12; Y21,Y22];
%Convert to S-parameters
s_params = y2s(y_params);

See Also abcd2s | h2s | s2y | y2abcd | y2h | y2s | y2z | z2s

11-81
y2z

Purpose Convert Y-parameters to Z-parameters

Syntax z_params = y2z(y_params)

Description z_params = y2z(y_params) converts the admittance parameters

y_params into the impedance parameters z_params. The y_params
input is a complex N-by-N-by-M array, representing M N-port
Y-parameters. z_params is a complex N-by-N-by-M array, representing
M N-port Z-parameters.

Examples Convert Y-parameters to Z-parameters:

%Define a matrix of Y-parameters.

Y11 = 0.0488133074245012 - 0.390764155450191i;
Y12 = -0.0488588365420561 + 0.390719345880018i;
Y21 = -0.0487261119282660 + 0.390851884427087i;
Y22 = 0.0487710062903760 - 0.390800401433241i;
y_params = [Y11,Y12; Y21,Y22];
%Convert to Z-parameters
z_params = y2z(y_params);

See Also abcd2z | h2z | y2abcd | y2h | y2s | y2z | z2s | z2y

11-82
 z2abcd

Purpose Convert Z-parameters to ABCD-parameters

Syntax abcd_params = z2abcd(z_params)

Description abcd_params = z2abcd(z_params) converts the impedance parameters

z_params into the ABCD-parameters abcd_params. The z_params input
is a complex 2-by-2-by-M array, representing M 2-port Z-parameters.
abcd_params is a complex 2-by-2-by-M array, representing M 2-port
ABCD-parameters.

Examples Convert Z-parameters to ABCD-parameters:

%Define a matrix of Z-parameters.

Z11 = -14567.2412789287 - 148373.315116592i
Z12 = -14588.1106171651 - 148388.583516562i
Z21 = -14528.0522132692 - 148350.705757767i
Z22 = -14548.5996561832 - 148363.457002006i
z_params = [Z11,Z12; Z21,Z22];
%Convert to ABCD-parameters
abcd_params = z2abcd(z_params);

See Also abcd2z | h2abcd | s2abcd | y2abcd | z2h | z2s | z2y

11-83
z2gamma

Purpose Convert impedance to reflection coefficient

Syntax gamma = z2gamma(z)

gamma = z2gamma(z,z0)

Description gamma = z2gamma(z) converts the impedance z to the reflection

coefficient gamma using a reference impedance of 50 ohms.
gamma = z2gamma(z,z0) converts the impedance z to the reflection
coefficient gamma using a reference impedance of z0 ohms.

Algorithm z2gamma calculates the coefficient using the equation

Z − Z0
Γ=
Z + Z0

Examples Convert an impedance of 100 ohms into a reflection coefficient, using a

50-ohm reference impedance:

z = 100;
gamma = z2gamma(z)

See Also gamma2z | gammain | gammaout

11-84
 z2h

Purpose Convert Z-parameters to hybrid h-parameters

Syntax h_params = z2h(z_params)

Description h_params = z2h(z_params) converts the impedance parameters

z_params into the hybrid parameters h_params. The z_params input
is a complex 2-by-2-by-M array, representing M 2-port Z-parameters.
h_params is a complex 2-by-2-by-M array, representing M 2-port hybrid
h-parameters.

Examples Convert Z-parameters to H-parameters:

%Define a matrix of Z-parameters.

Z11 = -14567.2412789287 - 148373.315116592i
Z12 = -14588.1106171651 - 148388.583516562i
Z21 = -14528.0522132692 - 148350.705757767i
Z22 = -14548.5996561832 - 148363.457002006i
z_params = [Z11,Z12; Z21,Z22];
%Convert to h-parameters
h_params = z2h(z_params);

See Also abcd2h | h2z | s2h | y2h | z2abcd | z2s | z2y

11-85
z2s

Purpose Convert Z-parameters to S-parameters

Syntax s_params = z2s(z_params,z0)

Description s_params = z2s(z_params,z0) converts the impedance parameters

z_params into the scattering parameters s_params. The z_params input
is a complex N-by-N-by-M array, representing M N-port Z-parameters.
z0 is the reference impedance; its default is 50 ohms. s_params is a
complex N-by-N-by-M array, representing M n-port S-parameters.

Examples Convert Z-parameters to S-parameters:

%Define a matrix of Z-parameters.

Z11 = -14567.2412789287 - 148373.315116592i
Z12 = -14588.1106171651 - 148388.583516562i
Z21 = -14528.0522132692 - 148350.705757767i
Z22 = -14548.5996561832 - 148363.457002006i
z_params = [Z11,Z12; Z21,Z22];
%Convert to S-parameters
s_params = z2s(z_params);

See Also abcd2s | h2s | s2z | y2s | z2abcd | z2h | z2y

11-86
 z2y

Purpose Convert Z-parameters to Y-parameters

Syntax y_params = z2y(z_params)

Description y_params = z2y(z_params) converts the impedance parameters

z_params into the admittance parameters y_params. The z_params
input is a complex N-by-N-by-M array, representing M N-port
Z-parameters. y_params is a complex N-by-N-by-M array, representing
M N-port Y-parameters.

Examples Convert Z-parameters to Y-parameters:

%Define a matrix of Z-parameters.

Z11 = -14567.2412789287 - 148373.315116592i
Z12 = -14588.1106171651 - 148388.583516562i
Z21 = -14528.0522132692 - 148350.705757767i
Z22 = -14548.5996561832 - 148363.457002006i
z_params = [Z11,Z12; Z21,Z22];
%Convert to Y-parameters
y_params = z2y(z_params);

See Also abcd2y | h2y | s2y | y2z | z2abcd | z2h | z2s

11-87
z2y

11-88
 A

AMP File Format

• “Overview” on page A-2

• “Denoting Comments” on page A-3
• “Data Sections” on page A-4
 A AMP File Format

Overview
The AMP data file describes a single nonlinear device. Its format can contain
the following types of data:

• S, Y, or Z network parameters
• Noise parameters
• Noise figure data
• Power data
• IP3 data

An AMP file must contain either power data or network parameter data to
be valid. To accommodate analysis at more than one frequency, the file can
contain more than one section of power data. Noise data, noise figure data,
and IP3 data are optional.

Note If the file contains both network parameter data and power data,
RF Toolbox software checks the data for consistency. If the amplifier gain
computed from the network parameters is not consistent with the gain
computed from the power data, a warning appears. For more information, see
“Inconsistent Data Sections” on page A-14.

Two AMP files, samplepa1.amp and default.amp, ship with the toolbox to
show the AMP format. They describe a nonlinear 2-port amplifier with noise.
See “Example — Modeling a Cascaded RF Network” on page 1-14 for an
example that shows how to use an AMP file.

For information on specifying data in an AMP file, see “Data Sections” on page
A-4. For information about adding comments to an AMP file, see “Denoting
Comments” on page A-3.

A-2
 Denoting Comments

Denoting Comments
An asterisk (*) or an exclamation point (!) precedes a comment that appears
on a separate line.

A semicolon (;) precedes a comment that appears following data on the same
line.

A-3
 A AMP File Format

Data Sections
In this section...
“Overview of Data Sections” on page A-4
“S, Y, or Z Network Parameters” on page A-4
“Noise Parameters” on page A-6
“Noise Figure Data” on page A-8
“Power Data” on page A-9
“IP3 Data” on page A-12
“Inconsistent Data Sections” on page A-14

Overview of Data Sections

Each kind of data resides in its own section. Each section consists of a
two-line header followed by lines of numeric data. Numeric values can be in
any valid MATLAB format.

A new header indicates the end of the previous section. The data sections
can appear in any order in the file.

Note In the data section descriptions, brackets ([]) indicate optional data or
characters. All values are case insensitive.

S, Y, or Z Network Parameters

Header Line 1
The first line of the header has the format

Keyword [Parameter] [R[REF][=]value]

Keyword indicates the type of network parameter. Its value can be

S[PARAMETERS], Y[PARAMETERS], or Z[PARAMETERS]. Parameter indicates the
form of the data. Its value can be MA, DB, or RI. The default for S-parameters

A-4
 Data Sections

is MA. The default for Y- and Z-parameters is RI. R[REF][=]value is the

reference impedance. The default reference impedance is 50 ohms.

The following table explains the meaning of the allowable Parameter values.

Parameter Description
MA Data is given in (magnitude, angle) pairs with
angle in degrees (default for S-parameters).
DB Data is given in (dB-magnitude, angle) pairs with
angle in degrees.
RI Data is given in (real, imaginary) pairs (default for
Y- and Z-parameters).

This example of a first line indicates that the section contains S-parameter
data given in (real, imaginary) pairs, and that the reference impedance is
50 ohms.

S RI R 50

Header Line 2
The second line of the header has the format

Independent_variable Units

The data in a section is a function of the Independent_variable. Currently,

for S-, Y-, and Z-parameters, the value of Independent_variable is always
F[REQ]. Units indicates the default units of the frequency data. It can be GHz,
MHz, or KHz. You must specify Units, but you can override this default on
any given line of data.

This example of a second line indicates that the default units for frequency
data is GHz.

FREQ GHZ

A-5
 A AMP File Format

Data
The data that follows the header typically consists of nine columns.

The first column contains the frequency points where network parameters are
measured. They can appear in any order. If the frequency is given in units
other than those you specified as the default, you must follow the value with
the appropriate units; there should be no intervening spaces. For example,

FREQ GHZ
1000MHZ ...
2000MHZ ...
3000MHZ ...

Columns two though nine contain 2-port network parameters in the order
N11, N21, N12, N22. Similar to the Touchstone format, each Nnn corresponds
to two consecutive columns of data in the chosen form: MA, DB, or RI. The
data can be in any valid MATLAB format.

This example is derived from the file default.amp. A comment line explains
the column arrangement of the data where re indicates real and im indicates
imaginary.

S RI R 50
FREQ GHZ
* FREQ reS11 imS11 reS21 imS21 reS12 imS12 reS22 imS22
1.00 -0.724725 -0.481324 -0.685727 1.782660 0.000000 0.000000 -0.074122 -0.321568
1.01 -0.731774 -0.471453 -0.655990 1.798041 0.001399 0.000463 -0.076091 -0.319025
1.02 -0.738760 -0.461585 -0.626185 1.813092 0.002733 0.000887 -0.077999 -0.316488

Noise Parameters

Header Line 1
The first line of the header has the format

Keyword

Keyword must be NOI[SE].

A-6
 Data Sections

Header Line 2
The second line of the header has the format

Variable Units

Variable must be F[REQ]. Units indicates the default units of the frequency
data. It can be GHz, MHz, or KHz. You can override this default on any given
line of data. This example of a second line indicates that frequency data is
assumed to be in GHz, unless other units are specified.

FREQ GHz

Data
The data that follows the header must consist of five columns.

The first column contains the frequency points at which noise parameters
were measured. The frequency points can appear in any order. If the
frequency is given in units other than those you specified as the default,
you must follow the value with the appropriate units; there should be no
intervening spaces. For example,

NOI
FREQ GHZ
1000MHZ ...
2000MHZ ...
3 ...
4 ...
5 ...

Columns two through five contain, in order,

• Minimum noise figure in decibels

• Magnitude of the source reflection coefficient to realize minimum noise
figure
• Phase in degrees of the source reflection coefficient
• Effective noise resistance normalized to the reference impedance of the
network parameters

A-7
 A AMP File Format

This example is taken from the file default.amp. A comment line explains
the column arrangement of the data.

NOI RN
FREQ GHz
* Freq Fmin(dB) GammmaOpt(MA:Mag) GammmaOpt(MA:Ang) RN/Zo
1.90 10.200000 1.234000 -78.400000 0.240000
1.93 12.300000 1.235000 -68.600000 0.340000
2.06 13.100000 1.254000 -56.700000 0.440000
2.08 13.500000 1.534000 -52.800000 0.540000
2.10 13.900000 1.263000 -44.400000 0.640000

Noise Figure Data

The AMP file format supports the use of frequency-dependent noise figure
(NF) data.

Header Line 1
The first line of the header has the format

Keyword [Units]

For noise figure data, Keyword must be NF. The optional Units field indicates
the default units of the NF data. Its value must be dB, i.e., data must be
given in decibels.

This example of a first line indicates that the section contains NF data, which
is assumed to be in decibels.

NF

Header Line 2
The second line of the header has the format

Variable Units

Variable must be F[REQ]. Units indicates the default units of the frequency
data. It can be GHz, MHz, or KHz. This example of a second line indicates that
frequency data is assumed to be in GHz.

A-8
 Data Sections

FREQ GHz

Data
The data that follows the header typically consists of two columns.

The first column contains the frequency points at which the NF data are
measured. Frequency points can appear in any order. For example,

NF
FREQ MHz
2090 ...
2180 ...
2270 ...

Column two contains the corresponding NF data in decibels.

This example is derived from the file samplepa1.amp.

NF dB
FREQ GHz
1.900 10.3963213
2.000 12.8797965
2.100 14.0611765
2.200 13.2556751
2.300 12.9498642
2.400 13.3244309
2.500 12.7545104

Note If your noise figure data consists of a single scalar value with no
associated frequency, that same value is used for all frequencies. Enter the
value in column 1 of the line following header line 2. You must include the
second line of the header, but it is ignored.

Power Data
An AMP file describes power data as input power-dependent output power.

A-9
 A AMP File Format

Header Line 1
The first line of the header has the format

Keyword [Units]

For power data, Keyword must be POUT, indicating that this section contains
power data. Because output power is complex, Units indicates the default
units of the magnitude of the output power data. It can be dBW, dBm, mW, or W.
The default is W. You can override this default on any given line of data.

The following table explains the meaning of the allowable Units values.

Allowable Power Data Units

Units Description
dBW Decibels referenced to one watt
dBm Decibels referenced to one milliwatt
mW Milliwatts
W Watts

This example of a first line indicates that the section contains output
power data whose magnitude is assumed to be in decibels referenced to one
milliwatt, unless other units are specified.

POUT dBm

Header Line 2
The second line of the header has the format

Keyword [Units] FREQ[=]value

Keyword must be PIN. Units indicates the default units of the input power
data. See Allowable Power Data Units on page A-10 for a complete list of
valid values. The default is W. You can override this default on any given
line of data. FREQ[=]value is the frequency point at which the power is

A-10
 Data Sections

measured. The units of the frequency point must be specified explicitly using
the abbreviations GHz, MHz, kHz, or Hz.

This example of a second line indicates that the section contains input power
data that is assumed to be in decibels referenced to one milliwatt, unless
other units are specified. It also indicates that the power data was measured
at a frequency of 2.1E+009 Hz.

PIN dBm FREQ=2.1E+009Hz

Data
The data that follows the header typically consists of three columns:

• The first column contains input power data. The data can appear in any
order.
• The second column contains the corresponding output power magnitude.
• The third column contains the output phase shift in degrees.

Note RF Toolbox software does not use the phase data directly. RF
Blockset™ software uses this data in conjunction with RF Toolbox software
to create the AM/PM conversion table for the General Amplifier and
General Mixer blocks.

If all phases are zero, you can omit the third column. If all phases are zero or
omitted, the toolbox assumes that the small signal phase from the network
parameter section of the file (180*angle(S21(f))/pi) is the phase for all
power levels.

In contrast, if one or more phases in the power data section are nonzero, the
toolbox interpolates and extrapolates the data to determine the phase at
all power levels. The small signal phase (180*angle(S21(f))/pi) from the
network parameter section is ignored.

A-11
 A AMP File Format

Inconsistency between the power data and network parameter sections of

the file may cause incorrect results. To avoid this outcome, verify that the
following criteria must is met:

• The lowest input power value for which power data exists falls in the small
signal (linear) region.
• In the power table for each frequency point f, the power gain and phase
at the lowest input power value are equal to 20*log10(abs(S21(f))) and
180*angle(S21(f))/pi, respectively, in the network parameter section.

If the power is given in units other than those you specified as the default,
you must follow the value with the appropriate units. There should be no
intervening spaces.

This example is derived from the file default.amp. A comment line explains
the column arrangement of the data.

POUT dbm
PIN dBm FREQ = 2.10GHz
* Pin Pout Phase(degrees)
0.0 19.28 0.0
1.0 20.27 0.0
2.0 21.26 0.0

Note The file can contain more than one section of power data, with each
section corresponding to a different frequency value. When you analyze data
from a file with multiple power data sections, power data is taken from the
frequency point that is closest to the analysis frequency.

IP3 Data
An AMP file can include frequency-dependent, third-order input (IIP3) or
output (OIP3) intercept points.

Header Line 1
The first line of the header has the format

Keyword [Units]

A-12
 Data Sections

For IP3 data, Keyword can be either IIP3 or OIP3, indicating that this section
contains input IP3 data or output IP3 data. Units indicates the default units
of the IP3 data. Valid values are dBW, dBm, mW, and W. The default is W. See
Allowable Power Data Units on page A-10 for an explanation of the allowable
Units values.

This example of a first line indicates that the section contains input IP3 data
which is assumed to be in decibels referenced to one milliwatt.

IIP3 dBm

Header Line 2
The second line of the header has the format

Variable Units

Variable must be FREQ. Units indicates the default units of the frequency
data. Valid values are GHz, MHz, and KHz. This example of a second line
indicates that frequency data is assumed to be in GHz.

FREQ GHz

Data
The data that follows the header typically consists of two columns.

The first column contains the frequency points at which the IP3 parameters
are measured. Frequency points can appear in any order.

OIP3
FREQ GHz
2.010 ...
2.020 ...
2.030 ...

Column two contains the corresponding IP3 data.

A-13
 A AMP File Format

This example is derived from the file samplepa1.amp.

OIP3 dBm
FREQ GHz
2.100 38.8730377

Note If your IP3 data consists of a single scalar value with no associated
frequency, then that same value is used for all frequencies. Enter the value
in column 1 of the line following header line 2. You must include the second
line of the header, but the application ignores it.

Inconsistent Data Sections

If an AMP file contains both network parameter data and power data, RF
Toolbox software checks the data for consistency.

The toolbox 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 )

wherefP is the lowest frequency for which power data is specified.

The discrepancy is shown in the following graph.

A-14
 Data Sections

Small Signal Network Data

*** Specified Power Data

Pout (dBm)
* * *
*
DP *

fP Pin (dBm)

If ΔP is more than 0.4 dB, a warning appears. Large discrepancies may

indicate measurement errors that require resolution.

A-15
 A AMP File Format

A-16
 B

Examples

Use this list to find examples in the documentation.

 B Examples

Modeling a Cascaded RF Network

“Example — Modeling a Cascaded RF Network” on page 1-14

Modeling a Transmission Line

“Example — Using a Rational Function Model to Analyze a Transmission
Line” on page 1-22

Working with Objects

“Example — Setting Circuit Object Properties Using Data Objects” on
page 3-11
“Reading and Analyzing RF Data from a Touchstone Data File” on page
3-42
“De-Embedding S-Parameters” on page 3-44

Exporting Object Data

“Example — Exporting Object Data” on page 3-40

Modeling an RF Network Using RF Tool

“Example — Modeling an RF Network Using RF Tool” on page 5-31

B-2
 Index

A
Index source reflection coefficient 11-18
ABCD-parameters specified network parameters 9-7
converting to h-parameters 11-2 cascadesparams function 11-6
converting to S-parameters 11-3 cascading
converting to Y-parameters 11-4 S-parameters 11-6
converting to Z-parameters 11-5 chart properties 11-61
abcd2h function 11-2 circle method 9-13
abcd2s function 11-3 circuit 9-2
abcd2y function 11-4 circuit analysis
abcd2z function 11-5 analyze method 9-2
accessing circuit object methods
object properties 3-14 list of 2-7
AMP file format A-1 circuit objects
comments A-3 constructing 3-2
data sections A-4 copying 11-12
noise parameters A-6 exporting to Verilog-A 4-5
overview A-2 list of 2-5
power data A-9 overview 2-4
S, Y, Z Network Parameters A-4 coaxial transmission line
analysis shunt and series stubs 7-154
list of methods 8-2 stubless 7-152
analyze method 9-2 constructing new objects 3-2
conversion
2N-port S-parameters to 4N-port
B S-parameters 11-64
budget plots 3-29 4N-port S-parameters to 2N-port
S-parameters 11-49
ABCD-parameters to h-parameters 11-2
C
ABCD-parameters to S-parameters 11-3
calculate method 9-7 ABCD-parameters to Y-parameters 11-4
example 9-10 ABCD-parameters to Z-parameters 11-5
calculations g-parameters to h-parameters 11-14
cascading S-parameters 11-6 h-parameters to ABCD-parameters 11-21
circuit analysis 9-2 h-parameters to g-parameters 11-22
de-embedding S-parameters 11-13 h-parameters to S-parameters 11-23
input reflection coefficient 11-16 h-parameters to Y-parameters 11-24
list of functions 10-2 h-parameters to Z-parameters 11-25
load reflection coefficient 11-17 impedance to reflection coefficient 11-84
output reflection coefficient 11-19 N-port S-parameters to M-port
power gain 11-29 S-parameters 11-68

Index-1
 Index

reflection coefficient to impedance 11-15 list of 2-2

S-parameters to ABCD-parameters 11-38 overview 2-2
S-parameters to h-parameters 11-39 data visualization
S-parameters to S-parameters 11-40 circles on Smith chart 9-13
S-parameters to T-parameters 11-53 list of functions 10-3
S-parameters to transfer function 11-55 list of methods 8-2
S-parameters to Y-parameters 11-59 log-log plot 9-30
S-parameters to Z-parameters 11-60 plot with left and right y-axes 9-41
T-parameters to S-parameters 11-76 polar plane 9-54
Y-parameters to ABCD-parameters 11-79 semilogx plot 9-61
Y-parameters to h-parameters 11-80 semilogy plot 9-66
Y-parameters to S-parameters 11-81 Smith chart from complex vector 11-61
Y-parameters to Z-parameters 11-82 Smith chart from object 9-73
Z-parameters to ABCD-parameters 11-83 using RF Tool 5-20
Z-parameters to h-parameters 11-85 X-Y plane 9-35
Z-parameters to S-parameters 11-86 de-embedding
Z-parameters to Y-parameters 11-87 S-parameters 11-13
conversion functions deembedsparams function 11-13
network parameters 10-3 demos
coplanar waveguide transmission line in Help browser 1-5
shunt and series stubs 7-168 displaying operating conditions 9-20
stubless 7-167 draw circles on Smith chart 9-13
copy function 11-12
copying objects 3-4
E
exporting Verilog-A models 4-5
D extract method 9-16
data access and restoration extracting
list of methods 8-3 network parameters 9-16
data I/O
list of methods 8-3
F
updating data object from a file 9-58
writing a Verilog-A file from a model file formats A-1
object 9-88 AMP A-1
writing file from a data object 9-85 supported 3-8
data object methods writing 3-39
list of 2-3 file I/O
data objects updating data object from a file 9-58
copying 11-12 writing a Verilog-A file from a model
corresponding to circuit object 11-20 object 9-88

Index-2
 Index

writing file from a data object 9-85 impulse method 9-22

freqresp method 9-18 example 9-23
example 9-18 input reflection coefficient
calculating 11-16
ispassive function 11-26
G
g-parameters
converting to h-parameters 11-14 L
g2h function 11-14 listformat method 9-25
gamma2z function 11-15 example 9-25
gammain function 11-16 listparam method 9-27
gammaml function 11-17 example 9-28
gammams function 11-18 load reflection coefficient
gammaout function 11-19 calculating 11-17
general transmission line loglog method 9-30
shunt and series stubs 7-351
stubless 7-350
M
getdata function 11-20
getop method 9-20 makepassive function 11-27
getz0 method 9-21 methods
rfckt and rfdata objects 3-26
that act on objects 3-26
H microstrip transmission line
h-parameters shunt and series stubs 7-246
converting to ABCD-parameters 11-21 stubless 7-245
converting to g-parameters 11-22 mixer spur plots 3-32
converting to S-parameters 11-23 model object methods
converting to Y-parameters 11-24 list of 2-10
converting to Z-parameters 11-25 model objects
h2abcd function 11-21 constructing 3-2
h2g function 11-22 list of 2-10
h2s function 11-23 overview 2-10
h2y function 11-24 models
h2z function 11-25 exporting to Verilog-A 4-2
Help browser how to export Verilog-A 4-5
demos 1-5
N
I network parameters
impedance calculating 9-7
converting to reflection coefficient 11-84 cascading 11-6

Index-3
 Index

conversion functions 10-3 budget 3-29

de-embedding 11-13 draw circles on Smith chart 9-13
extracting 9-16 left and right y-axes 9-41
listing valid formats 9-25 log-log 9-30
updating from a file 9-58 mixer spur 3-32
valid for a circuit or data object 9-27 polar plane 9-54
visualization 8-2 rectangular 3-29
writing to a file 9-85 semilogx 9-61
notation semilogy 9-66
S-parameter 1-9 Smith chart from complex vector 11-61
Smith chart from object 9-73
using RF Tool 5-20
O
X-Y plane 9-35
objects plotyy method 9-41
analysis 9-2 polar method 9-54
constructing new 3-2 powergain function 11-29
copying 3-4 product demos 1-5
example using RF Tool 5-31 properties of objects 3-5
example using rfckt objects 1-14 retrieving 3-14
example using rfmodel objects 1-22 setting 3-5
introduction to their use 1-7
methods 3-26
methods that act on 3-26 R
properties 3-5 rational function model
operating conditions writing to a Verilog-A file 9-88
displaying 9-20 rationalfit function 11-31
list of methods 8-3 read method 9-58
setting 9-71 reflection coefficient
output reflection coefficient calculating input 11-16
calculating 11-19 calculating load 11-17
calculating output 11-19
calculating source 11-18
P
converting to impedance 11-15
parallel-plate transmission line response
shunt and series stubs 7-281 frequency 9-18
stubless 7-279 impulse 9-22
plot method 9-35 time 9-83
plot parameters and formats restore method 9-60
list of methods 8-3 retrieving
plots object properties 3-14

Index-4
 Index

RF circuit object methods populating a network 5-13

list of 2-7 reordering circuits 5-14
RF circuit objects saving sessions 5-29
constructing 3-2 sessions 5-2
list of 2-5 starting new sessions 5-30
RF data object methods window 5-3
list of 2-3 workflow 5-5
RF data objects working with circuits 5-27
constructing 3-2 working with sessions 5-28
list of 2-2 rfckt methods
RF model object methods analyze 9-2
list of 2-10 calculate 9-7
RF model objects circle 9-13
constructing 3-2 copy 11-12
list of 2-10 getdata 11-20
RF objects listformat 9-25
modeling using Verilog-A 4-2 listparam 9-27
RF Tool loglog 9-30
adding a component 5-8 plot 9-35
adding a network 5-11 plotyy 9-41
analyzing circuits 5-20 polar 9-54
available components 5-7 semilogx 9-61
available networks 5-11 semilogy 9-66
creating components and networks 5-6 smith 9-73
deleting circuits 5-27 rfckt objects
exporting RF objects 5-23 changing properties 3-7
exporting RF objects to MATLAB viewing properties 3-14
workspace 5-23 rfdata methods
exporting to file 5-25 analyze 9-2
importing from file to network 5-18 calculate 9-7
importing from file to session 5-16 circle 9-13
importing RF objects 5-15 copy 11-12
importing RF objects from MATLAB extract 9-16
workspace 5-16 listformat 9-25
modifying component parameters 5-19 listparam 9-27
naming sessions 5-28 loglog 9-30
opening existing sessions 5-30 plot 9-35
opening the tool 5-2 plotyy 9-41
overview of use 5-2 polar 9-54
plotting network parameters 5-20 read 9-58

Index-5
 Index

semilogx 9-61 s2scc function 11-41

semilogy 9-66 s2scd function 11-43
smith 9-73 s2sdc function 11-45
write 9-85 s2sdd function 11-47
rfdata objects s2smm function 11-49
changing properties 3-7 s2t function 11-53
viewing properties 3-14 s2tf function 11-55
rfdata.data object s2y function 11-59
example 7-118 s2z function 11-60
rfmodel methods semilogx method 9-61
freqresp 9-18 semilogy method 9-66
impulse 9-22 series RLC filter
stepresp 9-79 example 7-97
timeresp 9-83 setop method 9-71
writeva 9-88 setting
rfmodel objects object properties 3-5
changing properties 3-7 setting operating conditions 9-71
viewing properties 3-14 shunt RLC filter
rftool function 11-36 example 7-102
Smith chart from complex vector 11-61
Smith chart from object 9-73
S
Smith chart properties 9-76
S-parameter notation 1-9 smith method 9-73
S-parameters smithchart function 11-61
cascading 11-6 smm2s function 11-64
changing impedance 11-40 snp2smp function 11-68
converting 2N-port to 4N-port 11-64 source reflection coefficient
converting 4N-port to 2N-port 11-49 calculating 11-18
converting N-port to M-port 11-68 stabilityk function 11-72
converting to ABCD-parameters 11-38 stabilitymu function 11-74
converting to h-parameters 11-39 stepresp method 9-79
converting to S-parameters 11-40 example 9-80
converting to T-parameters 11-53 stubless transmission lines
converting to transfer function 11-55 coaxial transmission line 7-152
converting to Y-parameters 11-59 coplanar waveguide 7-167
converting to Z-parameters 11-60 general 7-350
de-embedding 11-13 microstrip 7-245
s2abcd function 11-38 parallel-plate 7-279
s2h function 11-39 two-wire 7-335
s2s function 11-40 stubs (shunt and series)

Index-6
 Index

coaxial transmission line 7-154 semilogy plot 9-66

coplanar waveguide transmission line 7-168 Smith chart from complex vector 11-61
general transmission line 7-351 Smith chart from object 9-73
microstrip transmission line 7-246 using RF Tool 5-20
parallel-plate transmission line 7-281 X-Y plane 9-35
two-wire transmission line 7-337 voltage standing-wave ratio (VSWR)
calculating 11-78
VSWR
T
calculating 11-78
T-parameters vswr function 11-78
converting to S-parameters 11-76
t2s function 11-76
table method 9-81 W
time response write method 9-85
computing 9-83 writeva method 9-88
timeresp method 9-83
example 9-83
Y
two-wire transmission line
shunt and series stubs 7-337 Y-parameters
stubless 7-335 converting to ABCD-parameters 11-79
converting to h-parameters 11-80
converting to S-parameters 11-81
U converting to Z-parameters 11-82
utility functions y2abcd function 11-79
list of 10-3 y2h function 11-80
y2s function 11-81
y2z function 11-82
V
Verilog-A
how to export models 4-5 Z
modeling RF objects using 4-2 Z-parameters
overview 4-2 converting to ABCD-parameters 11-83
supported models 4-3 converting to h-parameters 11-85
viewing converting to S-parameters 11-86
demos 1-5 converting to Y-parameters 11-87
visualization z2abcd function 11-83
circles on Smith chart 9-13 z2gamma function 11-84
log-lot plot 9-30 z2h function 11-85
plot with left and right y-axes 9-41 z2s function 11-86
polar plane 9-54 z2y function 11-87
semilogx plot 9-61

Index-7