Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

From Workspace

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

  • 库:
  • Simulink / Sources

  • From Workspace block

描述

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

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

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

指定要加载的数据

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

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

端口

输出

全部展开

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

数据类型: single | double | half | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean | fixed point | enumerated | bus
复数支持:

参数

全部展开

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

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

  • timeseries 对象

  • timetable 对象

  • Simulink.SimulationData.Signal 对象

  • 表示总线数据的结构体。结构体层次结构必须与总线的层次结构相匹配,并使用 timeseriestimetable 对象来表示信号数据。

  • 表示单个信号的数据的结构体,其字段和层次结构符合“结构体”或“带时间的结构体”记录格式。

  • 表示单个信号的数据的二维数组。数组中的第一列表示时间,一个或多个其他列包含信号数据。

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

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

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

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

编程用法

模块参数VariableName
类型:字符向量
值:MATLAB 表达式 | timeseries 对象 | timetable 对象 | 结构体 | 二维数组
默认值:'simin'

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'

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

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

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

编程用法

模块参数SampleTime
类型:字符向量
值:标量 | 向量
默认值:'0'

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

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

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

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

编程用法

模块参数Interpolate
类型:字符向量
值:'off' | 'on'
默认值:'on'

过零检测是一种用于定位模块输出中的不连续点并避免在不连续点附近使用过小的时间步的方法,它可能会减慢仿真速度。过零指数据中的不连续点。当采样时间为连续 (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'

模块特性

数据类型

Boolean | bus | double | enumerated | fixed pointa | half | integer | single | string

直接馈通

多维信号

可变大小信号

过零检测

a 支持通过由 Fixed-Point Designer 创建的 fi 对象实现输入。

提示

  • From Workspace 模块支持加载总线的部分指定数据。要部分指定总线数据,请将不需要为其加载数据的总线元素设置为 []

  • 要加载使用 To File 模块以数组格式记录的数据,请转置数组以使时间值位于单列而不是单行中。您可以使用 transpose 函数,并将转置后的数据保存到一个新文件中。

  • 对于使用 simparsimbatchsim 函数的程序化仿真,您可以使用 Simulink.SimulationInput 对象来指定 From Workspace 模块要加载的数据。

算法

全部展开

扩展功能

版本历史记录

在 R2006a 之前推出