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

EngeeComms.ErrorRateCalculation

Вычисляет битовую или символьную ошибку во входных данных.

Библиотека

EngeeComms

Блок

Error Rate Calculation

Описание

Системный объект EngeeComms.ErrorRateCalculation сравнивает входные данные от передатчика с входными данными от приемника. Объект вычисляет коэффициент ошибок как текущую статистику путем деления общего количества неравных пар элементов данных на общее количество элементов входных данных из одного источника.

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

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

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

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

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

Синтаксис

Создание

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

    Пример:

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

    Пример:

    errcalc = EngeeComms.ErrorRateCalculation(ReceiveDelay=5)

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

  • outsignal = errcalc(insignal) сравнивает входные данные от передатчика с входными данными от приемника, как указано на errcalc. Результат возвращается в outsignal.

Аргументы

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

Tx — переданные данные
скаляр | вектор-столбец

Details

Переданные данные в виде скаляра или вектор-столбца.

Если вы задаете Tx или Rx ввод как скаляр, блок сравнивает это значение со всеми элементами другого ввода. Если вы задаете оба входа как векторы, они должны иметь одинаковый размер и тип данных.
Типы данных

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

Rx — полученные данные
скаляр | вектор-столбец

Details

Полученные данные в виде скаляра или вектор-столбца.

Типы данных

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

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

Out — разница между переданными и полученными данными
вектор-столбец

Details

Разница между переданными и полученными данными, возвращенная в форме вектор-столбца [R; N; S], где:

  • R — частота ошибок.

  • N — количество ошибок.

  • S — количество сравниваемых отсчетов.

Зависимости

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

Типы данных

Float64

Свойства

# ReceiveDelay — полученная задержка сигнала
Int64 integer

Details

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

Типы данных

Int64

# ResetPort — включение входного аргумента Rst
Logical

Details

Включите входной порт Rst.

# ComputationMode — метод сравнения
String

Details

Укажите метод сравнения образцов данных:

  • Entire frame — сравните все образцы полученных данных с образцами переданного кадра.

    Типы данных

    String

# StopSimulation — остановка симуляции
Logical

Details

Остановка симуляции после указанного количества ошибок или сравнений.

# OutputData — метод вывода данных
String

Details

Укажите метод вывода данных.

# ComputationDelay — задержка вычисления
Int64 integer

Details

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

Типы данных

Int64

Методы

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

step!

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