Skip to main content

A module for Audio/Acoustic Activity Detection

Project description

doc/figures/auditok-logo.png https://travis-ci.org/amsehili/auditok.svg?branch=master Documentation Status

auditok is an Audio Activity Detection tool that can process online data (read from an audio device or from standard input) as well as audio files. It can be used as a command line program or by calling its API.

A basic version of auditok will run with standard Python (>=3.4). Without installing additional dependencies, auditok can only deal with audio files in wav or raw formats. if you want more features, the following packages are needed:

  • pydub : read audio files in popular audio formats (ogg, mp3, etc.) or extract audio from a video file.

  • pyaudio : read audio data from the microphone and play back detections.

  • tqdm : show progress bar while playing audio clips.

  • matplotlib : plot audio signal and detections (see figures above ).

  • numpy : required by matplotlib. Also used for some math operations instead of standard python if available.

Installation

git clone https://github.com/amsehili/auditok.git
cd auditok
python setup.py install

Basic example

from auditok import split

# split returns a generator of AudioRegion objects
audio_regions = split("audio.wav")
for region in audio_regions:
    region.play(progress_bar=True)
    filename = region.save("/tmp/region_{meta.start:.3f}.wav")
    print("region saved as: {}".format(filename))

Example using AudioRegion

from auditok import AudioRegion
region = AudioRegion.load("audio.wav")
regions = region.split_and_plot() # or just region.splitp()

output figure:

doc/figures/example_1.png

Working with AudioRegions

Beyond splitting, there are a couple of interesting operations you can do with AudioRegion objects.

Concatenate regions

from auditok import AudioRegion
region_1 = AudioRegion.load("audio_1.wav")
region_2 = AudioRegion.load("audio_2.wav")
region_3 = region_1 + region_2

Particularly useful if you want to join regions returned by split:

from auditok import AudioRegion
regions = AudioRegion.load("audio.wav").split()
gapless_region = sum(regions)

Repeat a region

Multiply by a positive integer:

from auditok import AudioRegion
region = AudioRegion.load("audio.wav")
region_x3 = region * 3

Make slices of equal size out of a region

Divide by a positive integer:

from auditok import AudioRegion
region = AudioRegion.load("audio.wav")
regions = regions / 5
assert sum(regions) == region

Make audio slices of arbitrary size

Slicing an AudioRegion can be interesting in many situations. You can for example remove a fixed-size portion of audio data from the beginning or the end of a region or crop a region by an arbitrary amount as a data augmentation strategy, etc.

The most accurate way to slice an AudioRegion is to use indices that directly refer to raw audio samples. In the following example, assuming that the sampling rate of audio data is 16000, you can extract a 5-second region from main region, starting from the 20th second as follows:

from auditok import AudioRegion
region = AudioRegion.load("audio.wav")
start = 20 * 16000
stop = 25 * 16000
five_second_region = region[start:stop]

This allows you to practically start and stop at any sample within the region. Just as with a list you can omit one of start and stop, or both. You can also use negative indices:

from auditok import AudioRegion
region = AudioRegion.load("audio.wav")
start = -3 * region.sr # `sr` is an alias of `sampling_rate`
three_last_seconds = region[start:]

While slicing by raw samples is accurate, slicing with temporal indices is more intuitive. You can do so by accessing the millis or seconds views of AudioRegion (or their shortcut alias ms and sec/s).

With the millis view:

from auditok import AudioRegion
region = AudioRegion.load("audio.wav")
five_second_region = region.millis[5000:10000]

or with the seconds view

from auditok import AudioRegion
region = AudioRegion.load("audio.wav")
five_second_region = region.seconds[5:10]

Get an array of audio samples

from auditok import AudioRegion
region = AudioRegion.load("audio.wav")
samples = region.samples

If numpy is installed, this will return a numpy.ndarray. If audio data is mono the returned array is 1D, otherwise it’s 2D. If numpy is not installed this will return a standard array.array for mono data, and a list of array.array for multichannel data.

Alternatively you can use:

import numpy as np
region = AudioRegion.load("audio.wav")
samples = np.asarray(region)

License

MIT.

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

forked-auditok-split-without-data-0.2.0a0.tar.gz (38.8 kB view details)

Uploaded Source

Built Distribution

File details

Details for the file forked-auditok-split-without-data-0.2.0a0.tar.gz.

File metadata

  • Download URL: forked-auditok-split-without-data-0.2.0a0.tar.gz
  • Upload date:
  • Size: 38.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.8

File hashes

Hashes for forked-auditok-split-without-data-0.2.0a0.tar.gz
Algorithm Hash digest
SHA256 1c28c581ed58ebe5cca81cdddf642296c96b947bdc0ac873d0013d527356076c
MD5 c4dab69574ec33a96780725d06467ae0
BLAKE2b-256 d9d0da3001c311ba3f945d1a0848a7f6e426a397ce6b27f3b794fb93ac015e68

See more details on using hashes here.

File details

Details for the file forked_auditok_split_without_data-0.2.0a0-py3-none-any.whl.

File metadata

  • Download URL: forked_auditok_split_without_data-0.2.0a0-py3-none-any.whl
  • Upload date:
  • Size: 1.5 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.8

File hashes

Hashes for forked_auditok_split_without_data-0.2.0a0-py3-none-any.whl
Algorithm Hash digest
SHA256 58f5e48b8f29e1f138a0268ec3e617caca57009b80b9640ca703f2cdcec57741
MD5 edfac6e632e52947d95b124c3ec73311
BLAKE2b-256 9f4e6cfb572ecc55ee977a42735446c78eee396ff65bf7a9a0e5e8504960f3a1

See more details on using hashes here.

Supported by

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