Acoular 22.3 documentation


«  Acoular – Acoustic testing and source mapping software   ::   Main Page   ::   Getting Started  »


Depending on your operating system and python distribution, there are different options (see below) how to install Acoular.


Acoular runs under 64bit Windows and Linux (it should also run under OS X, but this is untested). In order to install Acoular you need a Python 3 environment running on your machine. Furthermore, Acoular requires the following Python Packages:

If you do not chose option 1 below for installation, you may have to take care that these are all installed on your machine before you can install Acoular.

In order to run the demo and examples you will also need:

and for the example_3D_beamforming:

Option 2: Windows with other Python distributions

Download and run the windows installer. You will have to take care by yourself that all required packages are installed, otherwise you will not be able to use Acoular.

Option 3: pip

If you have pip installed on your system, you may type

$ pip install acoular

to install acoular. Note that the required packages are not installed this way and you have to do it by yourself.

Option 4: Source install

You may download the source tarball. Unzip it and change into the “acoular” directory, then type

$ python install

to compile and install the software. This requires a properly set up system with all installed dependencies and a compiler. Another option to get the source is to clone or fork from Github.

Verify Acoular installation

If the installation has finished, you may try out Acoular by importing the module and running the acoular demo script in a Python console.

> import acoular

After some seconds, this should produce two pictures (a 64 microphone arrangement and a beamforming map with three sources).

«  Acoular – Acoustic testing and source mapping software   ::   Main Page   ::   Getting Started  »