主要内容

audioDatastore

用于收集音频文件的数据存储

描述

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

创建

描述

例子

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

例子

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

输入参数

全部展开

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

  • 文件集object—可以指定位置作为一个文件集对象。将位置指定为文件集对象导致数据存储的构造时间比指定路径或更快DsFileSet对象。有关更多信息,请参见matlab.io.datastore.FileSet

  • 文件路径——可以将单个文件路径指定为字符向量或字符串标量。可以将多个文件路径指定为字符向量单元格数组或字符串数组。

  • DsFileSetobject -你可以指定一个DsFileSet对象。有关更多信息,请参见matlab.io.datastore.DsFileSet

文件或文件夹可以是本地的或远程的:

  • 本地文件或文件夹—指定文件或文件夹的本地路径。如果文件不在当前文件夹中,则指定完整路径或相对路径。指定文件夹的子文件夹中的文件不会自动包含在数据存储中。指定本地路径时可以使用通配符(*)。此字符指定数据存储包含所有匹配的文件或匹配文件夹中的所有文件。

  • 远程文件或文件夹——指定远程文件或文件夹的完整路径,作为表单的统一资源定位符(URL)hdfs: / / /path_to_file.有关更多信息,请参见使用远程数据

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

例子:“song.wav”

例子:“. . / dir /音乐/ song.wav”

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

例子:“C: \ dir \ \ * . ogg的音乐

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

名称-值对的观点

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

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

子文件夹包含标志,指定为由逗号分隔的对组成“IncludeSubfolders”真正的.指定真正的将所有文件和子文件夹包含在每个文件夹或只包含每个文件夹中的文件。

如果没有指定“IncludeSubfolders”,则默认值为

例子:“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-by-1单元格字符向量数组。每一行指定一个包含音频文件的唯一文件夹audioDatastore对象指向。

数据类型:细胞

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

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

数据类型:分类|细胞|逻辑|||字符串|表格

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

  • “双”——双精度标准化样品。

  • “本地”——在文件中找到的本地数据类型。指audioread有关数据类型的更多信息OutputDataType设置为本机。

此属性的默认值为“双”

数据类型:字符|字符串

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

  • 若要将一组相互等效的根路径关联起来,请指定AlternateFileSystemRoots作为一个字符串向量。例如:

    “Z: \数据集”“mynetwork /数据集”

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

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

      {(“Z: \数据集”“mynetwork /数据集”];...“Y: \数据集”“mynetwork2 /数据集”“年代:\数据集”]}

    • 另外,指定AlternateFileSystemRoots作为字符向量的单元数组的单元数组。

      {{Z: \数据集的“mynetwork /数据集”};...Y: \数据集”,/ mynetwork2 /数据集”,“年代:\数据集”}}

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

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

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

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

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

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

此属性是只读的。

支持的格式编写音金宝app频文件时,使用writeall函数,指定为[" wav”、“flac”、“ogg”、“mp4”、“m4a格式”)

数据类型:字符串

此属性是只读的。

的默认输出格式,用于编写音频文件时writeall函数,指定为“wav”

数据类型:字符串

对象的功能

读下一个连续的音频文件
readall 从数据存储读取所有音频文件
重置 重置数据存储读指针以启动数据
hasdata 如果数据存储中有更多数据则返回true
洗牌 在数据存储中洗牌文件
子集 创建带有文件子集的数据存储
预览 从数据存储中读取第一个文件以便预览
进步 读取文件的百分数
splitEachLabel 根据指定的标签比例分割数据存储
countEachLabel 清点唯一标签的数量
分区 分区数据存储并返回分区部分
numpartitions 返回用于并行处理的合理分区数量的估计
结合 合并来自多个数据存储的数据
变换 转换音频数据存储
writeall 将数据存储写入文件
isPartitionable 确定数据存储是否可分区
isShuffleable 确定数据存储是否可洗牌

例子

全部折叠

指定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/Bdoc21b/build/matlab/toolbox/audio/samples'} AlternateFileSystemRoots: {} OutputDataType: 'double'标签:{}SupportedOutputFormats: ["wav" "金宝appflac" "ogg" "mp4" "m4a"] DefaultOutputFormat: "wav"

指定audio Toolbox™中包含的音频示例的文件路径。

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

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

广告= audioDatastore(文件夹,“FileExtension”. ogg的
/build/matlab/toolbox/audio/samples/FemaleVolumeUp-16-mono-11secs.ogg';’……/棒/ Bdoc21b /构建/ matlab工具箱/音频/样本/ Hey-16-mono-6secs.ogg ';’……/构建/ matlab工具箱/音频/样本/ MaleVolumeUp-16-mono-6secs。ogg的……{} SupportedOutputFormats: ["wav" "flac" "ogg" "mp4" "m4a"] DefaultOutputFormat: "wav"金宝app
介绍了R2018b