# Installation¶

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

## Requirements¶

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 2.7 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 the matplotlib package and for one example the Mayavi package.

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

If the installation has finished, you may try out Acoular by typing

>>> acoular_demo.py


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

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

If the installation has finished, you may try out Acoular by typing

>>> acoular_demo.py


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

## Option 4: Source install¶

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

>>> python setup.py 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.

If the installation has finished, you may try out Acoular by typing

>>> acoular_demo.py


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