colour.utilities.as_float¶
-
colour.utilities.
as_float
(a)[source]¶ Converts given \(a\) variable to numeric using the type defined by
colour.constant.DEFAULT_FLOAT_DTYPE
attribute. In the event where \(a\) cannot be converted, it is converted to ndarray using the type defined bycolour.constant.DEFAULT_FLOAT_DTYPE
attribute.- Parameters
a (object) – Variable to convert.
- Returns
\(a\) variable converted to numeric.
- Return type
ndarray
Warning
The behaviour of this definition is different than
colour.utilities.as_numeric()
definition when it comes to conversion failure: the former will forcibly convert \(a\) variable to ndarray using the type defined bycolour.constant.DEFAULT_FLOAT_DTYPE
attribute while the later will pass the \(a\) variable as is.Examples
>>> as_float(np.array([1])) 1.0 >>> as_float(np.arange(10)) array([ 0., 1., 2., 3., 4., 5., 6., 7., 8., 9.])