readall

Read all audio files from datastore

Syntax

data = readall(ADS)

data = readall(ADS,UseParallel=TF)

Description

data = readall(ADS) reads all audio files from the datastore.

If all the data in the datastore does not fit in memory, then readall returns an error.

data = readall(ADS,UseParallel=TF) reads the data in parallel if TF is true (requires Parallel Computing Toolbox™).

Examples

Read All Data in Audio Datastore

Specify the file path to the audio samples included with Audio Toolbox™. Create an audio datastore that points to the specified folder.

folder = fullfile(matlabroot,'toolbox','audio','samples');
ADS = audioDatastore(folder);

Read all the data in the datastore.

readall(ADS)

ans=39×1 cell array
    { 539648×1  double}
    { 320512×4  double}
    { 227497×1  double}
    {  48000×1  double}
    {   8000×1  double}
    { 685056×1  double}
    { 882688×2  double}
    {  24000×1  double}
    { 175104×1  double}
    {1116288×2  double}
    {1215360×2  double}
    { 263304×16 double}
    { 100868×1  double}
    { 180224×1  double}
    {  32768×1  double}
    { 192150×1  double}
      ⋮

Input Arguments

ADS — Audio datastore

audioDatastore object

Specify ADS as an audioDatastore object.

TF — Read in parallel

false (default) | true

Read in parallel, specified as true or false. If you specify true, readall reads all data from the datastore using a pool of parallel workers (requires Parallel Computing Toolbox). For more information on parallel pools, see parpool (Parallel Computing Toolbox). Parallel reading may result in improved performance when reading data.

Example: readall(ds,UseParallel=true)

Output Arguments

data — All audio files in audio datastore

cell array

All files in the audio datastore, returned as a cell array where each cell corresponds to a file.

Version History

Introduced in R2018b