colour.models.logarithmic_function_basic

colour.models.logarithmic_function_basic(x: FloatingOrArrayLike, style: Union[Literal['log10', 'antiLog10', 'log2', 'antiLog2', 'logB', 'antiLogB'], str] = 'log2', base: int = 2) → FloatingOrNDArray[source]

Define the basic logarithmic function.

Parameters

  • x (FloatingOrArrayLike) – The data to undergo basic logarithmic conversion.

  • style (Union[Literal['log10', 'antiLog10', 'log2', 'antiLog2', 'logB', 'antiLogB'], str]) –

    Defines the behaviour for the logarithmic function to operate:

    • log10: Applies a base 10 logarithm to the passed value.

    • antiLog10: Applies a base 10 anti-logarithm to the passed value.

    • log2: Applies a base 2 logarithm to the passed value.

    • antiLog2: Applies a base 2 anti-logarithm to the passed value.

    • logB: Applies an arbitrary base logarithm to the passed value.

    • antiLogB: Applies an arbitrary base anti-logarithm to the passed value.

  • base (int) – Logarithmic base used for the conversion.

Returns

Logarithmically converted data.

Return type

numpy.floating or numpy.ndarray

Examples

The basic logarithmic function styles operate as follows:

>>> logarithmic_function_basic(0.18)  
-2.4739311...
>>> logarithmic_function_basic(0.18, 'log10')  
-0.7447274...
>>> logarithmic_function_basic(  
...    0.18, 'logB', 3)
-1.5608767...
>>> logarithmic_function_basic(  
...    -2.473931188332412, 'antiLog2')
0.18000000...
>>> logarithmic_function_basic(  
...    -0.7447274948966939, 'antiLog10')
0.18000000...
>>> logarithmic_function_basic(  
...    -1.5608767950073117, 'antiLogB', 3)
0.18000000...

previous

colour.models.exponent_function_monitor_curve

next

colour.models.logarithmic_function_quasilog