Learn more about System Identification Toolbox

Managing Models in the GUI

On this page…
Importing Models into the GUI Viewing Model Properties Renaming Models and Changing Display Color Organizing Model Icons Deleting Models in the GUI Exporting Models from the GUI to the MATLAB Workspace

Importing Models into the GUI

You can import System Identification Toolbox models from the MATLAB workspace into the System Identification Tool GUI. If you have Control System Toolbox software, you can also import any models (LTI objects) you created using this toolbox.

The following procedure assumes that you begin with the System Identification Tool GUI already open. If this window is not open, type the following command at the prompt:

ident

To import models into the System Identification Tool GUI:

1. In the System Identification Tool GUI, select Import from the Import models list to open the Import Model Object dialog box.

2. In the Enter the name field, type the name of a model object. Press Enter.

3. (Optional) In the Notes field, type any notes you want to store with this model.

4. Click Import.

5. Click Close to close the Import Model Object dialog box.

Back to Top

Viewing Model Properties

You can get information about each model in the System Identification Tool GUI by right-clicking the corresponding model icon.

The Data/model Info dialog box opens. This dialog box describes the contents and the properties of the corresponding model. It also displays any associated notes and the command-line equivalent of the operations you used to create this model.

Tip   To view or modify properties for several models, keep this window open and right-click each model in the System Identification Tool GUI. The Data/model Info dialog box updates when you select each model.

Back to Top

Renaming Models and Changing Display Color

You can rename a model and change its display color by double-clicking the model icon in the System Identification Tool GUI.

The Data/model Info dialog box opens. This dialog box describes both the contents and the properties of the model. The object description area displays the syntax of the operations you used to create the model in the GUI.

To rename the model, enter a new name in the Model name field.

You can also specify a new display color using three RGB values in the Color field. Each value is between 0 to 1 and indicates the relative presence of red, green, and blue, respectively. For more information about specifying default data color, see Customizing the System Identification Tool GUI.

Tip   As an alternative to using three RGB values, you can enter any one of the following letters in single quotes: 'y' 'r' 'b' 'c' 'g' 'm' 'k' These strings represent yellow, red, blue, cyan, green, magenta, and black, respectively.

Finally, you can enter comments about the origin and state of the model in the Diary And Notes area.

To view model properties in the MATLAB Command Window, click Present.

Back to Top

Organizing Model Icons

You can rearrange model icons in the System Identification Tool GUI by dragging and dropping the icons to empty Model Board rectangles.

Note   You cannot drag and drop a model icon into the data area on the left.

When you need additional space for organizing model icons, select Options > Extra model/data board in the System Identification Tool GUI. This action opens an extra session window with blank rectangles. The new window is an extension of the current session and does not represent a new session.

Tip   When you import or estimate models and there is insufficient space for the icons, an additional session window opens automatically.

You can drag and drop model icons between the main System Identification Tool GUI and any extra session windows.

Type comments in the Notes field to describe the models. When you save a session, as described in Saving, Merging, and Closing Sessions, all additional windows and notes are also saved.

Back to Top

Deleting Models in the GUI

To delete models in the System Identification Tool GUI, drag and drop the corresponding icon into Trash. Moving items to Trash does not permanently delete these items.

To restore a model from Trash, drag its icon from Trash to the Model Board in the System Identification Tool GUI. You can view the Trash contents by double-clicking the Trash icon.

Note   You must restore a model to the Model Board; you cannot drag model icons to the Data Board.

To permanently delete all items in Trash, select Options > Empty trash.

Exiting a session empties Trash automatically.

Back to Top

Exporting Models from the GUI to the MATLAB Workspace

The models you create in the System Identification Tool GUI are not available in the MATLAB workspace until you export them. Exporting is necessary when you need to perform an operation on the model that is only available at the command line. Exporting models to the MATLAB workspace also makes them available to the Simulink software or another toolbox, such as the Control System Toolbox product.

To export a model to the MATLAB workspace, drag and drop the corresponding icon to the To Workspace rectangle.

When you export models to the MATLAB workspace, the resulting variables have the same name as in the System Identification Tool GUI.

Back to Top

Starting and Managing GUI Sessions

Working with Plots in the System Identification Tool GUI

© 1984-2009- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS