colour.utilities.set_default_int_dtype#

colour.utilities.set_default_int_dtype(dtype: Type[DTypeInt] = DTYPE_INT_DEFAULT) None[source]#

Set Colour default numpy.integer precision by setting colour.constant.DTYPE_INT_DEFAULT attribute with given numpy.dtype wherever the attribute is imported.

Parameters:

dtype (Type[DTypeInt]) – numpy.dtype to set colour.constant.DTYPE_INT_DEFAULT with.

Return type:

None

Notes

  • It is possible to define the int precision at import time by setting the COLOUR_SCIENCE__DEFAULT_INT_DTYPE environment variable, for example set COLOUR_SCIENCE__DEFAULT_INT_DTYPE=int32.

Warning

This definition is mostly given for consistency purposes with colour.utilities.set_default_float_dtype() definition but contrary to the latter, changing integer precision will almost certainly completely break Colour. With great power comes great responsibility.

Examples

>>> as_int_array(np.ones(3)).dtype  
dtype('int64')
>>> set_default_int_dtype(np.int32)  
>>> as_int_array(np.ones(3)).dtype  
dtype('int32')
>>> set_default_int_dtype(np.int64)
>>> as_int_array(np.ones(3)).dtype  
dtype('int64')