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

evalRequirement

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

Оценивает выполнение требований.

Библиотека

EngeeDesignOptimization

Описание

Функция evalRequirement оценивает, насколько сигнал удовлетворяет заданному требованию. Эту функцию можно использовать при написании целевой функции для оценки выполнения требований. Функция поддерживает требование SignalTracking во временной области: отслеживание сигнала относительно опорного сигнала. Такое требование может быть полезно для оценки параметров моделей.

Синтаксис

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

  • eval = evalRequirement(req,TestPoint) — оценивает, насколько сигнал TestPoint удовлетворяет требованию req.

Аргументы

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

# req — требование
объект

Details

Требование к сигналу, заданное как объект EngeeDesignOptimization.SignalTracking.

Типы данных

EngeeDesignOptimization.SignalTracking

# TestPoint — сигнал во временной области
матрица | табличные данные

Details

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

Типы данных

Float64, DataFrame

# RefSignal — опорный сигнал
матрица | табличные данные

Details

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

Если этот аргумент не задан, то в качестве опорного сигнала будет использован сигнал, определенный в свойстве объекта ReferenceSignal.

Типы данных

Float64, DataFrame

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

# eval — результат оценки выполнения требования
скаляр | вектор | матрица

Details

Результат оценки выполнения требования, возвращаемый как скаляр, вектор или матрица.

Вычисление оценки зависит от свойств объекта EngeeDesignOptimization.SignalTracking:

  • Если свойство Type имеет значение "==", то eval характеризует, насколько хорошо отслеживаемый сигнал TestPoint соответствует опорному сигналу. Алгоритм вычисления величины совпадения сигналов задается с помощью свойства объекта Method.

  • Если свойство Type имеет значение ">=" или "<=", то eval представляет собой расстояние от отслеживаемого сигнала до опорного. Отрицательные значения указывают на соблюдение ограничения, а положительные — на его нарушение.

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

Типы данных

Float64