主要内容

audioDatastore

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

展开全部页面

描述

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

创建

语法

ADS = audioDatastore(location)
ADS = audioDatastore(位置，名称，值)

描述

例子

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

例子

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

输入参数

全部展开

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

  • 文件集object -可以指定位置作为一个文件集对象。指定位置为文件集对象相比于指定路径或DsFileSet对象。有关更多信息，请参见matlab.io.datastore.FileSet．

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

  • DsFileSetobject -可以指定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之前，使用逗号分隔每个名称和值，并将其括起来的名字在报价。

例子:ADS = 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定义了文件创建数据存储时。

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

此属性是只读的。

用于创建音频数据存储的文件夹，返回为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必须满足这些条件:

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

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

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

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

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

此属性是只读的。

类型时写入音频文万博1manbetx件所支持的格式writeall函数，指定为[" wav”、“flac”、“ogg”、“作品”,“mp4”、“m4a格式”)．

数据类型:字符串

此属性是只读的。

写入音频文件时的默认输出格式writeall函数，指定为“wav”．

数据类型:字符串

对象的功能

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

例子

全部折叠

打开实时脚本

指定音频工具箱™中包含的音频样本的文件路径。

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

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

ADS = audioDatastore(文件夹)
ADS = audioDatastore属性:Files:{'…/build/matlab/toolbox/audio/samples/ ambient -16-44p1-mono- 12seconds .wav';’……/ matlab工具箱/音频/样本/ AudioArray-16-16-4channels-20secs.wav”;/toolbox/audio/samples/ churchimpulseresponse -16-44p1-mono- 5seconds .wav{'/mathworks/devel/bat/Bdoc22b/build/matlab/toolbox/audio/samples'} AlternateFileSystemRoots: {} OutputDataType: 'double'标签:{}SupportedOutputFormats: ["wav" "万博1manbetxflac" "ogg" "opus"…DefaultOutputFormat: "wav"
打开实时脚本

指定音频工具箱™中包含的音频样本的文件路径。

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

的音频数据存储. ogg指定文件夹中的文件。

ADS = audioDatastore(文件夹，“FileExtension”，. ogg的）
ADS = audioDatastore属性:Files:{'…/build/matlab/toolbox/audio/samples/ femalevolumeup -16-mono-11sec .ogg';’……/棒/ Bdoc22b /构建/ matlab工具箱/音频/样本/ Hey-16-mono-6secs.ogg ';’……/构建/ matlab工具箱/音频/样本/ MaleVolumeUp-16-mono-6secs。ogg的……{'/mathworks/devel/bat/Bdoc22b/build/matlab/toolbox/audio/samples'} AlternateFileSystemRoots: {} OutputDataType: 'double'标签:{}SupportedOutputFormats: ["wav" 万博1manbetx"flac" "ogg" "opus"…DefaultOutputFormat: "wav"

版本历史

在R2018b中引入

全部展开

另请参阅

||

主题