1 Colour - HDRI¶
A Python package implementing various HDRI / Radiance image processing algorithms.
It is open source and freely available under the New BSD License terms.
Table of Contents
1.1 Features¶
The following features are available:
HDRI / Radiance Image 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
1.2 Installation¶
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.
1.2.1 Primary Dependencies¶
Colour - HDRI requires various dependencies in order to run:
1.2.2 Optional Features Dependencies¶
1.2.3 Pypi¶
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 tests suite dependencies are installed as follows:
pip install --user 'colour-hdri[tests]'
The documentation building dependencies are installed as follows:
pip install --user 'colour-hdri[docs]'
The overall development dependencies are installed as follows:
pip install --user 'colour-hdri[development]'
1.3 Usage¶
1.3.1 API¶
The main reference for Colour - HDRI is the manual:
1.3.2 Examples¶
Various usage examples are available from the examples directory.
1.4 Contributing¶
If you would like to contribute to Colour - HDRI, please refer to the following Contributing guide for Colour.
1.6 Code of Conduct¶
The Code of Conduct, adapted from the Contributor Covenant 1.4, is available on the Code of Conduct page.