This section provides installation instructions for installing the concatenator project on your system. There are alternative methods that will most likely work for installing both the project and many of it’s dependencies, however the method shown below has been tested and is therefore the most reliable method for installing this project.
Tested working on:
There are a few dependencies required to install concatenator:
This package can be downloaded with git using the following command:
git clone https://github.com/Pezz89/pysound
This will clone the project folder into the current directory.
There are a number of ways to install python. The simplest is through homebrew (OSX) / Linuxbrew (most Linux distributions) using the following command:
brew install python
Homebrew can be installed by following installation instructions from here:
Linuxbrew can be installed by following installation instructions from here:
An alternative that allows greater flexibility is to use pyenv which allows for easy switching between python versions and guarantees the exact version needed:
brew install pyenv
pyenv install 2.7.11
pyenv global 2.7.11
Note that the following may need to be added to your ~/.bashrc file to add pyenv pythons to your path.
if which pyenv > /dev/null; then eval "$(pyenv init -)"; fi
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"
libsndfile, sox and the HDF5 libraries can also be installed via homebrew/linuxbrew:
brew install libsndfile
brew tap homebrew/science
brew install hdf5
brew install sox
The python package and it’s dependencies can then be easily installed by running the ./install.sh script from the root director of the project. Note that this will install the project in it’s project folder. To check that the project is working correctly, simply run run_tests.
./install.sh
./run_tests
There is a small chance that the installation may fail when installing dependencies such as scipy or numpy. In these cases the packages must be installed manually. When this has been done, simply re-run the install.sh script.
The Jupyter notebook application is required in order to run the interactive examples. It is recommended that this is installed as part of the iPython library using:
pip install "ipython[all]"
Notebooks can then be viewed from the Examples folder of the project by running:
jupyter notebook
This will open a notebook session in the browser.