.. _install:

Installation
============


.. _install_dep:

Dependencies
------------

LinPy requires Python version 3.4 or above to work.

LinPy's one mandatory dependency is `isl <http://isl.gforge.inria.fr/>`_ version 0.12 or 0.13 (it may work with other versions of isl, but this has not been tested).
isl can be downloaded `here <http://freshmeat.net/projects/isl/>`_ or preferably, using your favorite package manager.
For Debian or Ubuntu, the command to run is::

    sudo apt-get install libisl-dev

For Arch Linux, run::

    sudo pacman -S isl

Apart from isl, there are two optional dependencies that will maximize the use of LinPy's functions: `SymPy <http://sympy.org/en/index.html>`_ and `matplotlib <http://matplotlib.org/>`_.
Please consult the `SymPy download page <http://sympy.org/en/download.html>`_ and `matplotlib installation instructions <http://matplotlib.org/faq/installing_faq.html#how-to-install>`_ to install these libraries.


.. _install_pip:

Install Using pip
-----------------

This is the recommanded way to install LinPy, with the command::

    sudo pip install linpy


.. _install_source:

Install From Source
-------------------

Alternatively, LinPy can be installed from source.
First, clone the public git repository::

    git clone https://scm.cri.mines-paristech.fr/git/linpy.git

and build and install as usual with::

    sudo python3 setup.py install