colour.utilities.to_domain_100

colour.utilities.to_domain_100(a, scale_factor=100, dtype=<class 'numpy.float64'>)[source]

Scales given array \(a\) to domain ‘100’. The behaviour is as follows:

  • If Colour domain-range scale is ‘Reference’ or ‘100’ (currently unsupported private value only used for unit tests), the definition is almost entirely by-passed and will just conveniently convert array \(a\) to np.ndarray.

  • If Colour domain-range scale is ‘1’, array \(a\) is multiplied by scale_factor, typically 100.

Parameters
  • a (array_like) – \(a\) to scale to domain ‘100’.

  • scale_factor (numeric or array_like, optional) – Scale factor, usually numeric but can be an array_like if some axis need different scaling to be brought to domain ‘100’.

  • dtype (object, optional) – Data type used for the conversion to np.ndarray.

Returns

\(a\) scaled to domain ‘100’.

Return type

ndarray

Examples

With Colour domain-range scale set to ‘Reference’:

>>> with domain_range_scale('Reference'):
...     to_domain_100(1)
array(1.0)

With Colour domain-range scale set to ‘1’:

>>> with domain_range_scale('1'):
...     to_domain_100(1)
array(100.0)

With Colour domain-range scale set to ‘100’ (unsupported):

>>> with domain_range_scale('100'):
...     to_domain_100(1)
array(1.0)