Proper installation

[Nisheet Patel]

Due to known issues with OpenGL, namely that glut files are not part of either PyOpenGL or PyOpenGL_accelerate packages, pip install -r requirements.txt fails to set up the repository in a working condition. The easiest workaround (for Ubuntu) I have found is to run the command sudo apt-get install freeglut3-dev alongside the installation.

Thus, the full sequence I would follow with setting up a virtual environment would be something like:

git clone https://github.com/wiskott-lab/Ratlabv3.git
cd Ratlabv3
pip install virtualenv        # if not already installed
virtualenv venv               # create virtual environment
source ./venv/bin/activate    # activate it
pip install -r requirements.txt
sudo apt-get install freeglut3-dev

After this, the code runs smoothly as per this article.