gparameters

Create hybrid-g parameter object

Syntax

hg = gparameters(filename)

hg = gparameters(hnet)

hg = gparameters(data,freq)

hg = gparameters(rftbxobj)

Description

hg = gparameters(filename) creates a hybrid-g parameter object hg by importing data from the Touchstone file specified by filename. All data is stored in real/imag format.

hg = gparameters(hnet) creates a hybrid-g parameter object from the RF Toolbox™ network parameter object hnet.

hg = gparameters(data,freq) creates a hybrid-g parameter object from the g-parameter data, data, and frequencies, freq.

hg = gparameters(rftbxobj) extracts network data from rftbxobj and converts it into G-parameter data.

Examples

Extract G11

Read the file default.s2p as g-parameters and extract G11.

g = gparameters('default.s2p')

g = 
  gparameters: g-parameters object

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

  rfparam(obj,i,j) returns g-parameter gij

g11 = rfparam(g,1,1);

Input Arguments

data — Hybrid-g parameter data

array of complex numbers

Hybrid-g parameter data, specified as an array of complex numbers, of size 2-by-2-by-K. The function uses this input argument to set the value of the Parameters property of hg.

filename — Touchstone data file

character vector

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: hg = gparameters('defaultbandpass.s2p');

freq — Hybrid-g parameter frequencies

vector of positive scalars

Hybrid-g 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 hg.

hnet — Network parameter data

scalar handle

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

rftbxobj — network object

scalar handle

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

Output Arguments

hg — Hybrid-g parameter data

scalar handle

Hybrid-g parameter data, returned as a scalar handle. disp(hg) returns the properties of the object:

• Frequencies — Hybrid-g 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 — Hybrid-g parameter data, specified as an 2-by-2-by-K array of complex numbers. The function sets this property from the filename or data input arguments.

Version History

Introduced in R2012b

R2023b: Recommended over rfdata.network

gparameters is recommend over rfdata.network because it enables you to calculate g-parameters for a circuit object, an RF data, and a network.

R2023a: Build hybrid g-parameters with a vector of reference impedances for each port

The gparameters function now allows you to build a network with different reference impedance for each port.