Here are detailed instructions on how to get SnapPy working on a variety of platforms. The current version is 1.0.2 which was released October 21, 2009.
Simply download SnapPy.dmg and copy SnapPy.app to the Applications folder. Double-click to start it, just like any other application. Works with both 10.4 or 10.5 and either Intel or PPC processors.
Simply download and run InstallSnapPy.exe.
NOTE: The Windows version of SnapPy depends on the Microsoft Distributable Visual C++ Runtime. If you receive an error message saying “This application has failed to start because MSVCR90.DLL was not found” or “This application failed to start because the application configuration is incorrect” try downloading and installing vcredist_x86.exe from Microsoft.
Here are short recipes which work on many Linux systems, with both 32-bit and 64-bit kernels supported. These instructions assume you have system administrator (superuser) privileges; if not, you can install SnapPy into a virtual environment assuming the needed packages are installed. For other systems, try the one closet to yours below, and if that fails, follow the instructions for generic Unix in the next section.
Fedora: Tested on versions 8-10 (Werewolf-Sulfer-Cambridge):
sudo yum install tkinter python-setuptools-devel
sudo python -m easy_install -U -f http://www.math.uic.edu/~t3m/SnapPy snappy
Note: For this to work, you need to set the SELinux Enforcement mode to Permissive or lower.
Ubuntu: Tested on 8.04 (Hardy Heron), 8.10 (Intrepid Ibex) and 9.04 (Jaunty Jackalope):
sudo apt-get install python-tk python-setuptools
sudo python -m easy_install -U -f http://www.math.uic.edu/~t3m/SnapPy snappy
Debian: Try the instructions for Ubuntu.
Once you have it installed, do:
python -m snappy.app
You may get a message about creating a “.ipython” directory; this is normal, just hit return to continue. There should also now be a command “SnapPy” which does the same thing.
If you use a Unix other that OS X or Linux, or if the prebuilt packages don’t work for you, you’ll need to build SnapPy from source. Here are some detailed instructions.
Things you’ll need:
Python with Tkinter: You’ll need to have Python (at least version 2.5) and Tk (at least version 8.4) with Tkinter to connect them, including the header files. For instance, on Debian or Ubuntu, install the packages “python-tk” and “python-dev”. On Fedora, you’ll want “tkinter” and “python-devel”. In addition, you’ll need
Setuptools, which is typically packaged as “python-setuptools” (Ubuntu/Debian), “python-setuptools-devel” (Fedora), or can be installed via:
curl -O http://peak.telecommunity.com/dist/ez_setup.py
sudo python ez_setup.py
Test that Python is in order by installing PLink from source:
python -m easy_install http://www.math.uic.edu/~t3m/plink/plink.tar.gz
python -m plink.app # Should start the link editor!
Support for OpenGL (3D graphics): This is built in on OS X and the most installations of Fedora and Ubuntu. But you’ll need the MESA header files “gl.h” and “glu.h” to compile SnapPy. On Debian and Ubuntu, install “libglu1-mesa-dev”; On Fedora install “mesa-libGLU-devel”.
Cython, which you can install via:
sudo python -m easy_install cython
Sphinx, which you can install via:
sudo python -m easy_install sphinx
Now download the source code listed below, for instance:
curl -O http://www.math.uic.edu/~t3m/SnapPy/SnapPy.tar.gz
tar xfz SnapPy.tar.gz; cd SnapPy
There are two more dependencies that need to be dealt with:
PARI: Inside the SnapPy directory do:
bash build_pari.sh # Downloads and builds the PARI library
Togl: a 3d widget for Tk. For OS X and Linux, there are pre-built binaries of this in the snappy subdirectory, e.g. snappy/linux2-tk8.4. For Linux these are built for 32-bit kernels. If they don’t work for you, try untarring the files snappy/linux2-*-x86_64.tar.gz which are built for 64-bit kernels. If these don’t work either, you’ll need to edit or follow “build_togl.sh” to build Togl directly, and create the appropriate subdirectory of snappy.
Finally, compile and install the SnapPy module (which will install certain other dependencies) and test:
sudo python setup.py install
sudo python setup.py build_docs install
cd /tmp; python -m snappy.app
You may get a message about creating a “.ipython” directory; this is normal, just hit return to continue. There should also now be a command “SnapPy” which does the same thing as “python -m snappy.app”.
If you write Python programs on a Macintosh or Windows system, you may wish to install SnapPy as a Python module. After installing Python 2.6 and setuptools, you may install a SnapPy module from your Terminal application or Command Prompt with the command:
python -m easy_install -U -f http://www.math.uic.edu/~t3m/SnapPy snappy
All of the above instructions assume that you want to install SnapPy globally, in the main Python site-packages directory. You can also create a Python “virtual environment” and install SnapPy into it. For example, to install SnapPy into “~/bin” do:
# Move to where the virtual environment directories should go
cd ~
#Download needed files, could also use any webbrowser here.
wget -nd http://peak.telecommunity.com/dist/virtual-python.py
wget -nd http://peak.telecommunity.com/dist/ez_setup.py
# create virtual environment, install setuptools, and SnapPy
python virtual-python.py --prefix=.
bin/python ez_setup.py
bin/easy_install -U -f http://www.math.uic.edu/~t3m/SnapPy snappy
bin/SnapPy # Run SnapPy!
SnapPy has some special features when used within Sage, the universal mathematics software based on Python. Installation is easy:
curl -O http://www.math.uic.edu/~t3m/SnapPy/SnapPy.tar.gz
tar xfz SnapPy.tar.gz; cd SnapPy
sage -python setup.py install
sage -python setup.py build_docs install
The graphical features may or may not work, depending on how Tkinter was configured within Sage, but everything else should work fine.
The complete source code for all platforms: SnapPy.tar.gz
You can also get it straight from the Mercurial repository:
hg clone static-http://www.math.uic.edu/~t3m/hg/SnapPy