Make Expression.subs() always return a LinExpr instance
[linpy.git] / doc / install.rst
index 545e773..3064bc6 100644 (file)
@@ -1,23 +1,51 @@
-.. _installation:
+
+.. _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::
 
-Pypol requires at least Python3.4. Users will first need to install Integer Set Library (isl). The source files of isl are available as a tarball or a git repository. Both are available `here`_ .  
+    sudo pip install linpy
 
 
-Source
-======
+.. _install_source:
 
-add link to pypi pypol documentation.
+Install From Source
+-------------------
 
-Git
-===
+Alternatively, LinPy can be installed from source.
+First, clone the public git repository::
 
-add link to git repo
+    git clone https://scm.cri.mines-paristech.fr/git/linpy.git
 
+and build and install as usual with::
 
-.. _here: http://freshmeat.net/projects/isl/
+    sudo python3 setup.py install