abcdparameters

Create ABCD parameter object

Syntax

habcd = abcdparameters(filename)

habcd = abcdparameters(hnet)

habcd = abcdparameters(data,freq)

habcd = abcdparameters(rftbxobj)

Description

habcd = abcdparameters(filename) creates an ABCD parameter object habcd by importing data from the Touchstone file specified by filename. All data is stored in real/imag format.

habcd = abcdparameters(hnet) creates an ABCD parameter object from the RF Toolbox™ network parameter object hnet.

habcd = abcdparameters(data,freq) creates an ABCD parameter object from the ABCD parameter data, data, and frequencies, freq.

habcd = abcdparameters(rftbxobj) extracts network data from rftbxobj and converts it into ABCD-parameter data.

Examples

Read a File as ABCD-parameters and Extract A

Read the file default.s2p as abcd-parameters.

abcd = abcdparameters('default.s2p')

abcd = 
  abcdparameters: ABCD-parameters object

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

  rfparam(obj,specifier) returns specified ABCD-parameter 'A', 'B', 'C', or 'D'

Extract parameter A.

A = rfparam(abcd,'A')

A = 191×1 complex

  -0.1470 - 0.0698i
  -0.1421 - 0.0698i
  -0.1373 - 0.0696i
  -0.1325 - 0.0694i
  -0.1277 - 0.0691i
  -0.1231 - 0.0688i
  -0.1185 - 0.0683i
  -0.1140 - 0.0678i
  -0.1097 - 0.0672i
  -0.1054 - 0.0666i
      ⋮

Input Arguments

data — ABCD parameter data

array of complex numbers

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

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

freq — ABCD parameter frequencies

vector of positive numbers

ABCD 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 habcd.

hnet — Network parameter data

scalar handle

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

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

habcd — ABCD parameter data

scalar handle

ABCD parameter data, returned as a scalar handle. disp(habcd) 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 — ABCD 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 — ABCD parameter data, specified as a 2N-by-2N-by-K array of complex numbers. The function sets this property from the filename or data input arguments.