import numpy
import os
import subprocess
import sys
import wave
from dhbw import dasp
[docs]
def display(data, sr=None):
"""
Displays the specified audio data or file in a Python notebook.
Parameters
----------
data : ndarray, string
Audio samples or string containing the file path,
with or without the .wav extension.
sr : integer, optional
Sample rate in hertz.
"""
import IPython
if isinstance(data, str):
path = str(data)
if path.startswith('~'):
path = os.path.expanduser(path)
if not path.lower().endswith('.wav'):
path += '.wav'
return IPython.display.Audio(filename=path)
else:
sr = sr if sr is not None else dasp.SR
return IPython.display.Audio(data, rate=sr, normalize=False)
[docs]
def open(path, cmd='audacity', shell=False, wait=False):
"""
Executes custom command with specified .wav file path as an argument.
Parameters
----------
path : string
File path with or without the .wav extension.
cmd : string
Command to execute, e.g. audacity (https://www.audacityteam.org).
shell : bool
If true, the command will be executed through the shell.
wait : bool
If true, wait for child process to terminate.
"""
if path.startswith('~'):
path = os.path.expanduser(path)
if not path.lower().endswith('.wav'):
path += '.wav'
process = subprocess.Popen([cmd, path], shell=shell)
if wait:
return process.wait()
else:
return process.pid
[docs]
def play(path, cmd='play', shell=False, wait=True):
"""
Executes custom command with specified .wav file path as an argument.
Parameters
----------
path : string
File path with or without the .wav extension.
cmd : string
Command to execute, e.g. play (http://sox.sourceforge.net).
shell : bool
If true, the command will be executed through the shell.
wait : bool
If true, wait for child process to terminate.
"""
return open(path, cmd=cmd, shell=shell, wait=wait)
[docs]
def read(path):
"""
Reads a .wav file.
Parameters
----------
path : string
File path with or without the .wav extension.
Returns
-------
data : ndarray
Content of the .wav file.
time : ndarray
Corresponding timeline array.
sr : integer
Sample rate in hertz.
"""
if path.startswith('~'):
path = os.path.expanduser(path)
if not path.lower().endswith('.wav'):
path += '.wav'
with wave.open(path, 'rb') as file:
sr = file.getframerate()
bytes = file.getsampwidth()
channels = file.getnchannels()
data = file.readframes(file.getnframes())
dasp.log.echo(f'Reading data from file {path} {dict(sr=sr, bytes=bytes, channels=channels, n=len(data))}')
assert bytes in [1, 2, 3, 4]
bits = bytes * 8
scaler = 2 ** (bits - 1) - 1
data = numpy.frombuffer(data, dtype=numpy.uint8).reshape(-1, bytes)
data = numpy.asarray([
int.from_bytes(frame, signed=(bits != 8), byteorder=sys.byteorder)
for frame in data])
data = data.astype(float).reshape(-1, channels)
data -= 128 if bits == 8 else 0 # to signed 8bit
data = (data + 0.5) / (scaler + 0.5)
data = data.clip(-1, +1)
time = dasp.timeline(len(data) / sr, sr=sr)
data = data[:len(time), ...]
data = data.flatten() if channels == 1 else data
return data, time, sr
[docs]
def write(path, data, sr=None, bits=24):
"""
Writes a .wav file.
Parameters
----------
path : string
File path with or without the .wav extension.
data : ndarray
Content of the .wav file.
sr : integer, optional
Sample rate in hertz.
bits : integer, optional
Sample bitwidth.
"""
sr = sr if sr is not None else dasp.SR
if path.startswith('~'):
path = os.path.expanduser(path)
if not path.lower().endswith('.wav'):
path += '.wav'
data = numpy.asarray(data)
assert data.dtype in [float, complex]
assert data.ndim in [1, 2]
assert data.size > 0
if numpy.iscomplex(data).any():
assert data.ndim == 1
data = numpy.stack((numpy.real(data), numpy.imag(data)))
if data.ndim == 2:
if data.shape[0] == 2:
channels = data.shape[0]
data = data.ravel('F')
else:
channels = data.shape[1]
data = data.ravel('C')
else:
channels = 1
assert bits in [8, 16, 24, 32]
bytes = bits // 8
scaler = 2 ** (bits - 1) - 1
data = data.clip(-1, +1)
data = (data * (scaler + 0.5)) - 0.5
data += 128 if bits == 8 else 0 # to unsigned 8bit
data = b''.join([
int(frame).to_bytes(length=bytes, signed=(bits != 8), byteorder=sys.byteorder)
for frame in data])
dasp.log.echo(f'Writing data to file {path} {dict(sr=sr, bytes=bytes, channels=channels, n=len(data))}')
with wave.open(path, 'wb') as file:
file.setframerate(sr)
file.setsampwidth(bytes)
file.setnchannels(channels)
file.writeframes(data)