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

The theory section introduces the underlying physical principles of sound field synthesis and derives all of the so called driving functions that determine the actual loudspeaker signals. Most of them are implemented in the Toolboxes and comments in the code link back to the corresponding equations. A lot 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 based on Chap. 2 from [Wie14]. It is extended and corrected by the contributions from [Sch16]. The complete section 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/v3/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 et al. *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.