To Workspace

将数据写入工作区

库：
Simulink / Sinks
HDL Coder / Sinks

描述

To Workspace 模块将输入信号数据写入到工作区。在仿真期间，模块将数据写入到内部缓冲区。暂停仿真或仿真完成后，该数据将写入到工作区。在仿真暂停或停止之前，数据不可用。

To Workspace 模块通常将数据写入 MATLAB^® 基础工作区。对于 MATLAB 函数中的 sim 命令，To Workspace 模块将数据发送到调用函数的工作区，而不是 MATLAB 基础工作区。要将记录的数据发送给基础工作区，请在函数中使用 assignin 命令。

function myfunc
    a = sim('mTest','SimulationMode','normal');
    b = a.get('simout')
    assignin('base','b',b);
end

To Workspace 模块图标会显示写入数据的变量的名称。

控制保存的数据量

如果通过配置参数 > 数据导入/导出 > 记录间隔参数指定了数据记录时间间隔，To Workspace 模块将不会记录该时间间隔之外的数据。例如，如果时间间隔为空 ([])，模块则不会记录任何数据。模块将记录的数据存储在您为单一仿真输出参数指定的变量中。

对于变步长求解器，要控制 To Workspace 模块可用的数据量，请使用配置参数 > 数据导入/导出 > 附加参数 > 输出选项参数。例如，要在多次仿真的相同时间点写入数据，请选择 Produce specified output only 选项。

模块参数还控制保存的数据量。请参阅将数据点限制为最后, Limit data points to last将数据点限制为最后Limit data points to last、抽取, Decimation抽取Decimation 和采样时间, Sample time采样时间Sample time。

记录到 MAT 文件

在配置参数中启用 MAT 文件记录参数后，To Workspace 模块会将其数据记录到 MAT 文件中。有关此参数的信息，请参阅 MAT 文件日志记录 (Simulink Coder)。

端口

输入

全部展开

`Port_1` - 输入信号
标量 | 向量 | 矩阵 | N 维数组

从输入信号创建的工作区数据。To Workspace 模块可以保存 Simulink^® 支持的任何数据类型的实数或复数输入，包括定点和枚举数据类型以及总线对象。

默认情况下，To Workspace 模块将输入信号视为基于采样。要使 To Workspace 模块将输入信号视为基于帧，请执行以下操作：

将保存格式设置为“数组”或“结构体”
将将二维信号另存为设置为“二维数组(沿第一个维度串联)”

参数

全部展开

`变量名称` - 用于保存数据的变量的名称
`simout` （默认） | 字符向量

指定用于保存数据的变量的名称。

编程用法

模块参数：VariableName

类型：字符向量

值：字符向量

默认值：'simout'

`将数据点限制为最后` - 要保存的输入采样的最大数量
`inf` （默认） | 标量 | 向量

指定要保存的输入采样的最大数量。如果仿真生成的数据点大于指定的最大值，仿真将只保存最近生成的采样。默认值使模块写入所有数据。

编程用法

模块参数：MaxDataPoints

类型：字符向量

值：标量 | 向量

默认值： 'inf'

`抽取` - 确定数据写入时间的抽取因子
`1` （默认） | 标量 | 向量

指定抽取因子 n，它在模块每执行 n 次时写入数据。默认值使模块在每个时间步写入数据。

编程用法

模块参数：Decimation

类型：字符向量

值：标量 | 向量

默认值：'1'

`保存格式` - 保存仿真输出所用的格式
“`时间序列`” （默认） | “`带时间的结构体`” | “`结构体`” | “`数组`”

指定将仿真输出保存到工作区所用的格式。

默认的“时间序列”格式将非总线信号另存为 MATLAB timeseries 对象，将总线信号另存为 MATLAB timeseries 对象的结构体。

“数组”格式将输入另存为 N 维数组，其中 N 比输入信号的维数多一维。例如，如果输入信号是向量，则生成的工作区数组为二维。如果输入信号是矩阵，则数组为三维。Simulink 在数组中存储采样的方式取决于输入信号是标量、向量还是矩阵。

如果输入信号为标量或向量，则每个输入采样输出为数组的一行。假设输出数组的名称为 simout。那么，simout(1,:) 对应于第一个采样，simout(2,:) 对应于第二个采样，依此类推。
如果输入信号是矩阵，则时间对应于第三个维度。再次假设生成的工作区数组的名称为 simout。那么，simout(:,:,1) 是在第一个采样点的输入信号值；simout(:,:,2) 是在第二个采样点的输入信号值，依此类推。

“结构体”格式包含的结构体有三个字段：

time - 对于此格式，该字段为空。
signals - 包含下列三个字段的结构体：values、dimensions 和 label。values 字段包含信号值数组。dimensions 字段指定对应信号的维度。label 字段包含输入行的标签。
blockName - To Workspace 模块的名称。

“带时间的结构体”格式与“结构体”的格式相同，不同之处在于 time 字段包含仿真时间点向量。

如果选择“数组”或“结构体”，将显示将二维信号另存为参数。

要使用 From Workspace 模块直接读取 To Workspace 模块输出，请使用“时间序列”或“带时间的结构体”格式。From Workspace 模块可以从先前仿真中保存的 To Workspace 模块中读取基于采样的数据。有关详细信息，请参阅Comparison of Signal Loading Techniques。

下表显示了不同保存格式值对仿真模式的支持情况。

仿真模式	“`时间序列`”	“`数组`”、“`结构体`”或“`带时间的结构体`”
普通	支持	支持
加速	支持	仅在顶层模型中支持，在引用模型中不支持。
快速加速	不支持	仅在顶层模型中支持，在引用模型中不支持。
软件在环 (SIL)	不支持	如果启用了 MAT 文件日志记录，则仅在顶层模型中支持，在引用模型中不支持。
处理器在环 (PIL)	不支持	如果 MAT 文件日志记录可用并已启用，则仅在顶层模型中支持，在引用模型中不支持。
外部	不支持	仅在顶层模型中支持，在引用模型中不支持。
Simulink Coder™ 目标	不支持	如果启用了 MAT 文件日志记录，则仅在顶层模型中支持，在引用模型中不支持。

编程用法

模块参数：SaveFormat

类型：字符向量

值：'Timeseries' | 'Structure with Time' | 'Structure' | 'Array'

默认值：'Timeseries'

`将二维信号另存为` - 用于保存二维信号的格式
“`三维数组(沿第三个维度串联)`” （默认） | “`二维数组(沿第一个维度串联)`”

指定将二维信号保存到工作区中时使用的格式，包括：

“三维数组(沿第三个维度串联)”（默认值）
此设置非常适合基于采样的信号。数据沿第三个维度串联。例如，将 10 个采样的 2×4 矩阵输入存储为 2×4×10 数组。
“二维数组(沿第一个维度串联)”
此设置非常适合基于帧的信号。数据沿第一个维度串联。例如，将 10 个采样的 2×4 矩阵输入存储为 20×4 数组。

当保存格式设置为“数组”或“结构体”时，输出的维度取决于输入的维度和将二维信号另存为参数的设置。下表总结了各种情况下的输出维度。在该表中，K 代表将数据点限制为最后参数值。

输入信号维度	将二维信号另存为...	To Workspace 输出信号维度
M×N 矩阵	“`二维数组(沿第一个维度串联)`”	K×N 矩阵。如果将将数据点限制为最后参数设置为 `inf`，则 K 表示仿真结束时每一列中获取的采样总数。此设置等于输入帧大小 (M) 乘以模块获取的 M×N 输入的总个数。
M×N 矩阵	“`三维数组(沿第三个维度串联)`”	M×N×K 数组。如果将将数据点限制为最后参数设置为 `inf`，则 K 表示仿真结束时获取的 M×N 输入的总数。
长度为 N 的无向向量	任何设置	K×N 矩阵
N 维数组，其中 N > 2	任何设置	N + 1 维数组，最后一个维度的大小等于 K。如果将将数据点限制为最后参数设置为 `inf`，则 K 表示仿真结束时获取的 M×N 输入的总数。

依存关系

要启用将二维信号另存为参数，请将保存格式设置为“数组”或“结构体”。

编程用法

模块参数：Save2DSignal

类型：字符向量

值：'2-D array (concatenate along first dimension)' | '3-D array (concatenate along third dimension)'

默认值：'3-D array (concatenate along third dimension)'

`将定点数据记录为 fi 对象` - 将定点数据作为 fi 对象或双精度值进行记录
`off` （默认） | `on`

默认情况下，To Workspace 模块将定点数据作为 Fixed-Point Designer™ 的 fi 对象记录到 MATLAB 工作区中。如果清除此参数，Simulink 软件会将定点数据作为 double 记录到工作区。

编程用法

模块参数：FixptAsFi

类型：字符向量

值：'off' | 'on'

默认值：'off'

`采样时间` - 采样周期和偏移量
-1 （默认） | 标量 | 向量

指定采集数据点的采样周期和偏移量。使用时间步间隔不是常量的变步长求解器时，此参数很有用。默认值使此模块继承驱动模块的采样时间。请参阅指定采样时间。

编程用法

模块参数：SampleTime

类型：字符向量

值：标量 | 向量

默认值：'-1'

模型示例

Output Simulation Data with Blocks

How To Workspace and To File blocks write data to the workspace and to a file respectively.

打开脚本

Variable-Size Signal Basic Operations

How variable-size signals can be generated. It also illustrates some of the operations that can be applied to them. The purpose of this example is to introduce the basic operations associated with variable-size signals.

打开模型

模块特性

数据类型	`Boolean` \| `bus` \| `double` \| `enumerated` \| `fixed point` \| `integer` \| `single`
直接馈通	`否`
多维信号	`是`
可变大小信号	`是`
过零检测	`否`

提示

为了使后处理更容易，您可以将此模块保存的数据转换为“数据集”格式。当您通过可使用“数据集”格式的其他记录的数据（例如，记录的状态）后处理此数据时，此转换非常有用。请参阅Convert Logged Data to Dataset Format。

扩展功能

HDL 代码生成
使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 Verilog 代码和 VHDL 代码。

此模块可用于生成 HDL 代码的子系统中的仿真可见性，但不包括在硬件实现中。

To Workspace

描述

控制保存的数据量

记录到 MAT 文件

端口

输入

`Port_1` - 输入信号
标量 | 向量 | 矩阵 | N 维数组

参数

`变量名称` - 用于保存数据的变量的名称
`simout` （默认） | 字符向量

编程用法

`将数据点限制为最后` - 要保存的输入采样的最大数量
`inf` （默认） | 标量 | 向量

编程用法

`抽取` - 确定数据写入时间的抽取因子
`1` （默认） | 标量 | 向量

编程用法

`保存格式` - 保存仿真输出所用的格式
“`时间序列`” （默认） | “`带时间的结构体`” | “`结构体`” | “`数组`”

编程用法

`将二维信号另存为` - 用于保存二维信号的格式
“`三维数组(沿第三个维度串联)`” （默认） | “`二维数组(沿第一个维度串联)`”

依存关系

编程用法

`将定点数据记录为 fi 对象` - 将定点数据作为 fi 对象或双精度值进行记录
`off` （默认） | `on`

编程用法

`采样时间` - 采样周期和偏移量
-1 （默认） | 标量 | 向量

编程用法

模型示例

Output Simulation Data with Blocks

Variable-Size Signal Basic Operations

模块特性

提示

扩展功能

HDL 代码生成
使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 Verilog 代码和 VHDL 代码。

PLC 代码生成
使用 Simulink® PLC Coder™ 生成结构化文本代码。

定点转换
使用 Fixed-Point Designer™ 设计和仿真定点系统。

版本历史记录

另请参阅

主题

To Workspace

描述

控制保存的数据量

记录到 MAT 文件

端口

输入

Port_1 - 输入信号 标量 | 向量 | 矩阵 | N 维数组

参数

变量名称 - 用于保存数据的变量的名称 simout （默认） | 字符向量

编程用法

将数据点限制为最后 - 要保存的输入采样的最大数量 inf （默认） | 标量 | 向量

编程用法

抽取 - 确定数据写入时间的抽取因子 1 （默认） | 标量 | 向量

编程用法

保存格式 - 保存仿真输出所用的格式 “时间序列” （默认） | “带时间的结构体” | “结构体” | “数组”

编程用法

将二维信号另存为 - 用于保存二维信号的格式 “三维数组(沿第三个维度串联)” （默认） | “二维数组(沿第一个维度串联)”

依存关系

编程用法

将定点数据记录为 fi 对象 - 将定点数据作为 fi 对象或双精度值进行记录 off （默认） | on

编程用法

采样时间 - 采样周期和偏移量 -1 （默认） | 标量 | 向量

编程用法

模型示例

Output Simulation Data with Blocks

Variable-Size Signal Basic Operations

模块特性

提示

扩展功能

HDL 代码生成 使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 Verilog 代码和 VHDL 代码。

PLC 代码生成 使用 Simulink® PLC Coder™ 生成结构化文本代码。

定点转换 使用 Fixed-Point Designer™ 设计和仿真定点系统。

版本历史记录

另请参阅

主题

WeChat

`Port_1` - 输入信号
标量 | 向量 | 矩阵 | N 维数组

`变量名称` - 用于保存数据的变量的名称
`simout` （默认） | 字符向量

`将数据点限制为最后` - 要保存的输入采样的最大数量
`inf` （默认） | 标量 | 向量

`抽取` - 确定数据写入时间的抽取因子
`1` （默认） | 标量 | 向量

`保存格式` - 保存仿真输出所用的格式
“`时间序列`” （默认） | “`带时间的结构体`” | “`结构体`” | “`数组`”

`将二维信号另存为` - 用于保存二维信号的格式
“`三维数组(沿第三个维度串联)`” （默认） | “`二维数组(沿第一个维度串联)`”

`将定点数据记录为 fi 对象` - 将定点数据作为 fi 对象或双精度值进行记录
`off` （默认） | `on`

`采样时间` - 采样周期和偏移量
-1 （默认） | 标量 | 向量

HDL 代码生成
使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 Verilog 代码和 VHDL 代码。

PLC 代码生成
使用 Simulink® PLC Coder™ 生成结构化文本代码。

定点转换
使用 Fixed-Point Designer™ 设计和仿真定点系统。