stimuli.audio.Tone🔗

class stimuli.audio.Tone(frequency, volume, duration, sample_rate=None, device=None, n_channels=1, *, backend='sounddevice', clock=<class 'stimuli.time._clock.Clock'>, **kwargs)[source]🔗

Pure tone stimulus at a given frequency.

Parameters:
frequencyfloat

Frequency of the tone in Hz.

volumefloat | list of float | tuple of float | array of float

Volume of the sound as a percentage between 0 and 100. If a float is provided, the same volume is used for all channels. If a sequence is provided, the length must match the number of channels.

durationfloat

Duration of the sound in seconds, used to generate the time array.

sample_rateint | None

Sample rate of the sound. If None, the default sample rate of the device provided by the backend is used.

deviceint | None

Device index to use for sound playback. If None, the default device provided by the backend is used.

n_channelsint

Number of channels of the sound.

backend"sounddevice"

The backend to use for sound playback.

clockstimuli.time.BaseClock

Clock object to use for timing measurements.

**kwargs

Additional keyword arguments passed to the backend initialization.

Attributes

duration

The duration of the audio stimulus.

frequency

The frequency of the tone in Hz.

sample_rate

The sample rate of the audio stimulus.

signal

The audio signal.

times

The time array of the audio stimulus.

volume

The volume of the audio stimulus per channel given as a percentage.

window

Window applied to the audio signal.

Methods

play([when, blocking])

Play the audio data.

plot()

Plot the audio signal waveform.

save(fname, *[, overwrite])

Save the audio stimulus to a WAV file.

stop()

Interrupt immediately the playback of the audio data.

play(when=None, *, blocking=False)[source]🔗

Play the audio data.

Parameters:
whenfloat | None

The relative time in seconds when to start playing the audio data. For instance, 0.2 will start playing in 200 ms. If None, the audio data is played as soon as possible. A duration superior to the device latency is recommended.

blockingbool

If True, the function blocks until the audio playback is finished.

plot()[source]🔗

Plot the audio signal waveform.

Returns:
fmatplotlib.figure.Figure

The matplotlib figure object.

axmatplotlib.axes.Axes

The matplotlib axes object.

save(fname, *, overwrite=False)[source]🔗

Save the audio stimulus to a WAV file.

The saving is handled by scipy.io.wavfile.write().

Parameters:
fnamestr | pathlib.Path

Path to the output file. The extension should be '.wav'.

overwritebool

If True, existing files are overwritten.

stop()[source]🔗

Interrupt immediately the playback of the audio data.

property duration🔗

The duration of the audio stimulus.

Type:

float

property frequency🔗

The frequency of the tone in Hz.

Type:

float

property sample_rate🔗

The sample rate of the audio stimulus.

Type:

int

property signal🔗

The audio signal.

Type:

ndarray of shape (n_samples, n_channels)

property times🔗

The time array of the audio stimulus.

Type:

ndarray of shape (n_samples,)

property volume🔗

The volume of the audio stimulus per channel given as a percentage.

Type:

ndarray of shape (n_channels,)

property window🔗

Window applied to the audio signal.

Type:

ndarray of shape (n_samples,) | None

Examples using stimuli.audio.Tone🔗

Base sounds

Base sounds

Apply a window

Apply a window