skip to navigation
skip to content

flipper 0.10.3

For manipulating curves and measured laminations on surfaces and producing mapping tori.

Flipper is a program for computing the action of mapping classes on laminations on punctured surfaces using ideal triangulation coordinates. It can decide the Nielsen-Thurston type of a given mapping class and, for pseudo-Anosov mapping classes, construct a layered, veering triangulation of their mapping torus, as described by Agol.

Flipper can be run as a Python 2, Python 3 or Sage Python module. Currently, it is fastest when run through Sage. For even more speed (~25% more) consider running flipper with the -O optimise bytecode option.


Flipper is available on the Python Package Index. The preferred method for installing the latest stable release is to use pip (included in Python 2.7.9 and Python 3.4 by default):

> python -m pip install flipper --user --upgrade


In order to use the flipper GUI on OS X, users must first update their copy of Tk/Tcl as described here. Flipper has been tested with ActiveTcl 8.5.18. Additionally, if running under flipper Sage, users must then reinstall sage python by using the command:

> sage -f python


As of Sage 6.9, Sage no longer appears to load packages from the user directory. Therefore users may need to either install flipper directly into Sage (which may require superuser privileges) or add the path to flipper to their SAGE_PATH environment variable.


Once installed, start the flipper GUI by using:

> python -m

Run the flipper test suite by using:

> python -m flipper.test

Open the flipper documentation by using:

> python -m flipper.doc


If you find flipper useful in your research, please consider citing it. A suggested reference is:

Mark Bell. flipper (Computer Software)., 2013--2016. Version <<version number>>

the BibTeX entry:

        author = {Bell, Mark},
        title = {flipper (Computer Software)},
        howpublished = {\url{}},
        year = {2013--2016},
        note = {Version <<version number>>}

or the BibItem:

\bibitem{flipper} Mark Bell: \emph{flipper (Computer Software)},
        \url{}, (2013--2016),
        Version <<version number>>.


The latest development version of flipper is available from BitBucket. Alternatively, you can clone the mercurial repository directly using the command:

> hg clone

And then install using the command:

> python install --user
File Type Py Version Uploaded on Size
flipper-0.10.3.tar.gz (md5) Source 2016-05-18 318KB