Simulink.ModelWorkspace

以编程方式与模型的模型工作区进行交互

全页展开

说明

使用 Simulink.ModelWorkspace 对象与模型工作区进行交互。例如，您可以添加和删除变量、设置工作区的数据源以及将更改保存到工作区。

注意

对于涉及模型工作区、Simulink® 数据字典（“设计数据”分区）或 MAT 文件的最常见数据管理任务，推荐使用 Simulink.data.DataConnection 对象提供的函数，而不是特定于数据源的函数。这些对象函数提供通用的命令行界面，可以用更少的代码行来管理数据。使用 Simulink.data.connect 函数创建到数据源的连接，然后使用 Simulink.data.DataConnection 对象提供的通用函数集。对于特定于数据源的任务，例如删除或添加引用数据字典，请创建一个特定于数据源的对象，然后使用该对象提供的函数来管理您的数据源。有关详细信息，请参阅Manage Design Data for Simulink Models Programmatically。

有关详细信息，请参阅模型工作区。

创建对象

要创建 Simulink.ModelWorkspace，请使用 get_param 函数查询模型参数 ModelWorkspace 的值。例如，要创建名为 mdlWks 的对象（该对象表示名为 myModel.slx 的模型的模型工作区），请执行以下代码：

mdlWks = get_param('myModel','ModelWorkspace')

属性

全部展开

用于初始化模型工作区中变量的源，指定为以下字符向量之一：

  • 'Model File' - 变量存储在模型文件中。保存模型时，会同时保存变量。

  • 'MATLAB Code' - 变量由您编写并存储在模型文件中的 MATLAB® 代码创建。

  • 'MAT-File' - 变量存储在 MAT 文件中，您可以从模型文件中单独管理和操作这些变量。

  • 'MATLAB File' - 变量由脚本文件中的 MATLAB 代码创建，您可以从模型文件中单独管理和操作这些变量。

当 DataSource 设置为 'MATLAB Code' 或 'MATLAB File' 时，MATLAB 代码不能包含任何执行更新图的命令，包括：

  • sim

  • codegen

  • slbuild

  • set_param(model,'SimulationCommand','Update')

数据类型: char

存储或创建变量的外部文件的名称，指定为字符向量。要启用此属性，请将 DataSource 设置为 'MAT-File' 或 'MATLAB File'。

示例: 'myFile.mat'

示例: 'myFile.m'

数据类型: char

用于初始化变量的 MATLAB 代码，指定为字符向量。要启用此属性，请将 DataSource 设置为 'MATLAB Code'。

MATLAB 代码不能包含任何执行更新图的命令，包括：

  • sim

  • codegen

  • slbuild

  • set_param(model,'SimulationCommand','Update')

示例: sprintf('%% Create variables that this model uses.\n\nK = 0.00983;\n\nP = Simulink.Parameter(5);')

数据类型: char

对象函数

getVariable在模型的模型工作区中返回变量的值
getVariablePartGet value of variable property in model workspace
setVariablePartSet property of variable in model workspace
hasVariableDetermine whether variable exists in the model workspace of a model
whos返回模型的模型工作区中的变量列表
saveToSourceSave model workspace changes to the external data source of the model workspace
save将模型工作区的内容保存到 MAT 文件中
reloadReinitialize variables from the data source of a model workspace
evalin在模型的模型工作区中评估表达式
clear从模型的模型工作区中清除变量
assignin为模型工作区中的变量赋值

示例

全部折叠

在模型的模型工作区中创建一个变量。然后，修改该变量并查询变量值以确认修改。

打开示例模型 vdp。

openExample('simulink_general/VanDerPolOscillatorExample')

创建表示 vdp 模型工作区的 Simulink.ModelWorkspace 对象 mdlWks。

mdlWks = get_param('vdp','ModelWorkspace');

在模型工作区中创建具有值 5.12 的变量 myVar。

assignin(mdlWks,'myVar',5.12)

应用新值 7.22。为此，请首先使用 getVariable 函数创建变量的临时副本。然后，修改副本并使用它覆盖模型工作区中的原始变量。

temp = getVariable(mdlWks,'myVar');
temp = 7.22;
assignin(mdlWks,'myVar',temp)

通过查询变量的值来确认新值。

getVariable(mdlWks,'myVar')
ans =

    7.2200

版本历史记录

在 R2006a 之前推出

另请参阅

|

主题