From Workspace

将信号数据从工作区加载到 Simulink 模型中

库：
Simulink / Sources

描述

From Workspace 模块将数据从工作区读入 Simulink^® 模型，并在模块的输出端以信号或非虚拟总线形式提供数据。您可以从基础工作区、模型工作区或封装工作区加载数据。您可以使用 From Workspace 模块将信号数据从引用模型或子系统可访问的工作区加载到模型层次结构中的任何模型或子系统中。

您可以指定模块如何从工作区数据构造输出，包括输出采样周期、内插和外插行为，以及是否使用过零检测。

From Workspace 模块图标显示数据参数的值。例如，如果您使用 From Workspace 模块加载变量 x 中的数据，并且指定 x 作为数据参数的值，则该模块将显示 x。

指定要加载的数据

使用数据参数指定要加载的 From Workspace 模块的数据。您可以将数据参数的值指定为 MATLAB^® 表达式，例如变量名称。数据参数中的表达式的计算结果必须为 From Workspace 模块支持的格式的数据。有关如何计算表达式的详细信息，请参阅符号解析。

From Workspace 模块不从数据字典加载数据。使用数据字典仅存储模型的设计数据，不存储仿真输入数据。您可以在数据字典中存储与 From Workspace 模块相关的设计数据，例如采样时间参数的值。

端口

输出

全部展开

`Port_1` — 从工作区加载的数据
标量 | 向量 | 矩阵 | 数组

从工作区加载的数据，在模块输出端作为信号或非虚拟总线提供。根据您加载的数据，输出信号可能是标量、向量、多维或可变大小信号、总线或总线数组。From Workspace 模块支持加载除 int64 和 uint64 之外的所有内置数据类型的实数和复数数据。

参数

全部展开

`数据` — 要从工作区加载的数据
`timeseries` 对象 | `timetable` 对象 | 结构体 | 二维数组 | MATLAB 表达式

要从工作区加载的数据，指定为变量名称或 MATLAB 表达式，该表达式的计算结果为 From Workspace 模块支持的格式的数据。该表达式可以创建 From Workspace 模块在其输出端提供的数据，也可以引用包含要加载的数据的工作区变量。有关如何计算表达式的详细信息，请参阅符号解析。

From Workspace 模块可以加载标量、多维和可变大小信号的数据以及总线或总线数组的数据。From Workspace 模块支持加载以下格式的数据：

timeseries 对象
timetable 对象
Simulink.SimulationData.Signal 对象
表示总线数据的结构体。结构体层次结构必须与总线的层次结构相匹配，并使用 timeseries 和 timetable 对象来表示信号数据。
表示单个信号的数据的结构体，其字段和层次结构符合“结构体”或“带时间的结构体”记录格式。
表示单个信号的数据的二维数组。数组中的第一列表示时间，一个或多个其他列包含信号数据。

有关详细信息，请参阅使用 From Workspace 模块加载数据。

为总线加载数据时，请将输出数据类型参数指定为定义总线的 Simulink.Bus 对象。

double 类型的实信号可以采用 From Workspace 模块支持的任何数据格式。对于除 double 以外的数据类型的复信号和实信号，请使用除 Array 以外的任意格式。

From Workspace 模块支持以 Structure 或 Structure with time 格式加载可变大小信号数据。

编程用法

模块参数：VariableName

类型：字符向量

值：MATLAB 表达式 | timeseries 对象 | timetable 对象 | 结构体 | 二维数组

默认值：'simin'

`输出数据类型` — 加载的工作区数据类型
`Inherit: auto` （默认） | `double` | `single` | “`half`” | `int8` | `uint8` | `int16` | `uint16` | `int32` | `uint32` | `boolean` | `fixdt(1,16,0)` | “`fixdt(1,16,2^0,0)`” | “`Enum: <class_name>`” | “`Bus: <bus_object>`” | “`<data type expression>`”

From Workspace 模块加载的工作区数据的数据类型。默认情况下，From Workspace 模块从工作区数据或定义信号数据类型的下游模块继承输出信号数据类型。

加载标量或多维信号数据时，可以选择继承输出数据类型，也可以指定输出数据类型以匹配工作区数据的数据类型。

要加载总线或总线数组数据，请将输出数据类型设置为 Bus: <bus_object>，并指定定义输出总线的 Simulink.Bus 对象的名称。

加载枚举数据时，请将输出数据类型设置为 Enum: <class_name>，并指定定义枚举数据值的枚举类的名称。

点击显示数据类型助手按钮以显示数据类型助手，帮助您设置数据类型属性。有关详细信息，请参阅使用数据类型助手指定数据类型。

编程用法

模块参数：OutDataTypeStr

类型：字符向量

值：

'Inherit: auto' | 'double' | 'single' | 'half' | 'int8' | 'uint8' | 'int16' | 'uint16' | 'int32' | 'uint32' | 'boolean' | 'fixdt(1,16,0)' | 'fixdt(1,16,2^0,0)' | 'Enum: <class name>' | 'Bus: <object name>' | '<data type expression>'

默认值：'Inherit: auto'

`采样时间` — 输出采样周期和可选时间偏移量
`0` （默认） | 标量 | 向量

采样时间参数指定模块在仿真期间计算新输出值的时间。有关详细信息，请参阅指定采样时间。

当您不希望输出具有时间偏移量时，请将采样时间参数指定为标量。要向输出添加时间偏移量，请将采样时间参数指定为 1×2 向量，其中第一个元素是采样周期，第二个元素是偏移量。

默认情况下，采样时间参数值为 0，表示没有时间偏移量的连续采样时间。对于离散信号，请将采样时间指定为离散采样间隔。例如，将采样时间指定为 0.1 以对每 100 毫秒采样一次的离散信号建模。将采样时间指定为 -1 以继承该值。

编程用法

模块参数：SampleTime

类型：字符向量

值：标量 | 向量

默认值：'0'

`数据插值` — 插值方法
`on` （默认） | `off`

用于为加载的工作区数据中的时间值之间的仿真时间提供输出值的插值方法。当您选择数据插值时，From Workspace 模块使用加载的工作区数据中的相邻值对输出值进行线性插值。当未选择数据插值时，From Workspace 模块提供加载的工作区数据中前一个数据点的值。有关插值算法的详细信息，请参阅插值。

加载枚举、定点或可变大小信号数据时，请清除数据插值参数。

为了在加载的工作区数据的最后一个值后提供输出值，From Workspace 模块会组合使用数据插值参数和最终数据值之后的输出参数。

数据插值参数值还会影响 From Workspace 模块在加载的工作区数据的第一个数据点之前对仿真时间的输出值进行外插的方式。当选择数据插值时，From Workspace 模块使用工作区数据中的前两个数据点对第一个数据点之前的仿真时间的输出值进行线性外插。当未选择数据插值时，该模块提供接地值作为第一个工作区数据点之前的仿真时间的输出值。有关 From Workspace 模块外插行为的完整信息，请参阅外插。

编程用法

模块参数：Interpolate

类型：字符向量

值：'off' | 'on'

默认值：'on'

`启用过零检测` — 过零检测
`on` （默认） | `off`

过零检测是一种用于定位模块输出中的不连续点并避免在不连续点附近使用过小的时间步的方法，它可能会减慢仿真速度。过零指数据中的不连续点。当采样时间为连续 (0) 时，您可以为 From Workspace 模块启用过零检测。

当数据包含时间相同的多个采样时，加载的工作区数据会在模块输出中产生不连续点。例如，对于此输入数据，在时间 2 处出现不连续点。

time:     0 1 2 2 3
signal:   2 3 4 5 6

当您将最终数据值之后的输出设置为“设置为零”时，From Workspace 模块还会在工作区数据中的最后一个采样的输出中产生不连续点。

加载总线的输入数据时，From Workspace 模块会检测所有总线元素的过零点。

有关详细信息，请参阅过零检测。

编程用法

模块参数：ZeroCross

类型：字符向量

值：'off' | 'on'

默认值：'on'

`最终数据值之后的输出` — 确定最后一个数据点之后的模块输出的方法
“`外插`” （默认） | “`设置为零`” | “`保持最终值`” | “`循环重复`”

From Workspace 模块使用数据插值和最终数据值之后的输出设置来确定工作区数据中最后一个可用样本后的仿真时间的模块输出。

最终数据值之后的输出的设置	数据插值的设置	最终数据之后的模块输出
外插	On	根据最终数据值外插
外插	关闭	错误
设置为零	On	零
设置为零	Off	零
保持最终值	On	工作区中的最终值
保持最终值	Off	工作区中的最终值
循环重复	On	错误
循环重复	Off	当加载的工作区数据使用不带时间格式的结构体时，从工作区数据的第一个值开始重复。如果工作区数据格式不是带时间的结构体格式，则会出错。

有关 From Workspace 模块外插行为的完整信息，请参阅外插。

编程用法

模块参数：OutputAfterFinalValue

类型：字符向量

值：'Extrapolation' | 'Setting to zero' | 'Holding final value' | 'Cyclic repetition'

默认值：'Extrapolation'

模型示例

使用 From Workspace 模块加载数据

使用 From Workspace 模块加载仿真输入数据。

打开模型

从工作区读取结构体格式的二维信号

此示例说明如何从 MATLAB 工作区读取二维结构体。

打开模型

模块特性

数据类型	`Boolean` \| `bus` \| `double` \| `enumerated` \| `fixed point^a` \| `half` \| `integer` \| `single` \| `string`
直接馈通	`否`
多维信号	`是`
可变大小信号	`是`
过零检测	`是`
^a 支持通过由 Fixed-Point Designer 创建的 fi 对象实现输入。

提示

From Workspace 模块支持加载总线的部分指定数据。要部分指定总线数据，请将不需要为其加载数据的总线元素设置为 []。
要加载使用 To File 模块以数组格式记录的数据，请转置数组以使时间值位于单列而不是单行中。您可以使用 transpose 函数，并将转置后的数据保存到一个新文件中。
对于使用 sim、parsim 或 batchsim 函数的程序化仿真，您可以使用 Simulink.SimulationInput 对象来指定 From Workspace 模块要加载的数据。

算法

全部展开

插值

插值是 From Workspace 模块用来为加载的工作区数据中的采样时间之间的仿真时间提供输出值的过程。当选中数据插值时，From Workspace 模块会使用工作区数据中的两个相邻点对输出值进行线性插值。当未选中数据插值时，From Workspace 模块会使用前一个工作区数据点的值作为输出值。例如，下面的模型有一个选中了数据插值的 From Workspace 模块，还有一个清除了数据插值的模块。这两个模块从基础工作区加载相同的正弦波数据。

当选中数据插值参数时，From Workspace 模块会根据您加载的数据类型执行不同的步骤。

对于 double 数据，From Workspace 模块使用仿真时间前后的工作区数据值对该值进行线性插值。

对于 Boolean 数据，如果仿真时间在两个具有不同值的工作区数据点之间，则 From Workspace 模块会将值转换定位在工作区数据点的中间。例如，如果工作区数据从 true 转换为 false，则 From Workspace 数据为工作区数据点之间的前半段区间的仿真时间提供输出值 true，为后半段区间的仿真时间提供输出值 false。

对于 double 和 Boolean 以外的内置数据类型，From Workspace 模块会执行以下步骤：

将数据向上转换为 double 数据类型。
使用 double 值对输出值进行线性插值。
将插值向下转换为原始数据类型。

外插

外插是 From Workspace 模块用来为加载的工作区数据中第一个数据点之前和最后一个数据点之后的仿真时间提供输出值的过程。您可以使用数据插值参数控制 From Workspace 模块在第一个工作区数据值之前对输出值进行外插的方式。使用数据插值和最终数据值之后的输出参数指定模块对最后一个工作区数据点之后的仿真时间的输出值进行外插的方式。

数据插值	第一个数据点之前的输出	最终数据之后的输出值	最后一个数据点之后的输出值
On	使用前两个工作区数据点进行线性外插	外插	使用最后两个工作区数据值进行线性外插
		设置为零	零
		保持最终值	最后一个工作区数据值
		循环重复	错误
Off	零	外插	错误
		设置为零	零
		保持最终数据值	最后一个工作区数据值
		循环重复	当加载的工作区数据使用不带时间格式的结构体时，从工作区数据的第一个值开始重复。如果工作区数据格式不是带时间的结构体格式，则会出错。

例如，假设下面的模型包含一个启用了数据插值的 From Workspace 模块，且最终数据值之后的输出设置为“外插”。From Workspace 模块读取工作区数据，该数据是 Sine Wave 模块在历时 16 秒的仿真中的输出。Dashboard Scope 模块显示 Sine Wave 模块和 From Workspace 模块在历时 20 秒的仿真中的输出。仿真达到 16 秒后，From Workspace 模块输出与 Sine Wave 模块输出开始发生分歧，因为 From Workspace 模块会对其余部分仿真的输出值进行线性外插。

扩展功能

C/C++ 代码生成
使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。

不建议用于生产代码。

From Workspace 模块加载的工作区数据在生成的代码中为硬编码数据。

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

通过使用 Fixed-Point Designer™ 创建的 fi (Fixed-Point Designer) 对象支持输入。

From Workspace

描述

指定要加载的数据

端口

输出

`Port_1` — 从工作区加载的数据
标量 | 向量 | 矩阵 | 数组

参数

`数据` — 要从工作区加载的数据
`timeseries` 对象 | `timetable` 对象 | 结构体 | 二维数组 | MATLAB 表达式

编程用法

编程用法

`采样时间` — 输出采样周期和可选时间偏移量
`0` （默认） | 标量 | 向量

编程用法

`数据插值` — 插值方法
`on` （默认） | `off`

编程用法

`启用过零检测` — 过零检测
`on` （默认） | `off`

编程用法

`最终数据值之后的输出` — 确定最后一个数据点之后的模块输出的方法
“`外插`” （默认） | “`设置为零`” | “`保持最终值`” | “`循环重复`”

编程用法

模型示例

使用 From Workspace 模块加载数据

从工作区读取结构体格式的二维信号

模块特性

提示

算法

插值

外插

扩展功能

C/C++ 代码生成
使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。

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

版本历史记录

另请参阅

主题

From Workspace

描述

指定要加载的数据

端口

输出

Port_1 — 从工作区加载的数据 标量 | 向量 | 矩阵 | 数组

参数

数据 — 要从工作区加载的数据 timeseries 对象 | timetable 对象 | 结构体 | 二维数组 | MATLAB 表达式

编程用法

输出数据类型 — 加载的工作区数据类型 Inherit: auto （默认） | double | single | “half” | int8 | uint8 | int16 | uint16 | int32 | uint32 | boolean | fixdt(1,16,0) | “fixdt(1,16,2^0,0)” | “Enum: <class_name>” | “Bus: <bus_object>” | “<data type expression>”

编程用法

采样时间 — 输出采样周期和可选时间偏移量 0 （默认） | 标量 | 向量

编程用法

数据插值 — 插值方法 on （默认） | off

编程用法

启用过零检测 — 过零检测 on （默认） | off

编程用法

最终数据值之后的输出 — 确定最后一个数据点之后的模块输出的方法 “外插” （默认） | “设置为零” | “保持最终值” | “循环重复”

编程用法

模型示例

使用 From Workspace 模块加载数据

从工作区读取结构体格式的二维信号

模块特性

提示

算法

插值

外插

扩展功能

C/C++ 代码生成 使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。

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

版本历史记录

另请参阅

主题

WeChat

`Port_1` — 从工作区加载的数据
标量 | 向量 | 矩阵 | 数组

`数据` — 要从工作区加载的数据
`timeseries` 对象 | `timetable` 对象 | 结构体 | 二维数组 | MATLAB 表达式

`采样时间` — 输出采样周期和可选时间偏移量
`0` （默认） | 标量 | 向量

`数据插值` — 插值方法
`on` （默认） | `off`

`启用过零检测` — 过零检测
`on` （默认） | `off`

`最终数据值之后的输出` — 确定最后一个数据点之后的模块输出的方法
“`外插`” （默认） | “`设置为零`” | “`保持最终值`” | “`循环重复`”

C/C++ 代码生成
使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。

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