https://github.com/colour-science/colour-hdri
HDRI / Radiance image processing algorithms for Python
https://github.com/colour-science/colour-hdri
color color-science color-space color-spaces colorspace colorspaces colour colour-science colour-space colour-spaces colourspace colourspaces hdr hdr-image hdri hdri-image python raw tone-mapping tonemapping
Last synced: 6 months ago
JSON representation
HDRI / Radiance image processing algorithms for Python
- Host: GitHub
- URL: https://github.com/colour-science/colour-hdri
- Owner: colour-science
- License: bsd-3-clause
- Created: 2015-09-19T08:46:45.000Z (about 10 years ago)
- Default Branch: develop
- Last Pushed: 2025-04-07T21:33:15.000Z (6 months ago)
- Last Synced: 2025-04-10T19:48:43.651Z (6 months ago)
- Topics: color, color-science, color-space, color-spaces, colorspace, colorspaces, colour, colour-science, colour-space, colour-spaces, colourspace, colourspaces, hdr, hdr-image, hdri, hdri-image, python, raw, tone-mapping, tonemapping
- Language: Jupyter Notebook
- Homepage: https://www.colour-science.org
- Size: 96.1 MB
- Stars: 144
- Watchers: 21
- Forks: 19
- Open Issues: 3
-
Metadata Files:
- Readme: README.rst
- Funding: .github/funding.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
Colour - HDRI
=============
.. start-badges
|actions| |coveralls| |codacy| |version|
.. |actions| image:: https://img.shields.io/github/actions/workflow/status/colour-science/colour-hdri/.github/workflows/continuous-integration-quality-unit-tests.yml?branch=develop&style=flat-square
:target: https://github.com/colour-science/colour-hdri/actions
:alt: Develop Build Status
.. |coveralls| image:: http://img.shields.io/coveralls/colour-science/colour-hdri/develop.svg?style=flat-square
:target: https://coveralls.io/r/colour-science/colour-hdri
:alt: Coverage Status
.. |codacy| image:: https://img.shields.io/codacy/grade/f422dc0703dd4653b2b766217c745813/develop.svg?style=flat-square
:target: https://app.codacy.com/gh/colour-science/colour-hdri
:alt: Code Grade
.. |version| image:: https://img.shields.io/pypi/v/colour-hdri.svg?style=flat-square
:target: https://pypi.org/project/colour-hdri
:alt: Package Version
.. end-badges
A `Python `__ package implementing various
HDRI processing algorithms.
It is open source and freely available under the
`BSD-3-Clause `__ terms.
.. image:: https://raw.githubusercontent.com/colour-science/colour-hdri/master/docs/_static/Radiance_001.png
.. contents:: **Table of Contents**
:backlinks: none
:depth: 2
.. sectnum::
Features
--------
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
Examples
^^^^^^^^
Various usage examples are available from the
`examples directory `__.
User Guide
----------
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 `__.
Primary Dependencies
~~~~~~~~~~~~~~~~~~~~
**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 `__
Optional Features Dependencies
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- `colour-demosaicing `__
- `Adobe DNG Converter `__
- `dcraw `__
- `ExifTool `__
- `rawpy `__
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 overall development dependencies are installed as follows::
pip install --user 'colour-hdri[development]'
Contributing
^^^^^^^^^^^^
If you would like to contribute to `Colour - HDRI `__,
please refer to the following `Contributing `__
guide for `Colour `__.
Bibliography
^^^^^^^^^^^^
The bibliography is available in the repository in
`BibTeX `__
format.
API Reference
-------------
The main technical reference for `Colour - HDRI `__
is the `API Reference `__.
See Also
--------
Publications
^^^^^^^^^^^^
- `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**.
Software
^^^^^^^^
**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.
Code of Conduct
---------------
The *Code of Conduct*, adapted from the `Contributor Covenant 1.4 `__,
is available on the `Code of Conduct `__ page.
Contact & Social
----------------
The *Colour Developers* can be reached via different means:
- `Email `__
- `Facebook `__
- `Github Discussions `__
- `Gitter `__
- `X `__
- `Bluesky `__
About
-----
| **Colour - HDRI** by Colour Developers
| Copyright 2015 Colour Developers – `colour-developers@colour-science.org `__
| This software is released under terms of BSD-3-Clause: https://opensource.org/licenses/BSD-3-Clause
| `https://github.com/colour-science/colour-hdri `__