colour.models.eotf_ST2084#

colour.models.eotf_ST2084(N: ArrayLike, L_p: float = 10000, constants: Structure | None = None) NDArrayFloat[source]#

Apply the SMPTE ST 2084:2014 perceptual quantizer (PQ) electro-optical transfer function (EOTF).

Parameters:
  • N (ArrayLike) – Colour value abbreviated as \(N\), directly proportional to the encoded signal representation and not directly proportional to the optical output of a display device.

  • L_p (float) – System peak luminance in \(cd/m^2\). This parameter should remain at its default value of \(10000 cd/m^2\) for practical applications. It is exposed to enable the definition’s use as a fitting function.

  • constants (Structure | None) – SMPTE ST 2084:2014 constants.

Returns:

Target optical output \(C\) in \(cd/m^2\) of the ideal reference display.

Return type:

numpy.ndarray

Warning

SMPTE ST 2084:2014 is an absolute transfer function.

Notes

  • SMPTE ST 2084:2014 is an absolute transfer function, thus the domain and range values for the Reference and 1 scales are only indicative that the data is not affected by scale transformations.

Domain

Scale - Reference

Scale - 1

N

UN

UN

Range

Scale - Reference

Scale - 1

C

UN

UN

References

[Mil14], [SocietyoMPaTEngineers14]

Examples

>>> eotf_ST2084(0.508078421517399)
100.0000000...