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

Тестирование вашей модели часто требует условий оценки, которые гарантируют, что тест допустим, в дополнение к проверке поведения модели. MATLAB® Unit Test служит основой для таких оценок. В Simulink® Test™ можно использовать тест пользовательские критерии, чтобы создать определенные оценки и включать проверки Модульного теста MATLAB в скрипт.

Пользовательские критерии применяются как критерии постсимуляции к симуляции выход. Если вы требуете верификаций во время выполнения, используйте verify() оператор в блоке Test Assessment или Test Sequence. Смотрите Оценивают Симуляцию модели Используя, проверяют Операторы.

Среда тестирования MATLAB

Пользовательский скрипт критериев является методом test, который является matlab.unittest объект TestCase. Чтобы включить функцию, в разделе Custom Criteria теста менеджера по Тесту, выбирают function customCriteria(test). В функции введите пользовательский скрипт критериев во встроенный редактор MATLAB.

Встроенный редактор MATLAB перечисляет свойства test. Создайте тестовое использование оценок проверки Модульного теста MATLAB. Пользовательские критерии поддерживают верификацию и проверки типа утверждения. См. Таблицу Верификаций, Утверждений и Других Проверок. Верификации и утверждения действуют по-другому, когда пользовательские критерии оценены:

  • Верификации – Другие оценки оценены, когда верификации перестали работать. Диагностика появляется в результатах. Используйте верификации для общих оценок, таких как проверка симуляции против ожидаемых выходных параметров.

    Пример: test.verifyEqual(lastValue,0)

  • Утверждения – пользовательский скрипт критериев прекращает оценивать, когда утверждение перестало работать. Диагностика появляется в результатах. Используйте утверждения для условий, которые представляют недопустимые критерии.

    Пример: test.assertEqual(lastValue,0).

Задайте пользовательский скрипт критериев

В этом примере показано, как создать пользовательский скрипт критериев для теста автопилота.

  1. Откройте тестовый файл.

    sltest.testmanager.load('AutopilotTestFile.mldatx')
sltest.testmanager.view

  2. В Test Browser выберите AutopilotTestFile> Basic Design Test Cases> Requirement 1.3 Test. В тесте расширьте раздел Custom Criteria.

  3. Включите пользовательский скрипт критериев путем выбора function customCriteria(test).

  4. Во встроенном редакторе MATLAB введите следующий скрипт. Скрипт получает окончательное значение сигналов Phi и APEng, и проверяет, что окончательные значения равняются 0.

    % Get the last values
lastPhi = test.sltest_simout.get...
   ('Signals_Req1_3').get('Phi').Values.Data(end);
lastAPEng = test.sltest_simout.get...
   ('Signals_Req1_3').get('APEng').Values.Data(end);

% Verify the last values equal 0
test.verifyEqual(lastPhi,0,...
   ['Final Phi value: ',num2str(lastPhi),'.']);
test.verifyEqual(lastAPEng,false,...
   ['Final APEng value: ',num2str(lastAPEng),'.']);

  5. Запустите тест.

  6. В панели Results and Artifacts расширьте Результат Custom Criteria. Обе передачи критериев.

Повторное использование пользовательские критерии и отладка Используя точки останова

В дополнение к авторским скриптам критериев во встроенном редакторе MATLAB можно создать пользовательские критерии в автономной функции и вызвать функцию от теста. Используя автономную функцию позволяет вам

  • Снова использовать пользовательские критерии в нескольких тестах.

  • Установить точки останова в скрипте критериев для отладки.

  • Исследовать симуляцию выход с помощью командной строки.

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

Вызовите пользовательский скрипт критериев от теста

  1. Перейдите к папке, содержащей функцию критериев.

    cd(fullfile(docroot,'toolbox','sltest','examples'))

  2. Откройте пользовательский скрипт критериев

    open('sltestCheckFinalRollRefValues.m')

    % This is a custom criteria function for a Simulink Test test case.
% The function gets the last values of Phi and APEng from the 
% Requirements 1.3 test case in the test file AutopilotTestFile.

function sltestCheckFinalRollRefValues(test)

% Get the last values
lastPhi = test.sltest_simout.get...
   ('Signals_Req1_3').get('Phi').Values.Data(end)
lastAPEng = test.sltest_simout.get...
   ('Signals_Req1_3').get('APEng').Values.Data(end)

% Verify the last values equal 0
test.verifyEqual(lastPhi,0,...
   ['Final Phi value: ',num2str(lastPhi),'.']);
test.verifyEqual(lastAPEng,false,...
   ['Final APEng value: ',num2str(lastAPEng),'.']);

  3. Откройте тестовый файл

    sltest.testmanager.load('AutopilotTestFile.mldatx')
sltest.testmanager.view

  4. Во встроенном редакторе MATLAB под Custom Criteria введите вызов функции в пользовательские критерии:

    sltestCheckFinalRollRefValues(test)

Установка точек останова и список test Свойства

  1. На линии 8 из sltestCheckFinalRollRefValues.m, установите точку останова путем нажатия на тире справа от номера строки.

  2. В менеджере по Тесту запустите тест.

    Командное окно отображает подсказку отладки.

  3. Введите test в командной строке, чтобы отобразить свойства STMCustomCriteria объект. Свойства содержат характеристики и данные моделирования выход теста.

    test = 

  STMCustomCriteria with properties:

              TestResult: [1×1 sltest.testmanager.TestCaseResult]
                  sltest_simout: [1×1 Simulink.SimulationOutput]
         sltest_testCase: [1×1 sltest.testmanager.TestCase]
           sltest_bdroot: {'RollReference_Requirement1_3'}
              sltest_sut: {'RollAutopilotMdlRef/Roll Reference'}
        sltest_isharness: 1
    sltest_iterationName: ''

    Свойство sltest_simout содержит данные моделирования. Просмотреть данные PhiRef, войти

    test.sltest_simout.get('Signals_Req1_3').get('PhiRef')
    ans = 

  Simulink.SimulationData.Signal
  Package: Simulink.SimulationData

  Properties:
  struct with fields:

              Name: 'PhiRef'
    PropagatedName: ''
         BlockPath: [1×1 Simulink.SimulationData.BlockPath]
          PortType: 'outport'
         PortIndex: 1
            Values: [1×1 timeseries]

  4. В редакторе MATLAB нажмите Continue, чтобы продолжить запускать пользовательский скрипт критериев.

  5. В панели Results and Artifacts расширьте Результат Custom Criteria. Обе передачи критериев.

  6. Чтобы снова использовать скрипт в другом тесте, вызовите функцию от теста пользовательские критерии.

Пользовательские критерии программируемый интерфейсный пример

Скрипт Open Live Script

В этом примере показано, как установить и получить пользовательские критерии с помощью программируемого интерфейса.

Прежде, чем запустить этот пример, временно отключите предупреждения тот результат отказов верификации.

warning off Stateflow:Runtime:TestVerificationFailed;
warning off Stateflow:cdr:VerifyDangerousComparison;

Загрузите тестовый файл и получите объект теста

tf = sltest.testmanager.load('AutopilotTestFile.mldatx');

ts = getTestSuiteByName(tf,'Basic Design Test Cases');

tc = getTestCaseByName(ts,'Requirement 1.3 Test');

Создайте пользовательские критерии объекта и набора критериев

Создайте пользовательский объект критериев.

tcCriteria = getCustomCriteria(tc)
tcCriteria = 
  CustomCriteria with properties:

     Enabled: 0
    Callback: '% Return value: customCriteria...'

Создайте пользовательское выражение критериев. Этот скрипт получает последнее значение Phi сигнала и проверяет, что это равняется 0.

criteria = ...
    sprintf(['lastPhi = test.SimOut.get(''Signals_Req1_3'')',...
	'.get(''Phi'').Values.Data(end);\n',...
	'test.verifyEqual(lastPhi,0,[''Final: '',num2str(lastPhi),''.'']);'])
criteria = 
    'lastPhi = test.SimOut.get('Signals_Req1_3').get('Phi').Values.Data(end);
     test.verifyEqual(lastPhi,0,['Final: ',num2str(lastPhi),'.']);'

Установите и включите критерии.

tcCriteria.Callback = criteria;
tcCriteria.Enabled = true;

Запустите тест и получите результаты

Запустите тест.

tcResultSet = run(tc);

Получите результаты теста.

tcResult = getTestCaseResults(tcResultSet);

Получите пользовательский результат критериев.

ccResult = getCustomCriteriaResult(tcResult)
ccResult = 
  CustomCriteriaResult with properties:

             Outcome: Failed
    DiagnosticRecord: [1x1 sltest.testmanager.DiagnosticRecord]

Восстановите предупреждения от отказов верификации.

warning on Stateflow:Runtime:TestVerificationFailed;
warning on Stateflow:cdr:VerifyDangerousComparison;
sltest.testmanager.clearResults
sltest.testmanager.clear
sltest.testmanager.close

Похожие темы

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

Поддержка

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