Pythran: a Python to C++ compiler with a focus on scientific computing

User Manual Command Line Interface Developer Guide Developer Tutorial Internals LICENSE Authors TODO Changelog

Pythran is a python to c++ compiler for a subset of the Python language, with a focus on scientific computing. It takes a Python module annotated with a few interface description and turns it into a native python module with the same interface, but (hopefully) faster.

It is meant to efficiently compile scientific programs , and takes advantage of multi-cores and SIMD instruction units.

Pythran development is currently done using Python version 2.7 .

Pythran sources are hosted on https://github.com/serge-sans-paille/pythran .

Pythran releases are hosted on http://pypi.python.org/pypi/pythran .

Pythran is available through Conda on https://conda.anaconda.org/serge-sans-paille .

Using pip

Gather dependencies:

Pythran depends on a few Python modules and several C++ libraries. On a debian-like platform, run:

$> sudo apt-get install libgmp-dev libblas-dev $> sudo apt-get install python-dev python-ply python-networkx python-numpy

Use easy_install or pip :

$> pip install pythran

Using a private debian repo

Add serge_sans_paille’s debian server to your source.list , following the instruction given in http://serge.liyun.free.fr/serge/debian.html

Run the classic:

$> sudo apt-get update $> sudo apt-get install pythran

Using conda

Install conda , following the instruction given in http://conda.pydata.org/docs/install/quick.html

Run:

$> conda install -c serge-sans-paille pythran

Using brew ( http://brew.sh/ ):

$> brew install gmp $> brew install cmake $> easy_install pip $> pip install numpy pythran

Depending on your setup, you may need to add the following to your \~/.pythranrc`` file:

[compiler] CXX=g++-4.9 CC=gcc-4.9

Using yaourt :

$> yaourt -S python2-pythran-git

Using WinPython ( http://winpython.github.io ), start the WinPython prompt and run:

% pip install pythran

See User Manual file.

A simple pythran input could be dprod.py :

""" Naive dotproduct! Pythran supports numpy.dot """ #pythran export dprod(int list, int list) def dprod(l0,l1): """WoW, generator expression, zip and sum.""" return sum(x * y for x, y in zip(l0, l1))

To turn it into a native module, run:

$> pythran dprod.py

That will generate a native dprod.so that can be imported just like the former module:

$> python -c 'import dprod' # this imports the native module instead

The user documentation is available in the User Manual file from the doc directory.

The developer documentation is available in the Developer Guide file from the doc directory. The also is a Developer Tutorial file for those who don’t like reading documentation.

A todo list is maintained in the eponymous TODO file.

The Command Line Interface documentation is available from the pythran help command:

$> pythran --help

Some extra developer documentation is also available using pydoc. Beware, this is the computer science incarnation for the famous Where’s Waldo? game:

$> pydoc pythran $> pydoc pythran.typing

See the pythran/tests/cases/ directory from the sources.