Skip to main content

HDRI / Radiance image processing algorithms for Python

Project description

Develop Build Status Coverage Status Code Grade Package Version

A Python package implementing various HDRI / Radiance image processing algorithms.

It is open source and freely available under the New BSD License terms.

https://raw.githubusercontent.com/colour-science/colour-hdri/master/docs/_static/Radiance_001.png <nav class="contents" id="table-of-contents" role="doc-toc">

Table of Contents

</nav>

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.1 Examples

Various usage examples are available from the examples directory.

2 User Guide

2.1 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.

2.1.1 Primary Dependencies

Colour - HDRI requires various dependencies in order to run:

2.1.2 Optional Features Dependencies

2.1.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 overall development dependencies are installed as follows:

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

2.2 Contributing

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

2.3 Bibliography

The bibliography is available in the repository in BibTeX format.

3 API Reference

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

4 See Also

4.1 Publications

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

4.2 Software

C/C++

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

Matlab

5 Code of Conduct

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

6 Contact & Social

The Colour Developers can be reached via different means:

7 About

Colour - HDRI by Colour Developers
Copyright 2015 Colour Developers – colour-developers@colour-science.org
This software is released under terms of New BSD License: https://opensource.org/licenses/BSD-3-Clause

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

colour-hdri-0.2.0.tar.gz (7.7 MB view hashes)

Uploaded source

Built Distribution

colour_hdri-0.2.0-py3-none-any.whl (7.7 MB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page