colour.recovery.Tree_Otsu2018#

class colour.recovery.Tree_Otsu2018(*args: Any, **kwargs: Any)[source]#

A sub-class of colour.recovery.otsu2018.Node class representing the root node of a tree containing information shared with all the nodes, such as the standard observer colour matching functions and the illuminant, if any is used.

Global operations involving the entire tree, such as optimisation and conversion to dataset, are implemented in this sub-class.

Parameters:
  • reflectances (MultiSpectralDistributions) – Reference reflectances of the n reference colours to use for optimisation.

  • cmfs (MultiSpectralDistributions | None) – Standard observer colour matching functions, default to the CIE 1931 2 Degree Standard Observer.

  • illuminant (SpectralDistribution | None) – Illuminant spectral distribution, default to CIE Standard Illuminant D65.

Attributes

  • reflectances

  • cmfs

  • illuminant

Methods

  • __init__()

  • __str__()

  • optimise()

  • to_dataset()

References

[OYH18]

Examples

>>> import os
>>> import colour
>>> from colour import MSDS_CMFS, SDS_COLOURCHECKERS, SDS_ILLUMINANTS
>>> from colour.colorimetry import sds_and_msds_to_msds
>>> from colour.utilities import numpy_print_options
>>> XYZ = np.array([0.20654008, 0.12197225, 0.05136952])
>>> cmfs = (
...     MSDS_CMFS["CIE 1931 2 Degree Standard Observer"]
...     .copy()
...     .align(SpectralShape(360, 780, 10))
... )
>>> illuminant = SDS_ILLUMINANTS["D65"].copy().align(cmfs.shape)
>>> reflectances = sds_and_msds_to_msds(
...     SDS_COLOURCHECKERS["ColorChecker N Ohta"].values()
... )
>>> node_tree = Tree_Otsu2018(reflectances, cmfs, illuminant)
>>> node_tree.optimise(iterations=2, print_callable=lambda x: x)
>>> dataset = node_tree.to_dataset()
>>> path = os.path.join(
...     colour.__path__[0],
...     "recovery",
...     "tests",
...     "resources",
...     "ColorChecker_Otsu2018.npz",
... )
>>> dataset.write(path)  
>>> dataset = Dataset_Otsu2018()  
>>> dataset.read(path)  
>>> sd = XYZ_to_sd_Otsu2018(XYZ, cmfs, illuminant, dataset)
>>> with numpy_print_options(suppress=True):
...     sd  
SpectralDistribution([[ 360.        ,    0.0651341...],
                      [ 370.        ,    0.0651341...],
                      [ 380.        ,    0.0651341...],
                      [ 390.        ,    0.0749684...],
                      [ 400.        ,    0.0815578...],
                      [ 410.        ,    0.0776439...],
                      [ 420.        ,    0.0721897...],
                      [ 430.        ,    0.0649064...],
                      [ 440.        ,    0.0567185...],
                      [ 450.        ,    0.0484685...],
                      [ 460.        ,    0.0409768...],
                      [ 470.        ,    0.0358964...],
                      [ 480.        ,    0.0307857...],
                      [ 490.        ,    0.0270148...],
                      [ 500.        ,    0.0273773...],
                      [ 510.        ,    0.0303157...],
                      [ 520.        ,    0.0331285...],
                      [ 530.        ,    0.0363027...],
                      [ 540.        ,    0.0425987...],
                      [ 550.        ,    0.0513442...],
                      [ 560.        ,    0.0579256...],
                      [ 570.        ,    0.0653850...],
                      [ 580.        ,    0.0929522...],
                      [ 590.        ,    0.1600326...],
                      [ 600.        ,    0.2586159...],
                      [ 610.        ,    0.3701242...],
                      [ 620.        ,    0.4702243...],
                      [ 630.        ,    0.5396261...],
                      [ 640.        ,    0.5737561...],
                      [ 650.        ,    0.590848 ...],
                      [ 660.        ,    0.5935371...],
                      [ 670.        ,    0.5923295...],
                      [ 680.        ,    0.5956326...],
                      [ 690.        ,    0.5982513...],
                      [ 700.        ,    0.6017904...],
                      [ 710.        ,    0.6016419...],
                      [ 720.        ,    0.5996892...],
                      [ 730.        ,    0.6000018...],
                      [ 740.        ,    0.5964443...],
                      [ 750.        ,    0.5868181...],
                      [ 760.        ,    0.5860973...],
                      [ 770.        ,    0.5614878...],
                      [ 780.        ,    0.5289331...]],
                     SpragueInterpolator,
                     {},
                     Extrapolator,
                     {'method': 'Constant', 'left': None, 'right': None})

Return a new instance of the colour.utilities.Node class.

Parameters:
__init__(reflectances: MultiSpectralDistributions, cmfs: MultiSpectralDistributions | None = None, illuminant: SpectralDistribution | None = None) None[source]#
Parameters:
Return type:

None

Methods

__init__(reflectances[, cmfs, illuminant])

branch_reconstruction_error()

Compute the reconstruction error for all the leaves data connected to the node or its children, i.e. the reconstruction errors summation for all the leaves in the branch.

is_inner()

Return whether the node is an inner node.

is_leaf()

Return whether the node is a leaf node.

is_root()

Return whether the node is a root node.

leaf_reconstruction_error()

Return the reconstruction error of the node data.

minimise(minimum_cluster_size)

Find the best partition for the node that minimises the leaf reconstruction error.

optimise([iterations, minimum_cluster_size, ...])

Optimise the tree by repeatedly performing optimal partitioning of the nodes, creating a tree that minimises the total reconstruction error.

render([tab_level])

Render the current node and its children as a string.

split(children, axis)

Convert the leaf node into an inner node using given children and partition axis.

to_dataset()

Create a colour.recovery.Dataset_Otsu2018 class instance based on data stored in the tree.

walk([ascendants])

Return a generator used to walk into colour.utilities.Node trees.

Attributes

children

Getter and setter property for the node children.

cmfs

Getter property for the standard observer colour matching functions.

data

Getter property for the node data.

id

Getter property for the node id.

illuminant

Getter property for the illuminant.

leaves

Getter property for the node leaves.

name

Getter and setter property for the name.

parent

Getter and setter property for the node parent.

partition_axis

Getter property for the node partition axis.

reflectances

Getter property for the reference reflectances.

root

Getter property for the node tree.

row

Getter property for the node row for the selector array.

siblings

Getter property for the node siblings.