rfplot

Plotting the S-parameter data, as well as the dependence of the total result of calculating the RF budget on the input frequency of the cascade.

Library

EngeeRF

Description

Use the function rfplot to build the following graphs:

The total result of the RF budget depends on the input frequency of the cascade;
The amplitude-frequency characteristics of the S-parameters.

Syntax

Function call

S-parameters

rfplot(sobj) — plots the dependence of the amplitude of all S-parameters ( ) in dB of the frequency along the current axis.

rfplot(sobj,i,j) — plots the amplitude dependence in dB on the current axis.

rfplot(sobj,[i₁:i_n],[j₁:j_n]) — plots the dependence of the amplitude of several S-parameters in dB along the current axis.

rfplot(sobj,([i₁ j₁]; …; [i_n j_n])) — plots the dependence of the amplitude of specific S-parameters in dB along the current axis.

rfplot(___,plotargs…) — builds a graph of S-parameters using keywords to specify the graph style available in Julia Plots, set using the argument plotargs….

rfplot(___,plotflag) — plots the S-parameters according to the type specified in the argument plotflag.

rfplot(sobj,"diag") — plots the dependence of the amplitude of the reflection coefficients or diagonal elements from the coefficients of the S-parameter matrix "diag" on the current axis.

rfplot(sobj,part) — plots the upper or lower triangular part of the S-parameter matrix along the current axis.

rfplot(sobj,part,k) — plots the elements located on, above or below k`The th diagonal of the S-parameter matrix. For more information, see Function descriptions `tril and triu.

rfplot(ax,___) — plots the S-parameters along the axes specified in the argument ax, instead of the current axes. As the first input argument, specify ax, and then any combination of input arguments from the previous syntaxes. You can return the current axes using the function gca.

hline = rfplot(___) — plots the S-parameters and returns a column vector of line descriptors in a variable hline.

hline,haxes = rfplot(filter,frequencies) — plots the amplitude-frequency response of the S-parameters of the RF filter.

HRH budget_

rfplot(rfobj) — plots the amplitude-frequency response of the S-parameters for a cascading budget object rfobj.

rfplot(rfobj,rfpara) — plots the dependence of the RF budget result set by RF parameters rfpara, depending on the input frequency range. The input frequencies are fed to a cascade of elements in the RF budget object rfobj.

The total results (i.e. cascade results) are automatically calculated to show the change in the RF budget result across the scheme.

rfplot(rfobj,m,n) — plots the amplitude-frequency response of the S-parameters ( , , or ) for a cascading budget object rfobj.

rfplot(ax,___) — plots the total RF budget result along the axes specified in the argument ax, instead of the current axes. As the first input argument, specify ax, and then any combination of input arguments from the previous syntaxes. You can return the current axes using the function gca.

Arguments

Input arguments

# sobj — S-parameters

+ the object of network parameters

Details

S are the parameters set as an object of the library’s network parameters. EngeeRF. To create an object of this type, use the function sparameters.

# rfobj — RF budget object

+ the rfbudget object

Details

The RF budget object, set as an object rfbudget.

# i — row index

+ scalar | vector

Details

The index of the data row for plotting, specified as a scalar or vector.

Chart type How to set indexes

Chart type	How to set indexes
One parameter	Specify `i` and `j` like scalars. `rfplot(sobj,[1,2])`
A set of parameters	Specify `i` and `j` like vectors. `rfplot(sobj,[1:3],[2:3])` `rfplot(sobj,[1,2],[2,3])`
Specific parameters	Specify the tuple of scalars `i` and `j`. `rfplot(sobj,([1 2];[2 3]))`

One parameter

Specify i and j like scalars.

rfplot(sobj,[1,2])

A set of parameters

Specify i and j like vectors.

rfplot(sobj,[1:3],[2:3])

rfplot(sobj,[1,2],[2,3])

Specific parameters

Specify the tuple of scalars i and j.

rfplot(sobj,([1 2];[2 3]))

# j — column index

+ scalar | vector

Details

The index of the graph data column, specified as a scalar or vector.

Chart type How to set indexes

Chart type	How to set indexes
One parameter	Specify `i` and `j` like scalars. `rfplot(sobj,[1,2])`
A set of parameters	Specify `i` and `j` like vectors. `rfplot(sobj,[1:3],[2:3])` `rfplot(sobj,[1,2],[2,3])`
Specific parameters	Specify the tuple of scalars `i` and `j`. `rfplot(sobj,([1 2];[2 3]))`

One parameter

Specify i and j like scalars.

rfplot(sobj,[1,2])

A set of parameters

Specify i and j like vectors.

rfplot(sobj,[1:3],[2:3])

rfplot(sobj,[1,2],[2,3])

Specific parameters

Specify the tuple of scalars i and j.

rfplot(sobj,([1 2];[2 3]))

# plotflag — types of graphs

+ "db" (default) | "real" | "imag" | "abs" | "angle"

Details

Chart types defined as "db", "real", "imag", "abs" or "angle".

# filter — RF filter

+ the rffilter object | lcladder object

Details

RF filter set as an object rffilter or lcladder.

# frequencies — frequencies for plotting the amplitude-frequency response

+ vector

Details

Frequencies for plotting the amplitude-frequency response, specified as a vector.

# part — part of the S-parameter matrix

+ "triu" | "tril"

Details

The part of the S-parameter matrix defined as "triu" or "tril". Specify the value "triu" to plot the upper triangular part of the matrix and "tril" to plot the lower triangular part.

# k — diagonals to be included

+ 0 (by default) | scalar

Details

The diagonals to be included are set as a scalar.

k = 0 denotes the main diagonal.
k > 0 indicates the diagonals above the main diagonal.
k < 0 indicates the diagonals below the main diagonal.

rfplot 1

# rfpara — RF parameters

+ "Pout" | "GainT" | "NF" | "OIP3" | "IIP3" | 'SNR' | "Sparameters"

Details

RF parameters set using one of the following methods:

"Pout" — available output power, dBm;
"GainT" — converter gain, dB;
"NF"— noise factor, dB;
"OIP3" — third-order output signal, dBm;
`"IIP3`" — third-order input signal, dBm;
"SNR" — signal-to-noise ratio, dB;
"Sparameters" — S-parameters amplitude-frequency response, dB.

# ax — the axes object

+ the axes object | the uiaxes object

Details

The axes object, set as an object axes or uiaxes.

Input arguments «name-value»

Specify optional argument pairs as Name=Value, where Name — the name of the argument, and Value — the appropriate value.

# plotargs… — graph attributes

Details

Argument plotargs… It is used to pass the standard attributes supported by the package to the internal plotting call. Plots.jl. For example, you can set markers, color, line type, signatures, and other parameters in the same way as in the basic function. plot. For more information about the available graph attributes, see the article Attributes

Examples: rfplot(s, marker=:+), rfplot(s, 1, 1, m=:o), rfplot(s, "diag", color=:red).

Output arguments

# hline — line

+ line descriptor

Details

A line containing a graph of S-parameters returned as a line descriptor.

# haxes — axes

+ axis descriptor

Details

Axes of the function graph rfplot, returned as an axis descriptor.

Additional Info

The upper triangular part of the matrix

Details

The upper triangular part of the matrix includes the main diagonal and all the elements above it. The shaded elements in this figure represent the upper triangular part of the matrix in size 6 on 6.

rfplot 2

The lower triangular part of the matrix

Details

The lower triangular part of the matrix includes the main diagonal and all the elements below it. The shaded elements in this figure represent the lower triangular part of the matrix. 6 on 6.

rfplot 3