sltest.TestCase class

Package: sltest

Test case class for MATLAB-based Simulink tests integrated with Test Manager

Description

The sltest.TestCase class enables authoring MATLAB^®-based Simulink^® tests. You define a MATLAB-based Simulink test in a .m file that inherits from sltest.TestCase. Since sltest.TestCase is a matlab.unittest.TestCase, the matlab.unittest.TestCase methods and behaviors are available when authoring a MATLAB-based Simulink test.

The sltest.TestCase class is a handle class.

Class Attributes

Abstract

true

For information on class attributes, see Class Attributes.

Creation

To create a test that you can load, run, and analyze its results in the Test Manager, create a class definition file that inherits from sltest.TestCase. The file contains methods that define the test case.

For debugging at the command line without having to run an sltest.TestCase test, use the forInteractiveUse static method to create a TestCase.

Methods

Public Methods

In addition to the listed methods, the sltest.TestCase class can use the methods of the matlab.unittest.TestCase class.

loadSystem	Load model for MATLAB-based Simulink test
simulate	Simulate model or Simulink.SimulationInput for MATLAB-based Simulink test
createSimulationInput	Create simulation input object
createTemporaryFolder	Create temporary folder
sltest.TestCase.forInteractiveUse	Create test case for interactive use
assumeSignalsMatch	Assume two data sets are equivalent
assertSignalsMatch	Assert two data sets are equivalent
fatalAssertSignalsMatch	Fatally assert two data sets are equivalent
verifySignalsMatch	Verify two sets of data are equivalent

Examples

Test Case File Enabled for Use in the Test Manager

This myBaselineTest.m class definition file defines a test case that compares a set of baseline values and values produced from a simulation using the simulate method. See Using MATLAB-Based Simulink Tests in the Test Manager for the full example that includes the baseline data file and other files and commands required to run this test and then load it into the Test Manager.

The first line of the file shows the inheritance from sltest.TestCase. The method section, which has a Test attribute, contains the testOne test case. The test case loads a model, sets some variable values, simulates the harness, and tests whether the simulation and baseline signals match.

classdef myBaselineTest < sltest.TestCase
   methods (Test)
      function testOne(testCase)
         testCase.loadSystem('sltest_ratelim');

         in = testCase.createSimulationInput('sltest_ratelim',...
            'WithHarness','sltest_ratelim_Harness1');           
         in = in.setVariable('t_gain',[0;2],...
            'Workspace','sltest_ratelim');
         in = in.setVariable('u_gain',[-0.02;-4.02],...
            'Workspace','sltest_ratelim');

         simOut = testCase.simulate(in);
         testCase.verifySignalsMatch(simOut,'baseline1.mat');
      end
   end
end

Version History

Introduced in R2020b