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

В этом примере создаются данные рабочей области в timeseries только в иллюстративных целях. Вы можете использовать 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 ограничение включает в себя этап синхронизации, сравнение этих двух сигналов с различными векторами времени не всегда приводит к провалу теста. Второй сигнал также назван Wave Data таким образом, алгоритм выравнивания может объединять сигналы для сравнения.

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

Создание тестового случая и сравнение сигналов

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

Создать TestCase экземпляр для интерактивного использования.

import matlab.unittest.TestCase

testCase = TestCase.forInteractiveUse;

Выдержать сравнение sig1_ts и sig2_ts с использованием MatchesSignal ограничение. Использовать sig1_ts для ожидаемого значения в экземпляре MatchesSignal ограничение.

import Simulink.sdi.constraints.MatchesSignal

testCase.verifyThat(sig2_ts,MatchesSignal(sig1_ts));

Verification failed.
    ---------------------
    Framework Diagnostic:
    ---------------------
    MatchesSignal(<Value>) failed.
    --> The following aligned signals did not match:
        
               Name         ActualSignals      ExpectedSignals 
            ___________    _______________    _________________
        
            "Wave Data"    "<Actual>.Data"    "<Expected>.Data"
    
    Comparison results have been saved to:
    --> /tmp/BR2021ad_1657350_6935/mlx_to_docbook5/comparisonResults_b085887b-f6cb-4cdc-bf4e-e6dd1a5a325b.mldatx
    ------------------
    Stack Information:
    ------------------
    In /tmp/BR2021ad_1657350_6935/mlx_to_docbook5/tpbc009bb6/simulink-ex22803619/TestTimeSeriesDataWithTimeToleranceExample.mlx (TestTimeSeriesDataWithTimeToleranceExample) at 14
    In /mathworks/devel/bat/BR2021ad/build/matlab/toolbox/matlab/codetools/embeddedoutputs/+matlab/+internal/+editor/evaluateRegions.p (evaluateRegions) at 84
    In /mathworks/devel/bat/BR2021ad/build/matlab/toolbox/matlab/codetools/embeddedoutputs/+matlab/+internal/+editor/EvaluationOutputsService.p (EvaluationOutputsService.evalRegions) at 110
    In /mathworks/devel/bat/BR2021ad/build/matlab/toolbox/matlab/codetools/+matlab/+internal/+liveeditor/@LiveEditorUtilities/execute.m (execute) at 43
    In /mathworks/devel/bat/BR2021ad/build/matlab/tools/examples/exampletools/+mwtools/liveCodeToDocbook.m (doRun) at 376
    In /mathworks/devel/bat/BR2021ad/build/matlab/tools/examples/exampletools/+mwtools/liveCodeToDocbook.m (doRunConvert) at 326
    In /mathworks/devel/bat/BR2021ad/build/matlab/tools/examples/exampletools/+mwtools/liveCodeToDocbook.m (liveCodeToDocbook) at 151
    In /mathworks/devel/bat/BR2021ad/build/matlab/tools/build_using_matlab/BML.m (BML) at 13

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

Задание абсолютного допуска 0.02 для экземпляра MatchesSignal ограничение, используемое при сравнении.

testCase.verifyThat(sig2_ts,MatchesSignal(sig1_ts,'AbsTol',0.02));

Verification passed.

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

В этом примере создаются данные рабочей области для использования только в иллюстративных целях. Вы можете использовать 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