colour.utilities.from_range_degrees

colour.utilities.from_range_degrees(a, scale_factor=360)[source]

Scales given array \(a\) from degrees range. The behaviour is as follows:

  • If Colour domain-range scale is ‘Reference’, the definition is entirely by-passed.
  • If Colour domain-range scale is ‘1’, array \(a\) is divided by scale_factor, typically 360.
  • If Colour domain-range scale is ‘100’ (currently unsupported private value only used for unit tests), array \(a\) is divided by scale_factor / 100, typically 360 / 100.
Parameters:
  • a (array_like) – \(a\) to scale from degrees range.
  • 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 from degrees range.
Returns:

\(a\) scaled from degrees range.
Return type:

ndarray

Examples

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

>>> with domain_range_scale('Reference'):
...     from_range_degrees(1)
1

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

>>> with domain_range_scale('1'):
...     from_range_degrees(1)  # doctest: +ELLIPSIS
0.0027777...

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

>>> with domain_range_scale('100'):
...     from_range_degrees(1)  # doctest: +ELLIPSIS
0.2777777...