#!/usr/bin/env python
# coding: utf-8

# # Colour - Colour Science for Python

# In[1]:


from IPython.core.display import Image

Image(filename="resources/images/Colour_Logo_Medium_001.png")


# ## Introduction

# [Colour](https://github.com/colour-science/colour/) is a **Python** colour science package implementing a comprehensive number of colour theory transformations and algorithms.

# In[2]:


from colour.plotting import *


# In[3]:


colour_style();


# In[4]:


plot_visible_spectrum();


# ## Usage

# This notebook is a companion guide and usage showcase. Most of the public API is available from the root `colour` namespace:

# In[5]:


import colour

print(colour.__all__[:20] + ["..."])


# The notebook has been divided in different chapters dedicated to showcase the API:
# 
# * Colorimetry
#     * [Spectrum](colorimetry/spectrum.ipynb)
#     * [Spectral Bandpass Dependence Correction](colorimetry/correction.ipynb)
#     * [Colour Matching Functions](colorimetry/cmfs.ipynb)
#     * [Dominant Wavelength & Purity](colorimetry/dominant_wavelength.ipynb)
#     * [Photometry](colorimetry/photometry.ipynb)
#     * [Luminous Efficiency Functions](colorimetry/lefs.ipynb)
#     * [Blackbody](colorimetry/blackbody.ipynb)
#     * [Illuminants](colorimetry/illuminants.ipynb)
#     * [Light Sources](colorimetry/light_sources.ipynb)
#     * [Lightness](colorimetry/lightness.ipynb)
#     * [Luminance](colorimetry/luminance.ipynb)
#     * [Whiteness](colorimetry/luminance.ipynb)
# * Colour Temperature
#     * [Correlated Colour Temperature](temperature/cct.ipynb)
# * Chromatic Adaptation
#     * [Chromatic Adaptation - Johannes Von Kries Hypothesis](adaptation/vonkries.ipynb)
#     * [Fairchild (1990) Chromatic Adaptation Model](adaptation/fairchild1990.ipynb)
#     * [CIE 1994 Chromatic Adaptation Model](adaptation/cie1994.ipynb)
#     * [CMCCAT2000 Chromatic Adaptation Model](adaptation/cmccat2000.ipynb)
# * [Corresponding Chromaticities Prediction](corresponding/prediction.ipynb)
# * Colour Models
#     * [CIE xyY](models/cie_xyy.ipynb)
#     * [CIE Lab](models/cie_lab.ipynb)
#     * [CIE Luv](models/cie_luv.ipynb)
#     * [CIE UCS](models/cie_ucs.ipynb)
#     * [CIE UVW](models/cie_uvw.ipynb)
#     * [IPT Colourspace](models/ipt.ipynb)
#     * [$IC_TC_P$ Colourspace](models/ictcp.ipynb)
#     * [Hunter Lab](models/hunter_lab.ipynb)    
#     * [Hunter Rdab](models/hunter_rdab.ipynb)    
#     * [RGB](models/rgb.ipynb)    
#     * [YCbCr Colour Encoding](models/ycbcr.ipynb)    
#     * [MacAdam (1942) Ellipses (Observer PGN)](models/macadam_ellipses.ipynb)    
# * Colour Difference
#     * [$\Delta E_{ab}$](difference/delta_e.ipynb)
# * Colour Appearance Models
#     * [Nayatani (1995)](appearance/nayatani95.ipynb)
#     * [Hunt](appearance/hunt.ipynb)
#     * [RLAB](appearance/rlab.ipynb)
#     * [ATD (1995)](appearance/atd95.ipynb)
#     * [LLAB(l:c)](appearance/llab.ipynb)
#     * [CIECAM02](appearance/ciecam02.ipynb)
#     * [CAM16](appearance/cam16.ipynb)
# * Colour Notation Systems
#     * [Munsell Renotation System](notation/munsell.ipynb)
# * Characterisation
#     * [Colour Fitting](characterisation/fitting.ipynb)
#     * [Displays](characterisation/displays.ipynb)
# * Colourspace Volume Computation & Optimal Colour Stimuli
#     * [MacAdam Limits](volume/macadam_limits.ipynb)
#     * [Pointer's Gamut](volume/pointer_gamut.ipynb)
#     * [RGB Colourspace](volume/rgb.ipynb)    
#     * [Visible Spectrum](volume/spectrum.ipynb)    
# * Colour Quality
#     * [Colour Rendering Index](quality/cri.ipynb)
# * Contrast Sensitivity Function
#     * [Barten (1999)](contrast/barten1999.ipynb)
# * Optical Phenomena
#     * [Rayleigh Optical Depth](phenomena/rayleigh.ipynb)
# * [Automatic Conversion Graph](graph/conversion.ipynb)