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

EngeePhased.PhaseCodedWaveform

Генератор сигнала с фазокодовой модуляцией.

Библиотека

EngeePhased
Блок

ФКМ

Описание

Чтобы сгенерировать сигнал с фазокодовой модуляцией (ФКМ), выполните следующие действия:

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

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

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

Синтаксис

Создание

  • waveform = EngeePhased.PhaseCodedWaveform() — создает системный объект waveform генератора сигнала с ФКМ со свойствами по умолчанию.

  • waveform = EngeePhased.PhaseCodedWaveform(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".

  • 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

Текущая частота повторения импульсов, возвращаемая в виде скаляра.

Зависимости

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

Типы данных

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

да

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

Details

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

Зависимости

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

Типы данных

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

да

Свойства

# Code — тип фазового кода
Строка

Details

Укажите тип фазового кода, используемого при фазовой модуляции. Допустимые значения:

  • "Frank" (по умолчанию);

  • "P1";

  • "P2";

  • "Px";

  • "Zadoff-Chu";

  • "P3";

  • "P4";

  • "Barker".

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

Details

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

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

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

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

Details

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

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

Зависимости

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

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

Details

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

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

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

# NumPulses — число импульсов выходного сигнала
Вещественное число

Details

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

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

Зависимости

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

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

Details

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

  • Произведение PRF и длительности импульса должно быть меньше или равно единице. Это условие требует, чтобы ширина импульса была меньше одного 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.

# SequenceIndex — индекс последовательности Задова — Чу
Целое число

Details

Укажите индекс последовательности, используемый в коде "Zadoff-Chu", в виде целого положительного числа.

Значение свойства SequenceIndex должно быть взаимно простым со значением свойства NumChips.

Зависимости

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

# ChipWidth — длительность каждого чипа
Вещественное число

Details

Укажите длительность каждого чипа в сигнале с ФКМ в виде положительного скаляра. Для данного сигнала длительность импульса равна произведению длительности чипа и количества чипов.

Значение этого свойства должно удовлетворять следующим ограничениям:

  • ChipWidth меньше или равно (1/(NumChips * PRF)) — общая длительность всех чипов не может превышать длительность импульса.

  • SampleRate * ChipWidth является целым числом — количество выборок в чипе должно быть целым числом.

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

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

Details

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

# SampleRate — частота дискретизации
Вещественное число

Details

Частота дискретизации сигнала, заданная как положительный скаляр. Значение этого свойства должно удовлетворять следующим ограничениям:

  • SampleRate/PRF является скаляром или вектором, содержащим только целые числа — количество отсчетов в импульсе должно быть целым числом.

  • SampleRate * ChipWidth является целым числом — количество отсчетов в чипе должно быть целым числом.

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

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

# NumChips — длина кода
Вещественное число

Details

Укажите количество чипов на импульс в сигнале с ФКМ в виде целого положительного числа. Значение этого свойства должно быть меньше или равно (1/(NumChips * PRF)) — общая длительность всех чипов не может превышать интервал повторения импульсов.

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

В таблице приведены дополнительные ограничения на количество чипов для различных типов кода.

Code

NumChips

"Frank", "P1", "Px"

Квадрат простого числа

"P2"

Четное число, которое является квадратом простого числа

"Barker"

2, 3, 4, 5, 7, 11 или 13

# PRFOutputPort — включить вывод PRF
Логический тип

Details

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

Зависимости

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

# FrequencyOffset — смещение частоты
Вещественное число

Details

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

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

Зависимости

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

Методы

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

step!

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

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

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

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

bandwidth

Ширина полосы пропускания сигнала
getMatchedFilter

Коэффициенты согласованного фильтра, полученные из сигнала
plot

Построение графика импульсного сигнала

Алгоритмы

В двухчиповом коде Баркера можно использовать [1 −1] или [1 1] в качестве последовательности амплитуд. В данном системном объекте реализовано [1 −1].

В четырехчиповом коде Баркера можно использовать [1 1 −1 1] или [1 1 1 −1] в качестве последовательности амплитуд. В данном системном объекте реализовано [1 1 −1 1].

В коде Задова — Чу можно использовать последовательность фаз по часовой стрелке или против нее. В данном системном объекте реализована последовательность против часовой стрелки, например, π⋅f(k)⋅SequenceIndex/NumChips вместо −π⋅f(k)⋅SequenceIndex/NumChips. В этих выражениях k — индекс чипа, а f(k) — функция от k.

Более подробную информацию см. в [1].

Литература

  1. Levanon, N. and E. Mozeson. Radar Signals. Hoboken, NJ: John Wiley & Sons, 2004.