主要内容

记录，XY图

将数据记录到工作区、文件或两者都记录

展开全部页面
  • 库:

  • 金宝appSimulink / sink

  • 记录块

描述

您可以使用记录块或XY图块将数据记录到工作区、文件或同时记录到工作区和文件。将数据记录到文件时，可以选择记录到MAT文件、MLDATX文件或Excel®文件。连接到记录block总是登录到模拟数据检查器。如果您决定在模拟后需要保存数据，则可以从记录块转移到工作区或任何受支持的文件类型。金宝app

你也可以使用记录块来可视化连接的信号。查看连接到记录块，双击块。您可以访问模拟控件，例如运行控件中的数据，同时查看记录块。

默认情况下，记录块显示火花线图上的所有连接信号。为每个连接的信号添加一个火花线。当火花线填满可见空间后，滚动条允许您继续绘制信号。

打开模型以查看记录块记录的数据，块参数在属性检查器中可见。

建立可视化

的记录块支持仿真数金宝app据检查器中可用的大多数可视化。方法对数据使用不同的可视化时，可以修改图形布局和图形类型布局选项和带有标记的绘图类型选择器微线图默认情况下。使用布局列表以选择子图的布局。若要更改子图的图类型，请选择子图，然后从图类型选择器中选择所需的图类型。

有关更多信息，请参见使用记录块将数据记录到工作区和文件．有关如何使用每种可视化类型的示例，请参见:

的记录块不支持模拟数据检查器中可用的金宝app数组可视化。的记录Block支金宝app持记录多维信号数据，包括可变大小的信号，但不支持可视化多维数据。控件来可视化多维信号的数据记录块，将带有多维采样值的信号转换为一组信号，称为渠道，每个都有标量抽样值。有关更多信息，请参见多维信号数据分析．

XY图形块

的XY图block在Simulin金宝appk中®类的另一种配置记录在XY图上可视化两个输入信号的块。第一个输入端口提供x用于XY图的数据，并且第二个输入端口提供y数据。

的XY图块支持非标量金宝app输入的日志记录和可视化数据。然而，XY可视化不支持多维数据。金宝app将非标量信号连接到XY图块时，必须手动配置非标量信号的哪些通道或元素提供x而且yXY图的数据。

港口

输入

全部展开

开始录音。端口可以添加到记录控件可以将行拖动到块的边缘，或使用港口参数。

的记录块支持记录可金宝app变大小的信号，但不支持可视化可变大小的信号。

的XY图块的另一种配置记录块，显示连接到XY图上两个输入端口的数据。第一个输入端口提供x用于XY图的数据，并且第二个输入端口提供y数据。

提示

  • 若要记录基于帧的数据，请指定输入处理接收基于帧的信号的每个端口的参数。

  • 的输入端口连接非标量信号时XY图块时，必须手动配置非标量信号的哪些通道或元素提供x而且yXY图的数据。

数据类型:单|双|一半|int8|int16|int32|int64|uint8|uint16|uint32|uint64|布尔|不动点|枚举|公共汽车|图像
复数支持:金宝app是的

参数

全部展开

修改记录块参数，使用属性检查器。

主要

输入端口数，以整数形式指定1而且One hundred.、包容。

的XY图块的另一种配置记录块，显示连接到XY图上两个输入端口的数据。第一个输入端口提供x用于XY图的数据，并且第二个输入端口提供y数据。

编程使用

块参数:“NumPorts”
类型:整数|特征向量
价值观:范围为[的整数1，One hundred.］
默认值:1

使用港口而且输入处理参数一起指定端口的输入处理模式。输入处理模式决定了如何处理记录Block解释矩阵数据:

  • 基于样本的-矩阵中的每个元素都是一个单独的通道。

  • 基于帧的-矩阵中的每一列都是一个单独的通道。

要使用基于帧的输入处理，信号必须具有离散的采样率，并且采样值必须是固定维度的非标量。

默认情况下，每个端口对输入信号进行采样处理。

修改端口的输入处理模式。

  1. 属性选择端口号港口参数。

  2. 属性选择输入处理模式输入处理参数。

编程使用

属性以编程方式指定每个端口的输入处理模式FrameSettings参数作为行向量，其元素数量与块端口一样多。元素索引对应于块上的端口号。指定1对端口和使用基于帧的输入处理0使用基于样本的处理。

块参数:“FrameSettings”
类型:逻辑阵列
价值观:1——- - - - - -n行向量，其中n等于端口的数量
默认值:0

使用港口而且输入处理参数一起指定端口的输入处理模式。输入处理模式决定了如何处理记录Block解释矩阵数据:

  • 基于样本的-矩阵中的每个元素都是一个单独的通道。

  • 基于帧的-矩阵中的每一列都是一个单独的通道。

要使用基于帧的输入处理，信号必须具有离散的采样率，并且采样值必须是固定维度的非标量。

默认情况下，每个端口对输入信号进行采样处理。

修改端口的输入处理模式。

  1. 属性选择端口号港口参数。

  2. 属性选择输入处理模式输入处理参数。

编程使用

属性以编程方式指定每个端口的输入处理模式FrameSettings参数作为行向量，其元素数量与块端口一样多。元素索引对应于块上的端口号。指定1对端口和使用基于帧的输入处理0使用基于样本的处理。

块参数:“FrameSettings”
类型:逻辑阵列
价值观:1——- - - - - -n行向量，其中n等于端口的数量
默认值:0

记录

工作区日志记录选项。默认情况下，记录block只将数据记录到模拟数据检查器。选择记录到工作区来记录连接到记录块到MATLAB®中的工作区金宝appSimulink.SimulationData.Dataset对象。

使用工作区变量名称属性的名称数据集对象，该对象包含已记录日志的记录块数据。

提示

  • 当您将数据记录到工作区时，您访问数据的方式取决于您的模型配置。默认情况下，模型在一个输出变量中提供所有日志数据金宝app仿真软件。SimulationOutput对象。您可以访问记录使用得到函数或点记录块工作区变量名。当单次仿真输出选项禁用后，日志记录数据将显示在工作区中的单独变量中，并且您可以访问记录直接块数据。

  • 属性指定的日志记录间隔记录时间间隔属性应用于记录到工作区的数据记录块。

  • 你可以用单人间记录块将数据记录到模拟数据检查器、工作区和文件。

编程使用

块参数:“RecordToWorkspace”
类型:字符向量|布尔值|数值
价值观:“上”|“关闭”|真正的或1|假或0
默认值:“关闭”

包含已记录块数据的工作区变量的名称。

依赖关系

要启用此参数，请选择记录到工作区参数。

编程使用

块参数:“VariableName”
类型:字符向量|字符串
默认值:“recordout”

日志到文件选项。默认情况下，记录block只将数据记录到模拟数据检查器。选择记录存档来记录连接到记录块到文件。

提示

  • 使用文件名称参数为文件指定名称。

  • 使用文件类型参数指定将数据记录到MLDATX文件、MAT文件或Excel文件中。

  • 使用文件位置参数指定文件的路径。

  • 属性指定的日志记录间隔记录时间间隔配置参数不适用于记录到文件中的数据记录块。

编程使用

块参数:“RecordToFile”
类型:字符向量|布尔值|数值
价值观:“上”|“关闭”|真正的或1|假或0
默认值:“关闭”

包含日志数据的文件名。名称不需要包含文件扩展名。如果在名称中包含文件扩展名，请确保该名称使用了指定的有效扩展名文件类型．

提示

  • 如果在每次运行时未更改记录到的文件的名称或位置，则记录块将覆盖文件中的先前数据。

  • 如果要将文件保存在工作目录以外的位置，请使用文件位置参数指定要保存文件的目录的路径。

依赖关系

要启用此参数，请选择记录存档参数。

编程使用

使用文件名参数来指定文件名称，文件类型,文件位置参数。在传递给的名称中包含所需文件类型的扩展名set_param．当要将文件保存在当前工作目录以外的位置时，请使用文件名和扩展名指定路径。

块参数:“文件名”
类型:字符向量|字符串
默认值:“recording.mldatx”

使用文件类型参数指定是要将数据记录到MLDATX文件、MAT文件还是Excel文件。

提示

依赖关系

若要启用该参数，请选中记录存档．

编程使用

使用文件名参数来指定文件名称，文件类型,文件位置参数。在传递给的名称中包含所需文件类型的扩展名set_param．当要将文件保存在当前工作目录以外的位置时，请使用文件名和扩展名指定路径。

块参数:“文件名”
类型:字符向量|字符串
默认值:“recording.mldatx”

使用文件位置参数指定当要将文件保存在工作目录以外的其他位置时，要将包含日志数据的文件保存在其中的位置。确保您在指定的目录中具有写权限。

依赖关系

若要启用该参数，请选中记录存档．

编程使用

使用文件名参数来指定文件名称，文件类型,文件位置参数。在传递给的名称中包含所需文件类型的扩展名set_param．当要将文件保存在当前工作目录以外的位置时，请使用文件名和扩展名指定路径。

块参数:“文件名”
类型:字符向量|字符串
默认值:“recording.mldatx”

使用时间参数来指定如何记录信号时间数据记录块数据到Excel文件。

  • 共享时间列—当多个信号的时间数据相同时，这些信号在日志文件中共用一个时间列。日志文件仍然可能包含多个时间列，如果记录对于具有唯一时间数据的信号，块记录数据。

  • 单个时间列-每个被记录的信号在日志文件中总是有自己的时间列。

依赖关系

若要启用该参数，请选中记录存档并指定文件类型作为* .xlsx．

在将数据记录到Excel文件时，选择一个或多个要包含在日志文件中的信号属性选项。所选信号属性根据中所述的格式出现在第一个数据点上方的信号列中Microsoft Excel导入，导出和日志格式．

依赖关系

若要启用该参数，请选中记录存档并指定文件类型作为* .xlsx．

模型的例子

使用记录块将数据记录到工作区和文件

使用记录块将数据记录到工作区和文件

使用Record块将数据记录到工作空间、文件或同时记录到工作空间和文件。
开放模式
使用XY图形块绘制圆

使用XY图形块绘制圆

情节x而且y的圆的数据XY图块。
开放模式
使用回放块加载数据

使用回放块加载数据

使用Playback块从工作区、文件和模拟数据检查器加载数据。
打开实时脚本

块特征

数据类型

布尔|公共汽车|双|枚举|不动点|一半|整数|单|字符串

直接引线

没有

多维信号

是的

适应信号

是的

讨论二阶导数过零检测

没有

提示

  • 打开记录块在一个新的窗口，右键单击块，然后选择在新窗口中打开．

  • 打开记录块在一个新的选项卡，右键单击块，然后选择在新标签中打开．

扩展功能

版本历史

R2021a中引入

另请参阅

工具

块

模型设置