stimuli.audio.Noise

class stimuli.audio.Noise(color, volume, duration, sample_rate=None, device=None, n_channels=1, *, backend='sounddevice', clock=<class 'stimuli.time._clock.Clock'>, **kwargs)

Colored noise stimulus.

Parameters:

color'white' | 'pink' | 'blue' | 'violet' | 'brown'

The name of the noise color.

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

color	The color of the noise.
duration	The duration of the audio stimulus.
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)

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()

Plot the audio signal waveform.

Returns:

fmatplotlib.figure.Figure

The matplotlib figure object.

axmatplotlib.axes.Axes

The matplotlib axes object.

save(fname, *, overwrite=False)

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()

Interrupt immediately the playback of the audio data.

property color

The color of the noise.

Type:

str

property duration

The duration of the audio stimulus.

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.Noise

Colored noise

Colored noise