Installation Guide

Dependencies

Colour requires various dependencies in order to run. Depending your intended use, i.e. using or developing, you may not need to install all of them. Please refer to the Installation Methods for Using Colour and Installation Methods for Developing Colour sections below.

Primary Dependencies

Optional Dependencies

Plotting Dependencies

Installation Methods for Using Colour

Pypi

Colour can be easily installed from the Python Package Index by issuing this command in a shell:

$ pip install colour-science

This asciicast demonstrates how to generate a pristine Python VirtualEnv environment for Colour:

The optional features dependencies are installed as follows:

$ pip install 'colour-science[optional]'

The development dependencies are installed as follows:

$ pip install 'colour-science[development]'

The figures plotting dependencies are installed as follows:

Note

Graphviz might need to be installed beforehand, please refer to the specific section for your platform on the Graphviz download page.
$ pip install 'colour-science[plotting]'

If you wish to read OpenEXR files, you will need to install the FreeImage plugin for Imageio as follows:

$ python -c "import imageio;imageio.plugins.freeimage.download()"

Continuum Analytics Anaconda

Colour is also available for Anaconda from Continuum Analytics via conda-forge:

$ conda install -c conda-forge colour-science

This asciicast demonstrates how to generate a pristine Python conda environment for Colour:

Github

Alternatively, you can also install directly from Github source repository:

$ git clone git://github.com/colour-science/colour.git
$ cd colour
$ pip install .

Installation Methods for Developing Colour

Poetry

Colour adopts Poetry to help managing its dependencies, this is the recommended way to get started with Colour development:

$ git clone git://github.com/colour-science/colour.git
$ cd colour
$ poetry install --extras "graphviz optional plotting"
Note

At the time of this writing, the preview version of Poetry, i.e. 1.0.0b3, is recommended to be used. Poetry can be updated to the latest preview version by issuing poetry self:update --preview.

Those commands will create a Virtual Environment in which all the required dependencies will be installed. Tools can then be run as follows:

$ poetry run invoke -l

or alternatively:

$ source $(poetry env info -p)/bin/activate
$ invoke -l

Vagrant

An easy way to get all the pre-requisites at once is to use our colour-vagrant environment for Vagrant.

Please refer to the dedicated blog post for more details about its deployment: PyCharm, Vagrant, Ansible & Poetry