Main Content

Test Scripts

Customize test environment, automate testing

You can use the Simulink® Test™ programmatic interface to:

  • Create test scripts and functions.

  • Run tests from the command line.

  • Set up and standardize your testing environment.

You can use scripts and functions to repeat the same test strategy on multiple systems, or perform regression testing. These functions and classes cover test authoring, execution, and results in Simulink Test. If you want to combine existing Simulink tests with MATLAB® tests, or run tests with continuous integration, use the MATLAB Unit Test Framework. See Continuous Integration.

Simulink Test provides graphical user interfaces to help you create and run tests. For more information, see Test Authoring, Test Execution, and Reports and Test Management.


expand all

Test Files

sltest.testmanager.TestFileCreate or modify test file
sltest.testmanager.TestSuiteCreate or modify test suite
sltest.testmanager.TestCaseCreate or modify test case
sltest.testmanager.createTestForComponentCreate test case and test harness for model or model component
sltest.testmanager.createTestsFromModelGenerate test cases from a model
sltest.testmanager.copyTestsCopy test cases or test suites to another location
sltest.testmanager.moveTestsMove test cases or test suites to a new location
sltest.testmanager.loadLoad a test file in the Simulink Test manager
sltest.testmanager.getTestFilesGet test files open in the Test Manager
sltest.testmanager.clearClear test files from the Test Manager


sltest.testmanager.TestInputAdd or modify test input
sltest.import.sldvDataCreate test cases from Simulink Design Verifier results spreadsheet in format used by Simulink Test


sltest.testmanager.BaselineCriteriaAdd or modify baseline criteria
sltest.testmanager.EquivalenceCriteriaAdd or modify equivalence criteria
sltest.testmanager.SignalCriteriaAdd or modify signal criteria
sltest.testmanager.CustomCriteriaAdd or modify custom criteria
sltest.testmanager.LoggedSignalCreate or modify logged signals for use as simulation outputs
sltest.testmanager.LoggedSignalSetCreate or modify a set of logged signals


sltestiterationCreate test iteration
sltest.testmanager.TestIterationCreate or modify test iteration
sltest.testmanager.ParameterSetAdd or modify parameter set
sltest.testmanager.ParameterOverrideAdd or modify parameter override

MATLAB-Based Simulink Tests

sltest.TestCaseTest case class for MATLAB-based Simulink tests integrated with Test Manager
loadSystem Load model for MATLAB-based Simulink test
simulate Simulate model or Simulink.SimulationInput for MATLAB-based Simulink test
sltest.TestCase.forInteractiveUseCreate test case for interactive use
createTemporaryFolder Create temporary folder
assumeSignalsMatchAssume two data sets are equivalent
assertSignalsMatchAssert two data sets are equivalent
fatalAssertSignalsMatchFatally assert two data sets are equivalent
verifySignalsMatchVerify two sets of data are equivalent
sltest.harness.SimulationInputCreate test harness simulation input for MATLAB-based Simulink tests
createSimulationInput Create simulation input object
addModelCoverageEnable collect model coverage collection for Simulink tests
addSimulinkTestResultsEnable pushing test results to Simulink Test Manager
sltest.plugins.MATLABTestCaseIntegrationPluginAdd simulation and test results for MATLAB-based Simulink tests to Test Manager
sltest.plugins.ToTestManagerLogOutput stream to write text to Test Manager result Logs for MATLAB-based Simulink tests
sltest.plugins.ModelCoveragePluginCollect model coverage using the MATLAB Unit Test framework
sltest.testmanager.viewLaunch the Simulink Test Manager
sltest.testmanager.setprefSet Test Manager preferences
sltest.testmanager.getprefGet Test Manager preferences
sltest.testmanager.OptionsReturn and specify test file options
sltest.testmanager.closeClose the Simulink Test Manager
sltest.testmanager.runRun tests with Test Manager
sltest.testmanager.CoverageSettingsModify coverage settings
sltest.CodeImporterImport C or C++ code into Simulink for testing
sltest.CodeImporter.SandboxSettingsSandbox settings for C code testing
sltest.testmanager.ResultSetAccess results set data
sltest.testmanager.TestFileResultAccess test file results data
sltest.testmanager.TestSuiteResultAccess test suite results data
sltest.testmanager.TestCaseResultAccess test case results data
sltest.testmanager.TestIterationResultAccess test iteration result data
sltest.testmanager.ComparisonRunResultAccess result of a comparison test
sltest.testmanager.ComparisonSignalResultAccess signal comparison results from a baseline or equivalence result
sltest.testmanager.CustomCriteriaResultView custom criteria test result
sltest.testmanager.importResultsImport Test Manager results file
sltest.testmanager.exportResultsExport results set from Test Manager
sltest.testmanager.getResultSetsReturns result set objects in Test Manager
sltest.testmanager.clearResultsClear results from Test Manager
sltest.testmanager.reportGenerate report of test results
sltest.testmanager.TestResultReportCustomize generated results report
sltest.testmanager.TestSpecReportGenerate report of test specifications
sltest.testmanager.DiagnosticRecordView custom criteria diagnostic information

Steps, Transitions, and Symbols

sltest.testsequence.addStepAdd test sequence step
sltest.testsequence.addStepAfterAdd test sequence step after existing step
sltest.testsequence.addStepBeforeAdd test sequence step before existing step
sltest.testsequence.addSymbolAdd symbol to test sequence
sltest.testsequence.addTransitionAdd new transition to test sequence step
sltest.testsequence.deleteStepDelete test sequence step
sltest.testsequence.deleteSymbolDelete test sequence block symbol
sltest.testsequence.deleteTransitionDelete test sequence transition
sltest.testsequence.editStepEdit test sequence step
sltest.testsequence.editSymbolEdit symbol in Test Sequence block
sltest.testsequence.editTransitionEdit test sequence step transition
sltest.testsequence.findFind Test Sequence blocks
sltest.testsequence.findStepFind test sequence steps
sltest.testsequence.findSymbolFind Test Sequence block symbols
sltest.testsequence.getPropertyGet Test Sequence block properties
sltest.testsequence.newBlockCreate Test Sequence block
sltest.testsequence.readStepRead Test Sequence block steps
sltest.testsequence.readSymbolRead Test Sequence block symbol properties
sltest.testsequence.readTransitionRead properties of test sequence transition
sltest.testsequence.setPropertySet Test Sequence block properties


sltest.testsequence.activateScenarioSet Test Sequence block scenario as active
sltest.testsequence.addScenarioAdd new scenario to Test Sequence block
sltest.testsequence.deleteScenarioDelete scenario from Test Sequence block
sltest.testsequence.editScenarioEdit Test Sequence block test scenario properties
sltest.testsequence.getActiveScenarioGet Test Sequence block active scenario
sltest.testsequence.getAllScenariosGet names of all Test Sequence block scenarios
sltest.testsequence.getScenarioControlSourceGet source that controls Test Sequence active scenario
sltest.testsequence.isUsingScenariosDetermine whether Test Sequence block uses scenarios
sltest.testsequence.setScenarioControlSourceSet source controlling Test Sequence active scenario
sltest.testsequence.useScenarioConvert Test Sequence block to scenario mode
sltest.getAssessmentsReturns test assessment set object
sltest.AssessmentAccess assessment from set
sltest.AssessmentSetAccess a set of assessments from a simulation
sltest.harness.checkCompare component under test between harness model and main model
sltest.harness.cloneCopy test harness
sltest.harness.closeClose test harness
sltest.harness.convertConvert test harnesses between internal and external storage
sltest.harness.createCreate test harness
sltest.harness.setHarnessCreateDefaultsCustomize default property values for test harness creation
sltest.harness.getHarnessCreateDefaultsGet harness creation default values
sltest.harness.deleteDelete test harness
sltest.harness.exportExport test harness to Simulink model
sltest.harness.findFind test harnesses in model
sltest.harness.importImport Simulink model to test harness
sltest.harness.loadLoad test harness
sltest.harness.moveMove test harness from linked instance to library block or to a different harness owner
sltest.harness.openOpen test harness
sltest.harness.pushPush test harness workspace entries and configuration set to model
sltest.harness.rebuildRebuild test harness and update workspace entries and configuration parameter set based on main model
sltest.harness.setChange test harness property
sltest.harness.showDialogShow test harness dialog box


Create and Run Test Cases with Scripts

Examples of how to create and run tests using the programmatic interface.

Test Models Using MATLAB-Based Simulink Tests

Write test files in MATLAB that can be used in the Test Manager.

Using MATLAB-Based Simulink Tests in the Test Manager

Use MATLAB-based Simulink test to simulate a model and verify it against a baseline.

Programmatically Create and Run Test Sequence Scenarios

Add test scenarios to Test Sequence block programmatically.

Featured Examples