Installation

Linux

On debian and derivative (e.g. Ubuntu 10.09) :

double click on the .deb

Other system (Mandriva, RedHat, ...) :

Install the dependancies :

python-numpy, python-scipy, python-matplotlib, python-gtk2, python-imaging, python-gtkglext1 and setuptools.

Get the OpenFovea archive. Its name should look like this :

OpenFovea-x.x.tar.gz

Extract the files and execute OpenFovea :

$ tar -xvf OpenFovea-x.x.tar.gz
$ cd OpenFovea-x.x
$ ./openfovea-gtk

Mac OSX

Section author: Michka Popoff

As Mac OS X comes with a slightly out-dated version of Python and lacks some important python libraries, you will need to install everything manually. Don’t worry, this is quite easy.

First, download and install the last version of Macports (http://www.macports.org/). After installation, try to update the MacPorts database with the following command :

sudo port selfupdate

Note

If you are beyond a proxy, the easiest way to update the MacPorts database is to edit the following file :

/opt/local/etc/macports/sources.conf

Comment out the last line and add :

http://www.macports.org/files/ports.tar.gz [default]

The end of the file should now look like this :

#rsync://rsync.macports.org/release/ports/ [default]
http://www.macports.org/files/ports.tar.gz [default]

Now you should be able to use the selfupdate command.

Type the following commands to install python 2.7 and the needed libraries :

sudo port install python27
sudo port install python27 python_select
sudo python_select python27
sudo port install py27-scipy
sudo port install py27-matplotlib +gtk2
sudo port install py27-opengl

Reboot your computer to be sure all the installs are completed.

Note

If you get the following error when you launch OpenFovea :

Xlib: extension  "RANDR" missing on display  "/tmp/launch-XXXXXX/:0

don’t worry, this is only a warning, as explained in the macports FAQ :

Many X11 programs try to use the RANDR extension , and print this warning when it is not available. The RANDR extension is available in development builds of the X11 server and will eventually make its way into a production release. If you want to test out RANDR support, install the xorg-server-devel port. This warning is harmless and safe to ignore.

If problem with the locale :

For Mac OS-X 10.6 (Snow Leopard) the setting can be found here:

  1. Open the System Preferences App
  2. Click on “Language and Text” icon
  3. The Language can be changed under the “Language” pane/tab
  4. the User Locale setting can be changed under the “Formats” pans/tab

Windows

Simplified install

To install OpenFovea, get the OpenFovea installation script.

Unzip it and go to the newly created folder.

  1. install the two packages in the Python directory : python-2.7.2.msi and pywin32-2.16.win32-py2.7.exe.

    Warning

    It is important to use the default installation directory (‘c:\Python27’), otherwise the installation procedure won’t work.

  2. double click on openfovea_install and follow the instructions.

    Warning

    when installing PyGTK AIO, the installer tool ask to select component to install. Please select everything.

  3. An icon will appeare on the desktop. Double-click to launch openfovea.

Common version

Warning

Install versions related to python 2.7 and 32bits. All dependencies are available for this version.

  • Install Python

    First install the Python environment. Choose the 2.6 release, some dependencies are compiled only for 2.6 in the windows platform. link : http://www.python.org/download/releases/

    To execute python software, it’s required to set a system variable for windows :

    On the “My Computer” icon, right-click and select “Properties”. In the “System Properties” dialogue that newly appears, choose “Advanced” tab. On this tab, select “Environment Variables” on the lower part. Click on it. On the “System Variables” panel (the lower one), choose “Path” variable. Select and edit it. At the end, add :

    ";C:\Python27"
    

    Do not forget the ; to separate from the previous entry.

    This completes python installation. We now have to install the other dependencies :

  • Install numpy

    Download the numpy installer. Choose the python version 2.6. The file name should look like this :

    numpy-x.x.x-win32-superpack-python2.7.exe
  • Install scipy

    Download the scipy installer. Choose the python version 2.6. The file name should look like this :

    scipy-x.x.x-win32-superpack-python2.7.exe
  • Install matplotlib

    Download the matplotlib installer. Choose the python version 2.6. The file name should look like this :

    matplotlib-x.x.x.win32-py2.7.exe
  • Install setuptools

    Download the setuptools installer. Choose the python version 2.6. The file name should look like this :

    setuptools-x.x.win32-py2.7.exe
  • Install opengl and graphical interface

    Download the gtkgl install pack. The file name should look like this :

    pygtk_aio-2011_win32_installer-rev2.exe

    On the dialogue, select only PyGTKGLExt to install.

Installing the archive extractor

If you cannot extract the tar.gz archives that contain OpenFovea, download and install 7zip .

Installing OpenFovea

Get the OpenFovea archive. Its name should look like this :

OpenFovea-x.x.tar.gz

Extract the files (with 7zip, for example). In a terminal windows, move to the the folder you extracted the archive and execute the following instruction :

python openfovea-gtk

Finally, you can install OpenFovea :

python setup.py install

And from now, to execute it :

python C:\python26\Scripts\openfovea-gtk

Table Of Contents

Previous topic

Welcome to OpenFovea User’s documentation !

Next topic

Graphical interface

This Page