We are assuming that you have default Python environment already configured on
your computer and you intend to install scikit-image
inside of it. If you
want to create and work with Python virtual environments, please follow the
instructions on venv and virtual environments.
There are two ways you can install scikit-image
on your preferred Python
environment.
- Standard Installation
- Development Installation
scikit-image
comes pre-installed with several Python distributions,
including Anaconda,
Enthought Canopy,
Python(x,y) and
WinPython.
On all other systems, install it via shell/command prompt:
pip install scikit-image
If you are running Anaconda or miniconda, use:
conda install -c conda-forge scikit-image
You can install the scikit-image
development version if either your
distribution ships an outdated version or you want to develop and work on new
features before the package is released officially.
First, uninstall any existing installations:
pip uninstall scikit-image
or, on conda-based systems:
conda uninstall scikit-image
Now, clone scikit-image on your local computer, and install:
git clone https://github.com/scikit-image/scikit-image.git cd scikit-image pip install -e .
To update the installation:
git pull # Grab latest source pip install -e . # Reinstall
Platform-specific notes follow below.
If you experience the error Error:unable to find vcvarsall.bat
it means
that your computer does not have recommended compilers for Python. You can
either download and install Windows compilers from here or use
MinGW compilers . If using MinGW, make sure to correctly configure
distutils
by modifying (or create, if not existing) the configuration file
distutils.cfg
(located for example at
C:\Python26\Lib\distutils\distutils.cfg
) to contain:
[build] compiler=mingw32
A run-through of the compilation process for Windows is included in our setup of Azure Pipelines (a continuous integration service).
Install all the required dependencies:
sudo apt-get install python3-matplotlib python3-numpy python3-pil python3-scipy python3-tk
Install suitable compilers:
sudo apt-get install build-essential cython3
Complete the general development installation instructions above.
You can use scikit-image
with the basic requirements listed above, but some
functionality is only available with the following installed:
- PyAMG
- The
pyamg
module is used for the fast cg_mg mode of random walker segmentation.
- Astropy
- Provides FITS I/O capability.