主要内容

audiodatastore.

音频文件集合的数据存储

描述

使用一个audiodatastore.对象来管理音频文件集合,其中每个单独的音频文件适合于内存,但整个音频文件集合不一定适合。

创建

描述

例子

广告= audioDatastore (位置创建一个数据存储广告基于音频文件或音频文件的集合位置

例子

广告= audioDatastore (位置名称,价值使用一个或多个名称值对参数指定其他属性。

输入参数

全部展开

数据存储中包含的文件或文件夹,指定为路径或dsfileset.对象。

  • path—将路径指定为包含文件或文件夹位置的字符向量、字符向量单元格数组、字符串标量或字符串数组。指定位置作为文件或文件夹的本地路径。如果文件不在当前文件夹中,则本地路径必须指定完整路径或相对路径。指定文件夹的子文件夹中的文件不会自动包含在数据存储中。指定本地路径时可以使用通配符(*)。此字符指定数据存储包含所有匹配的文件或匹配文件夹中的所有文件。

  • dsfileset.object—你也可以指定位置作为一个dsfileset.对象。有关更多信息,请参见matlab.io.datastore.dsfileset.

位置表示文件夹时,该数据存储只包含支持的文件格式,而忽略任何其他格式。金宝app要指定要包含在数据存储中的文件扩展名的自定义列表,请参阅过滤义财产。

例子:'song.wav'

例子:'../dir/music/song.wav'

例子:{“C: \ dir \ \ song.wav音乐”,“C: \ dir \演讲\ english.mp3”}

例子:'c:\ dir \ music \ *。ogg'

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

名称值对参数

指定可选的逗号分离对名称,价值参数。的名字是参数名称和价值为对应值。的名字必须出现在引号内。您可以以任何顺序指定多个名称和值对参数Name1, Value1,…,的家

例子:广告= audioDatastore (C: \ dir \ audiodata, FileExtensions, . ogg)

子文件夹包含标志,指定为由逗号分隔的对组成'insertumbfolders'真正的错误的.指定真正的包括每个文件夹中的所有文件和子文件夹或错误的只包含每个文件夹中的文件。

如果您未指定'insertumbfolders',然后默认值是错误的

例子:“IncludeSubfolders”,真的

数据类型:逻辑|

提供标签数据的源,指定为逗号分隔对“LabelSource”'没有任何'“foldernames”.如果'没有任何'指定,然后是标签属性是空的。如果“foldernames”,则根据文件夹名称分配标签并存储在标签财产。您可以在以后通过访问标签直接的财产。

数据类型:字符|字符串

音频文件扩展名,指定为逗号分隔对,由“FileExtensions”以及字符向量、字符向量的单元数组、字符串标量或字符串数组。如果您未指定“FileExtensions”, 然后audiodatastore.自动包含所有支持的文件类型:金宝app

  • . wav

  • .avi

  • aif

  • .aifc

  • .aiff

  • .mp3.

  • .au

  • 爱恋

  • .mp4.

  • .m4a

  • .flac

  • . ogg

  • .MOV.

例子:'fileextensions','。wav'

例子:'fileextensions',{'。mp3','。mp4'}

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

除了这些名称 - 值对之外,还可以指定此页面上的任何属性作为名称值对,除了文件财产。

属性

全部展开

数据存储中包含的文件,指定为字符向量,字符向量,字符串标量或字符串数​​组的单元格数组。每个字符向量或字符串是文件的完整路径。这位置论点的audiodatastore.定义了文件创建数据存储时。

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

此属性是只读的。

用于创建音频数据存储的文件夹,作为N- 1个字符向量的单元阵列。每行指定包含音频文件的唯一文件夹audiodatastore.对象要点。

数据类型:细胞

数据存储中文件的文件标签,指定为向量、单元格数组、字符串数组或表。数组或表中标签的顺序与数据存储中相关文件的顺序相对应。

如果您指定LabelSource作为“foldernames”在创建audiodatastore.对象,则文件的标签名就是包含该文件的文件夹的名称。如果您未指定LabelSource作为“foldernames”, 然后标签是空单元格数组或字符串数组。如果你改变文件创建数据存储后的属性,那么标签属性不会自动更新以合并添加的字段。

数据类型:分类|细胞|逻辑|||字符串|桌子

输出数据类型,指定为'双倍的'“本地”

  • '双倍的'- 双精度标准化样品。

  • “本地”- 文件中找到的本机数据类型。参考Audioread.有关数据类型的更多信息OutputDataType设置为本机。

此属性的默认值为'双倍的'

数据类型:字符|字符串

可选的文件系统根路径,指定为字符串行向量、字符串向量的单元数组或字符向量的单元数组。使用AlternateFileSystemRoots当您在本地机器上创建数据存储,但必须访问和处理另一台机器(可能是不同的操作系统)上的数据时。此外,当使用并行计算工具箱™处理数据时MATLAB®并行服务器™,数据存储在本地计算机上,使用不同平台云或群集计算机上可用的数据副本,您必须使用AlternateFileSystemRoots关联根路径。

  • 要关联一组等同于彼此的根路径,请指定AlternateFileSystemRoots作为串矢量。例如:

    [“z:\ datasets”“mynetwork /数据集”]

  • 要关联多组等同于数据存储的根路径,请指定AlternateFileSystemRoots作为包含多行的单元格数组,其中每一行表示一组等价的根路径。将单元格数组中的每一行指定为字符串向量或字符向量的单元格数组。例如:

    • 指定AlternateFileSystemRoots作为字符串向量的单元格数组。

      {(“z:\ datasets”“mynetwork /数据集”];...[“y:\ datasets”“/ mynetwork2 / datasets”“年代:\数据集”]}

    • 或者,指定AlternateFileSystemRoots作为字符向量的单元阵列的单元阵列。

      {{'z:\ datasets'“mynetwork /数据集”};...{Y: \数据集”,/ mynetwork2 / datasets',':\ datasets'}}

的价值AlternateFileSystemRoots必须满足以下条件:

  • 包含一个或多个行,其中每行指定一组等效根路径。

  • 每行指定多个根路径,每个根路径至少包含两个字符。

  • 根路径是唯一的,不是彼此的子文件夹。

  • 包含至少一个点指向文件位置的根路径条目。

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

此属性是只读的。

使用时支持写入音金宝app频文件的格式reliteall.功能,指定为[" wav”、“flac”、“ogg”、“mp4”、“m4a格式”)

数据类型:字符串

此属性是只读的。

的默认输出格式,用于编写音频文件时reliteall.功能,指定为“wav”

数据类型:字符串

对象功能

阅读下一个连续的音频文件
读物 从数据存储读取所有音频文件
重置 重置数据存储读指针以启动数据
哈迪塔 如果数据存储中有更多数据则返回true
洗牌 在数据存储中洗牌文件
子集 创建带有文件子集的数据存储
预览 从数据存储中读取第一个文件以便预览
进步 读取文件的百分数
spliteachlabel. 根据指定的标签比例拆分数据存储
countEachLabel 清点唯一标签的数量
分区 分区数据存储和返回分区部分
numpartitions 返回用于并行处理的合理分区数量的估计
结合 将数据与多个数据存储组合
变换 转换音频数据存储
reliteall. 将数据存储写入文件
isPartitionable 确定数据存储是否可分区
isShufflable. 确定数据存储是否会破坏

例子

全部收缩

将文件路径指定为Audio Toolbox™包含的音频样本。

文件夹= fullfile(matlabroot,'工具箱'“音频”“样本”);

创建指向指定文件夹的音频数据存储。

广告= audiodataStore(文件夹)
/build/matlab/toolbox/audio/samples/Ambiance-16-44p1-mono-12secs.wav';’……/ matlab工具箱/音频/样本/ AudioArray-16-16-4channels-20secs.wav”;’……/工具箱/音频/样本/ ChurchImpulseResponse-16-44p1-mono-5secs.wav’……{'/mathworks/devel/bat/Bdoc21a/build/matlab/toolbox/audio/samples'} AlternateFileSystemRoots: {} OutputDataType: 'double'标签:{}SupportedOutputFormats: ["wav" "金宝appflac" "ogg" "mp4" "m4a"] DefaultOutputFormat: "wav"

将文件路径指定为Audio Toolbox™包含的音频样本。

文件夹= fullfile(matlabroot,'工具箱'“音频”“样本”);

创建一个音频数据存储,指向. ogg指定文件夹中的文件。

广告= audiodataStore(文件夹,'文件扩展名''.gg'
/build/matlab/toolbox/audio/samples/FemaleVolumeUp-16-mono-11secs.ogg';’……/棒/ Bdoc21a /构建/ matlab工具箱/音频/样本/ Hey-16-mono-6secs.ogg ';’……/构建/ matlab工具箱/音频/样本/ MaleVolumeUp-16-mono-6secs。ogg的……{} SupportedOutputFormats: ["wav" "flac" "ogg" "mp4" "m4a"] DefaultOutputFormat: "wav"金宝app
在R2018B中介绍