主要内容

音频数据存储

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

描述

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

创建

描述

实例

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

实例

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

输入参数

全部展开

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

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

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

  • 数据文件集object -你可以指定一个数据文件集对象。有关更多信息,请参见matlab.io.datastore.DsFileSet

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

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

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

当指定文件夹时,数据存储只包含支持的文件格式的文件,而忽略任何其他格式的文件。金宝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)

子文件夹包含标志,指定为由逗号分隔的对组成“IncludeSubfolders”真正的错误的具体说明真正的包括每个文件夹或文件夹中的所有文件和子文件夹错误的只包含每个文件夹中的文件。

如果您没有指定“IncludeSubfolders”,则默认值为错误的

例子:“IncludeSubfolders”,真的

数据类型:必然的|

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

数据类型:字符|字符串

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

  • . wav

  • .avi

  • aif

  • .aifc

  • .aiff

  • .mp3

  • 欧先生

  • 爱恋

  • .mp4

  • .m4a

  • .flac

  • . ogg

  • 莫夫先生

例子:“文件扩展名”,“.wav”

例子:'文件扩展名',{.mp3','.mp4'}

数据类型:字符|单间牢房|字符串

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

属性

全部展开

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

数据类型:字符|单间牢房|字符串

此属性是只读的。

用于创建音频数据存储的文件夹,作为N-字符向量的by-1单元格数组。每行指定一个唯一的文件夹,其中包含音频数据存储对象指向。

数据类型:单间牢房

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

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

数据类型:分类|单间牢房|必然的|||字符串|桌子

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

  • “双人”–双精度标准化样本。

  • “本地”–在文件中找到本机数据类型。请参阅音频读物有关数据类型的更多信息OutputDataType设置为本机。

此属性的默认值为“双人”

数据类型:字符|字符串

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

  • 要关联一组彼此等效的根路径,请指定AlternateFileSystemRoots作为字符串向量。例如:

    [“Z:\数据集”,“mynetwork /数据集”]

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

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

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

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

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

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

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

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

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

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

数据类型:字符|单间牢房|字符串

此属性是只读的。

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

数据类型:字符串

此属性是只读的。

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

数据类型:字符串

目标函数

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

例子

全部崩溃

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

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

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

ADS=音频数据存储(文件夹)
/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"

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

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

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

ADS=音频数据存储(文件夹,“文件扩展名”,“.ogg”)
ADS=audioDatastore,具有以下属性:文件:{'/build/matlab/toolbox/audio/samples/FemaleVolumeUp-16-mono-11secs.ogg';'/bat/Bdoc21b/build/matlab/toolbox/audio/samples/FemaleVolumeUp-16-mono-6secs.ogg';'.'./build/matlab/matlab/matlab/toolbox/toolbox/toolbox/audio/audio/samples/maleUp-16-{'/mathworks/devel/bat/Bdoc21b/build/matlab/toolbox/audio/samples'}可选文件系统根:{}输出数据类型:{}双标签:{}支持输出格式:[“wav”“flac”“ogg”“mp4”“m4a”]默认输出格式:“wav”金宝app
在R2018b中引入