Welcome to the Sound Field Synthesis Toolbox¶
Sound field synthesis (SFS) includes methods that try to generate a defined sound field in an extended area that is surrounded by loudspeakers. This project focuses on those methods that provide analytical solutions to the underlying mathematical problem, namely WFS, NFC-HOA, and the SDM.
The SFS Toolbox project is structured in the following three sub-projects.
- Overview and Theory:
- http://sfstoolbox.org (current page)
- SFS Toolbox for Matlab/Octave:
- http://matlab.sfstoolbox.org
- SFS Toolbox for Python:
- http://python.sfstoolbox.org
The Toolboxes provide you with the implementation of the underlying mathematics. You can make numerical simulations of the resulting sound fields and can even create binaural simulations of the same sound fields. This enables you to listen to large loudspeaker arrays, even if you don’t have one in your laboratory or at home. In addition, you can easily plug-in your own algorithms in order to test or compare them.
Most of the figures in the theory section are directly created by the SFS Toolbox for Python. All of them display the corresponding code for creating them directly before the actual figure. In order to recreate them, you have to execute the following code first:
import numpy as np
import matplotlib.pyplot as plt
import sfs
plt.rcParams['figure.figsize'] = 8, 4.5 # inch
The image at the top of the page is extracted from [ZS13].
Theory¶
The theory is an extended and corrected version of Chap. 2 from [Wie14]. It is also available as a pdf document.
You can link to any equation within it by the permalink that becomes visible by hovering over the corresponding equation number, e.g. http://sfstoolbox.org/en/3.0/wfs/#equation-D_wfs. Those links will always work. If you prefer to reference an equation from the pdf document instead, please cite the document with “H. Wierstorf, F. Winter, F. Schultz, N. Hahn, T. Rettberg, C. Hohnerlein, and S. Spors. Theory of Sound Field Synthesis. doi:10.5281/zenodo.1112451 (v2).” Whereby it is important that you mention “(v2)” as the provided DOI is a general one. All future document updates will also be available under that one. If you prefer to use the DOI corresponding to the used document version, you can look it up on zenodo.
Warning
Don’t use the permalinks yet. This version is still in beta, and they will most probably change during the next days.