A Python package implementing various HDRI processing algorithms.

It is open source and freely available under the BSD-3-Clause terms.

The following features are available:

• HDRI Generation
• Debevec (1997) Camera Response Function Computation
• Grossberg (2003) Histogram Based Image Sampling
• Variance Minimization Light Probe Sampling
• Global Tonemapping Operators
• Adobe DNG SDK Colour Processing
• Absolute Luminance Calibration
• Digital Still Camera (DSC) Exposure Model
• Raw Processing Helpers
• Vignette Characterisation & Correction
• Graph and Node Network-Based Processing

Various usage examples are available from the examples directory.

Because of their size, the resources dependencies needed to run the various examples and unit tests are not provided within the Pypi package. They are separately available as Git Submodules when cloning the repository.

Colour - HDRI requires various dependencies in order to run:

• python >= 3.10, < 3.14
• colour-science >= 4.4
• imageio >= 2, < 3
• numpy >= 1.24, < 3
• scipy >= 1.10, < 2

• colour-demosaicing
• Adobe DNG Converter
• dcraw
• ExifTool
• rawpy

Once the dependencies are satisfied, Colour - HDRI can be installed from the Python Package Index by issuing this command in a shell:

pip install --user colour-hdri

The optional features dependencies are installed as follows:

pip install --user 'colour-hdri[optional]'

The figures plotting dependencies are installed as follows:

pip install --user 'colour-hdri[plotting]'

The overall development dependencies are installed as follows:

pip install --user 'colour-hdri[development]'

If you would like to contribute to Colour - HDRI, please refer to the following Contributing guide for Colour.

The bibliography is available in the repository in BibTeX format.

The main technical reference for Colour - HDRI is the API Reference.

• Advanced High Dynamic Range Imaging: Theory and Practice by Banterle, F. et al.

Advanced High Dynamic Range Imaging: Theory and Practice was used as a reference for some of the algorithms of Colour - HDRI.

C/C

• OpenCV by Bradski, G.
• Piccante by Banterle, F. and Benedetti, L.,

Piccante was used to verify the Grossberg (2003) Histogram Based Image Sampling.

Matlab

• HDR Toolbox by Banterle, F. et al.

The Code of Conduct, adapted from the Contributor Covenant 1.4, is available on the Code of Conduct page.

The Colour Developers can be reached via different means:

• Email
• Facebook
• Github Discussions
• Gitter
• X
• Bluesky