Installation

Dependencies

PyLocator relies on a bunch of libraries:

On a Debian-like environement, these dependencies can usually be resolved via a simple:

sudo apt-get install python-vtk python-nibabel python-numpy python-gtk2 python-gtkglext1

This should prepare your system for PyLocator. On Windows and OS X, things are a little bit more complicated, but Python distributions like EPD or Python(x,y) should be helpful here. The main problem will be to get gtkgtlext working. If you have any hints, e.g., binary packages, please let me know.

Depending on your configuration, nibabel has to be downloaded separately.

Can you help with detailed instructions for these operating systems? Please tell me!

How to download

The source code of PyLocator is kept in a public GIT repository:

http://www.github.com/nipy/PyLocator

You can simply clone this repository via:

git clone git://github.com/nipy/PyLocator.git

There is a binary package for Debian-like systems (Debian, Ubuntu, ...) available. It will make sure that all requirements are installed and add an entry to your applications menu.

_images/download_deb.png

It is tested with Ubuntu Oneiric and Natty. If you successfully installed it on other flavours and versions, please let me know.

Alternatively, you can download a tarball that is updated once in a while from

http://pylocator.thorstenkranz.de/download/pylocator_1.0b3.tar.gz

Extract this archive using your preferred archive manager or in a terminal using something like:

tar xfvz pylocator_1.0b3.tar.gz

How to install

From Debian-package

Installation of Debian packages should be straight-forward. Usually you just have to double click the downloaded file and confirm the installation. If you prefer to work in a terminal, you can:

sudo dpkg -i pylocator_1.0b3_all.deb

That’s it!

From PyPI

PyLocator is registered at PyPI, the Python Package Index. This makes installation easy also for non-debian systems. If you have setuptools installed, simply type:

sudo easy_install PyLocator

and the setuptools will do the magic for you.

From source

Once you obtained the source code, enter the PyLocator-directory and type:

python setup.py build
python setup.py install --user # For per-user installation
# or
sudo python setup.py install # system-wide installation

After these steps, the package pylocator should be properly installed. You can then run the program by running:

python ~/.local/lib/python2.?/site-packages/pylocator/pylocator.py

in case of a per-user installation or:

python /usr/local/lib/python2.?/site-packages/pylocator/pylocator.py

or similar in case of a system-wide installation. Replace the 2.? by your python version number.

This solution isn’t perfect yet, I’ll clean it up soon. Of course you can create some little bash-script that calls this for you and put it into ~/bin/pylocator or similar:

#! /bin/bash
python ~/.local/lib/python2.?/site-packages/pylocator/pylocator.py $@

Table Of Contents

Previous topic

PyLocator

Next topic

Tutorial

This Page