Edit and Manage Workspace Variables by Using Model Explorer
To learn all of the techniques you can use to create, edit, and manage workspace variables, seeCreate, Edit, and Manage Workspace Variables.
Finding Variables That Are Used by a Model or Block
In the Model Explorer, you can get a list of variables that a model or block uses. The following approach is one way to get that list of variables:
In theContentspane, right-click the block for which you want to find the variables that it uses.
Select theFind Referenced Variablesmenu item.
Model Explorer returns results similar to these:
For performance, Model Explorer uses cached information from the last compiled version of the model. If you want to recompile the model, either do so manually or, in the Model Explorer, set theUpdate diagramfield toyes
and repeat the search.
You can also use the following approaches to find variables that a model or block uses:
In the Model Explorer, in theModel Hierarchypane, right-click a block or model node and select theFind Referenced Variablesmenu item.
In the Model Explorer, in the search bar, use the
for Referenced Variables
search type option.In the Simulink®Editor, right-click a block, subsystem, or in the canvas and select theFind Referenced Variablesmenu item. Clicking the canvas returns results for the whole model.
The金宝appSimulink.findVars
function provides additional options for returning information about workspace variables that is not available from the Model Explorer or Simulink Editor.
For information about limitations when finding referenced variables, see the金宝appSimulink.findVars
documentation.
Using the Set of Returned Variables
For a variable in the set of returned variables, you can find the blocks that use that variable (for details, seeFinding Blocks That Use a Specific Variable). Also, you can export variables from the returned set of variables. For details, seeExport Workspace Variables.
Finding Blocks That Use a Specific Variable
This example shows how to use Model Explorer to get a list of blocks that use a specific workspace variable.
Open the model
f14
.Open Model Explorer.
In theModel Hierarchypane, select the
Base Workspace
node.In theContentspane, right-click the variable
Mq
and selectFind Where Used.In theSelect a systemdialog box, select
f14
.Clear theSearch in referenced modelscheck box, since
f14
does not reference any models, and clickOK.WithSearch in referenced modelsselected, you can find the target variable everywhere it is used in a model reference hierarchy. However, finding the target variable in an entire hierarchy can take more time.
TheUpdate diagram to include recent changescheck box is cleared by default to save time by avoiding unnecessary model diagram updates. Select the check box to incorporate recent changes you made to the model by forcing a diagram update.
ClickOKin response to the message to update the model diagram.
Because you just opened the model, you must update the model diagram at least once before finding a variable. You could have selectedUpdate diagram to include recent changesin theSelect a systemdialog box to force an initial diagram update, though you typically use that option when you make changes to the model while performing multiple searches withFind Where Used.
Model Explorer displays the search results:
The property columns whose values include
Mq
represent the block parameters that use theMq
variable. If those property columns are not already in the view, then the Model Explorer adds them to the end of the search results display.
You can also find blocks that use a specific variable by using one of these approaches:
In the search bar, select the
for Variable Usage
search type option.In theSearch Resultspane, right-click a variable and select theFind Where Usedmenu item.
In the Model Data Editor, right-click a workspace variable and select theFind Where Usedmenu item.
Finding Unused Workspace Variables
You can use the Model Explorer to get a list of variables that are defined in a workspace but not used by a model or block. One way to get that list of variables is to right-click a workspace name in theModel Hierarchypane and select theFind Unused Variablesmenu item. For example:
Open the
f14
model.Open the Model Explorer.
In the search toolbar, set theUpdate diagramfield to
yes
.In theModel Hierarchypane, right-click the
Base Workspace
node and select theFind Unused Variablesmenu item.The Model Explorer displays output similar to this:
The
金宝appSimulink.findVars
function provides additional options for returning information about unused workspace variables that is not available from the Model Explorer or Simulink Editor.
Editing Workspace Variables
In the Model Explorer, you can use the Variable Editor to edit variables from the MATLAB®base workspace or model workspace. The Variable Editor is available for editing large arrays and structures.
To open the Variable Editor:
In theContentspane, select the variable.
In the Dialog pane (the right pane), click the button
near the value of the variable.
In the menu, selectOpen Variable Editor.
Alternatively, to open the Variable Editor from theContentspane instead of the Dialog pane, begin editing the value of the variable by clicking the appropriate cell. The button appears in the cell.
Representation of Arrays with Three or More Dimensions
When the value of a variable orSimulink.Parameter
object is an array with three or more dimensions, theValuecolumn displays the array as an expression that contains a call to thereshape
function.
To edit the values in the array, modify the first argument of thereshape
call, which contains all of the array values in a serialized vector. When you add or remove elements along a dimension, you must also correct the argument that represents the length of the modified dimension.
Rename Variables
This example shows how to use Model Explorer to rename a variable everywhere it is used by blocks in Simulink models.
Open the model
sldemo_absbrake
. The model loads data to the MATLAB base workspace.Open Model Explorer.
In theModel Hierarchypane, select the base workspace.
In theContentspane, right-click the base workspace variable
m
and selectRename All.In theSelect a systemdialog box, click the name of the model
sldemo_absbrake
to select it as the context for renaming the variablem
.Clear theSearch in referenced modelscheck box and clickOK. The model
sldemo_absbrake
references the modelsldemo_wheelspeed_absbrake
, but onlysldemo_absbrake
uses the variablem
.WithSearch in referenced modelsselected, you can rename the target variable everywhere it is used in a model reference hierarchy. However, renaming the target variable in an entire hierarchy can take more time.
TheUpdate diagram to include recent changescheck box is cleared by default to save time by avoiding unnecessary model diagram updates. Select the check box to incorporate recent changes you made to the model by forcing a diagram update.
ClickOKin response to the message to update the model diagram.
因为你只是打开模型时,您必须更新the model diagram at least once before renaming a variable. You could have selectedUpdate diagram to include recent changesin theSelect a systemdialog box to force an initial diagram update, though you typically use that option when you make changes to the model while performing multiple variable renaming operations.
In theRename Alldialog box, type a new name for the variable in theNew namebox and clickOK.
You can use the hyperlinks in theCorresponding blockssection of theRename Alldialog box to view the target blocks.
Note
You can rename only variables that the function金宝appSimulink.findVars
supports.
For help with renaming files, use a project. SeeAutomatic Updates When Renaming, Deleting, or Removing Files.
Compare Duplicate Workspace Variables
You can compare duplicate variables that are stored in the same workspace or in different workspaces. For example, you can compare a variable stored in the base workspace with its duplicate, which is stored in the model workspace.
Open a model and the Model Explorer.
In the search toolbar, search for the variable that is duplicated. Select the rows with the duplicate entries. Then, right-click and selectCompare Selected.
Review the differences in theComparison Viewer.
Export Workspace Variables
You can export (save) a set of variables listed in the Model Explorer, exporting either individual variables or all the variables in the base or model workspace.
One possible workflow is to export the set of variables returned with theFind Referenced Variables选择或金宝appSimulink.findVars
function. For details, seeFinding Variables That Are Used by a Model or Block.
Note
所有the variables that you export must be from the same workspace.
To export all the variables in a workspace in the Model Explorer to a MATLAB code file or MAT-file:
Select the variables that you want to export.
To select all the variables in a workspace, right-click the workspace node (for example,
Base Workspace
) and select theExportmenu item. For example:To select individual variables, in theContentspane, select the variables that you want to export. Right-click one of the highlighted variables and select theExport Selectedmenu item.
If theContentspane has data grouped by a property, selecting the top line in a group does not select all the variables in that group. For details about grouped data, seeModel Explorer.
Specify whether to save the variables in a MATLAB code file or a MAT-file.
The MATLAB code file format is easier to read, is editable, and supports version control. The MAT-file format is binary, which has performance advantages.
If you specify a MATLAB code file format, the Model Explorer may create an associated MAT-file, reflecting the name of the MATLAB code file, but with an extension of
.mat
instead of.m
.Specify a name and location for the file.
If the file already exists, Model Explorer displays a dialog box asking you to choose one of these options:
Overwrite entire file
Replaces all variables in the target file with the selected variables, which are stored in alphabetical order.
Update variables that exist in file and append new variables to file
Updates existing variables in place and appends new variables.
Only update variables that exist in file
Updates existing variables, but does not add any new variables, which eliminates potentially extraneous variables.
To permanently store workspace variables for a model, instead of using the base workspace, create a data dictionary. SeeWhat Is a Data Dictionary?.
Importing Workspace Variables
你可以导入(负载)fi的一组变量le into the base workspace or into a model workspace using the Model Explorer. When you import variables into a workspace, the Model Explorer overwrites existing variables and adds any new variables.
To import variables into a workspace:
In theModel Hierarchypane, right-click the workspace into which you want to import variables.
Select theImportmenu item.
In the Import from File dialog box, select a MATLAB code file or MAT-file for the variables that you want to import.
Note
If you import a MATLAB code file, then Simulink also imports the associated MAT-file.
See Also
Model Explorer|金宝appSimulink.findVars