Engee documentation

tparameters

Creates an object of T-parameters.

Library

EngeeRF

Syntax

Function call

  • tobj = tparameters(filename) — creates a T-parameter object tobj by importing data from the Touchstone file specified in filename.

  • tobj = tparameters(tobj_old, Z0) — converts T-parameters to T-parameters with a different calculated impedance Z0. Argument Z0 optional. If it is not specified, then tobj_old copied to tobj.

  • tobj = tparameters(rftbx_obj) — extracts network S-parameter data from any analyzed network object rftbx_obj, and then converts this data into T-parameter data.

  • tobj = tparameters(hnet, Z0) — converts network parameter data hnet into a T-parameter object with a specified design impedance Z0.

Arguments

Input arguments

# tobj_old is an object of T-parameters

+ scalar descriptor

Details

An object of T-parameters specified as a scalar descriptor.

# paramdata — T-parameter data

+ an array of complex numbers

Details

T-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 the T-parameter object tobj.

# filename — Touchstone file

+ line

Details

The Touchstone data file, specified as a string containing data about network parameters.

# freq — frequencies of T-parameters

+ positive real vector

Details

The frequencies of the T-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 the T-parameter object tobj.

# Z0 is the calculated impedance, ohms

+ 50 | positive real scalar | positive real vector

Details

The calculated impedance in ohms, set using one of the following methods:

  • A positive real scalar, if you want to set the same calculated impedance for all network ports.

  • A positive real vector of length if you want to set a different design impedance for each port in - the port network.

  • A positive real vector of length if you want to set a different design impedance for each of the frequencies in the data.

If the calculated impedance is a vector, and the number of ports is is equal to the number of data frequencies , , then the function tparameters assigns each element of the vector to each network port. To set the calculated impedance for each frequency in this case, specify Z0 as a three-dimensional vector in size on on .

Argument Z0 it cannot be specified when importing T-parameter data from a file. Argument Z0 is optional, and the function stores the resistance in the property Impedance the object tobj.

# hnet — data about network parameters

+ scalar descriptor

Details

Network parameter data, set as a scalar descriptor. If hnet is an object of T-parameters, then tobj — full copy hnet. Otherwise, the function performs a transformation of network parameters to create tobj. Specify hnet as one of the following objects: sparameters, yparameters, gparameters, hparameters, zparameters or abcdparameters.

# rftbx_obj — network object

+ scalar descriptor

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

# tobj is an object of T-parameters

+ scalar descriptor

Details

An object of T-parameters 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 T-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 — T-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 paramdata.

  • Impedance — the calculated impedance in ohms in the form of a positive real scalar. The function sets this property based on the arguments filename or Z0. If the calculated impedance is not specified, the function uses the default value. 50.

Examples

Creating a T-parameter object

Details

Let’s create a T-parameter object and output its properties.

using EngeeRF

T = tparameters([1 + im 2; 3 4;;;], [1], 60)

println("NumPorts: ", T.NumPorts,
        "\nFrequencies: ", T.Frequencies,
        "\nParameters: ", T.Parameters,
        "\nImpedance: ", T.Impedance)
NumPorts: 2
Frequencies: [1]
Parameters: ComplexF64[1.0 + 1.0im 2.0 + 0.0im; 3.0 + 0.0im 4.0 + 0.0im;;;]
Impedance: 60