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

EngeePhased.CustomMicrophoneElement

Страница в процессе разработки.

Пользовательский микрофон.

Библиотека

EngeePhased

Описание

Системный объект EngeePhased.CustomMicrophoneElement моделирует микрофон с пользовательской пространственной диаграммой направленности.

Чтобы создать и использовать пользовательский микрофон, выполните следующие действия:

  1. Создайте объект EngeePhased.CustomMicrophoneElement и установите его свойства.

  2. Вызовите объект с аргументами, как если бы это была функция.

Чтобы узнать подробнее о том, как работать с системными объектами, см. Системные объекты Engee.

Синтаксис

Создание

  • microphone = phased.CustomMicrophoneElement() — создает пользовательский микрофон со значениями свойств по умолчанию.

  • microphone = phased.CustomMicrophoneElement(Name=Value) — создает пользовательский микрофон с заданными свойствами в виде пары Name=Value, где Name — имя свойства, а Value — соответствующее значение. Можно указать несколько пар «имя-значение», порядок пар не имеет значения. Неуказанные свойства сохраняют свои значения по умолчанию.

Использование

  • RESP = microphone(FREQ,ANG) — возвращает диаграмму направленности микрофона RESP на рабочих частотах FREQ в направлениях ANG.

Аргументы

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

FREQ — рабочие частоты микрофона
скаляр | вектор-строка длиной L

Details

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

Типичные значения находятся в диапазоне FrequencyVector. В противном случае элемент не имеет диаграммы направленности и возвращает ее в виде −Inf.

Единицы измерения — Гц.

Типы данных

Float64

ANG — азимутальный угол и угол места диаграммы направленности
вектор-строка длиной M | матрица 2 на M

Details

Направления диаграммы направленности, заданные как вещественный вектор-строка длиной или вещественная матрица на .

Если ANG — матрица, то каждый столбец задает направление в виде [azimuth; elevation]. Азимутальный угол должен находиться в диапазоне от −180° до 180° включительно. Угол места должен находиться в диапазоне от −180° до 180° включительно.

Если ANG — вектор-строка, каждый элемент задает азимутальный угол направления. В этом случае соответствующий угол места принимается равным 0°.

Единицы измерения — градусы.

Подробнее про азимутальный угол и угол места см. Азимутальные углы и углы места.

Типы данных

Float64

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

RESP — диаграмма направленности микрофона
комплексная матрица M на L

Details

Диаграмма направленности микрофона, возвращаемый как комплексная матрица на , где — количество углов, заданных в ANG, — количество частот, заданных в FREQ.

Свойства

# FrequencyVector — вектор диапазона рабочих частот
[0 1e20] (по умолчанию) | неотрицательный вещественный вектор-строка 1 на L

Details

Частоты, на которых должны быть получены частотные характеристики и диаграммы направленности антенны, заданные как неотрицательный вещественный вектор-строка на . Элементы вектора должны располагаться в порядке возрастания. Микрофон не имеет диаграммы направленности вне диапазона частот, заданного минимальным и максимальным элементами вектора частот.

Единицы измерения — Гц.

# FrequencyResponse — частотные характеристики микрофона
[0 0] (по умолчанию) | вещественный вектор 1 на L

Details

Частотные характеристики на частотах, определенных свойством FrequencyVector, заданные как вектор-строка на , где — длина вектора FrequencyVector.

Единицы измерения — дБ.

# PolarPatternFrequencies — частоты измерения полярной диаграммы направленности
1e3 (по умолчанию) | вещественный вектор положительных значений 1 на M

Details

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

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

Единицы измерения — Гц.

# PolarPatternAngles — углы измерения полярной диаграммы направленности
[-180:180] (по умолчанию) | вещественный вектор 1 на N

Details

Углы измерения полярных диаграмм направленности, заданное как вещественный вектор на . Углы измеряются от центральной оси микрофона и должны находиться в диапазоне от −180° до 180° включительно.

Единицы измерения — градусы.

# PolarPattern — диаграмма направленности
изотропная диаграмма направленности с нормированным уровнем сигнала 0 дБ (по умолчанию) | матрица вещественных значений M на N

Details

Диаграмма направленности микрофона, заданная как вещественная матрица на , где — это количество частот, указанное в свойстве PolarPatternFrequencies, а — количество углов, указанных в свойстве PolarPatternAngles.

Каждая строка матрицы представляет собой диаграмму направленности микрофона, измеренного на соответствующей частоте, указанной в свойстве PolarPatternFrequencies, и соответствующих углах, указанных в свойстве PolarPatternAngles.

Предполагается, что диаграмма направленности измеряется в азимутальной плоскости, где угол места равен 0° и где центральная ось приемника принимается равной 0° по азимутальному углу и 0° по углу места.

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

Единицы измерения — дБ.

Методы

Общие для всех системных объектов

step!

Запуск алгоритма работы системного объекта

release!

Разрешение изменение значения свойства системного объекта

reset!

Сброс внутренних состояний системного объекта

Алгоритмы

Details

Диаграмма направленности пользовательского микрофона представляет собой комбинацию его частотной характеристики и пространственной характеристики. Этот системный объект вычисляет обе характристики с помощью интерполяции ближайших соседей, а затем перемножает их для получения общей диаграммы.

Если значение свойства PolarPatternFrequencies не является скаляром, объект задает несколько диаграмм направленности. В этом случае при интерполяции используется та диаграмма направленности, которая измерена ближе всего к указанной частоте.