Main Content

yparameters

Create Y-parameter object

Description

example

hy = yparameters(filename) creates a Y-parameter object hy by importing data from the Touchstone file specified by filename. All data is stored in real/imag format.

hy = yparameters(hnet) creates a Y-parameter object from the RF Toolbox™ network parameter object hnet.

hy = yparameters(data,freq) creates a Y-parameter object from the Y-parameter data, data, and frequencies, freq.

hy = yparameters(rftbxobj) extracts network data from rftbxobj and converts it into y-parameter data.

Examples

collapse all

Extract Y-parameters from default.s2p and plot on a smith chart.

Y = yparameters('default.s2p')
Y = 
  yparameters with properties:

       NumPorts: 2
     Parameters: [2x2x191 double]
    Frequencies: [191x1 double]

figure;
smith(Y,1,1)

Input Arguments

collapse all

Y-parameter data, specified as an array of complex numbers, of size N-by-N-by-K. The function uses this input argument to set the value of the Parameters property of hy.

Touchstone data file, specified as a character vector, that contains network parameter data. filename can be the name of a file on the MATLAB® path or the full path to a file.

Example: hy = yparameters('defaultbandpass.s2p');

Y-parameter frequencies, specified as a vector of positive real numbers, sorted from smallest to largest. The function uses this input argument to set the value of the Frequencies property of hy.

Network parameter data, specified as a scalar handle. If hnet is a Y-parameter object, then hy is a deep copy of hnet. Otherwise, the function performs a network parameter conversion to create hy. When converting network parameters, the same restrictions apply as those for RF Toolbox network parameter data conversion functions:

  • ABCD parameter objects support 2N-port data.

  • Hybrid-g parameter objects support 2-port data.

  • Hybrid parameter objects support 2-port data.

  • S-parameter objects support N-port data.

  • Y-parameter objects support N-port data.

  • Z-parameter objects support N-port data.

  • T-parameter objects support 2-port data.

Network object, specified as scalar handle. Specify rftbxobj as one of the following types: rfdata.data, rfdata.network, and any analyzed rfckt type.

Output Arguments

collapse all

Y-parameter data, returned as a scalar handle. disp(hy) returns the properties of the object:

  • NumPorts — Number of ports, specified as an integer. The function calculates this value automatically when you create the object.

  • Frequencies — Y-parameter frequencies, specified as a K-by-1 vector of positive real numbers sorted from smallest to largest. The function sets this property from the filename or freq input arguments.

  • Parameters — Y-parameter data, specified as an N-by-N-by-K array of complex numbers. The function sets this property from the filename or data input arguments.

Version History

Introduced in R2012b

expand all