Тестирование вашей модели часто требует условий оценки, которые гарантируют, что тест допустим, в дополнение к проверке поведения модели. MATLAB® Unit Test служит основой для таких оценок. В Simulink® Test™ можно использовать тест пользовательские критерии, чтобы создать определенные оценки и включать проверки Модульного теста MATLAB в скрипт.
Пользовательские критерии применяются как критерии постсимуляции к симуляции выход. Если вы требуете верификаций во время выполнения, используйте verify() оператор в блоке Test Assessment или Test Sequence. Смотрите Оценивают Симуляцию модели Используя, проверяют Операторы.
Пользовательский скрипт критериев является методом test, который является matlab.unittest объект TestCase. Чтобы включить функцию, в разделе Custom Criteria теста менеджера по Тесту, выбирают function customCriteria(test). В функции введите пользовательский скрипт критериев во встроенный редактор MATLAB.
Встроенный редактор MATLAB перечисляет свойства test. Создайте тестовое использование оценок проверки Модульного теста MATLAB. Пользовательские критерии поддерживают верификацию и проверки типа утверждения. См. Таблицу Верификаций, Утверждений и Других Проверок. Верификации и утверждения действуют по-другому, когда пользовательские критерии оценены:
Верификации – Другие оценки оценены, когда верификации перестали работать. Диагностика появляется в результатах. Используйте верификации для общих оценок, таких как проверка симуляции против ожидаемых выходных параметров.
Пример: test.verifyEqual(lastValue,0)
Утверждения – пользовательский скрипт критериев прекращает оценивать, когда утверждение перестало работать. Диагностика появляется в результатах. Используйте утверждения для условий, которые представляют недопустимые критерии.
Пример: test.assertEqual(lastValue,0).
В этом примере показано, как создать пользовательский скрипт критериев для теста автопилота.
Откройте тестовый файл.
sltest.testmanager.load('AutopilotTestFile.mldatx')
sltest.testmanager.viewВ Test Browser выберите AutopilotTestFile> Basic Design Test Cases> Requirement 1.3 Test. В тесте расширьте раздел Custom Criteria.
Включите пользовательский скрипт критериев путем выбора function customCriteria(test).
Во встроенном редакторе 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),'.']);
Запустите тест.
В панели Results and Artifacts расширьте Результат Custom Criteria. Обе передачи критериев.
В дополнение к авторским скриптам критериев во встроенном редакторе MATLAB можно создать пользовательские критерии в автономной функции и вызвать функцию от теста. Используя автономную функцию позволяет вам
Снова использовать пользовательские критерии в нескольких тестах.
Установить точки останова в скрипте критериев для отладки.
Исследовать симуляцию выход с помощью командной строки.
В этом примере вы добавляете точку останова в пользовательский скрипт критериев. Вы запускаете тест, перечисляете свойства тестового объекта в командной строке и вызываете пользовательские критерии от теста.
Перейдите к папке, содержащей функцию критериев.
cd(fullfile(docroot,'toolbox','sltest','examples'))
Откройте пользовательский скрипт критериев
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),'.']);
Откройте тестовый файл
sltest.testmanager.load('AutopilotTestFile.mldatx')
sltest.testmanager.viewВо встроенном редакторе MATLAB под Custom Criteria введите вызов функции в пользовательские критерии:
sltestCheckFinalRollRefValues(test)
test СвойстваНа линии 8 из sltestCheckFinalRollRefValues.m, установите точку останова путем нажатия на тире справа от номера строки.
В менеджере по Тесту запустите тест.
Командное окно отображает подсказку отладки.
Введите 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]В редакторе MATLAB нажмите Continue, чтобы продолжить запускать пользовательский скрипт критериев.
В панели Results and Artifacts расширьте Результат Custom Criteria. Обе передачи критериев.
Чтобы снова использовать скрипт в другом тесте, вызовите функцию от теста пользовательские критерии.
В этом примере показано, как установить и получить пользовательские критерии с помощью программируемого интерфейса.
Прежде, чем запустить этот пример, временно отключите предупреждения тот результат отказов верификации.
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