主要内容

tdmsread

从tdms文件中读取数据

描述

例子

数据= tdmsread (tdmsfile从指定的tdms文件检索数据,并返回表的单元格数组。单元格数组的每个元素都是一个与信道组对应的表。

数据= tdmsread (tdmsfile名称=值使用名称-值对筛选数据读取并指定输出格式。

例子

全部折叠

从指定的tdms文件中读取数据。您可以确定读取哪些通道,以及结果的格式。

将tdms文件中的所有数据读入表。

数据= tdmsread(“airlinesmall.tdms”);

将tdms文件中的变量子集作为时间表读入MATLAB。使用变量ArrTime在tdms文件中作为输出时间表的时间向量。

数据= tdmsread(“airlinesmall.tdms”...ChannelGroupName =“航空公司”...ChannelNames = [“ArrTime”“FlightNum”“ArrDelay”],...RowTimes =“ArrTime”);

将通道数据读入具有指定开始时间和步骤持续时间的时间表。

数据= tdmsread(“airlinesmall.tdms”...ChannelGroupName =“航空公司”...ChannelNames = [“ArrTime”“FlightNum”“ArrDelay”],...TimeStep = seconds(0.01), StartTime = seconds(30));

输入参数

全部折叠

TDMS文件名,指定为字符串。

对于本地文件,请使用包含文件名和扩展名的完整路径或相对路径。还可以在MATLAB路径上指定文件。

对于Internet文件,指定URL。例如,从Amazon S3云中读取远程文件:

数据= tdmsread(“s3: / / bucketname / path_to_file / data.tdms”);

例子:“airlinesmall.tdms”

数据类型:字符|字符串

名称-值参数

指定可选参数对为Name1 = Value1,…,以=家,在那里的名字参数名称和价值对应的值。名称-值参数必须出现在其他参数之后,但对的顺序无关紧要。

例子:ChannelGroupName =“扭矩”,ChannelNames = " Torque1”

金宝app支持的名值对有:

包含要从中读取的通道的通道组,指定为字符串或字符向量。

例子:“扭矩”

数据类型:字符串|字符

要读取的通道名称,指定为字符串、字符串数组、字符向量或字符向量的单元格数组。所指定的通道组中必须包含通道ChannelGroupName

例子:[" Torque1”“Torque2”)

数据类型:字符|字符串|细胞

与表中的行关联的时间,指定为选定的时间通道名称、日期时间向量或持续时间向量。指定此选项将使函数输出一个时间表单元格数组。每个time元素标记输出时间表中的一行。

例子:持续时间(秒([1:1000]/ 1000))

数据类型:datetime|持续时间|字符串

输出时间表的开始时间,指定为标量datetime或duration,指示时间表中第一个数据记录的时间。

例子:开始时间=秒(60)

数据类型:datetime|持续时间

输出时间表的采样率,指定为正标量的双倍,表示每秒采样。

例子:SampleRate = 1000

数据类型:

输出时间表的时间步长,指定为标量duration或calendarDuration,表示数据记录之间的时间跨度。

例子:步伐=秒(0.01)

数据类型:持续时间|calendarDuration

输出参数

全部折叠

输出数据,作为包含tdms文件数据记录的表格或时间表的单元格数组返回。单元格数组的每个元素都是通道组的表格或时间表。单元格数组索引对应于通道组号。

当第一个样本的开始时间为0并且样本时间相对于该时间(持续时间)时,返回到时间表的样本时间基于相当于01/01/1904 00:00:00.00 UTC(使用公历并忽略闰秒)的本地时区epoch以来的秒数。有关更多信息,请参见TDMS文件格式内部结构

限制

  • Windows操作系统支持TDMS功能金宝app®平台。

版本历史

R2022a中引入

另请参阅

功能