Pre-built installation
----------------------

`Windows binaries
<http://www.lfd.uci.edu/~gohlke/pythonlibs/#scikits.image>`__
are kindly provided by Christoph Gohlke.

The latest stable release is also included as part of the `Enthought Python
Distribution (EPD) <http://enthought.com/products/epd.php>`__, `Python(x,y)
<http://code.google.com/p/pythonxy/wiki/Welcome>`__ and
`Anaconda <https://store.continuum.io/cshop/anaconda/>`__.

On Debian and Ubuntu, a Debian package ``python-skimage`` can be found in
`the Neurodebian repository <http://neuro.debian.net>`__. Follow `the
instructions <http://neuro.debian.net/#how-to-use-this-repository>`__ to
add Neurodebian to your system package manager, then look for
``python-skimage`` in the package manager.

On systems that support setuptools, the package can be installed from the
`Python packaging index <http://pypi.python.org/pypi/scikit-image>`__ using


::

  easy_install -U scikit-image

or

::

  pip install -U scikit-image

Installation from source
------------------------

Obtain the source from the git-repository at
`http://github.com/scikit-image/scikit-image
<http://github.com/scikit-image/scikit-image>`_ by running::

  git clone http://github.com/scikit-image/scikit-image.git

in a terminal (you will need to have git installed on your machine).

If you do not have git installed, you can also download a zipball from
`https://github.com/scikit-image/scikit-image/zipball/master
<https://github.com/scikit-image/scikit-image/zipball/master>`_.

The SciKit can be installed globally using::

  python setup.py install

or locally using::

  python setup.py install --prefix=${HOME}

If you prefer, you can use it without installing, by simply adding
this path to your ``PYTHONPATH`` variable and compiling extensions
in-place::

  python setup.py build_ext -i

In addition you can install using 
`bento`<http://cournape.github.io/Bento/>_. However the extension
requires you to not only install Bento, but also WAFLIB
which is part of `Waf`<https://code.google.com/p/waf/>_.

To install bento follow the 
`instructions on the webpage`<http://cournape.github.io/Bento/html/install.html>,
then make it aware of WAF by adding::

    export WAFLIB=<path/to/waf>

to the appropriate config file such as ``.bashrc`` or ``.zshrc``.
Then install scikit-image by going to the latter's directory
and typing::

    bentomaker configure
    bentomaker build  -j -i (if you want to build it inplace)
    bentomaker install

Depending on the permissions of your /usr/local/ dir you might need
to run the above command as sudo.
 
.. include:: ../../DEPENDS.txt