audioDatastore

数据存储的音频文件集合

描述

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

创建

描述

ADS= audioDatastore(位置创建数据存储ADS基于在音频文件或采集的音频文件位置

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

输入参数

展开全部

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

  • 路径 - 指定路径作为字符向量,特征向量的单元阵列,串标量,或者一个字符串数组,包含文件或文件夹的位置。指定位置作为本地路径,文件或文件夹。如果文件不在当前文件夹中,然后本地路径必须指定完整或相对路径。指定文件夹子文件夹中的文件不自动包含在数据存储中。指定本地路径时,您可以使用通配符(*)。这个字符指定的数据存储包括相应的文件夹的所有匹配的文件或所有文件。

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

位置表示文件夹,数据存储只包含受支持的文件格式,而忽略任何其他格式。万博1manbetx若要指定要包含在数据存储中的文件扩展名的自定义列表,请参见FileExtensions属性。

例子:'song.wav'

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

例子:{ 'C:\目录\音乐\ song.wav', 'C:\目录\语音\ english.mp3'}

例子:'C:\目录\音乐\ * OGG'

数据类型:字符||细胞

名称 - 值对参数

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

例子:ADS = audioDatastore( 'C:\ DIR \ audiodata', 'FileExtensions', 'OGG')

子文件夹包含标志,指定为逗号分隔的一对组成的'IncludeSubfolders'真正要么。指定真正包括每个文件夹中的所有文件和子文件夹或只包括每个文件夹中的文件。

如果没有指定'IncludeSubfolders',那么默认值是

例子:“IncludeSubfolders”,真的

数据类型:合乎逻辑|

源提供标签数据,指定为逗号分隔的一对组成的'LABELSOURCE''没有'要么'foldernames'。如果'没有'被指定,则标签属性为空。如果'foldernames',然后根据文件夹名分配标签并将其存储在标签属性。您可以通过访问后修改标签标签直接的财产。

数据类型:字符|

音频文件扩展名,指定为逗号分隔的对组成“FileExtensions”以及字符向量、字符向量的单元数组、字符串标量或字符串数组。如果没有指定“FileExtensions”, 然后audioDatastore自动包含所有支持的文件类型:万博1manbetx

  • . wav

  • .avi

  • .AIF

  • .aifc

  • .AIFF

  • .MP3

  • .AU

  • .SND

  • .MP4

  • .M4A

  • .FLAC

  • .OGG

  • .MOV

例子:'FileExtensions', 'WAV'

例子:'FileExtensions',{” MP3' , 'MP4'}

数据类型:字符|细胞|

除了这些名称 - 值对,你也可以指定任何此页面的名称 - 值对的特性,除了属性。

属性

展开全部

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

数据类型:字符|细胞|

此属性是只读的。

用于创建音频数据存储的文件夹,以ñ×1字符向量的单元阵列。每一行指定包含音频文件的唯一的文件夹audioDatastore对象指向。

数据类型:细胞

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

如果您指定LABELSOURCE'foldernames'创建时audioDatastore对象,然后为一个文件中的标签名是包含它的文件夹的名称。如果没有指定LABELSOURCE'foldernames', 然后标签是空单元格数组或字符串数组。如果你改变数据存储后财产被创建,那么标签属性不会自动更新,其中包含增加的领域。

数据类型:分类|细胞|合乎逻辑||||

输出的数据类型,指定为'双'要么“天然”

  • '双'- 双精度标准化样本。

  • “天然”- 在文件中找到本地数据类型。请参阅audioread有关数据类型的更多信息OutputDataType设置为native。

此属性的默认值为'双'

数据类型:字符|

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

  • 到一组的根路径等效于彼此关联,指定AlternateFileSystemRoots作为一个字符串矢量。例如:

    [“Z:\数据集”“/的MyNetwork /数据集”]

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

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

      {[“Z:\数据集”“/的MyNetwork /数据集”];...[“Y:\数据集”“/ mynetwork2 /数据集”“年代:\数据集”]}

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

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

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

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

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

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

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

数据类型:字符|细胞|

此属性是只读的。

支持使用时书写格万博1manbetx式的音频文件writeall功能,指定为[ “WAV”, “后手”, “奥格”, “MP4”, “M4A”]

数据类型:

此属性是只读的。

属性时写入音频文件的默认输出格式writeall功能,指定为“wav”

数据类型:

对象函数

阅读下一个连续的音频文件
readall 从数据存储中读取所有音频文件
重启 重置数据存储读指针开始数据的
hasdata 如果数据存储中有更多的数据,则返回true
拖曳 在数据存储中洗牌文件
子集 用文件的子集,创建数据存储
预习 从数据存储预览阅读第一个文件
进展 读取文件的部分
splitEachLabel 分裂根据指定的标签数据存储区的比例
countEachLabel 伯爵独有的标签数
划分 分区数据存储和分区部分收益
numpartitions 返回估计用于并行处理的分区的合理数量的
结合 合并来自多个数据存储数据
转变 变换音频数据存储
writeall 写数据存储到文件
isPartitionable 确定数据存储是否可分区
isShuffleable 确定数据存储是否shuffleable

例子

全部收缩

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

夹=完整文件(matlabroot,'工具箱'“音频”“样品”);

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

ADS = audioDatastore(文件夹)
ADS = audioDatastore具有属性:文件:{ '... /建造/ MATLAB /工具箱/音频/样品/气氛-16-44p1单 -  12secs.wav';'... / MATLAB /工具箱/音频/样品/ AudioArray-16-16-4channels-20secs.wav';'... /工具箱/音频/样品/ ChurchImpulseResponse-16-44p1单 -  5secs.wav' ...和26更}文件夹:{“/ MathWorks公司/ devel的/蝙蝠/ Bdoc20a /建造/ MATLAB /工具箱/音频/样品} AlternateFileSystemRoots:{} OutputDataType: '双' 标签:{} SupportedOutputFor万博1manbetxmats:[ “WAV” “后手” “奥格” “MP4” “M4A”] DefaultOutputFormat: “WAV”

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

夹=完整文件(matlabroot,'工具箱'“音频”“样品”);

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

ADS = audioDatastore(文件夹,'文件扩展名''.OGG'
ADS = audioDatastore具有属性:文件:{ '... /建造/ MATLAB /工具箱/音频/样品/ SoftGuitar-44p1_mono-10mins.ogg'}文件夹:{“/ MathWorks公司/ devel的/蝙蝠/ Bdoc20a /建造/ MATLAB /工具箱/音频/样品} AlternateFileSystemRoots:{} OutputDataType: '双' 标签:{} SupportedOutputFormats:[ 万博1manbetx“WAV” “后手” “奥格” “MP4” “M4A”] DefaultOutputFormat: “WAV”

介绍了在R2018b