colour.plotting.models Module

Colour Models Plotting

Defines the colour models plotting objects:

colour.plotting.models.RGB_colourspaces_CIE_1931_chromaticity_diagram_plot(colourspaces=None, cmfs='CIE 1931 2 Degree Standard Observer', **kwargs)[source]

Plots given RGB colourspaces in CIE 1931 Chromaticity Diagram.

Parameters:
  • colourspaces (array_like, optional) – RGB colourspaces to plot.
  • cmfs (unicode, optional) – Standard observer colour matching functions used for diagram bounds.
Other Parameters:
 
  • **kwargs (dict, optional) – {boundaries(), canvas(), decorate(), display()}, Please refer to the documentation of the previously listed definitions.
  • show_diagram_colours (bool, optional) – {CIE_1931_chromaticity_diagram_plot()}, Whether to display the chromaticity diagram background colours.
Returns:

Current figure or None.

Return type:

Figure

Examples

>>> c = ['Rec. 709', 'ACEScg', 'S-Gamut']
>>> RGB_colourspaces_CIE_1931_chromaticity_diagram_plot(
...     c)  
colour.plotting.models.RGB_colourspaces_CIE_1960_UCS_chromaticity_diagram_plot(colourspaces=None, cmfs='CIE 1931 2 Degree Standard Observer', **kwargs)[source]

Plots given RGB colourspaces in CIE 1960 UCS Chromaticity Diagram.

Parameters:
  • colourspaces (array_like, optional) – RGB colourspaces to plot.
  • cmfs (unicode, optional) – Standard observer colour matching functions used for diagram bounds.
Other Parameters:
 
  • **kwargs (dict, optional) – {boundaries(), canvas(), decorate(), display()}, Please refer to the documentation of the previously listed definitions.
  • show_diagram_colours (bool, optional) – {CIE_1960_UCS_chromaticity_diagram_plot()}, Whether to display the chromaticity diagram background colours.
Returns:

Current figure or None.

Return type:

Figure

Examples

>>> c = ['Rec. 709', 'ACEScg', 'S-Gamut']
>>> RGB_colourspaces_CIE_1960_UCS_chromaticity_diagram_plot(
...     c)  
colour.plotting.models.RGB_colourspaces_CIE_1976_UCS_chromaticity_diagram_plot(colourspaces=None, cmfs='CIE 1931 2 Degree Standard Observer', **kwargs)[source]

Plots given RGB colourspaces in CIE 1976 UCS Chromaticity Diagram.

Parameters:
  • colourspaces (array_like, optional) – RGB colourspaces to plot.
  • cmfs (unicode, optional) – Standard observer colour matching functions used for diagram bounds.
Other Parameters:
 
  • **kwargs (dict, optional) – {boundaries(), canvas(), decorate(), display()}, Please refer to the documentation of the previously listed definitions.
  • show_diagram_colours (bool, optional) – {CIE_1976_UCS_chromaticity_diagram_plot()}, Whether to display the chromaticity diagram background colours.
Returns:

Current figure or None.

Return type:

Figure

Examples

>>> c = ['Rec. 709', 'ACEScg', 'S-Gamut']
>>> RGB_colourspaces_CIE_1976_UCS_chromaticity_diagram_plot(
...     c)  
colour.plotting.models.RGB_chromaticity_coordinates_CIE_1931_chromaticity_diagram_plot(RGB, colourspace, **kwargs)[source]

Plots given RGB colourspace array in CIE 1931 Chromaticity Diagram.

Parameters:
  • RGB (array_like) – RGB colourspace array.
  • colourspace (unicode) – RGB colourspace of the RGB array.
Other Parameters:
 
  • **kwargs (dict, optional) – {boundaries(), canvas(), decorate(), display()}, Please refer to the documentation of the previously listed definitions.
  • show_diagram_colours (bool, optional) – {CIE_1931_chromaticity_diagram_plot()}, Whether to display the chromaticity diagram background colours.
Returns:

Current figure or None.

Return type:

Figure

Examples

>>> RGB = np.random.random((10, 10, 3))
>>> c = 'Rec. 709'
>>> RGB_chromaticity_coordinates_CIE_1931_chromaticity_diagram_plot(
...     RGB, c)  
colour.plotting.models.RGB_chromaticity_coordinates_CIE_1960_UCS_chromaticity_diagram_plot(RGB, colourspace, **kwargs)[source]

Plots given RGB colourspace array in CIE 1960 UCS Chromaticity Diagram.

Parameters:
  • RGB (array_like) – RGB colourspace array.
  • colourspace (unicode) – RGB colourspace of the RGB array.
Other Parameters:
 
  • **kwargs (dict, optional) – {boundaries(), canvas(), decorate(), display()}, Please refer to the documentation of the previously listed definitions.
  • show_diagram_colours (bool, optional) – {CIE_1960_UCS_chromaticity_diagram_plot()}, Whether to display the chromaticity diagram background colours.
Returns:

Current figure or None.

Return type:

Figure

Examples

>>> RGB = np.random.random((10, 10, 3))
>>> c = 'Rec. 709'
>>> RGB_chromaticity_coordinates_CIE_1960_UCS_chromaticity_diagram_plot(
...     RGB, c)  
colour.plotting.models.RGB_chromaticity_coordinates_CIE_1976_UCS_chromaticity_diagram_plot(RGB, colourspace, **kwargs)[source]

Plots given RGB colourspace array in CIE 1976 UCS Chromaticity Diagram.

Parameters:
  • RGB (array_like) – RGB colourspace array.
  • colourspace (unicode) – RGB colourspace of the RGB array.
Other Parameters:
 
  • **kwargs (dict, optional) – {boundaries(), canvas(), decorate(), display()}, Please refer to the documentation of the previously listed definitions.
  • show_diagram_colours (bool, optional) – {CIE_1976_UCS_chromaticity_diagram_plot()}, Whether to display the chromaticity diagram background colours.
Returns:

Current figure or None.

Return type:

Figure

Examples

>>> RGB = np.random.random((10, 10, 3))
>>> c = 'Rec. 709'
>>> RGB_chromaticity_coordinates_CIE_1976_UCS_chromaticity_diagram_plot(
...     RGB, c)  
colour.plotting.models.single_cctf_plot(colourspace='Rec. 709', decoding_cctf=False, **kwargs)[source]

Plots given colourspace colour component transfer function.

Parameters:
  • colourspace (unicode, optional) – RGB Colourspace colour component transfer function to plot.
  • decoding_cctf (bool) – Plot decoding colour component transfer function instead.
Other Parameters:
 

**kwargs (dict, optional) – {boundaries(), canvas(), decorate(), display()}, Please refer to the documentation of the previously listed definitions.

Returns:

Current figure or None.

Return type:

Figure

Examples

>>> single_cctf_plot()  
colour.plotting.models.multi_cctf_plot(colourspaces=None, decoding_cctf=False, **kwargs)[source]

Plots given colourspaces colour component transfer functions.

Parameters:
  • colourspaces (array_like, optional) – Colourspaces colour component transfer function to plot.
  • decoding_cctf (bool) – Plot decoding colour component transfer function instead.
Other Parameters:
 

**kwargs (dict, optional) – {boundaries(), canvas(), decorate(), display()}, Please refer to the documentation of the previously listed definitions.

Returns:

Current figure or None.

Return type:

Figure

Examples

>>> multi_cctf_plot(['Rec. 709', 'sRGB'])