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

sparameters

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

Библиотека

EngeeRF

Синтаксис

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

  • sobj = sparameters(filename) — создает объект S-параметров sobj путем импорта данных из файла Touchstone, указанного в filename.

  • sobj = sparameters(data, freq) — создает объект S-параметров на основе данных S-параметров data и частот freq.

  • sobj = sparameters(data, freq, Z0) — создает объект S-параметров на основе данных S-параметров data и частот freq с заданным расчетным полным сопротивлением Z0.

  • sobj = sparameters(rfobj, freq) — рассчитывает S-параметры радиочастотного объекта, например фильтра, схемы, линии передачи, последовательного или шунтирующего RLC объекта, аттенюатора или радиочастотной антенны с расчетным полным сопротивлением по умолчанию.

  • sobj = sparameters(rfobj, freq, Z0) — вычисляет S-параметры радиочастотного объекта, например фильтра, схемы или линии передачи, с заданным расчетным полным сопротивлением Z0.

  • sobj = sparameters(netparamobj) — преобразует объект параметров сети netparamobj в объект S-параметров с расчетным полным сопротивлением по умолчанию.

  • sobj = sparameters(netparamobj, Z0) — преобразует объект параметров сети netparamobj в объект S-параметров с заданным расчетным полным сопротивлением Z0.

  • sobj = sparameters(rfdataorckt) — извлекает данные сети из rfdataobj или rfcktobj и преобразует их в объект S-параметров.

  • sobj = sparameters(mnobj) — возвращает S-параметры наилучшей согласующей схемы, рассчитанные для списка частот, составленного на основе нагрузочного сопротивления и сопротивления источника.

  • sobj = sparameters(mnobj, freq) — возвращает S-параметры наилучшей согласующей схемы на каждой заданной частоте freq.

  • sobj = sparameters(mnobj, freq, Z0) — возвращает S-параметры наилучшей согласующей схемы на каждой заданной частоте freq и характеристическом сопротивлении Z0.

  • sobj = sparameters(___, circuitindices) — возвращает массив объектов S-параметров, по одному объекту на каждую цепь, указанную в circuitindices. Используйте эту опцию с любой комбинацией входных аргументов из предыдущих синтаксисов.

Аргументы

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

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

Details

Файл данных Touchstone, заданный как символьный вектор, содержащий данные о параметрах сети.

# data — данные S-параметров
массив комплексных чисел

Details

Данные S-параметров, заданные как массив комплексных чисел размером на на .

# freq — частоты S-параметров
положительный вещественный вектор

Details

Частоты S-параметров, заданные как вектор положительных вещественных чисел, отсортированных от наименьшего к наибольшему.

# Z0 — расчетное полное сопротивление, Ом
50 | положительный вещественный скаляр | положительный вещественный вектор

Details

Расчетное полное сопротивление в Ом, задается одним из следующих способов:

  • Положительный вещественный скаляр, если требуется задать одинаковое расчетное полное сопротивление для всех портов сети.

  • Положительный вещественный вектор длиной , если требуется задать разное расчетное полное сопротивление для каждого порта в -портовой сети.

  • Положительный вещественный вектор длиной , если требуется задать разное расчетное полное сопротивление для каждой из частот в данных.

Если расчетное полное сопротивление — это вектор, а количество портов равно количеству частот данных , , то функция sparameters назначит каждый элемент вектора каждому порту сети. Чтобы задать расчетное полное сопротивление для каждой частоты в этом случае, укажите Z0 как трехмерный вектор размером 1 на 1 на .

Аргумент Z0 нельзя указать при импорте данных S-параметров из файла. Аргумент Z0 является необязательным, и функция сохраняет сопротивление в свойстве Impedance объекта sobj.

# rfobj — радиочастотный объект
РЧ объект

Details

Радиочастотный (РЧ) объект, заданный как один из перечисленных ниже:

  • Объект схемы электрической цепи circuit.

  • Объект РЧ фильтра: rffolter и lcladder.

  • Объект линии передач: txlineCoaxial, txlineCPW, txlineMicrostrip, txlineParallelPlate, txlineRLCGLine, txlineLumped, txlineTwoWire, txlineEquationBased, txlineDelayLossless, txlineDelayLossy, txlineElectricalLength, txlineStripline.

  • Последовательные и шунтирующие RLC-объекты: seriesRLC и shuntRLC.

  • Объект аттенюатора attenuator.

  • Объект РЧ антенны rfantenna.

  • Объект сдвига фазы phaseshift.

  • Объект IMT-миксер mixerIMT.

  • Объект РЧ делителя rfdivider.

  • Объект взаимной индуктивности mutualInductor.

# netparamobj — объект параметров сети
объект параметров сети

Details

Объект параметров сети следующих типов: sparameters, yparameters, zparameters, gparameters, hparameters, abcdparameters и tparameters.

# rfdataorckt — объект РЧ данных или схемы
объект РЧ данных | объект РЧ сетей

Details

Объект РЧ данных или схемы. Укажите rfdataobj как объект rfdata.data или rfdata.network, либо укажите rfcktobj как любой анализируемый объект типа rfckt, например, rfckt.amplifier или rkckt.cascade.

# mnobj — согласующая схема
объект согласующей схемы

Details

Согласующая схема, заданная как объект matchingnetwork.

Типы данных

String, Char

# circuitindices — индекс согласующей схемы
скаляр

Details

Индекс согласующей схемы, заданный как скаляр.

Типы данных

Float64

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

# sobj — данные S-параметров
объект S-параметр

Details

Данные S-параметров, возвращаемые в виде объекта. Объект содержит следующие свойства:

  • NumPorts — количество портов в виде целого числа. Функция вычисляет это значение автоматически при создании объекта.

  • Frequencies — частоты S-параметров в виде вектора размером на 1 положительных вещественных чисел, отсортированных от наименьшего к наибольшему. Функция устанавливает это свойство на основе аргументов filename или freq.

  • Parameters — данные S-параметров в виде массива комплексных чисел размером на на . Функция устанавливает это свойство на основе аргументов filename или data.

  • Impedance — расчетное полное сопротивление в Ом в виде положительного вещественного скаляра. Функция устанавливает это свойство на основе аргументов filename или Z0. Если расчетное полное сопротивление не указано, то функция использует значение по умолчанию 50.

Примеры

Расчет S-параметров для объекта схемы

Details

Создадим резистор R50 и добавим его к объекту схемы example1. Рассчитаем S-параметры для example1 и выведем свойства объекта S-параметра.

using EngeeRF
hR1 = resistor(50,"R50")
hckt1 = circuit("example1")
add(hckt1,[1 2],hR1)
setports(hckt1, [1 0],[2 0])
freq = range(1e3, 2e3, length=100)
S = sparameters(hckt1,freq,100)

println("NumPorts - ", S.NumPorts)
println("Parameters - ", summary(S.Parameters))
println("Frequencies - ", summary(S.Frequencies))
println("Impedance - ", S.Impedance)
NumPorts - 2
Parameters - 2×2×100 Array{Float64, 3}
Frequencies - 100-element StepRangeLen{Float64, Base.TwicePrecision{Float64}, Base.TwicePrecision{Float64}, Int64}
Impedance - 100