Gato: Installation

Requirements

Unix (Linux, MacOS X, BSD, ...)

Most distributions come with Python installed. You can check that you are all set up by invoking the Python interpreter in a terminal

  > python
  Python 2.6.4 (r264:75706, Mar 16 2010, 09:46:46) 
  [GCC 4.0.1 (Apple Inc. build 5490)] on darwin
  Type "help", "copyright", "credits" or "license" for more information.
  >>> import Tkinter
  >>> t = Tkinter.Tk()
  >>> 
Ctrl-D exists the Python shell. If there are problems, or you only have an outdated Python version available install Python and Tkinter packages with the package manager for your distribution.

If your Python is set-up, download Gato, unpack it and execute either Gato.py or Gred.py by evoking

  you@yourbox> python Gato.py
You can also manually create symlinks as follows. Make Gato and Gred executable for everybopd by changing the protections. Make sure that the directory where they reside has the right execute and read permissions and that the read permissions for all files in the directory are correct (A umask 022 before unpacking helps)
  > chmod 755 Gato.py Gred.py
Create symbolic links to the executables in a directory contained in your path with
  > cd dir_on_path
  > ln -s /whereever_you_put_gato/Gato.py gato 
  > ln -s /whereever_you_put_gato/Gred.py gred
so all users on the system can use gato and gred without worrying about paths or gato's files cluttered in all kinds of directories.

If you want to install Gato permanently, you can do so by using Python's setuptools and the provided setup.py in the Gato directory,

> python setup.py install
to install Gato in the default site-packages directory for your python installation. If you need to install it elsewhere you can control the install location by specifying an alternative prefix path and/or an alternative Python interpreter.
> /some/otherpath/python setup.py install --prefix=/yetanotherpath/

Linux packages

For Gentoo there is a Gato package available at http://packages.gentoo.org/search/?sstring=Graph%20Animation%20Toolbox.

BSD

There is a port of Gato available under the name py-gato, see http://portsmon.freebsd.org/portoverview.py?category=math&portname=py-gato

MacOS X

Starting with MaxOS X 10.6 the situation with Tk and Python has been somewhat difficult, see http://www.python.org/download/mac/tcltk/. The binaries for MacOS X have been tested on 10.5.x and 10.6.x and you can just use them if you run into difficulties installing from source. Please make sure that you have all the system updates.

MacOS X Version 10.4 and above come with Python 2.5 or 2.6 and Tkinter installed. You can run Gato either using with or without X11, based on the Tk library (Tk for X11, or AquaTk) used. If you want to use Gato without X11 you need to start it with pythonw, otherwise you will just get an error message. From within X11 you need to use python. Updates to the Python which comes pre-installed on MacOS X are available from http://www.python.org/download.

We also make a download available of Gato.app which runs directly on MacOS X 10.4 and above. Check the Download page. You find also more recent binary releases at http://schliep.org/CATBox/ as part of the CATBox distribution.

If you want to use X11 on MacOS X you can check whether you are all set up using example under the Linux instructions.

Windows

On http://www.python.org/download/ you can find a one (well, multiple) click installer which installs everything you need. After you have downloaded Gato and unpacked everything double-clicking Gato.py should start the software. You find a binary release at http://schliep.org/CATBox/ as part of the CATBox distribution.