plot

Plot circuit object parameters on X-Y plane

collapse all in page

Syntax

plot(h,circuitPara)

plot(h,circuitPara,xAxisPara,xAxisFmt)

plot(h,circuitPara,xAxisPara,xAxisFmt,opCon,opVal)

plot(___,Name,Value)

plot(h,'budget',___)

plot(h,'mixerspur',k,pin,fin)

plot(___,format)

lineseries = plot(___)

Description

plot(h,circuitPara) plots the circuit parameters specified in circuitPara from the RFCKT or RF data object h on the X-Y plane in the default format. You can specify one or more circuit parameters in circuitPara.

example

plot(h,circuitPara,xAxisPara,xAxisFmt) plots the circuit parameters on the X-Y plane along with the variables xAxisPara and their corresponding format xAxisFmt.

Derive xAxisPara and xAxisFmt for the RFCKT or RF data object h using the listparam(h) and listformat(h,'xAxisPara') commands, respectively.

example

plot(h,circuitPara,xAxisPara,xAxisFmt,opCon,opVal) plots the circuit parameters on the X-Y plane with operating conditions opCon and operating values opVal.

Derive operating conditions for the RFCKT or RF data object h using the getop(h) command.

example

plot(___,Name,Value) plots the circuit parameters with name-value arguments. Specify the name-value argument after any of the input argument combinations in the previous syntaxes.

example

plot(h,'budget',___) plots budget data on the X-Y plane from the rfckt.cascade object h. Specify any of the input argument combinations in the previous syntaxes after 'budget'.

plot(h,'mixerspur',k,pin,fin) plots the spur power of the rfckt.mixer object or rfckt.cascade object h that contains one or more mixers. For more information on plotting mixer spur power, see the Visualize Mixer Spurs example.

Note

For all circuit objects except those that contain data from a data file, you must perform a frequency domain analysis with the analyze function before calling plot.

example

plot(___,format) plots the data in the specified format.

lineseries = plot(___) returns a column vector of handles to lineseries objects with one handle per line. This output is the same as the output returned by the MATLAB^® plot function.

example

Examples

collapse all

Plot Circuit Parameters of RFCKT Object on X-Y Plane

Open Live Script

Create an RFCKT amplifier object.

 amp = rfckt.amplifier;

Plot the S11 and S12 parameters on the X-Y plane.

 plot(amp,'S11','S21')

$Figure contains an axes object. The axes object with xlabel Freq [GHz], ylabel Magnitude (decibels) contains 2 objects of type line. These objects represent S_{11}, S_{21}.$

Plot Output Power of Amplifier in X-Y Plane

Open Live Script

Create an amplifier object from a P2D file.

ckt1 = read(rfckt.amplifier,'default.p2d');

Plot the output power of the amplifier in the X-Y plane.

plot(ckt1,'Pout','Freq','GHz')

$Figure contains an axes object. The axes object with xlabel Freq [GHz], ylabel dBm contains 3 objects of type line. These objects represent P_{out}(P_{in}=0[dBm];Bias=1.5), P_{out}(P_{in}=9.52872[dBm];Bias=1.5), P_{out}(P_{in}=19[dBm];Bias=1.5).$

Plot Output of Amplifier with Biasing Condition

Open Live Script

Create an amplifier object from a P2D file.

ckt1 = read(rfckt.amplifier,'default.p2d');

Plot the output power of the amplifier with the bias set to 1.5 v.

plot(ckt1,'Pout','Freq','GHz','bias',1.5)

Plot Output Power of Amplifier at Specified Input Power

Open Live Script

Create an amplifier object from a P2D file.

ckt1 = read(rfckt.amplifier, 'default.p2d');

Plot the output power of the amplifier when the input power is 18 dBm.

plot(ckt1,'Pout','Freq','GHz','bias',1.5,'Pin',18)

$Figure contains an axes object. The axes object with xlabel Freq [GHz], ylabel dBm contains an object of type line. This object represents P_{out}(P_{in}=18[dBm];Bias=1.5).$

Plot Budget Data on X-Y Plane

Open Live Script

Create two amplifiers by specifying an rfdata.network object as an input to an rfckt.amplifier object.

ai1 = rfckt.amplifier('NetworkData', ...
    rfdata.network('Type','S','Freq',2.1e9,'Data',[0,0;3.98,0]), ...
    'NoiseData',2,'NonlinearData',35);
ai2 = rfckt.amplifier('NetworkData', ...
    rfdata.network('Type','S','Freq',2.1e9,'Data',[0,0;31.66,0]), ...
    'NoiseData',8,'NonlinearData',37);

Create a microstrip transmission line with an rfckt.microstrip object.

tx1 = rfckt.microstrip('Thickness',0.0075e-6);

Cascade the circuit using an rfckt.cascade object.

c = rfckt.cascade('Ckts',{ai1 ai2 tx1});

Analyze the cascaded circuit and plot the 3-D S11 and S21 plot.

analyze(c,linspace(2.08e9,2.12e9,100));
plot(c,'budget','S11','S21','Freq','GHz')

$Figure contains an axes object. The axes object with xlabel Freq [GHz], ylabel Stage of cascade contains 2 objects of type line. These objects represent S_{11}, S_{21}.$

Plot S11 of Microstrip Transmission Line

Open Live Script

Create an rfckt.microstrip object.

tx1 = rfckt.microstrip;

Analyze and plot the S11 parameter of the microstrip transmission line from 1– 2.4 GHz

analyze(tx1,1e9:0.4e9:2.4e9);
lineseries = plot(tx1,'S11')

lineseries = 
  Line (S_{11}) with properties:

              Color: [0 0.4470 0.7410]
          LineStyle: '-'
          LineWidth: 0.5000
             Marker: 'none'
         MarkerSize: 6
    MarkerFaceColor: 'none'
              XData: [1 1.4000 1.8000 2.2000]
              YData: [-55.0369 -50.9945 -47.8763 -45.4391]

  Use GET to show all properties

Change the color of the S11 plot.

set(lineseries,'Color',[0.7 0.3 0.35])

$Figure contains an axes object. The axes object with xlabel Freq [GHz], ylabel Magnitude (decibels) contains an object of type line. This object represents S_{11}.$

Input Arguments

collapse all

`h` — RF circuit or data object
RFCKT object | RF Data object

RF circuit or data object, specified as an RFCKT or RF data object. For a complete list of RFCKT and RF data objects, see RF Circuit Objects and RF Data Objects, respectively.

Data Types: char | string

`circuitPara` — Valid circuit parameters
character vector | string scalar

Valid circuit parameters of the RFCKT or RF data object, specified as a character vector or string scalar.

Use listparam(h) for a list of valid parameters for the circuit or data object h. You can also use listformat(h,parameter) to see the valid formats for a specific parameter. For more information, see listparam.

`xAxisPara` — Independent variable to plot with circuit parameters
`Pin` (default) | `Freq` | `AM`

Independent variable to plot with the circuit parameters circuitPara, values specified in the table given. This table shows the circuitPara and their corresponding xAxisPara values. The function uses the default values listed in the table if you do not specify xAxisPara.

`circuitPara` Value	`xAxisPara` Value
`Pout`, `Phase`, `LS11`, `LS12`, `LS21`, `LS22`	`Pin` (default), `Freq`
`S11`, `S12`, `S21`, `S22`, `NF`, `IIP3`, `OIP3`, `GroupDelay`, `VSWRIn`, `VSWROut`, `GammaIn`, `GammaOut`, `FMIN`, `GammaOPT`, `RN`, `TF1`, `TF2`, `Gt`, `Ga`, `Gp`, `Gmag`, `Gmsg`, `GammaMS`, `GammaML`, `K`, `Delta`, `Mu`, `MuPrime`	`Freq`
`AM/AM`, `AM/PM`	`AM`

`xAxisFmt` — `xAxisPara` format
`dBm` (default) | character vector | string scalar

xAxisPara format, specified as a character vector or string scalar. You do not need to specify xAxisFmt when xAxisPara is an operating condition.

This table shows the commonly used xAxisPara values and their corresponding xAxisFmt values. The function uses the default values listed in the table if you do not specify xAxisFmt.

xAxisPara Value xAxisFmt Value

Pin dBm (default), mW, W, dBW

`xAxisPara` Value	`xAxisFmt` Value
`Pin`	`dBm` (default), `mW`, `W`, `dBW`
`Freq`	`THz`, `GHz`, `MHz`, `KHz`, `Hz` If you do not specify `xAxisFmt`, the function chooses the `xAxisFmt` value that provides the best scaling for the given `xAxisPara` value.
`AM`	`Magnitude (decibels)` (default), `Magnitude (linear)`

Freq

THz, GHz, MHz, KHz, Hz

If you do not specify xAxisFmt, the function chooses the xAxisFmt value that provides the best scaling for the given xAxisPara value.

AM Magnitude (decibels) (default), Magnitude (linear)

Example: plot(h,'Pout','Pin','mW') plots data on the X-Y plane for the circuit object h with xAxisPara set to 'Pin' and xAxisFmt set to 'mW'.

`opCon` — Operating conditions
string scalar | character vector

Operating conditions derived from a P2D or S2D file, specified as a string scalar or a character vector.

For some circuit parameters, you can specify a set of frequency or input power values at which the function plots 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 opCon and opVal arguments.
When plotting large-signal S-parameters as a function of frequency, you can specify input power levels of interest using opCon and opVal arguments.
When plotting parameters as a function of an operating condition, you can specify both frequency and input power values using opCon and opVal arguments.

Enter the getop(h) command at the command line to get the operating conditions for the RF circuit object h.

`opVal` — Value of operating conditions
scalar

Value of the operating conditions in the opCon argument, specified as a scalar.

Example: plot(h,'Pout','Pin','mW','bias',1.5) plots the data on the X-Y plane for circuit object h with opCon set to 'bias' and value set to 1.5.

`'budget'` — Budget parameter of `rfckt.cascade` object
budget parameter object

Budget parameter of an rfckt.cascade object, specified as a budget parameter object handle.

The following table summarizes the parameters and formats that are available for a budget plot.

Parameter	Format
`S₁₁`, `S₁₂`, `S₂₁`, `S₂₂`, `S_ij`	`Magnitude (decibels) Magnitude (linear) Angle (degrees) Real Imaginary`
`OIP3`	`dBm dBW W mW`
`NF`	`Magnitude (decibels) Magnitude (linear)`

`format` — Format of data
`'Real'` | `'None'` | string scalar | character vector | ...

Format of data, specified as a string scalar or character vector. The format determines if RF Toolbox™ 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 circuit parameter.
Specify format as 'None' to plot the unchanged parameter values.

Use the listformat function to get a list of the valid formats for a particular parameter.

`k` — Index of the circuit object
`'all'` (default) | integer

Index of the circuit object to plot spur power, specified as an integer or 'all'. This value creates a budget plot of the spur power for h. Use 0 to plot the power at the input of h.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: plot(h,'Pout','Pin','Freq',2.1e9)

`Freq` — Frequency
positive scalar

Frequency, specified as a positive scalar in Hz.

`Pin` — Input power level
positive scalar

Input power level, specified as a positive scalar in dBm.

`fin` — Input frequency value
positive scalar

Input frequency value, specified as a positive scalar in Hz to plot the spur power. The default value of fin varies based on h.

If h is an rfckt.mixer object, the default value of fin is the input frequency at which the magnitude of the S₂₁ 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 S₂₁ parameter of the first mixer in the cascade is highest.

Note

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.

Output Arguments

collapse all

`lineseries` — `lineseries` object
column vector of object handles

lineseries object, returned as a column vector of object handles.

Tips

Use the Property Editor (propertyeditor) or the MATLAB set function to change Line Properties. For more information and complete description of object properties, see figure, axes, and text.
Use the MATLAB plot function to plot network parameters specified as vector data and not as part of a circuit (rfckt) object or data (rfdata) object.

Alternatives

rfplot The function creates magnitude-frequency plots for RF Toolbox S-parameter objects.

Version History

Introduced before R2006a

plot

Syntax

Description

Examples

Plot Circuit Parameters of RFCKT Object on X-Y Plane

Plot Output Power of Amplifier in X-Y Plane

Plot Output of Amplifier with Biasing Condition

Plot Output Power of Amplifier at Specified Input Power

Plot Budget Data on X-Y Plane

Plot S11 of Microstrip Transmission Line

Input Arguments

h — RF circuit or data object RFCKT object | RF Data object

circuitPara — Valid circuit parameters character vector | string scalar

xAxisPara — Independent variable to plot with circuit parameters Pin (default) | Freq | AM

xAxisFmt — xAxisPara format dBm (default) | character vector | string scalar

opCon — Operating conditions string scalar | character vector

opVal — Value of operating conditions scalar

'budget' — Budget parameter of rfckt.cascade object budget parameter object

format — Format of data 'Real' | 'None' | string scalar | character vector | ...

k — Index of the circuit object 'all' (default) | integer

Name-Value Arguments

Freq — Frequency positive scalar

Pin — Input power level positive scalar

fin — Input frequency value positive scalar

Output Arguments

lineseries — lineseries object column vector of object handles

Tips

Alternatives

Version History

See Also

`h` — RF circuit or data object
RFCKT object | RF Data object

`circuitPara` — Valid circuit parameters
character vector | string scalar

`xAxisPara` — Independent variable to plot with circuit parameters
`Pin` (default) | `Freq` | `AM`

`xAxisFmt` — `xAxisPara` format
`dBm` (default) | character vector | string scalar

`opCon` — Operating conditions
string scalar | character vector

`opVal` — Value of operating conditions
scalar

`'budget'` — Budget parameter of `rfckt.cascade` object
budget parameter object

`format` — Format of data
`'Real'` | `'None'` | string scalar | character vector | ...

`k` — Index of the circuit object
`'all'` (default) | integer

`Freq` — Frequency
positive scalar

`Pin` — Input power level
positive scalar

`fin` — Input frequency value
positive scalar

`lineseries` — `lineseries` object
column vector of object handles