Contents

MLSoundClassifier.DataSource.labeledDirectories(at:)

Creates a data source from a folder with subfolders that each contain audio files.

Declaration

case labeledDirectories(at: URL)

Parameters

  • at:

    URL : The URL to a folder in the file system that contains folders of audio files. The data source uses the name of each folder as the classification label for the audio content it contains.

Discussion

This data source uses each subdirectory’s name as the label for the audio files contained within them. For example, for a directory that contains a Laughter subdirectory, the data source applies the label "Laughter" to each audio file in that subdirectory.

// Build a URL to the directory that contains the labeled directories.
let home = FileManager.default.homeDirectoryForCurrentUser
let documents = home.appendingPathComponent("Documents")
let labeledDirectories = documents.appendingPathComponent("Labeled Audio Directories")

// Labeled Audio Directories/
// ├── Laughter/
// │ ├── Laughter1.m4a
// │ ├── 20190229164259.m4a
// │ ├── .
// │ ├── .
// │ ├── .
// │ └── AudienceLaughing.mp3
// └── Applause
//   ├── misc-clapping.mp3
//   ├── 20190229164211.m4a
//   ├── .
//   ├── .
//   ├── .
//   └── AudienceClapping.m4a

// Create a data source from the labeled directories.
let soundDataSource = MLSoundClassifier.DataSource.labeledDirectories(at: labeledDirectories)

// Train a sound classifier with the data source.
let soundClassifier = try MLSoundClassifier(trainingData: soundDataSource)

See Also

Creating a data source