audiodatastore.

音频文件集合的数据存储

展开所有页面

描述

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

创建

句法

广告= audioDataStore（位置）

广告= audioDataStore（位置，名称，值）

描述

例子

广告= audiodataStore（地点）创建一个数据存储广告基于音频文件或音频文件集合地点。

例子

广告= audiodataStore（地点那名称，价值）使用一个或多个名称值对参数指定其他属性。

输入参数

展开全部

`地点`-在数据存储区中包含文件或文件夹
小路|`dsfileset.`目的

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

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

当地点表示一个文件夹时，数据存储只包含支持的文件格式，而忽略任何其他格式。金宝app若要指定要包含在数据存储中的自定义文件扩展名列表，请参见过滤义财产。

例子：'song.wav'

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

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

例子：'c：\ dir \ music \ *。ogg'

数据类型：字符|细绳|细胞

名称值对参数

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

例子：广告= audioDataStore（'C：\ dir \ audiodata'，'fileextensions'，'。ogg'）

`'insertumbfolders'`-子文件夹包含标志
`错误的`（默认）|`真的`

子文件夹包含标志，指定为逗号分隔的配对'insertumbfolders'和真的或者错误的。指定真的包括每个文件夹中的所有文件和子文件夹或错误的仅包含每个文件夹中的文件。

如果您未指定'insertumbfolders'，然后默认值是错误的。

例子：“IncludeSubfolders”,真的

数据类型：逻辑|双倍的

`'labelsource'`-提供标签数据的源
`'没有任何'`（默认）|`'foldernames'`

提供标签数据的源，指定为逗号分隔对'labelsource'和'没有任何'或者'foldernames'。如果'没有任何'指定，然后是标签财产是空的。如果'foldernames'，则根据文件夹名称分配标签，并存储在标签财产。您可以稍后通过访问来修改标签标签直接的财产。

数据类型：字符|细绳

`“FileExtensions”`-音频文件扩展
字符向量|字符向量的单元格阵列|字符串标量|字符串数组

音频文件扩展名，由逗号分隔的对组成“FileExtensions”字符向量，字符向量的单元数组，字符串标量，或字符串数组。如果您未指定“FileExtensions”，然后audiodatastore.自动包含所有支持的文件类型：金宝app

. wav
.avi
.AIF
.AIFC.
.AIFF.
.mp3
.au
.snd.
.mp4.
.m4a.
.flac.
.ogg.
.MOV.

例子：'fileextensions'，'。wav'

例子：'fileextensions'，{'。mp3'，'。mp4'}

数据类型：字符|细胞|细绳

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

特性

展开全部

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

数据存储中包含的文件，指定为字符向量，字符向量，字符串标量或字符串数组的单元格数组。每个字符向量或字符串是文件的完整路径。这地点争论在audiodatastore.定义文件创建数据存储时。

数据类型：字符|细胞|细绳

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

此属性是只读的。

用于创建音频数据存储的文件夹，返回为N- 1个字符向量的单元阵列。每行指定包含音频文件的唯一文件夹audiodatastore.对象要点。

数据类型：细胞

`标签`-文件标签
分类，逻辑或数字矢量|细胞阵列|字符串数组|桌子

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

如果您指定LabelSource.作为'foldernames'创建时audiodatastore.对象，然后文件的标签名称是包含它的文件夹的名称。如果您未指定LabelSource.作为'foldernames'，然后标签是一个空单元格数组或字符串数组。如果你改变文件创建数据存储后的属性，那么标签未更新属性以合并添加的字段。

数据类型：分类|细胞|逻辑|双倍的|单身的|细绳|桌子

`outputDataType.`-输出读取的数据类型
`'双倍的'`（默认）|`'本国的'`

输出的数据类型，指定为'双倍的'或者'本国的'。

'双倍的'- 双精度标准化样品。
'本国的'- 文件中找到的本机数据类型。参考Audioread.有关数据类型的详细信息outputDataType.设置为本机。

此属性的默认值为'双倍的'。

数据类型：字符|细绳

`AlternateFileSystemRoots`-备用文件系统根路径
串行矢量|串载体的单元阵列|字符向量的单元格阵列

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

要关联一组等同于彼此的根路径，请指定AlternateFileSystemRoots作为串矢量。例如：
```
[“z：\ datasets”那“/ mynetwork / datasets”]
```
要关联多组等同于数据存储的根路径，请指定AlternateFileSystemRoots作为包含多行的单元格数组，其中每行表示一组等价的根路径。将单元格数组中的每一行指定为字符串向量或字符向量的单元格数组。例如：
- 指定AlternateFileSystemRoots作为字符串向量的单元格数组。
  {[“z：\ datasets”那“/ mynetwork / datasets”]；......[“y：\ datasets”那“/ mynetwork2 / datasets”那“年代:\数据集”]}
- 或者，指定AlternateFileSystemRoots作为字符向量的单元阵列的单元阵列。
  {{'z：\ datasets'那'/ mynetwork / datasets'};......{'y：\ datasets“，'/ mynetwork2 / datasets'，'：\ datasets'}}

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

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

数据类型：字符|细胞|细绳

`金宝appSupportedOutputFormats`-编写音频文件支持金宝app的格式
`[“WAV”，“FLAC”，“OGG”，“MP4”，“M4A”]`

此属性是只读的。

使用时支持写入音金宝app频文件的格式reliteall.功能，指定为[“WAV”，“FLAC”，“OGG”，“MP4”，“M4A”]。

数据类型：细绳

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

此属性是只读的。

的默认输出格式写入音频文件时reliteall.功能，指定为“wav”。

数据类型：细绳

对象功能

`读`	阅读下一个连续的音频文件
`读物`	从数据存储读取所有音频文件
`重启`	重置数据存储读取指针到数据开始
`哈迪塔`	如果数据存储中有更多数据，则返回true
`洗牌`	转移数据存储中的文件
`子集`	使用文件子集创建数据存储区
`预习`	从数据存储读取第一个文件进行预览
`进步`	读取的文件的比例
`spliteachlabel.`	根据指定的标签比例拆分数据存储
`counteanceLabel.`	数量唯一标签数
`划分`	分区数据存储和返回分区部分
`numpartitions.`	返回估计，以获得并行处理的合理分区
`结合`	将数据与多个数据存储组合
`转换`	转换音频数据存储
`reliteall.`	将数据存储写入文件
`是可分派的`	确定数据存储是否可分区
`isShufflable.`	确定数据存储是否会破坏

例子

全部收缩

创建音频数据存储

打开直播脚本

将文件路径指定为Audio Toolbox™包含的音频样本。

文件夹= fullfile（matlabroot，'工具箱'那'声音的'那'样品'）;

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

广告= audiodataStore（文件夹）

广告=具有属性的audioDataStore：文件：{'... / build / matlab / toolbox / audian / samples / bamaniance-16-44p1-mono-12secs.wav';'... / matlab / toolbox / audio / samples / audioArray-16-16-4Channels-20secs.wav';'/工具箱/音频/样本/ churchimpulsEsponse-16-44p1-mono-5secs.wav'...和26更多}文件夹：{'/ mathworks / devel / bat / bdoc20a / build / matlab / toolbox / authin/ samples'} learstatefilesystemroots：{} outputDatatype：'double'标签：{} supporte金宝appdOutputFormats：[“WAV”“FLAC”“OGG”“MP4”“M4A”] DefaultOutputFormat：“WAV”

指定包含的文件扩展名

打开直播脚本

将文件路径指定为Audio Toolbox™包含的音频样本。

文件夹= fullfile（matlabroot，'工具箱'那'声音的'那'样品'）;

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

广告= audiodataStore（文件夹，'文件扩展名'那'.gg'）

ADS =具有属性的AudioDataStore：文件：{'... / build / matlab / toolbox / audio / samples / softguitar-44p1_mono-10mins.ogg'}文件夹：{'/ mathworks / devel / bat / bdoc20a / build / matlab /工具箱/音频/示例'} learstefilesystemroots：{} outputDatatype：'double'标签：{} supportedOutputFormats：金宝app[“WAV”“FLAC”“OGG”“MP4”“M4A”] DefaultOutputFormat：“WAV”