| Contents | Index |
| On this page… |
|---|
Getting Familiar with the Desktop |
The SystemTest desktop is an integrated development environment that lets you perform all of your testing activities from one centralized location. This section provides an overview of the SystemTest environment. For more information about how to use the SystemTest software to build tests and run them, see Example: Building a Test.
To get familiar with the SystemTest environment, open the SystemTest desktop from MATLAB by selecting Start > MATLAB > SystemTest > SystemTest Desktop or typing systemtest at the MATLAB command line.

The desktop has a number of different panes that help you to build and run your test.
Test Browser — Shows the overall structure of a test. A test is made up of Pre Test, Main Test, Save Results, and Post Test. Use the Test Browser to add elements to your test. These elements determine what actions your test performs.
Test Vectors — Lets you define the parameters or test cases of your test. The test vectors you define determine the number of iterations performed by your test. Test vectors are automatically indexed during test execution.
Test Variables — Lets you define variables used in the scope of your test. Variables can serve both input and output functions in your test. You can define variables that are declared in the Pre Test section of your test or in the Main Test section of your test.
Properties — Shows the properties of the test or the element you are editing. The contents of this pane change when you select a section or element in your test.
Elements — If open, this undocked Elements pane allows you to add elements to your test. If not open, you can add elements using the New button in the Test Browser.
Resources — Lists the instrument or other external device resources associated with the current test. This is only used if you have a license for the Instrument Control Toolbox™ software.
Getting Started — Shows information to help you start using the SystemTest software. If the Getting Started page is closed, select Help > SystemTest Getting Started to open it.
Desktop Help — Shows help about the element or aspect of the test that is currently selected. For the full product Help, select Help > SystemTest User's Guide.
Run Status — Shows a summary of the test's execution status.
The SystemTest desktop has a variety of features to make navigation easier.
Many areas of the user interface have context menus. For example, if you right-click in the Test Vectors, Test Variables, Resources, Run Status, Getting Started, or Desktop Help panes, you can access these context menus.
If you have the Elements pane open, you can add elements to your test using the context menus. If you right-click any element there, you can insert it directly into Pre Test, Main Test, or Post Test using the Elements pane context menus. If that section of the test already contains elements, the inserted element will be placed below the currently selected element in that section. You can change the order of elements in the test by using the arrow buttons in the Test Browser, or by dragging and dropping.
The SystemTest software offers various keyboard shortcuts, or hot keys, to access certain commands via the keyboard. For example, pressing F5 is an alternative way to run a test, and pressing Ctrl+N creates a new untitled test.
See the full list of SystemTest hot keys in SystemTest Hot Keys.
Undo and redo support is available through the Edit menu or on the SystemTest toolbar. This feature allows you to undo actions you have done throughout the desktop. The undo queue is global to the entire desktop. For example, if you add a test vector and then perform an action in the Properties pane, those two actions will be the last two items in the queue. The undo order applies across all the panes in the desktop.
To use this feature, select the Edit > Undo action command, where action is the last action you performed. Use the Undo command repeatedly to undo multiple actions. The Edit > Redo action command will redo the last undo you performed.
Most actions in the desktop are undoable. Some actions pertaining to the elements that are part of the hardware toolboxes, Data Acquisition Toolbox™, Instrument Control Toolbox, and Image Acquisition Toolbox™, cannot be undone since they involve connections to hardware.
The following actions will clear the list of actions in the undo queue:
Closing a test
Opening a test
Creating a new test
Refreshing a Simulink model in the Simulink element
You can set SystemTest preferences by selecting File > Preferences on the SystemTest desktop. This opens the MATLAB Preferences dialog box. Click SystemTest in the left tree if SystemTest Preferences are not showing in the right pane.

This option determines how many tests will appear on the SystemTest File menu's most recent files list. The default is 4 tests. If you change it to 0, no recent tests will appear on the list. The maximum number is 9.
Select Minimize SystemTest when starting a test if you want the SystemTest desktop to minimize when a test starts running. This check box is cleared by default.
Select Save test before running if you want the SystemTest software to save your test before it runs. If this option is selected and you run a test that is not yet saved, you will be prompted to name and save the test. This check box is selected by default.
You can also turn off confirmation dialog boxes used in the SystemTest software in a different area of the Preferences dialog box by selecting General > Confirmation Dialogs. Four SystemTest confirmation dialog boxes are listed there, as shown in the figure that follows.
Warn about using a Simulink model with an infinite simulation stop time — Occurs if you attempt to run a test containing a Simulink element that uses a model with an infinite simulation stop time.
Warn about using a Simulink model with unnamed logged signals — Occurs if you have a model that has logging enabled but has logged signals with no name, and you use that model in a Simulink element in the SystemTest software.
Warn each time a new signal is added in the test case editor — Occurs if you add a signal in the Test Case Editor.
Warn each time a signal is deleted in the test case editor — Occurs if you delete a signal in the Test Case Editor.

The SystemTest software allows you to view the results you have chosen to save for your test using a workspace variable called stresults. It provides access to the test results object, which is useful for comparing the results of separate test runs and for postprocessing test results.
For more information, see Accessing Test Results from the MATLAB Command Line.
![]() | Product Overview | Running Tests from the MATLAB Command Line | ![]() |

Includes the most popular MATLAB recorded presentations with Q&A sessions led by MATLAB experts.
| © 1984-2012- The MathWorks, Inc. - Site Help - Patents - Trademarks - Privacy Policy - Preventing Piracy - RSS |