主要内容

仪器性能

查看和编辑记录信号的记录和可视化属性

描述

使用“仪器仪表属性”对话框可配置记录信号的记录和可视化设置,包括数据访问回调函数,用于在模拟和记录采样时间处理记录数据。

打开仪表属性

  • 右键单击标记为日志的信号上的日志标记,然后选择属性

参数

测井与可视化

选择此选项可为记录的信号数据指定与模型中信号名称不同的名称。默认情况下,记录的信号数据使用模型中指定的信号名称。

使用自定义名称属性与日志的名字属性配置的信号特性对话框。

编程使用

要以编程方式指定日志记录名称,请使用set_param函数配置DataLoggingNameMode而且DataLoggingName对应于产生信号的块输出端口的端口句柄的参数。有关示例,请参见以编程方式指定的信号专用日志名称

参数:DataLoggingNameMode
值:“SignalName”|“自定义”
默认值:“SignalName”
参数:DataLoggingName
类型:字符串|字符向量

当您希望降低记录数据的有效采样率时,请选择成千上万的数据并在文本框中指定所需的抽取因子。例如,如果指定抽取因子为2,每一个其他信号值被记录。

在减少在模拟中记录的数据点数量之前,考虑每个信号的数据要求。如果有效采样率过低,抽取会导致混叠。

有关更多信息,请参见为日志指定信号值而且限制记录数据的大小

编程使用

要以编程方式配置此选项,请使用set_param函数配置DataLoggingDecimateData而且DataLoggingDecimation对应于产生信号的块输出端口的端口句柄的参数。

参数:DataLoggingDecimateData
值:“上”|“关闭”
默认值:“关闭”
参数:DataLoggingDecimation
值:数字标量
类型:字符串|字符向量
默认值:' 2 '

当您只想保存或分析模拟结束时的数据时,您可以配置日志记录以仅捕获最后的数据n信号值。选择最后限制数据点并指定要记录的数据点的数量。

当您只记录最后的模拟值时,仪表板块和模拟数据检查器在模拟期间不会显示数据。在减少在模拟中记录的数据点数量之前,请考虑每个信号的数据要求。

有关更多信息,请参见为日志指定信号值而且限制记录数据的大小

编程使用

要以编程方式配置此选项,请使用set_param函数指定DataLoggingLimitDataPoints而且DataLoggingMaxPoints对应于产生信号的块输出端口的端口句柄的参数。

参数:DataLoggingLimitDataPoints
值:“上”|“关闭”
默认值:“关闭”
参数:DataLoggingMaxPoints
值:数字标量
类型:字符串|字符向量
默认值:“5000”

指定用于记录所选信号数据的采样时间。默认情况下,将继承日志记录示例时间(-1)从产生信号的块中取出。对于连续记录采样时间,将值指定为0.若要对记录数据使用离散采样时间,请将采样间隔指定为标量。

指定日志记录采样时间可以向模型添加新的采样时间。当您指定日志记录采样时间时,模型会为精确的命中时间计算一个值。当您使用固定步长求解器时,您指定的日志记录采样时间必须是模型的基本速率的倍数。

条件子系统或条件引用模型中的信号不支持记录采样时间。万博1manbetx

测井采样时间属性与样品时间属性配置信号特性对话框。

编程使用

要以编程方式配置此选项,请使用set_param函数配置DataLoggingSampleTime对应于产生信号的块输出端口的端口句柄的参数。

参数:DataLoggingSampleTime
值:数字标量
类型:字符串|字符向量
默认值:' 1 '

指定模拟数据检查器如何记录和解释多维数据。默认情况下,信号被记录为基于样本的,多维样本中的每个元素都被视为一个通道。

当记录基于帧的信号时,设置输入处理列作为通道(基于帧).基于帧的信号缓冲一批样本以创建一帧数据。当您将数据记录为基于帧的时,样本中的每一列都被视为一个通道,而行维则被视为通道内的均匀间隔样本。

您还可以在模拟后使用模拟数据检查器从基于帧的信号中删除缓冲。有关更多信息,请参见转换基于框架的数据表示

编程使用

以编程方式配置或访问输入处理属性获取记录信号,请使用万博1manbetxSimulink.sdi.setSignalInputProcessingMode功能和万博1manbetxSimulink.sdi.getSignalInputProcessingMode函数。

复杂信号数据被记录为单个信号。使用复杂的格式属性指定如何在模拟数据检查器中显示复杂信号。通过在Instrumentation Properties中指定复杂的格式,您可以在模型中保存首选项,以便为每个模拟一致地显示记录的数据。在从模拟中记录数据或导入数据之后,还可以在模拟数据检查器中修改信号的复杂格式。

对于所有的复杂格式,你把复杂信号画成一个信号。有些格式将绘制信号的组成部分显示为单独的轨迹。

  • Real-Imaginary-将实分量和虚分量绘制为单独的轨迹。

    信号线颜色指定实际组件的颜色。虚数组件使用指定线条颜色的不同阴影。

  • Magnitude-Phase-绘制幅值和相位分量作为单独的迹线。

    信号线颜色指定幅度分量的颜色。相位组件使用指定线条颜色的不同色度。

  • -只绘制幅值分量。

  • 阶段-只绘制相位分量。

属性指定值时次要情节属性时,信号被绘制在仿真数据检查器中相应的子图上。您可以使用此属性在模型中保存绘图配置。但是,该属性不会影响模拟数据检查器中的子图布局或已绘制的清除信号。

启用后,您可以在“模拟数据检查器”中配置用于显示信号的线条样式和颜色仪表板范围块并保存在模型中的首选项,以便信号在MATLAB中一致地显示®会话。

在模型中指定线条样式和颜色并不会阻止您在“模拟数据检查器”中更改线条样式和颜色。的仪表板范围块和仿真数据检查器总是使用记录信号属性中指定的线条样式和颜色显示信号,如属性窗格中的模拟数据检查器。

设置用于显示信号的线条样式、宽度和颜色仪表板范围块和在模拟数据检查器中。

在模型中指定线条样式和颜色并不会阻止您在“模拟数据检查器”中更改线条样式和颜色。的仪表板范围块和仿真数据检查器总是使用记录信号属性中指定的线条样式和颜色显示信号,如属性窗格中的模拟数据检查器。

依赖关系

要启用属性,选择自定义样式和颜色

数据访问

启用后,可以指定一个数据访问回调函数,该函数在模拟期间处理或可视化记录的信号数据。该函数在整个模拟过程中异步接收数据包中的数据,并且每次接收到新数据时执行该函数。有关更多信息,请参见仿真过程中MATLAB函数的数据存取

在模拟过程中处理或可视化信号数据的数据访问回调函数的名称。数据访问回调函数总是接收信号数据作为第一个参数,也可以接收模拟时间和函数参数作为附加参数。当函数接收到所有三个参数时,模拟时间是第二个参数。有关更多信息,请参见仿真过程中MATLAB函数的数据存取

有关编写MATLAB函数的详细信息,请参见在文件中创建函数

依赖关系

要启用函数名属性,选择启用运行时数据访问

选项,在模拟期间将模拟时间与信号数据一起发送到数据访问回调函数。数据访问回调函数总是接收信号数据作为第一个参数,也可以接收模拟时间和函数参数作为附加参数。当函数接收到所有三个参数时,模拟时间是第二个参数。有关更多信息,请参见仿真过程中MATLAB函数的数据存取

依赖关系

要启用包括模拟时间属性,选择启用运行时数据访问

属性指定值时函数参数,数据访问回调函数接收指定的值作为第二个或第三个参数,这取决于发送给回调函数的数据是否包含时间。当使用相同的数据访问回调函数处理多个信号的数据时,请指定函数参数以确定函数在给定调用中接收到哪些信号数据。有关更多信息,请参见仿真过程中MATLAB函数的数据存取

依赖关系

要启用函数参数属性,选择启用运行时数据访问

版本历史

在R2018a中引入