本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

mdfDatastore

MDF 文件集合的数据存储

说明

使用 MDF 数据存储对象可访问 MDF 文件集合中的数据。

创建对象

说明

示例

mdfds = mdfDatastore(location) 根据 MDF 文件或 location 指定的文件夹中的文件集合创建一个 MDF 数据存储。包含文件夹中扩展名为 .mdf.dat.mf4 的所有文件。

mdfds = mdfDatastore(__,'Name1',Value1,'Name2',Value2,...) 使用可选的名称-值对组指定 mdfds 的函数选项和属性。

注意

只有 64 位 Windows® 操作系统支持此函数。

输入参数

全部展开

MDF 数据存储文件的位置(用于标识文件或文件夹),指定为字符向量、字符向量元胞数组或 matlab.io.datastore.DsFileSet 对象。路径可以是相对路径或绝对路径,并且可以包含通配符 *。如果 location 指定一个文件夹,则默认情况下,数据存储包含该文件夹中扩展名为 .mdf.dat.mf4 的所有文件。

示例: 'CANape.MF4'

数据类型: char | cell | DsFileSet

名称-值对组参数

指定可选的以逗号分隔的名称-值参数对组以设置文件信息或对象 属性。允许的选项有 IncludeSubfoldersFileExtensions 以及属性 ReadSizeSelectedChannelGroupNumberSelectedChannelNames

示例: 'SelectedChannelNames','Counter_B4'

包含子文件夹中的文件,指定为逻辑值。指定 true 可包含每个文件夹及其子文件夹中的文件。

示例: 'IncludeSubfolders',true

数据类型: logical

要包含在 MDF 数据存储中的文件名的自定义扩展名,指定为字符向量或字符向量元胞数组。默认情况下,支持的扩展名包括 .mdf.dat.mf4。如果您的文件具有自定义或非标准扩展名,请使用此“名称-值”设置来包含具有这些扩展名的文件。

示例: 'FileExtensions',{'.myformat1','.myformat2'}

数据类型: char | cell

属性

全部展开

第一个 MDF 文件中存在的所有通道组,以表形式返回。

数据类型: table

第一个 MDF 文件中存在的所有通道,以表形式返回。

那些要读取的通道必须具有相同的名称,并且属于 MDF 数据存储的每个文件中的同一通道组

数据类型: table

数据存储中包含的文件,指定为字符向量、字符串或元胞数组。

示例: {'file1.mf4','file2.mf4'}

数据类型: char | string | cell

read 函数返回的数据的大小,指定为 'file'、数值或持续时间。字符向量值 'file' 表示读取整个文件;双精度数值表示要读取的记录数;持续时间值表示要读取记录的时间范围。

如果稍后更改 ReadSize 属性值类型,则数据存储将重置。

示例: 50

数据类型: double | char | duration

要读取的通道组,指定为数值标量值。

示例: 1

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

要读取的通道的名称,指定为字符向量、字符串或元胞数组。

那些要读取的通道必须具有相同的名称,并且属于 MDF 数据存储的每个文件中的同一通道组。

示例: 'Counter_B4'

数据类型: char | string | cell

对象函数

read读取 MDF 数据存储中的数据
readall读取 MDF 数据存储中的所有数据
preview来自 MDF 数据存储的数据子集
reset将 MDF 数据存储重置为初始状态
hasdata确定 MDF 数据存储中是否有数据可以读取
partition对 MDF 数据存储分区
numpartitionsMDF 数据存储的分区数
combine (MATLAB)合并来自多个数据存储的数据
transform (MATLAB)转换数据存储
isPartitionable (MATLAB)确定数据存储是否可分区
isShuffleable (MATLAB)确定数据存储是否可乱序

示例

全部折叠

基于示例文件 CANape.MF4 创建一个 MDF 数据存储,并将其读入一个时间表中。

mdfds = mdfDatastore(fullfile(matlabroot,'examples','vnt','CANape.MF4'));
while hasdata(mdfds)
    m = read(mdfds);
end 
在 R2017b 中推出