主要内容

audioDatastore

数据存储的音频文件的集合

扩展所有的页面

描述

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

创建

语法

广告= audioDatastore(位置)
广告= audioDatastore(位置、名称、值)

描述

例子

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

例子

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

输入参数

全部展开

文件或文件夹包括在数据存储中,指定为一个文件集对象,如文件路径,或者作为一个DsFileSet对象。

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

  • 文件路径,您可以指定一个文件路径作为特征向量或字符串标量。您可以指定多个文件路径作为一个单元阵列特征向量或一个字符串数组。

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

文件或文件夹可能是本地或远程:

  • 本地文件或文件夹-指定本地文件或文件夹路径。如果文件不在当前文件夹,然后指定完整或相对路径。指定文件夹的子文件夹内文件不会自动包含在数据存储中。您可以使用通配符(*)时指定的本地路径。这个角色指定数据存储包括所有匹配的文件或匹配所有文件文件夹。

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

指定一个文件夹时,数据存储只包含文件支持的文件格式和忽略任何其他格式的文件。万博1manbetx指定一个自定义列表的文件扩展名,包括数据存储,看到FileExtensions财产。

例子:“song.wav”

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

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

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

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

名称-值参数

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

R2021a之前,用逗号来分隔每一个名称和值,并附上的名字在报价。

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

子文件夹包含标志,指定为逗号分隔组成的“IncludeSubfolders”和真正的或假。指定真正的包括每个文件夹内的所有文件和子文件夹假只包括每个文件夹内的文件。

如果你不指定“IncludeSubfolders”,那么默认值是假。

例子:“IncludeSubfolders”,真的

数据类型:逻辑|双

提供标签数据来源,指定为逗号分隔组成的“LabelSource”和“没有”或“foldernames”。如果“没有”是指定的,那么标签属性是空的。如果“foldernames”是指定的,那么标签分配根据文件夹名称和存储在吗标签财产。你可以通过访问后修改标签标签直接的财产。

数据类型:字符|字符串

音频文件扩展名,指定为逗号分隔组成的“FileExtensions”一个特征向量,单元阵列特征向量,标量字符串或字符串数组。如果你不指定“FileExtensions”,然后audioDatastore自动包括所有支持的文件类型:万博1manbetx

  • . wav

  • .avi

  • aif

  • .aifc

  • .aiff

  • mp3

  • .au

  • 爱恋

  • mp4

  • .m4a

  • .flac

  • . ogg

  • 。mov

  • .opus

例子:“FileExtensions”、“wav”

例子:FileExtensions, {mp3, mp4的}

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

除了这些名称-值对,你也可以在这个页面指定的任何属性名称-值对,除了文件财产。

属性

全部展开

文件中包含的数据存储,指定为一个特征向量,单元阵列的特征向量,标量字符串或字符串数组。向量的每个字符或字符串是一个文件的完整路径。的位置论点的audioDatastore定义了文件创建数据存储时。

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

这个属性是只读的。

文件夹用来创建音频数据存储,作为一个返回N1单元阵列的特征向量。每一行包含音频文件,指定一个独特的文件夹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必须满足以下条件:

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

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

  • 根路径都是独一无二的,没有子文件夹。

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

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

这个属性是只读的。

写作格式支持的音万博1manbetx频文件时使用writeall函数,指定为[" wav”、“flac”、“ogg”、“作品”,“mp4”、“m4a格式”)。

数据类型:字符串

这个属性是只读的。

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

数据类型:字符串

对象的功能

读 连续读取下一个音频文件
readall 从数据存储读取所有音频文件
重置 重置数据存储读取指针指向的数据
hasdata 如果有更多的数据在数据存储返回true
洗牌 洗牌文件数据存储
子集 创建数据存储子集的文件
预览 从数据存储读取第一个文件预览
进步 部分文件读
splitEachLabel 根据指定的标签比例分割数据存储
countEachLabel 计算数量的独特的标签
分区 分区数据存储和分区部分回报
numpartitions 回归估计合理数量的分区并行处理
结合 合并来自多个数据存储的数据
变换 转换音频数据存储
writeall 写数据存储文件
isPartitionable 确定是否可分区的数据存储
isShuffleable 确定是否shuffleable数据存储

例子

全部折叠

打开生活的脚本

指定文件路径与音频音频样本包括工具箱™。

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

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

广告= audioDatastore(文件夹)
广告= audioDatastore属性:文件:{"…/构建/ matlab工具箱/音频/样本/ Ambiance-16-44p1-mono-12secs.wav ';’……/ matlab工具箱/音频/样本/ AudioArray-16-16-4channels-20secs.wav”;’……/工具箱/音频/样本/ ChurchImpulseResponse-16-44p1-mono-5secs。wav”……和32}文件夹:{' / mathworks /猛击/棒/ Bdoc22b /构建/ matlab工具箱/音频/样品'}AlternateFileSystemRoots: {} OutputDataType:“双”标签:{}SupportedOutputFormats:(“wav”“flac”“ogg”“作品”…万博1manbetx]DefaultOutputFormat:“wav”
打开生活的脚本

指定文件路径与音频音频样本包括工具箱™。

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

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

广告= audioDatastore(文件夹,“FileExtension”,. ogg的)
广告= audioDatastore属性:文件:{"…/构建/ matlab工具箱/音频/样本/ FemaleVolumeUp-16-mono-11secs.ogg ';’……/棒/ Bdoc22b /构建/ matlab工具箱/音频/样本/ Hey-16-mono-6secs.ogg ';’……/构建/ matlab工具箱/音频/样本/ MaleVolumeUp-16-mono-6secs。ogg的……文件夹和2}:{/ mathworks猛击/棒/ Bdoc22b /构建/ matlab工具箱/音频/样品'}AlternateFileSystemRoots: {} OutputDataType:“双”标签:{}SupportedOutputFormats:(“wav”“flac”“ogg”“作品”…万博1manbetx]DefaultOutputFormat:“wav”

版本历史

介绍了R2018b

全部展开

另请参阅

||

主题