Wiki » History » Version 2

« Previous - Version 2/8 (diff) - Next » - Current version
Emmanouil Theofanis Chourdakis, 2017-10-04 07:32 PM - An acoustic pattern generation tool

Copyright (c) Emmanouil Theofanis Chourdakis <> is a collection of tools to synthesize an audio scene from independent sound events.
It is inspired by Lagrange et al. simScene ( but takes
a different direction. The goal of is to (1) have a python implementation of such a
system since python is the platform of choice for developers accustomed with deep learning packages
or other python package candy and (2) to allow generating audio scenes from graph-based patterns.

Currently it can only batch-generate acoustic scenes with target EBRs

Please direct any comments, suggestions, etc. to Emmanouil Chourdakis <>

This code is licensed under GPLv3. Please see LICENSE for more info.


The best way to show usage of the tool is through an example of generating 10 scenes of bird sounds in the forest. First, clone this repository in a directory (requires mercurial):

hg clone

Then install the necessary libraries

pip install -r requirements.txt

Then open the files forest_backgrounds.xls and forest_events.xls in the examples folder which contain information about the event and background tracks (for now do not change them, just see that you can open them). Note that you can view the same files as .txt files in the same directory. allows both formats.

Here is a preview of the forest_backgrounds.xls in Calc:

An explanation of the fields follows:
  • label - The name of the track
  • sampleid - Prefix of the filename the track uses. If there are many files with sampleid as their prefix, one as random is picked and used for generation.
  • snr - For the first row, it is just the amplitude of that track. For the second row and below, it is the SNR (not dB) of the track of that row, relative to the sum of the other tracks.

Screenshot from 2017-10-03 19-07-11.png 141 KB, downloaded 28 times Emmanouil Theofanis Chourdakis, 2017-10-03 07:10 PM

forest_backgrounds.png 37.5 KB, downloaded 95 times Emmanouil Theofanis Chourdakis, 2017-10-04 07:27 PM

forest_events.png 57.8 KB, downloaded 97 times Emmanouil Theofanis Chourdakis, 2017-10-04 07:27 PM

scene.png 149 KB, downloaded 99 times Emmanouil Theofanis Chourdakis, 2017-10-04 07:54 PM

scene.wav 3.36 MB, downloaded 16 times Emmanouil Theofanis Chourdakis, 2017-10-04 08:05 PM

patterns.png 71.5 KB, downloaded 83 times Emmanouil Theofanis Chourdakis, 2017-10-05 03:10 PM