audiblelight.synthesize.render_audio_for_all_scene_events

audiblelight.synthesize.render_audio_for_all_scene_events#

audiblelight.synthesize.render_audio_for_all_scene_events(scene, ignore_cache=False)#

Renders audio for all Events associated with a given Scene object.

Audio is rendered following the following stages:
  • Generate IRs for associated microphones and emitters inside Scene.WorldState using ray-tracing engine

  • Load audio for all Scene.Event objects and transform according to given SNR, effects, etc.

  • Convolve Scene.Event audio with IRs from associated Emitter objects

Note that this function has no direct return. Instead, the audio for every Event object is populated inside the Event.spatial_audio attribute, which can be written using (for example) pysoundfile or librosa.

Parameters:
  • scene (Scene) – Scene object with associated WorldState, Emitter, MicArray, Event objects added.

  • ignore_cache (optional) – If True, cached Event audio will be ignored

Returns:

None

Return type:

None