EngeePhased.RectangularWaveform

Генератор прямоугольных импульсов.

Библиотека	`EngeePhased`
Блок	Rectangular Waveform

Описание

Чтобы сгенерировать импульсный сигнал с заданной длительностью импульса и частотой повторения импульсов (PRF), выполните следующие действия:

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

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

Синтаксис

Создание

waveform = phased.RectangularWaveform — создает системный объект генератора прямоугольных импульсов waveform со свойствами по умолчанию.
waveform = phased.RectangularWaveform(Name=Value) — создает системный объект генератора прямоугольных импульсов waveform с указанным свойством Name, установленным на указанное значение Value. Вы можете указать дополнительные свойства в виде пар имя-значение в любом порядке (Name1=Value1,…,Name=ValueN).

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

Y = waveform() — возвращает прямоугольный импульсный сигнал Y.
Y = waveform(prfidx) — использует индекс prfidx для выбора частоты повторения импульсов (PRF) из предопределенного вектора значений, заданного свойством PRF. Этот синтаксис применяется, если для свойства PRFOutputPort установлено значение true.
Y = waveform(freqoffset) — использует freqoffset для генерации сигнала со смещением частоты. Используйте этот синтаксис в случаях, когда необходимо динамически обновлять частоту передаваемых импульсов. Этот синтаксис применяется, если для свойства FrequencyOffsetSource установлено значение "Input port".
Y,PRF = waveform(___) — также возвращает текущую частоту повторения импульсов PRF. Чтобы использовать этот синтаксис, установите для свойства PRFOutputPort значение true, а для свойства OutputFormat значение "Pulses". PRF возвращает текущую частоту повторения импульсов, используемую системой.
Y,COEFF = waveform(___) — также возвращает коэффициенты согласованного фильтра COEFF для текущего импульса. Чтобы использовать этот синтаксис, установите для свойства CoefficientsOutputPort значение true.

Вы можете комбинировать необязательные входные и выходные аргументы, если заданы свойства, которые их включают. Необязательные входы и выходы должны быть перечислены в том же порядке, что и свойства, которые их включают. Например, Y,PRF,COEFF = waveform(prfidx,freqoffset).

Аргументы

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

prfidx — индекс частоты повторения импульсов
целое положительное число

Details

Индекс частоты повторения импульсов (PRF), заданный в виде положительного целого числа. Индекс идентифицирует записи в свойстве PRF. Используйте этот аргумент в случаях, когда импульс передачи должен выбираться динамически. В таких ситуациях свойство PRF содержит список заранее определенных вариантов выбора PRF. Во время моделирования на основе входных данных prfidx один из PRF выбирается в качестве PRF для следующей передачи.

Зависимости

Чтобы использовать этот аргумент, установите для свойства PRFOutputPort значение true.

freqoffset — смещение частоты, Гц
скаляр

Details

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

Зависимости

Чтобы использовать этот аргумент, установите для свойства FrequencyOffsetSource значение "Input port".

Типы данных

Float64

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

Y — импульсный сигнал
комплексный вектор

Details

Выходной сигнал, возвращаемый в виде комплексного вектора.

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

PRF — частота повторения импульсов, Гц
скаляр

Details

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

Зависимости

Чтобы использовать этот аргумент, установите для свойства PRFOutputPort значение true, а для свойства OutputFormat значение "Pulses".

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

COEFF — коэффициенты согласованного фильтра
вектор | матрица

Details

Коэффициенты согласованного фильтра, возвращаемые в виде комплексного вектора размером или комплексной матрицы размером .

Зависимости

Чтобы использовать этот аргумент, установите для свойства CoefficientsOutputPort значение true.

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

Свойства

# NumSamples — число отсчетов выходного сигнала
Real number

Details

Число отсчетов выходного сигнала, заданное в виде положительного целого числа.

Значение по умолчанию — 100.

Зависимости

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

# OutputFormat — формат выходного сигнала
String

Details

Формат выходного сигнала в виде "Pulses" (по умолчанию) или "Samples":

Если вы устанавливаете для этого свойства значение "Pulses", то выход блока состоит из нескольких импульсов. Количество импульсов — это значение свойства NumPulses.
Если вы устанавливаете для этого свойства значение "Samples", то выход блока состоит из нескольких отсчетов. Количество отсчетов — это значение свойства NumSamples.

# FrequencyOffsetSource — источник установки смещения частоты
String

Details

Источник установки смещения частоты, заданный в виде "Property" (по умолчанию) или "Input port":

Если установлено значение "Property", то смещение определяется значением свойства FrequencyOffset.
Если установлено значение "Input port", то смещение определяется значением аргумента FreqOffset.

# DutyCycle — коэффициент заполнения
Real number

Details

Безразмерный коэффициент заполнения, заданный в виде скаляра в диапазоне [0, 1]. Ширина импульса — это значение свойства DutyCycle, деленное на значение свойства PRF. Эта величина безразмерна.

Значение по умолчанию — 0.5.

Зависимости

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

# NumPulses — число импульсов выходного сигнала
Real number

Details

Число импульсов выходного сигнала, заданное в виде положительного целого числа.

Значение по умолчанию — 1.

Зависимости

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

# PRF — частота повторения импульсов
Real number

Details

Частота повторения импульсов (PRF), заданная в виде скаляра или вектора-строки. Единицы измерения — Гц. Интервал повторения импульсов (PRI) является обратной величиной значения (PRF) частоты повторения импульсов. Значение PRF должно удовлетворять следующим ограничениям:

Произведение PRF и PulseWidth должно быть меньше или равно единице. Это условие требует, чтобы ширина импульса была меньше одного PRI. Для сигнала с фазовым кодированием длительность импульса равна произведению длительности одного чипа на количество чипов.
Отношение SampleRate к PRF должно быть целым числом. Это условие требует, чтобы количество отсчетов в одном PRI было целым числом.

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

Если PRFOutputPort имеет значение false, PRF устанавливается только с помощью свойств PRF. Вы можете:
- Реализовать постоянную PRF, указав свойство PRF как положительное вещественное скалярное значение.
- Реализовать дискретную PRF, указав свойство PRF как вектор-строку с положительными вещественными элементами. Каждый вызов объекта использует последовательные элементы этого вектора в качестве PRF. Как только объект достигает последнего элемента вектора, он циклически продолжает процесс с первым элементом вектора.
Когда PRFOutputPort имеет значение true, вы можете установить значение PRF, используя свойство PRF в сочетании с входным аргументом prfidx. Вы реализуете выбираемую PRF, указав свойство PRF как вектор-строку с положительными вещественными элементами. При выполнении объекта выбор PRF осуществляется с использованием индекса, указанного во входном аргументе prfidx, для индексации вектора PRF.

Во всех случаях количество выходных отсчетов фиксировано, если установить для свойства OutputFormat значение "Samples". При использовании изменяющейся частоты повторения импульсов (PRF) и установке для свойства OutputFormat значения "Pulses" количество отсчетов может меняться.

Значение по умолчанию — 10e3.

# CoefficientsOutputPort — включить вывод коэффициентов согласованного фильтра
Logical

Details

Включить или выключить вывод коэффициентов согласованного фильтра, указав значение false (по умолчанию) или true. Установите для этого свойства значение true, чтобы включить вывод коэффициентов согласованного фильтра для формы сигнала, использованной во время моделирования.

# PulseWidth — длительность импульса
Real number

Details

Длительность импульса, заданная в виде положительного скаляра. Значение должно удовлетворять условию PulseWidth ≤ 1/PRF. Единицы измерения — секунды.

Значение по умолчанию — 50e−6.

Зависимости

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

# SampleRate — частота дискретизации
Real number

Details

Частота дискретизации сигнала, заданная как положительный скаляр. Отношение частоты дискретизации к частоте повторения импульсов должно быть положительным целым числом, поэтому количество отсчетов в каждом импульсе должно быть целым числом. Единицы измерения — Гц.

Значение по умолчанию — 1e6.

# DurationSpecification — метод установки длительности импульса
String

Details

Метод установки длительности импульса в виде "Pulse width" (по умолчанию) или "Duty cycle":

"Pulse width" — длительность импульса устанавливается с помощью свойства PulseWidth.
"Duty cycle" — длительность импульса вычисляется из значений свойств PRF и DutyCycle. Ширина импульса равна значению свойства DutyCycle, деленному на значение свойства PRF.

# PRFOutputPort — включить вывод PRF
Logical

Details

Включите ввод выбора PRF, указав значение false (по умолчанию) или true. Если установить для этого свойства значение true, вы можете передать аргумент индекса объекту для выбора предопределенного значения из вектора значений свойства PRF. Если установить для этого свойства значение false, объект будет использовать свойство PRF для определения последовательности PRF, используемой в моделировании.

# FrequencyOffset — смещение частоты
Real number

Details

Смещение частоты, заданное в виде скаляра. Единицы измерения — Гц.

Значение по умолчанию — 0.

Зависимости

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

Методы

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

`step!`	Запустить алгоритм работы системного объекта
`release!`	Разрешить изменение значения свойства системного объекта
`reset!`	Сброс внутренних состояний системного объекта

Специальные для системных объектов генераторов сигнала

`bandwidth`	Ширина полосы пропускания сигнала
`getMatchedFilter`	Коэффициенты согласованного фильтра, полученные из сигнала
`plot`	Построение графика импульсного сигнала

Литература

Richards, M. A. Fundamentals of Radar Signal Processing. New York: McGraw-Hill, 2005.