colour.utilities.to_domain_10¶
-
colour.utilities.
to_domain_10
(a, scale_factor=10, dtype=<class 'numpy.float64'>)[source]¶ Scales given array \(a\) to domain ‘10’, used by Munsell Renotation System. The behaviour is as follows:
- If Colour domain-range scale is ‘Reference’, 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 10. - If Colour domain-range scale is ‘100’ (currently unsupported
private value only used for unit tests), array \(a\) is
divided by
scale_factor
, typically 10.
Parameters: - a (array_like) – \(a\) to scale to domain ‘10’.
- 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 ‘10’.
- dtype (object, optional) – Data type used for the conversion to
np.ndarray
.
Returns: \(a\) scaled to domain ‘10’.
Return type: ndarray
Examples
With Colour domain-range scale set to ‘Reference’:
>>> with domain_range_scale('Reference'): ... to_domain_10(1) array(1.0)
With Colour domain-range scale set to ‘1’:
>>> with domain_range_scale('1'): ... to_domain_10(1) array(10.0)
With Colour domain-range scale set to ‘100’ (unsupported):
>>> with domain_range_scale('100'): ... to_domain_10(1) array(0.1)
- If Colour domain-range scale is ‘Reference’, the
definition is almost entirely by-passed and will just conveniently
convert array \(a\) to