User manual MATLAB SYSTEMTEST 2

[. . . ] SystemTestTM 2 User's Guide How to Contact The MathWorks Web Newsgroup www. mathworks. com/contact_TS. html Technical Support www. mathworks. com comp. soft-sys. matlab suggest@mathworks. com bugs@mathworks. com doc@mathworks. com service@mathworks. com info@mathworks. com Product enhancement suggestions Bug reports Documentation error reports Order status, license renewals, passcodes Sales, pricing, and general information 508-647-7000 (Phone) 508-647-7001 (Fax) The MathWorks, Inc. 3 Apple Hill Drive Natick, MA 01760-2098 For contact information about worldwide offices, see the MathWorks Web site. SystemTestTM User's Guide © COPYRIGHT 2006­2010 by The MathWorks, Inc. The software described in this document is furnished under a license agreement. The software may be used or copied only under the terms of the license agreement. [. . . ] See "Using the Model Output Mappings Assistant" on page 4-20 for more information. 4-17 4 Using the Simulink Element Mapping Simulink To Workspace Blocks to Test Variables When Simulink runs a model with To Workspace blocks, these blocks save model information in the MATLAB workspace as variables. Using the SystemTest software, this data can be mapped to SystemTest test variables. This section shows how you create To Workspace block mappings in the SystemTest software using the Inverted Pendulum demo as an example. To map the To Workspace block: 1 In the Assign Model Outputs to SystemTest Data section of the Simulink element Properties pane, click the New Mapping button. The SystemTest software adds a row for a new mapping of this type. 2 Specify the To Workspace block in the model that you want to capture. Click the Simulink Data field and select the block from the list. For this example, select To Workspace. 3 Specify the SystemTest test variable to which you want to map the To Workspace block. Click the SystemTest Data field and select a test variable from the list. For this example, select New Test Variable to create a test variable. 4-18 Mapping Test Vectors and Test Variables to a Simulink® Model The SystemTest software opens the Edit Variable dialog box. Assign a name to the test variable and optionally an initial value, and then click OK. Name the test variable ToWSResult. 4-19 4 Using the Simulink Element The SystemTest software creates the mapping to the new test variable and adds the new test variable to the list in the Test Variables pane. Note If you are mapping To Workspace blocks to test variables, as shown in the above procedure, then you can optionally use the Mappings Assistant if you want the variables to have the same names as the inputs. This is useful if your model contains many signals or blocks and you want to name the outputs the same way. You no longer have to create test variables with matching names manually. See "Using the Model Output Mappings Assistant" on page 4-20 for more information. Using the Model Output Mappings Assistant If you are mapping logged signals, outport signals, or To Workspace blocks to test variables, for example in the procedures in the above section "Mapping Simulink Model Outputs to Test Variables" on page 4-13, then you can optionally use the Mappings Assistant if you want the variables to have the same names as the inputs. This is useful if your model contains many signals or blocks and you want to name the outputs the same way. You no longer have to create test variables with matching names manually. Using the Mappings Assistant is the preferred method of setting up mappings since it is easier. 1 In the Assign Model Outputs to SystemTest Data section of the Simulink element, click the Mappings Assistant button above the table. 2 In the Model Output Mappings Assistant dialog box, choose your mapping(s) in the Create mappings for each section. 4-20 Mapping Test Vectors and Test Variables to a Simulink® Model · If your model contains any logged signals, the Logged Signals option is available. · If your model contains any outport signals, the Outport Signals option is available. · If your model contains any To Workspace blocks, the To Workspace Blocks option is available. If the model contains no To Workspace blocks, this option is disabled. 3 Click OK to create the mappings. The Simulink Data column then displays the names of the logged signals, outports, or To Workspace blocks that the model contained. The SystemTest Data column displays the test variables created with the same name. For example, if the model contains two outports called Out1 and Out2, the Simulink Data column displays Out1 and Out2, and the SystemTest Data column displays Out1 and Out2 to represent the test variables that were created. Editing a Test Vector or Test Variable from within the Element If you want to edit a test vector or test variable while working in the Simulink element, you can open the appropriate editor by right-clicking on the name of the test vector or test variable in any of the tables on the Mappings tab. 4-21 4 Using the Simulink Element Overriding Inport Block Signals In this section. . . "Introduction" on page 4-22 "Overriding Inport Block Signals in a Simulink Element" on page 4-23 "Using the Inport Block Mappings Assistant" on page 4-27 "Example: Overriding Simulink Inport Blocks Using a Spreadsheet Data Test Vector" on page 4-28 "Mapping Logged Signals from a Model to Inport Blocks" on page 4-36 "Editing a Test Vector or Test Variable from within the Element" on page 4-37 Introduction The examples in "Mapping Test Vectors and Test Variables to a Simulink Model" on page 4-5 described how to override block parameters and workspace variables. [. . . ] In the case of the SystemTest software, when a test is run, a dataset array is created and stored as part of a test results object. The test results object is assigned to a variable named stresults in the MATLAB workspace when the test stops running. See Chapter 11, "Accessing Test Results from the MATLAB Command Line" for information on using stresults. The following table lists the accessible properties of dataset arrays. [. . . ]