exponenta event banner

Simulink.sdi.constraints. Класс MatchesSignalOptions

Пакет: Simulink.sdi.constraints

Укажите параметры сравнения для Simulink.sdi.MatchesSignal ограничение

Описание

Использовать Simulink.sdi.constraints.MatchesSignalOptions для настройки поведения сравнения и критериев принятия для экземпляра Simulink.sdi.constraints.MatchesSignal ограничение.

Примечание

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

  • Симулинк ®

  • Toolbox™ обработки сигналов

  • MATLAB ® Coder™

  • Designer™ с фиксированной точкой

Создание

Описание

пример

MatchesSignalOptions создает экземпляр Simulink.sdi.constraints.MatchesSignalOptions класс со свойствами, соответствующими ограничению, которое не игнорирует проверки и использует параметры выравнивания по умолчанию для Инспектора расчетных данных.

пример

MatchesSignalOptions(Name,Value) создает экземпляр Simulink.sdi.constraints.MatchesSignalOptions класс со сравнительным поведением с использованием свойств, заданных одним или несколькими Name,Value аргументы пары.

Свойства

развернуть все

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

  • false - ограничение проверяет, совпадают ли типы данных ожидаемого и фактического значений.

  • true - Ограничение нечувствительно к несоответствиям типов данных между ожидаемым и фактическим значениями.

Можно указать IgnoreDataTypes свойство в конструкторе с использованием 'IgnoringDataTypes' аргумент пары имя-значение.

Атрибуты:

GetAccess
public
SetAccess
public

Чувствительность ограничения к одному или нескольким сигналам, не выравнивающимся между ожидаемым значением и фактическим значением.

  • false - ограничение проверяет наличие сигналов, которые не совпадают между ожидаемым значением и фактическим значением.

  • true - Ограничение нечувствительно к одному или нескольким сигналам, не выравнивающимся между ожидаемым значением и фактическим значением.

Можно указать IgnoreSignalsNotAligned свойство в конструкторе с использованием 'IgnoringSignalsNotAligned' аргумент пары имя-значение.

Атрибуты:

GetAccess
public
SetAccess
public

Чувствительность ограничения к фактическому значению, содержащему данные за пределами временного интервала, определенного ожидаемым значением.

  • false - ограничение проверяет, содержит ли фактическое значение данные за пределами временного интервала, определенного ожидаемым значением.

  • true - ограничение нечувствительно к фактическому значению, содержащему данные за пределами временного интервала, определенного ожидаемым значением.

Можно указать IgnoreExtraData свойство в конструкторе с использованием 'IgnoringExtraData' аргумент пары имя-значение.

Атрибуты:

GetAccess
public
SetAccess
public

Критерии выравнивания для сравнения. Если ожидаемое значение содержит более одного сигнала, алгоритм сравнения Simulation Data Inspector выравнивает сигналы для сравнения между ожидаемым и фактическим значениями. По умолчанию инспектор данных моделирования выравнивается по источнику данных, затем по пути блока, затем по SID, а затем по имени сигнала. Дополнительные сведения об алгоритме выравнивания инспектора данных моделирования см. в разделе Как инспектор данных моделирования сравнивает данные.

Укажите критерии выравнивания в виде массива строк с одним или несколькими из перечисленных ниже параметров в том порядке, в котором они должны учитываться:

  • BlockPath - путь к блоку источника сигнала.

  • SID - идентификатор Simulink. Дополнительные сведения см. в разделе Идентификаторы Simulink.

  • SignalName - название сигнала.

  • DataSource - Путь к переменной.

Можно указать Alignment свойство в конструкторе с использованием 'AligningBy' аргумент пары имя-значение.

Примеры

свернуть все

В этом примере показано, как настроить поведение сравнения Simulink.sdi.constraints.MatchesSignal ограничение с использованием Simulink.sdi.constraints.MatchesSignalOptions объект. Вы можете использовать MatchesSignalOptions объект для настройки нескольких свойств сравнения с одним вводом пары имя-значение при построении MatchesSignal экземпляр.

Создание данных временных рядов

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

В этом примере первым сигналом является timeseries объект с именем Wave Data содержит данные для синусоидальной волны.

time = 0:0.1:20;
sig1vals = sin(2*pi/5*time);
sig1_ts = timeseries(sig1vals,time);
sig1_ts.Name = 'Wave Data';

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

time2 = 0:0.1:22;
sig2vals = single(0.98*sin(2*pi/5*time2));
sig2_ts = timeseries(sig2vals,time2);
sig2_ts.Name = 'Wave Data';

Конфигурирование MatchesSignal Создание экземпляра и сравнение данных

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

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

import Simulink.sdi.constraints.MatchesSignalOptions
opts = MatchesSignalOptions('IgnoringDataTypes',true,'IgnoringExtraData',true);

Создать TestCase экземпляр для интерактивного использования и сравнения sig1_ts и sig2_ts с использованием MatchesSignal ограничение, MatchesSignalOptions объект и абсолютный допуск 0.02.

import matlab.unittest.TestCase
testCase = TestCase.forInteractiveUse;

import Simulink.sdi.constraints.MatchesSignal
testCase.verifyThat(sig2_ts,MatchesSignal(sig1_ts,'AbsTol',0.02,'WithOptions',opts))
Verification passed.

Тест проходит. При повторном выполнении того же теста без опций, определенных MatchesSignalOptions , тест завершается неуспешно из-за несовпадения типов данных.

testCase.verifyThat(sig2_ts,MatchesSignal(sig1_ts,'AbsTol',0.02))
Verification failed.
    ---------------------
    Framework Diagnostic:
    ---------------------
    MatchesSignal(<Value>,'AbsTol',0.02) failed.
    --> Data types do not match for the following aligned signals:
        
               Name         ActualSignals     ActualDataType     ExpectedSignals     ExpectedDataType
            ___________    _______________    ______________    _________________    ________________
        
            "Wave Data"    "<Actual>.Data"      {'single'}      "<Expected>.Data"       {'double'}   
    
    ------------------
    Stack Information:
    ------------------
    In C:\Users\snadeau\AppData\Local\Temp\Editor_oxzoe\LiveEditorEvaluationHelperE1184446395.m (LiveEditorEvaluationHelperE1184446395) at 16
    In E:\jobarchive\Bdoc20b\2020_06_06_h12m11s21_job1400967_pass\matlab\toolbox\matlab\codetools\embeddedoutputs\+matlab\+internal\+editor\evaluateRegions.p (evaluateRegions) at 0
    In E:\jobarchive\Bdoc20b\2020_06_06_h12m11s21_job1400967_pass\matlab\toolbox\matlab\codetools\embeddedoutputs\+matlab\+internal\+editor\EvaluationOutputsService.p (EvaluationOutputsService.evalRegions) at 0
Представлен в R2019a