Skip to main content

Python library for loading and working with sound datasets.

Project description

soundata

Python library for downloading, loading & working with sound datasets. Check the API documentation and the contributing instructions.
For Music Information Retrieval (MIR) datasets please check mirdata.

CI status Formatting status Linting status Downloads

codecov Documentation Status GitHub PyPI version PRs Welcome

This library provides tools for working with common sound datasets, including tools for:

  • Downloading datasets to a common location and format
  • Validating that the files for a dataset are all present
  • Loading annotation files to a common format
  • Parsing clip-level metadata for detailed evaluations

Here's soundata's list of currently supported datasets.

Installation

To install, simply run:

pip install soundata

Quick example

import soundata

dataset = soundata.initialize('urbansound8k')
dataset.download()  # download the dataset
dataset.validate()  # validate that all the expected files are there

example_clip = dataset.choice_clip()  # choose a random example clip
print(example_clip)  # see the available data

See the documentation for more examples and the API reference.

Contributing a new dataset loader

We welcome and encourage contributions to this library, especially new dataset loaders. Please see contributing for guidelines. Feel free to open an issue if you have any doubt or your run into problems when working on the library.

Citing

TBA

When working with datasets, please cite the version of soundata that you are using AND include the reference of the dataset, which can be found in the respective dataset loader using the cite() method.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

soundata-1.0.1.tar.gz (142.0 kB view details)

Uploaded Source

Built Distribution

soundata-1.0.1-py3-none-any.whl (162.0 kB view details)

Uploaded Python 3

File details

Details for the file soundata-1.0.1.tar.gz.

File metadata

  • Download URL: soundata-1.0.1.tar.gz
  • Upload date:
  • Size: 142.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.3

File hashes

Hashes for soundata-1.0.1.tar.gz
Algorithm Hash digest
SHA256 8dbbf2367463b0fb7ff4fe8b512271ae73c5b4f5f96db57b9c1ac085c74a8d16
MD5 33580da53b2a62780464b0c1c782c93f
BLAKE2b-256 23642c6662d7f41c1aef966c7f67c92872876e302ac1b6d71869fa959193db04

See more details on using hashes here.

File details

Details for the file soundata-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: soundata-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 162.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.3

File hashes

Hashes for soundata-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8756d614d0ec2b2be2bb5be290898ed8e856aac0bb271c5eaeed16792d78a8dd
MD5 af6459c48e29ac9ae1295be701ba115e
BLAKE2b-256 dab0d8823eed97b11b44a6031db3e53db55ccc734fb049e27b48ad88fa11d854

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page