nport

Creates a linear multiport element in an electrical circuit diagram.

Library

EngeeRF

Syntax

Function call

nport_obj = nport(filename) — creates a multiport element with the property filename.

nport_obj = nport(netparamobj) — creates a multiport element with the property netparamobj.

nport_obj = nport(_, name) — creates a multiport element with the name name.

nport_obj = nport(Name=Value) — creates a multiport element with properties specified by one or more arguments Name=Value. Unspecified properties retain their default values.

Arguments

Input arguments

# filename — Touchstone file

+ line | character vector

Details

The name of the Touchstone file.

# netparamobj — network data

+ scalar

Details

Network data set as a scalar. Network data can contain S-, Z-, Y-, ABCD-, h-, or g-parameters.

# name — the name of the multiport element

+ scalar

Details

The name of the multiport element, set as a scalar.

Name-value input arguments

Specify optional argument pairs in the format Name=Value, where Name — the name of the argument, and Value — the appropriate value. Type arguments Name=Value they should be placed after the other arguments, but the order of the pairs does not matter.

# FileName — Touchstone file

+ line | character vector

Details

The name of the Touchstone file.

# NumPorts — number of ports

+ scalar

Details

The number of ports specified as a scalar.

# Input is the number of the input port of the multiport element in the radio frequency distribution

+ 1 (by default) | scalar

Details

The number of the input port of the multiport (n-port) element in the radio frequency distribution, set as a scalar. Use this property to assign the port of a multiport element to the input port.

Features Input, Output and Termination they allow you to consider a multiport (n-port) element as a two-port one.

If the property Input set the same port number as the property Output, then the function nport assigns a new port number to the property Output by cyclically shifting to the right. For example, if in a three-port element the properties Input and Output set the value 2, then the function nport assigns the property Output meaning 3.

# Output is the number of the output port of the multiport element in the radio frequency distribution

+ 2 (by default) | scalar

Details

The number of the output port of the multiport (n-port) element in the radio frequency distribution, set as a scalar. Use this property to assign the port of the multiport element to the output.

Features Input, Output and Termination they allow you to consider a multiport (n-port) element as a two-port one.

If the property Output set the same port number as the property Input, then the function nport assigns a new port number to the property Input by cyclically shifting to the left. For example, if in a three-port element the properties Output and Input set the value 2, then the function nport assigns the property Input meaning 1.

# Termination — resistance for matching unused ports of multiport elements in radio frequency allocation

+ NetworkData.Impedance (by default) | a real non-negative scalar | a real non-negative vector

Details

The resistance in ohms for matching unused ports of multiport elements in the radio frequency distribution is given as a real non-negative scalar or a real non-negative vector of length NumPorts. If no resistance is specified, the object loads unused ports by setting the resistance value. NetworkData.Impedance. To create:

Short circuit load — install Termination an equal 0.
Idle load — set Termination an equal Inf

Features Input, Output and Termination they allow you to consider a multiport (n-port) element as a two-port one.

When setting the property Termination in the value [], element nport It is no longer considered as a two-port, but the properties of Input and Output will not be displayed in the list of properties.

# NetworkData — network data

+ scalar

Details

Network data set as a scalar. Network data can contain S-, Z-, Y-, ABCD-, h-, or g-parameters.

# NoiseData — noise data of a two-port element

+ noiseParameters object

Details

Noise data of a two-port element, set as an object noiseParameters. An object noiseParameters It contains a frequency-dependent noise factor, downloaded from the Touchstone file for a dual-port element or built on the command line. To reset the noise of a two-port element, set the property NoiseData meaning [].

If NumPorts more 2, set the value of the argument NoiseData along with the argument NetworkData.

# Name — the name of the multiport element

+ scalar

Details

The name of the multiport element, set as a scalar.

# Ports — port names

+ vector of cells

Details

Port names in the form of a vector of cells. This argument is read-only.

# Terminals — terminal names

+ vector of cells

Details

Terminal names in the form of a vector of cells. There are two terminals per port. The positive terminals are listed first ("p1+", "p2+"…) and then negative ("p1–", "p2–"…). This argument is read-only.

# parentNodes — the parent nodes of the circuit connected to the terminals of the multiport element

+ a vector of integers

Details

The parent nodes of the circuit connected to the terminals of a multiport element, in the form of a vector of integers. Vector ParentNodes has the same length as Terminals. This argument is read-only and is displayed only after adding the multiport element data.

# ParentPath is the full path to the schema to which the multiport element belongs

+ character vector

Details

The full path to the chain to which the multiport element belongs, in the form of a vector of characters. This property is read-only and is displayed only after adding a multiport element to the chain.

Output arguments

# nport_obj — multi-port element

+ object

Details

Multi-port element.