Main Content

zparameters

Create Z-parameter object

Description

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

example

hz = zparameters(hnet) creates a Z-parameter object from the RF Toolbox™ network parameter object hnet.

hz = zparameters(data,freq) creates a Z-parameter object from the Z-parameter data, data, and frequencies, freq.

hz = zparameters(rftbxobj) extracts network data from rftbxobj and converts it into z-parameter data.

Examples

collapse all

Read the file default.s2p as z-parameters and extract Z11.

Z = zparameters('defaultbandpass.s2p')
Z = 
  zparameters with properties:

       NumPorts: 2
     Parameters: [2x2x1000 double]
    Frequencies: [1000x1 double]

z11 = rfparam(Z,1,1);

Plot imaginary part of Z11.

 plot(Z.Frequencies, imag(z11))

Figure contains an axes object. The axes object contains an object of type line.

Input Arguments

collapse all

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

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

Example: hz = zparameters('defaultbandpass.s2p');

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

Network parameter data, specified as a scalar handle. If hnet is a Z-parameter object, then hz is a deep copy of hnet. Otherwise, the function performs a network parameter conversion to create hz. 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

Z-parameter data, returned as a scalar handle. disp(hz) 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 — Z-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 — Z-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