sltest.TestCase Class

Namespace: sltest

Test case class for MATLAB-based Simulink tests

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 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

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

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, creates an input object, 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

Note

For an example using the ASAM XIL framework, see Create Tests That Use Third-Party Test Benches.

Version History

Introduced in R2020b