music.mix_many

music.mix_many(sonic_vectors, end=False, offset=0, sample_rate=44100)

Mix sonic vectors of arbitrary lengths.

The operation consists in summing sample by sample [1]. This function helps when the sonic_vectors are not of the same size.

Parameters:

sonic_vectorslist of sonic_arrays

The sonic vectors to be summed.

endbool

If True, sync the final samples. If False (default) sync the initial samples.

offsetlist of scalars

A list of the offsets for each sonic vectors in seconds.

sample_rateinteger

The sample rate. Only used if offset is supplied.

Returns:

Sndarray

A numpy array where each value is a PCM sample of the resulting sound.

Notes

Cite the following article whenever you use this function.

References

[1]

Fabbri, Renato, et al. “Musical elements in the discrete-time representation of sound.” arXiv preprint arXiv:abs/1412.6853 (2017)

Examples

>>> mixed = mix_many([note(220, 2), note(440, 1)])
>>> write_wav_mono(mixed)  # writes a WAV of the two notes summed