txlineRLCGLine

Create RLCG line transmission line

Since R2020b. Recommended over rfckt.rlcgline.

Description

Use the txlineRLCGLine object to create a RLCG transmission line that is characterized by line loss, line length, stub type, and termination.

Creation

Syntax

rlcgtxline = txlineRLCGLine

rlcgtxline = txlineRLCGLine(Name=Value)

Description

rlcgtxline = txlineRLCGLine creates a default RLCG line transmission line object.

rlcgtxline = txlineRLCGLine(Name=Value) sets Properties using one or more name-value pairs. For example, rlcgtxline = txlineRLCGLine(Freq=2.0e9) creates an RLCG line transmission line at a frequency of 2 GHz.. Properties you do not specify retain their default values.

Properties

Name — Name of RLCG line transmission line

'rlcgline' (default) | string scalar | character vector

Name of the RLCG line transmission line, specified as a string scalar or a character vector.

Example: Name='rlcgline1'

Example: rlcgtxline.Name = 'rlcgline1'

Data Types: char | string

Freq — Frequency

1.0e9 (default) | nonnegative scalar or vector

Frequency of the RLCG of the transmission line, specified as a nonnegative scalar in hertz.

Example: Freq=2.0e9

Example: rlcgtxline.Freq = 2.0e9

Data Types: double

R — Resistor values

0 (default) | nonnegative scalar or vector

Resistor values per length of the transmission line, specified as a nonnegative scalar in ohms per meter or a nonnegative vector with each element unit in ohms per meter.

Example: R=0.5

Example: rlcgtxline.R = 0.5

Data Types: double

L — Inductance values

0 (default) | nonnegative scalar or vector

Inductance values per length of the transmission line, specified as a nonnegative scalar in Henry per meter or a nonnegative vector with each element unit in Henry per meter.

Example: L=0.5

Example: rlcgtxline.L = 0.5

Data Types: double

C — Capacitance values

0 (default) | nonnegative scalar or vector

Capacitance values per length of the transmission line, specified as a nonnegative scalar in Faraday per meter or a nonnegative vector with each element unit in Faraday per meter.

Example: C=0.5

Example: rlcgtxline.C = 0.5

Data Types: double

G — Conductance values

0 (default) | nonnegative scalar or vector

Conductance values per length of the transmission line, specified as a nonnegative scalar in Siemens per meter or a nonnegative vector with each element unit in Siemens per meter.

Example: G=0.5

Example: rlcgtxline.G = 0.5

Data Types: double

IntpType — Type of interpolation

'Linear' (default) | 'Spline' | 'Cubic'

Type of interpolation, specified as 'Linear', 'Spline', or 'Cubic'.

Example: IntpType=Spline'

Example: rlcgtxline.IntpType = 'Spline'

Data Types: char

LineLength — Physical length

'0.0100' (default) | positive scalar

Physical length of the transmission line, specified as a positive scalar in meters.

Example: LineLength=,0.0200

Example: rlcgtxline.LineLength = 0.0200

Data Types: double

Termination — Stub transmission line termination

'NotApplicable' (default) | 'Open' | 'Short'

Stub transmission line termination, specified as 'NotApplicable', 'Open', or 'Short'.

Example: Termination='Short'

Example: rlcgtxline.Termination = 'Short'

Data Types: char

StubMode — Type of stub

'NotAStub' (default) | 'Series' | 'Shunt'

Type of stub, specified as 'NotAStub', 'Series', or 'Shunt'.

Example: StubMode='Series'

Example: rlcgtxline.StubMode = 'Series'

Data Types: char

NumPorts — Number of input and output ports

Read-only: 2 (default) | positive scalar

This property is read-only.

Number of input and output ports, specified as positive scalar.

Data Types: double

Terminals — Terminals of RLGC transmission line

Read-only: {'p1+' p2+' 'p1-' 'p2-'} (default) | cell array of strings

This property is read-only.

Number of input and output ports, specified as a cell array of strings.

Data Types: char | string

Object Functions

sparameters	Calculate S-parameters for RF data, network, circuit, and matching network objects
groupdelay	Group delay of S-parameter object or RF filter object or RF Toolbox circuit object
noisefigure	Calculate noise figure of transmission lines, series RLC, and shunt RLC circuits
getZ0	Calculate characteristic impedance with and without dispersion for transmission line
circuit	Circuit object
clone	Create copy of existing circuit element or circuit object

Examples

S-parameters of RLCG Transmission Line

Create an RLCG transmission line using these specifications:

• Resistor : 100 ohms

• Capacitor : 1 pF

rlcglinetxline = txlineRLCGLine(R=100,C=1e-12)

rlcglinetxline = 
  txlineRLCGLine: RLCGLine element

           Name: 'RLCGLine'
      Frequency: 1.0000e+09
              R: 100
              L: 0
              C: 1.0000e-12
              G: 0
       IntpType: 'Linear'
     LineLength: 0.0100
    Termination: 'NotApplicable'
       StubMode: 'NotAStub'

Calculate the S-parameters of the transmission line at 1 GHz.

sparam = sparameters(rlcglinetxline,1e9);

Version History

Introduced in R2020b

R2023b: Recommended over rfckt.microstrip

txlineRLCGLine is recommended over rfckt.rlcgline because it enables you to:

• Create a RLCG transmission line that is characterized by line loss, line length, stub type, and termination.

• Build a circuit object with a RLCG transmission line.

• Model a RLCG transmission line element in an RF chain created using an rfbudget object or the RF Budget Analyzer app, and then export this element to RF Blockset™ or to rfsystem System object™ for circuit envelope analysis.