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

SignalTracking

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

Создает объект с требованиями для отслеживания сигнала.

Библиотека

EngeeDesignOptimization

Описание

Функция SignalTracking создает объект EngeeDesignOptimization.SignalTracking с требованиями для отслеживания сигнала относительно опорного сигнала во временной области. Можно задать требование в виде равенства, а также в виде ограничения сверху или снизу.

Синтаксис

Вызов функции

  • track_req = SignalTracking() — создает объект с требованиями для отслеживания сигнала track_req со значениями свойств по умолчанию.

  • track_req = SignalTracking(Name=Value) — создает объект track_req и задает его свойства с помощью одного или нескольких аргументов типа «имя-значение». Неуказанные свойства сохраняют свои значения по умолчанию.

Аргументы

Входные аргументы «имя-значение»

Укажите необязательные пары аргументов в виде Name=Value, где Name — имя аргумента, а Value — соответствующее значение. Порядок аргументов типа «имя-значение» не имеет значения.

# AbsTol — абсолютный допуск
0 (по умолчанию) | скаляр

Details

Абсолютный допуск, используемый для определения границ по мере приближения сигнала к опорному сигналу, заданный как неотрицательный скаляр.

Границы для опорного сигнала определяются следующим образом:



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

Типы данных

Float64

# Description — описание требования
nothing (по умолчанию) | строка

Details

Описание требования, заданное как строка.

Типы данных

String

# InterpolationTimes — моменты времени, используемые при сравнении точек отслеживаемого и опорного сигналов
"Reference only" (по умолчанию) | "Testpoint only" | "Reference and Testpoint"

Details

Моменты времени, используемые при сравнении точек отслеживаемого и опорного сигналов.

Задаются одним из следующих значений:

  • "Reference only" — сравнение сигналов только в моменты времени, соответствующие опорному сигналу;

  • "Testpoint only" — сравнение сигналов только в моменты времени, соответствующие отслеживаемому сигналу;

  • "Reference and Testpoint" — сравнение сигналов в моменты времени, соответствующие как опорному сигналу, так и отслеживаемому.

Для сравнения сигналов в одних и тех же моментах времени используется линейная интерполяция.

Типы данных

String

# Method — алгоритм оценки выполнения требования
"SSE" (по умолчанию) | "SAE" | "Residuals"

Details

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

  • "SSE"

  • "SAE"

  • "Residuals"

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

Типы данных

String

# Name — имя требования
nothing (по умолчанию) | строка

Details

Имя требования, заданное как строка.

Типы данных

String

# Normalize — опция включения нормализации
true (по умолчанию) | false

Details

Опция включения нормализации, заданная как true или false. Для нормализации используется максимальное абсолютное значение опорного сигнала.

Типы данных

Bool

# ReferenceSignal — опорный сигнал
nothing (по умолчанию) | матрица | табличные данные

Details

Опорный сигнал, заданный как матрица или таблица, первый столбец которой содержит время, а второй — вещественные значения сигнала.

Типы данных

Float64, DataFrame

# RelTol — относительный допуск
0 (по умолчанию) | скаляр

Details

Относительный допуск, используемый для определения границ по мере приближения сигнала к опорному сигналу, заданный как неотрицательный скаляр.

Границы для опорного сигнала определяются следующим образом:



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

Типы данных

Float64

# RobustCost — опция включения устойчивой обработки выбросов
true (по умолчанию) | false

Details

Опция включения устойчивой обработки выбросов при вычислении требования, заданная как true для включения устойчивой обработки выбросов или false в противном случае.

Если включена устойчивая обработка выбросов, то при вызове функции evalRequirement для оценки стоимости (величины штрафа), связанной с выбросами ошибки отслеживания, используется функция потерь Хубера. Ошибка отслеживания вычисляется как . Для идентификации выбросов используются статистические характеристики ошибки.

Конкретный вид используемой функции стоимости зависит от метода оценки требования.

Алгоритм оценки Функция стоимости для отсчетов, не являющихся выбросами Функция стоимости для выбросов

"SSE"

где — это множество отсчетов, не являющихся выбросами.

где — линейный вес, — множество выбросов.

"SAE"

где — это множество отсчетов, не являющихся выбросами.

где — постоянная величина, — множество выбросов.

"Residuals"

Выбросы не удаляются.

где — число отсчетов.
Типы данных

Bool

# Type — тип требования
"==" (по умолчанию) | "<=" | ">="

Details

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

  • "==" — совпадение;

  • "<=" — верхняя граница;

  • ">=" — нижняя граница.

Типы данных

String

# Weights — весовые коэффициенты, используемые при вычислении ошибки
nothing (по умолчанию) | вектор

Details

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

Типы данных

Float64

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

# track_req — объект с требованиями
объект

Details

Объект с требованиями отслеживания. Объект содержит следующие свойства: ReferenceSignal, Weights, Type, Method, InterpolationTimes, Normalize, RobustCost, RelTol, AbsTol, Name, Description.

Типы данных

EngeeDesignOptimization.SignalTracking