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

EngeeComms.Repeat

Повторная дискретизация входного сигнала с более высокой скоростью путем повторения значений.

Библиотека

EngeeComms

Блок

Repeat

Описание

Системный объект EngeeComms.Repeat увеличивает частоту дискретизации каждого канала входного сигнала (размером на ) до частоты, в раз превышающей частоту дискретизации входного сигнала. Для этого объект повторяет на выходе каждый последовательный входной отсчет раз. Целое число L задается в свойстве RepetitionCount или через входной аргумент L.

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

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

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

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

Синтаксис

Создание

  • repeat = EngeeComms.Repeat() создает системный объект для увеличения частоты дискретизации каждого канала входного сигнала repeat со свойствами по умолчанию.

    Пример:

    repeat = EngeeComms.Repeat()
  • repeat = EngeeComms.Repeat(Name=Value) создает системный объект repeat с указанным свойством Name, установленным на указанное значение Value. Вы можете указать дополнительные аргументы в виде пары имя-значение в любом порядке (Name1=Value1,…​,NameN=ValueN).

    Пример:

    repeat = EngeeComms.Repeat(RepetitionCountSource=10)

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

  • outsignal = repeat(insignal) увеличивает частоту дискретизации каждого канала входного сигнала, как указано на repeat. Результат возвращается в outsignal.

Аргументы

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

In — входной сигнал
скаляр | вектор | матрица

Details

Входной сигнал в виде действительного скаляра, вектора или матрицы.

Этот аргумент не имеет названия до тех пор, пока вы не установите для свойства RepetitionCountSource значение Input port.

Типы данных

Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool

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

Да

L — количество повторений
целое положительное число ≤ Lmax

Details

Входной сигнал количества повторений как целое положительное число.

Зависимости

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

Типы данных

Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64

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

Нет

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

Out — выходной сигнал
скаляр | вектор | матрица

Details

Выходной сигнал с частотой дискретизации, которая в раз выше частоты дискретизации на входе. Системный объект EngeeComms.Repeat показывает на выходе сигнал, имеющий тот же тип данных и ту же размерность, что и входной сигнал. Размер выходного сигнала зависит от значения числа повторений и настройки свойства RateOptions.

Если для свойства RepetitionCount установлено значение L, а для свойства RateOptions установлено значение:

  • Enforce single-rate processing — объект поддерживает частоту дискретизации на входе, увеличивая размер выходного кадра в раз.

  • Allow multirate processing — объект произведет повторный отсчет сигнала таким образом, что частота дискретизации на выходе в раз превышает входную. Выходной сигнал имеет тот же размер кадра, что и входной.

При вводе количества повторов через входной порт L свойство RateOptions автоматически устанавливается в положение Enforce single-rate processing. В этом случае объект поддерживает на выходе частоту дискретизации входного сигнала, увеличивая размер выходного кадра в раз.

Выходной сигнал является сигналом переменного размера, если выполняется одно или оба условия:

  • На вход подается сигнал переменного размера.

  • Количество повторений подается через порт L.

Типы данных

Float64

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

Нет

Свойства

# InputProcessing — метод обработки входных сигналов
Строка

Details

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

  • Columns as channels (frame based) — если вы выбираете эту опцию, объект обрабатывает каждый столбец ввода как отдельный канал. В этом режиме объект может выполнять односкоростную или многоскоростную обработку.

  • Elements as channels (sample based) — если вы выбираете эту опцию, объект обрабатывает каждый элемент ввода как отдельный канал. В этом режиме объект всегда выполняет многоскоростную обработку.

Типы данных

String

# RateOptions — метод, с помощью которого объект повышает частоту дискретизации входа
Строка

Details

Задайте метод, которым объект повышает частоту дискретизации входа. Вы можете выбрать один из следующих вариантов:

  • Enforce single-rate processing — если вы выбираете эту опцию, объект поддерживает входную частоту дискретизации, увеличивая размер выходного кадра фактором L. Чтобы выбрать эту опцию, вы должны установить для свойства InputProcessing значение Columns as channels (frame based).

  • Allow multirate processing — если вы выбираете эту опцию, объект произведет повторный отсчет сигнала таким образом, что частота дискретизации на выходе в раз быстрее, чем на входе.

Типы данных

String

# RepetitionCountSource — источник количества повторений
Строка

Details

Источник количества повторений:

  • Dialog parameter — количество повторений задается в свойстве RepetitionCount.

  • Input port — количество повторений будет получено через входной аргумент L.

Типы данных

String

# RepetitionCount — количество повторений
Вещественное число

Details

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

Зависимости

Чтобы использовать этот свойство, установите для свойства RepetitionCountSource значение Dialog parameter.

# InitialConditions — начальное значение
Скаляр / вектор целых чисел типа Int64

Details

Укажите значение, которым инициализируется объект для случаев ненулевого времени ожидания в виде скаляра или матрицы.

Типы данных

Int8, Int16, Int32, Int64

Методы

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

step!

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

release!

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