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

EngeeRF.rfantenna

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

Библиотека

EngeeRF

Описание

Используйте системный объект EngeeRF.rfantenna для создания элемента антенны, который можно смоделировать в виде передатчика, приемника или приемопередатчика. При проектировании РЧ-системы с использованием объекта rfbudget, можно смоделировать РЧ-антенну с помощью объекта EngeeRF.rfantenna и добавить ее в РЧ-систему. Затем этот элемент можно экспортировать в библиотеку EngeeRF для анализа огибающей цепи.

Синтаксис

Создание

  • ant = EngeeRF.rfantenna() — создает объект радиочастотной (РЧ) антенны с коэффициентом усиления 0 дБи, свойства которого заданы по умолчанию.

  • ant = EngeeRF.rfantenna(Name=Value) — создает системный объект РЧ-антенны ant со свойствами, заданными в виде пары Name=Value, где Name — имя свойства, а Value — соответствующее значение. Можно указать несколько пар «имя-значение», порядок пар не имеет значения. Неуказанные свойства сохраняют свои значения по умолчанию.

    Пример: ant = EngeeRF.rfantenna(Gain = 10) создает объект РЧ-антенны с коэффициентом усиления 10 дБи.

Аргументы

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

# ant — объект РЧ-антенны
объект

Details

Объект РЧ-антенны, содержащий следующие свойства:

  • Gain — коэффициент усиления антенны;

  • Z — входной импеданс;

  • Type — тип элемента антенны;

  • TxEIRP — эффективная изотропно-излучаемая мощность (EIRP) передающей антенны, к которой настроен приемник;

  • PathLoss — потери сигнала до его поступления на приемник;

  • Name — название объекта в виде строки, например "Antenna";

  • Ports — имена портов в виде кортежа строк: ("p1",);

  • Terminals — имена клемм в виде кортежа строк;

  • ParentNodes — узлы родительской схемы в виде вектора целых чисел, отображаемые только после добавления дочерней схемы к родительской схеме;

  • ParentPath — полный путь к родительской схеме в виде строки, отображаемый только после добавления дочерней схемы к родительской схеме;

  • NumPorts — количество портов;

  • Parent — родительская схема, которой принадлежит объект цепи.

Свойства

# Gain — коэффициент усиления антенны, дБи
0.0 (по умолчанию) | скаляр | вектор

Details

Коэффициент усиления антенны в дБи, заданный как неотрицательный скаляр или двухэлементный вектор (значение по умолчанию — [0.0, 0.0]).

Укажите свойство Gain в виде вектора из двух элементов, если для свойства Type установлено значение "TransmitReceive". Для управления эффективной изотропной мощностью излучения (Effective Isotropically Radiated Power, EIRP) изменяйте коэффициент усиления антенного элемента.

Типы данных

Float64

# Z — входной импеданс, Ом
50.0 (по умолчанию) | скаляр | вектор

Details

Входной импеданс элемента РЧ-антенны в Ом, заданный как положительный скаляр или вектор из двух элементов (значение по умолчанию — ComplexF64[50.0 + 0.0im, 50.0 + 0.0im]).

Укажите свойство Z в виде вектора из двух элементов, если для свойства Type установлено значение "TransmitReceive".

Типы данных

Float64
Поддержка комплексных чисел

Да

# Type — тип элемента антенны
"Transmitter" (по умолчанию) | "Receiver" | "TransmitReceive"

Details

Тип элемента антенны, заданный как "Transmitter", "Receiver" или "TransmitReceive". Если для свойства Type установлено значение "TransmitReceive", передающая и приемная антенны работают одновременно.

Типы данных

String

# TxEIRP — эффективная изотропно-излучаемая мощность передающей антенны, к которой настроен приемник, дБм
−30.0 (по умолчанию) | скаляр

Details

Значение эффективной изотропно-излучаемой мощности (Effective Isotropically Radiated Power, EIRP) передающей антенны, к которой настроен приемник, заданное как скаляр в дБм.

Это свойство необходимо задать при проектировании элемента приемной антенны.

Типы данных

Float64

# PathLoss — потери сигнала до его поступления на приемник, дБ
0.0 (по умолчанию) | скаляр

Details

Потери в дБ, которые несет сигнал до достижения приемника, заданные как неотрицательный скаляр.

Зависимости

Чтобы использовать это свойство, установите для свойства Type значение "Receiver" или "TransmitReceive".

Типы данных

Float64

# Name — имя элемента РЧ-антенны
"Antenna" (по умолчанию) | строка

Details

Имя элемента РЧ-антенны, заданное как строка.

Типы данных

String

# Terminals — имена клемм РЧ-антенны
("p1+", "p1−") (по умолчанию) | кортеж строк

Details

Имена клемм РЧ-антенны, заданные как кортеж строк.

Это свойство доступно только для чтения.

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

Details

Количество входных и выходных портов в элементе РЧ-антенны, заданное как положительный скаляр.

Это свойство доступно только для чтения.
Типы данных

Int64

Методы

sparameters

Вычисление S-параметров для радиочастотных данных, сетей, схем и соответствующих объектов

Примеры

Создание приемопередающего антенного элемента

Details

Создадим радиочастотный антенный элемент в конфигурации «передатчик — приемник». Установим коэффициент усиления и импеданс передающей антенны равными 5 дБ и 45 Ом соответственно, а коэффициент усиления и импеданс приемной антенны — 6 дБ и 55 Ом соответственно.

import EngeeRF: rfantenna

ant = rfantenna(Type = "TransmitReceive", Gain = [5, 6], Z = [45, 55])

println("Gain: ", ant.Gain,
        "\nZ: ", ant.Z,
        "\nType: ", ant.Type,
        "\nTxEIRP: ", ant.TxEIRP,
        "\nPathLoss: ", ant.PathLoss,
        "\nName: ", ant.Name)
Gain: [5.0, 6.0]
Z: ComplexF64[45.0 + 0.0im, 55.0 + 0.0im]
Type: TransmitReceive
TxEIRP: -30.0
PathLoss: 0.0
Name: Antenna

Рассчитаем S-параметры радиочастотного элемента антенны в конфигурации «передатчик — приемник» на частоте 1 ГГц. Выведем свойства объекта S-параметров.

import EngeeRF: sparameters

sparam = sparameters(ant, 1e9)

println("Impedance: ", sparam.Impedance,
        "\nNumPorts: ", sparam.NumPorts,
        "\nParameters: ", sparam.Parameters,
        "\nFrequencies: ", sparam.Frequencies)
Impedance: 50.0
NumPorts: 1
Parameters: ComplexF64[-0.0025062656641604013 + 0.0im;;;]
Frequencies: [1.0e9]