Installing scikit-image¶

Standard Python installation¶

From the shell, execute:

pip install scikit-image

Conda-based distributions (Anaconda, Miniconda)¶

From the shell/command prompt, execute:

conda install scikit-image

Windows¶

scikit-image comes pre-installed with several Python distributions, including Anaconda, Enthought Canopy, Python(x,y) and WinPython.

If you are using the distribution from python.org, you’ll need to manually download a few packages: numpy, scipy and scikit-image from Christoph Gohlke’s website. Python wheels are installed using:

pip install SomePackage-1.0-py2.py3-none-any.whl

Debian and Ubuntu¶

On Debian and Ubuntu install scikit-image with:

sudo apt-get install python-skimage

Building from source¶

Execute the following command from the shell:

pip install scikit-image

[build]
compiler=mingw32

sudo apt-get install python-matplotlib python-numpy python-pil python-scipy

sudo apt-get install build-essential cython

Running the development version¶

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

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

After unpacking, change into the source directory and execute:

pip install -e .

To update:

git pull  # Grab latest source
python setup.py build_ext -i  # Compile any modified extensions

export WAFDIR=<path/to/waf>

bentomaker configure
bentomaker build -j     # (add -i for in-place build)
bentomaker install      # (when not building in-place)

Build Requirements¶

• Python >= 2.6
• Numpy >= 1.7.2
• Cython >= 0.23
• Six >=1.4
• SciPy >=0.9

Runtime requirements¶

• Python >= 2.6

• Numpy >= 1.7.2

• SciPy >= 0.9

• Matplotlib >= 1.1.0

• NetworkX >= 1.8

• Six >=1.4

• Pillow >= 1.7.8

  (or PIL)

• dask[array] >= 0.5.0

You can use pip to automatically install the runtime dependencies as follows:

$ pip install -r requirements.txt

Optional Requirements¶

You can use this scikit with the basic requirements listed above, but some functionality is only available with the following installed:

• PyQt4

  The qt plugin that provides imshow(x, fancy=True) and skivi.

• FreeImage

  The freeimage plugin provides support for reading various types of image file formats, including multi-page TIFFs.

• PyAMG

  The pyamg module is used for the fast cg_mg mode of random walker segmentation.

• Astropy provides FITS io capability.

• SimpleITK Optional io plugin providing a wide variety of formats. including specialized formats using in medical imaging.

• imread Optional io plugin providing most standard formats.

Testing requirements¶

• Nose

  A Python Unit Testing Framework

• Coverage.py

  A tool that generates a unit test code coverage report

Documentation requirements¶

sphinx >= 1.3 is required to build the documentation.