sltest.TestCase class

Package: sltest

Test case class for MATLAB-based Simulink tests

Since R2020b

Description

The sltest.TestCase class enables authoring MATLAB^®-based Simulink^® tests. You define a MATLAB-based Simulink test in a MATLAB code .m file that inherits from sltest.TestCase. The types of MATLAB-based Simulink tests include MATLAB unit testing framework tests and ASAM^® XIL framework tests. For the unit testing framework tests, you can use matlab.unittest.TestCase methods. For ASAM XIL, you must install the Simulink Test™ Support Package for ASAM XIL Standard and use the methods of sltest.xil.framework.Framework and its associated FrameworkConfiguration, TestVariable, Stimulation, and Acquisition classes.

The sltest.TestCase class is a handle class.

Class Attributes

Abstract true

For information on class attributes, see Class Attributes.

Creation

To create a MATLAB unit testing framework test that you can load, run, and analyze its results in the Test Manager, or an ASAM XIL framework test to run tests on a test bench, create a class definition file that inherits from sltest.TestCase. The file contains methods that define the test case.

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

Methods

expand all

Public Methods

In addition to the listed methods for the MATLAB unit testing framework, the sltest.TestCase class can use the methods of the matlab.unittest.qualifications.Verifiable and matlab.unittest.TestCase classes.

For the methods you can use with the ASAM XIL framework, see sltest.xil.framework.Framework and its associated FrameworkConfiguration, TestVariable, Stimulation, and Acquisition classes.

`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

collapse all

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