colour.utilities.to_domain_degrees#

colour.utilities.to_domain_degrees(a: ArrayLike, scale_factor: ArrayLike = 360, dtype: Type[DTypeFloat] | None = None) → NDArray[source]#

Scale given array \(a\) to degrees domain. The behaviour is as follows:

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

Parameters:

a (ArrayLike) – Array \(a\) to scale to degrees domain.
scale_factor (ArrayLike) – Scale factor, usually numeric but can be a numpy.ndarray if some axis need different scaling to be brought to degrees domain.
dtype (Type[DTypeFloat] | None) – Data type used for the conversion to np.ndarray.

Returns:

Array \(a\) scaled to degrees domain.

Return type:

numpy.ndarray

Examples

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

>>> with domain_range_scale("Reference"):
...     to_domain_degrees(1)
array(1.0)

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

>>> with domain_range_scale("1"):
...     to_domain_degrees(1)
array(360.0)

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

>>> with domain_range_scale("100"):
...     to_domain_degrees(1)
array(3.6)