evalRequirement

Класс: sdo.requirements.PhasePlaneEllipse
Пакет: sdo.requirements

Оцените удовлетворение эллиптической границы на траектории фазовой плоскости двух сигналов

Синтаксис

evaluation = evalRequirement(requirement,signal1,signal2)
evaluation = evalRequirement(requirement,signals)

Описание

evaluation = evalRequirement(requirement,signal1,signal2) определяет, является ли траектория плоскости фазы двух сигналов, заданных в signal1 и signal2 удовлетворяет эллиптической привязке, указанной в requirement объект. Траектория фазы плоскости является графиком из двух сигналов друг против друга. Положительное evaluation значение указывает, что требование было нарушено.

evaluation = evalRequirement(requirement,signals) задает два сигнала как массив n -by-2. Первый столбец соответствует первому сигналу, а второй столбец соответствует второму сигналу. n - количество временных точек в сигналах.

Входные параметры

расширить все

Фаза эллипса плоскости, заданное как sdo.requirements.PhasePlaneEllipse объект. В объекте задаются характеристики ограничивающего эллипса, такие как радиусы, центр и поворот эллипса. Вы также задаете, является ли эллипс верхней или нижней границей.

Сигналы, которые будут оценены, заданные как два разделенных запятыми timeseries объекты.

signal1 соответствует x- значение траектории плоскости фазы и signal2 соответствует y- значение траектории плоскости фазы. Для получения примера смотрите Вычисление эллиптической границы на Фазу плоскости.

Сигналы, которые будут оценены, заданные как массив n -by-2. Первый столбец соответствует первому сигналу, x- значение траектории плоскости фазы. Второй столбец соответствует второму сигналу, y- значение траектории плоскости фазы. n - количество временных точек в сигналах. Для получения примера смотрите «Вычисление круговой границы на Фазу плоскости».

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

расширить все

Оценка требования к эллипсу фазы плоскости, возвращенная в виде скаляра или вектора-столбца в зависимости от Method свойство requirement. evalRequirement команда вычисляет минимальное расстояние со знаком для каждой точки в траектории плоскости фазы до ограничивающего эллипса.

  • Если requirement.Method является 'Maximum', evaluation является скаляром, который является максимумом расстояний со знаком. Положительное значение указывает, что требование было нарушено, и, по крайней мере, одна из точек траектории находится вне ограниченной области.

  • Если requirement.Method является 'Residuals', evaluation - вектор-столбец, который содержит знаки расстояния каждой точки в траектории плоскости фазы до ограничивающего эллипса. Положительное значение в векторе указывает, что требование было нарушено для этой временной точки. Отрицательное значение или нуль указывает, что требование было удовлетворено для этой временной точки.

Примеры

расширить все

Создайте объект требования по умолчанию.

Requirement = sdo.requirements.PhasePlaneEllipse;

Объект требования задает ограничивающий эллипс как верхнюю границу с центром, расположенным в [0,0], и без поворота. Радиус оси X эллипса равен 1, а радиус оси Y равен 0,5.

Задайте данные тестового сигнала следующим timeseries объекты.

signal1 = timeseries(1-exp(-(0:10)'));
signal2 = timeseries(sin((0:10)'));

Оцените требование.

Evaluation = evalRequirement(Requirement,signal1,signal2)
Evaluation = 0.6997

Метод оценки требований по умолчанию, Requirement.Method является 'Maximum'. Таким образом, evalRequirement команда вычисляет минимальное расстояние со знаком каждой точки в траектории плоскости фазы до ограничивающего эллипса и затем возвращает максимальное из этих расстояний. Положительное значение указывает, что по меньшей мере одна точка на траектории фазы находится вне эллипса и нарушает требование.

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

Requirement.Method = 'Residuals';

Оцените требование с помощью нового метода оценки.

Evaluation2 = evalRequirement(Requirement,signal1,signal2)
Evaluation2 = 11×1

   -0.5000
    0.4291
    0.5711
   -0.0078
    0.4850
    0.6695
    0.1133
    0.4079
    0.6997
    0.2102
      ⋮

Evaluation2 - минимальное расстояние траектории плоскости фазы до ограничивающего эллипса и представляет собой вектор-столбец с длиной, равной длине сигналов.

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

Вы можете увидеть, что максимальное значение в Evaluation2 то же, что и Evaluation.

Создайте объект требования по умолчанию.

Requirement = sdo.requirements.PhasePlaneEllipse;

Задайте круговую границу радиуса 2. Ограничивающий круг является верхней границей.

Requirement.Radius = [2 2];

Укажите данные тестового сигнала.

Signals = [1 2 3 4 5 6; 10 20 30 40 50 60]';

Тестовые данные заданы как массив n на 2. Первый столбец соответствует первому сигналу, x-значению траектории фазовой плоскости. Второй столбец соответствует второму сигналу, значению y траектории фазовой плоскости.

Оцените требование.

Evaluation = evalRequirement(Requirement,Signals)
Evaluation =

   58.2993

Положительное Evaluation значение указывает, что требование нарушено.

Введенный в R2016b