Engee documentation

zparameters

Creates an object of Z-parameters.

Library

EngeeRF

Syntax

Function call

  • hz = zparameters(filename) — creates a Z-parameter object hz by importing data from the Touchstone file specified in filename.

  • hz = zparameters(hnet) — creates a Z-parameter object from a network parameter object hnet.

  • hz = zparameters(data, freq) — creates a Z-parameter object based on the Z-parameter data data and frequencies freq.

  • hz = zparameters(rftbxobj) — extracts network data from rftbxobj and converts them into a Z-parameter object.

Arguments

Input arguments

# filename is a Touchstone file containing data about network parameters

+ character vector

Details

A Touchstone data file specified as a character vector containing data about network parameters.

# hnet — data about network parameters

+ scalar descriptor

Details

Network parameter data, set as a scalar descriptor. If hnet is an object of Z-parameters, then hz — full copy hnet. Otherwise, the function performs a transformation of network parameters to create hz. When converting network parameters, the same restrictions apply as for the functions for converting network parameter data EngeeRF:

  • The ABCD parameter objects support data on ports.

  • Hybrid-g parameter objects support data on two ports.

  • Hybrid parameter objects support data on two ports.

  • S-parameter objects support data on ports.

  • Y-parameter objects support data on ports.

  • Z-parameter objects support data on ports.

  • T-parameter objects support data on two ports.

# data — Z-parameter data
an array of complex numbers

Details

Z-parameter data, specified as an array of complex numbers of the size on on . The function uses this input argument to set the value of the property. Parameters for hz.

# freq — frequencies of Z-parameters

+ positive real vector

Details

The frequencies of the Z-parameters are defined as a vector of positive real numbers sorted from smallest to largest. The function uses this input argument to set the value of the property. Frequencies for hz.

# rftbxobj — network object

+ scalar

Details

A network object specified as a scalar descriptor. A network parameter object can be one of the following types: rfdata.data, rfdata.network and any analyzed type rfckt.

Output arguments

# hz — Z-parameter data

+ scalar descriptor

Details

Z-parameter data returned as a scalar descriptor. The object contains the following properties:

  • NumPorts — the number of ports as an integer. The function calculates this value automatically when creating an object.

  • Frequencies — frequencies of Z-parameters in the form of a vector of size on positive real numbers sorted from smallest to largest. The function sets this property based on the arguments filename or freq.

  • Parameters — Z-parameter data in the form of an array of complex numbers of the size on on . The function sets this property based on the arguments filename or data.

Examples

Creating a Z-parameter object

Details

Creating a Z-parameter object.

using EngeeRF
Z = zparameters([1 + im 2; 3 4;;;], [1])
zparameters(NumPorts = 2, Parameters = ComplexF64[1.0 + 1.0im 2.0 + 0.0im; 3.0 + 0.0im 4.0 + 0.0im;;;], Frequencies = [1])