Документация Engee

nport

Создает линейный многопортовый элемент в схеме электрической цепи.

Библиотека

EngeeRF

Синтаксис

Вызов функции

  • nport_obj = nport(___, name) — создает многопортовый элемент с именем name.

  • nport_obj = nport(Name=Value) — создает многопортовый элемент со свойствами, заданными одним или несколькими аргументами Name=Value. Неуказанные свойства сохраняют свои значения по умолчанию.

Аргументы

Входные аргументы

# filename — Touchstone файл
строка | символьный вектор

Details

Имя Touchstone файла.

# netparamobj — сетевые данные
скаляр

Details

Сетевые данные, заданные как скаляр. Сетевые данные могут содержать S-, Z-, Y-, ABCD-, h- или g-параметры.

# name — имя многопортового элемента
скаляр

Details

Имя многопортового элемента, заданное как скаляр.

Входные аргументы «имя-значение»

Укажите необязательные пары аргументов в формате Name=Value, где Name — имя аргумента, а Value — соответствующее значение. Аргументы типа Name=Value должны располагаться после других аргументов, но порядок пар не имеет значения.

# FileName — Touchstone файл
строка | символьный вектор

Details

Имя Touchstone файла.

# NumPorts — число портов
скаляр

Details

Число портов, заданное как скаляр.

# Input — номер входного порта многопортового элемента в распределении радиочастот
1 (по умолчанию) | скаляр

Details

Номер входного порта многопортового (n-портового) элемента в распределении радиочастот, заданный как скаляр. Используйте это свойство, чтобы назначить порт многопортового элемента входным.

Свойства Input, Output и Termination позволяют рассматривать многопортовый (n-портовый) элемент как двухпортовый.

Если свойству Input задать тот же номер порта, что и свойству Output, то функция nport присвоит новый номер порта свойству Output посредством циклического сдвига вправо. Например, если в трехпортовом элементе свойствам Input и Output задать значение 2, то функция nport присвоит свойству Output значение 3.

# Output — номер выходного порта многопортового элемента в распределении радиочастот
2 (по умолчанию) | скаляр

Details

Номер выходного порта многопортового (n-портового) элемента в распределении радиочастот, заданный как скаляр. Используйте это свойство, чтобы назначить порт многопортового элемента выходным.

Свойства Input, Output и Termination позволяют рассматривать многопортовый (n-портовый) элемент как двухпортовый.

Если свойству Output задать тот же номер порта, что и свойству Input, то функция nport присвоит новый номер порта свойству Input посредством циклического сдвига влево. Например, если в трехпортовом элементе свойствам Output и Input задать значение 2, то функция nport присвоит свойству Input значение 1.

# Termination — сопротивление для согласования неиспользуемых портов многопортовых элементов в распределении радиочастот
NetworkData.Impedance (по умолчанию) | вещественный неотрицательный скаляр | вещественный неотрицательный вектор

Details

Сопротивление в Ом для согласования неиспользуемых портов многопортовых элементов в распределении радиочастот, задается как вещественный неотрицательный скаляр или вещественный неотрицательный вектор длиной NumPorts. Если сопротивление не указано, то объект нагружает неиспользуемые порты, устанавливая значение сопротивления NetworkData.Impedance. Чтобы создать:

  • Нагрузку короткого замыкания — установите Termination равным 0.

  • Нагрузку холостого хода — установите Termination равным Inf

Свойства Input, Output и Termination позволяют рассматривать многопортовый (n-портовый) элемент как двухпортовый.

При установке свойства Termination в значение [], элемент nport больше не рассматривается как двухпортовый, а свойства Input и Output не будут отображаться в списке свойств.

# NetworkData — сетевые данные
скаляр

Details

Сетевые данные, заданные как скаляр. Сетевые данные могут содержать S-, Z-, Y-, ABCD-, h- или g-параметры.

# NoiseData — данные о шуме двухпортового элемента
noiseParameters объект

Details

Данные о шуме двухпортового элемента, заданные как объект noiseParameters. Объект noiseParameters содержит частотно-зависимый коэффициент шума, загруженный из файла Touchstone для двухпортового элемента или построенный в командной строке. Чтобы сбросить шум двухпортового элемента, установите для свойства NoiseData значение [].

Если NumPorts больше 2, установите значение аргумента NoiseData вместе с аргументом NetworkData.

# Name — имя многопортового элемента
скаляр

Details

Имя многопортового элемента, заданное как скаляр.

# Ports — имена портов
вектор ячеек

Details

Имена портов в виде вектора ячеек. Этот аргумент доступен только для чтения.

# Terminals — имена клемм
вектор ячеек

Details

Имена клемм в виде вектора ячеек. На каждый порт приходится два терминала. Положительные клеммы указаны первыми ("p1+", "p2+"…​), а затем отрицательные ("p1–", "p2–"…​). Этот аргумент доступен только для чтения.

# ParentNodes — родительские узлы схемы, подключенные к клеммам многопортового элемента
вектор целых чисел

Details

Родительские узлы схемы, подключенные к клеммам многопортового элемента, в виде вектора целых чисел. Вектор ParentNodes имеет ту же длину, что и Terminals. Этот аргумент доступен только для чтения и отображается только после добавления данных многопортового элемента.

# ParentPath — полный путь к схеме, к которой принадлежит многопортовый элемент
символьный вектор

Details

Полный путь к цепи, к которой принадлежит многопортовый элемент, в виде вектора символов. Это свойство доступно только для чтения и отображается только после добавления многопортового элемента в цепь.

Выходные аргументы

# nport_obj — многопортовый элемент
объект

Details

Многопортовый элемент.