audioDatastore

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

展开页面中的所有内容

描述

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

创建

语法

广告= audioDatastore(位置)

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

描述

例子

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

例子

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

输入参数

全部展开

`位置`- - - - - -要包含在数据存储中的文件或文件夹
路径|`DsFileSet`对象

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

path—指定路径为字符向量、字符向量的单元数组、字符串标量或字符串数组，包含文件或文件夹的位置。指定位置作为文件或文件夹的本地路径。如果文件不在当前文件夹中，则本地路径必须指定完整路径或相对路径。指定文件夹的子文件夹中的文件不会自动包含在数据存储中。指定本地路径时可以使用通配符*。这个字符指定数据存储包括所有匹配的文件或匹配文件夹中的所有文件。
DsFileSet对象 - 您也可以指定位置作为一个DsFileSet对象。有关更多信息，请参阅matlab.io.datastore.DsFileSet。

什么时候位置表示一个文件夹，数据存储区仅包括支持的文件格式并忽略任何其他格式。金宝app要在数据存储区中指定要包含的文件扩展名的自定义列表，请参阅FileExtensions财产。

例子：“song.wav”

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

例子：{'c：\ dir \ music \ song.wav'，'c：\ dir \ speep \ English.mp3'}

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

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

名称-值对的观点

指定可选的逗号分隔对名称,值论点。的名字参数名和价值是对应的值。的名字必须出现在引号内。您可以按如下顺序指定几个名称和值对参数name1，value1，...，namen，valuen。

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

`“IncludeSubfolders”`- - - - - -子文件夹包含国旗
`假`(默认)|`真正的`

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

如果不指定“IncludeSubfolders”，则默认值为假。

例子：'insertumubfolders'，真实

数据类型:逻辑|双倍的

`“LabelSource”`- - - - - -提供标签数据的源
`“没有”`(默认)|`“foldernames”`

提供标签数据的源，指定为逗号分隔的对，由“LabelSource”和“没有”或“foldernames”。如果“没有”指定，那么标签属性是空的。如果“foldernames”指定，然后根据文件夹名称分配标签并存储在标签财产。属性可以在以后修改标签标签property直接。

数据类型:char|字符串

`'fileextensions'`- - - - - -音频文件扩展名
特征向量|字符向量的单元数组|字符串标量|字符串数组

音频文件扩展，指定为逗号分隔对组成'fileextensions'和字符矢量，字符向量，字符串标量或字符串数组的字符矢量。如果不指定'fileextensions',然后audioDatastore自动包括所有支持的文件类型:金宝app

.wav.
.avi.
aif
.aifc
.aiff
mp3
.au
爱恋
mp4
.m4a
.flac
. ogg
。mov

例子：“FileExtensions”、“wav”

例子：FileExtensions, {mp3, mp4的}

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

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

属性

全部展开

`文件`- - - - - -数据存储中包含的文件
特征向量|字符向量的单元数组|字符串标量|字符串数组

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

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

`文件夹`- - - - - -用于创建音频数据存储的文件夹
N-by-1单元格数组的字符向量

此属性是只读的。

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

数据类型:细胞

`标签`- - - - - -文件标签
分类的、逻辑的或数字的向量|单元阵列|字符串数组|表格

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

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

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

`OutputDataType`- - - - - -数据类型的输出读取
`“双”`(默认)|`“本地”`

数据类型的输出，指定为“双”或“本地”。

“双”——双精度归一化样本。
“本地”——在文件中找到的本地数据类型。指audioread有关数据类型的更多信息OutputDataType被设置为原生。

此属性的默认值是“双”。

数据类型:char|字符串

`lexeryfilesystemroots.`- - - - - -备用文件系统根路径
字符串行向量|单元格数组的字符串向量|字符向量的单元数组

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

若要将一组彼此等价的根路径关联起来，请指定lexeryfilesystemroots.作为一个字符串向量。例如:
```
(“Z: \数据集”,“mynetwork /数据集”]
```
若要关联与数据存储等价的多组根路径，请指定lexeryfilesystemroots.作为包含多行的单元数组，其中每行代表一组等效的根路径。将单元格数组中的每一行指定为字符串向量或字符向量的小区数组。例如:
- 指定lexeryfilesystemroots.作为串向量的单元阵列。
  {[“Z: \数据集”,“mynetwork /数据集”];…(“Y: \数据集”,“mynetwork2 /数据集”,“s：\ datasets”]}
- 另外,指定lexeryfilesystemroots.作为单元数组的单元数组的字符向量。
  {{Z: \数据集的,“mynetwork /数据集”};…{'y：\ datasets“，'/ mynetwork2 /数据集”,“年代:\数据集”}}

的价值lexeryfilesystemroots.必须满足这些条件：

包含一行或多行，其中每行指定一组等价的根路径。
每行指定多个根路径，且每个根路径至少包含两个字符。
根路径是唯一的，不是彼此的子文件夹。
包含至少一个指向文件位置的根路径项。

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

`金宝app支持的upTutFormats.`- - - - - -支持音频文件的格金宝app式
`[" wav”、“flac”、“ogg”、“mp4”、“m4a格式”)`

此属性是只读的。

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

数据类型:字符串

`DefaultOutputFormat`- - - - - -默认输出音频文件格式
`“wav”`（默认）

此属性是只读的。

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

数据类型:字符串

对象的功能

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

例子

全部折叠

创建音频数据存储

打开生活的脚本

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

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

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

广告= audioDatastore(文件夹)

Files:{'…/build/matlab/toolbox/audio/samples/ ambient -16-44p1-mono- 12seconds .wav';’……/ matlab工具箱/音频/样本/ AudioArray-16-16-4channels-20secs.wav”;’……/工具箱/音频/样本/ ChurchImpulseResponse-16-44p1-mono-5secs.wav’……和31多个}文件夹:{'/mathworks/devel/bat/Bdoc21a/build/matlab/toolbox/audio/samples'} AlternateFileSystemRoots: {} OutputDataType: 'double'标签:{}SupportedOutputFormats金宝app: ["wav" "flac" "ogg" "mp4" "m4a"] DefaultOutputFormat: "wav"

指定要包含的文件扩展

打开生活的脚本

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

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

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

广告= audioDatastore(文件夹,“FileExtension”,. ogg的)

Files:{'…/build/matlab/toolbox/audio/samples/ femalevolumeup -16-mono- 11seconds .ogg';’……/棒/ Bdoc21a /构建/ matlab工具箱/音频/样本/ Hey-16-mono-6secs.ogg ';’……/构建/ matlab工具箱/音频/样本/ MaleVolumeUp-16-mono-6secs。ogg的……and 2 more} Folders: {'/mathworks/devel/bat/Bdoc21a/build/matlab/toolbox/audio/samples'} AlternateFileSystemRoots: {} OutputDataType: 'double'标签:{}SupportedO金宝apputputFormats: ["wav" "flac" "ogg" "mp4" "m4a"] DefaultOutputFormat: "wav"