Metadata-Version: 2.1
Name: colour-hdri
Version: 0.1.8
Summary: HDRI / Radiance image processing algorithms for Python
Home-page: https://www.colour-science.org/
License: BSD-3-Clause
Keywords: 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
Author: Colour Developers
Author-email: colour-developers@colour-science.org
Maintainer: Colour Developers
Maintainer-email: colour-developers@colour-science.org
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development
Provides-Extra: development
Provides-Extra: optional
Provides-Extra: plotting
Provides-Extra: read-the-docs
Requires-Dist: backports.functools_lru_cache; extra == "plotting"
Requires-Dist: biblib-simple; extra == "development"
Requires-Dist: colour-demosaicing; extra == "optional"
Requires-Dist: colour-science (>=0.3.16,<0.4.0)
Requires-Dist: coverage; extra == "development"
Requires-Dist: coveralls; extra == "development"
Requires-Dist: flake8; extra == "development"
Requires-Dist: invoke; extra == "development"
Requires-Dist: jupyter; extra == "development"
Requires-Dist: matplotlib; extra == "plotting"
Requires-Dist: mock; extra == "development" or extra == "read-the-docs"
Requires-Dist: nbformat (>=4,<5); extra == "development"
Requires-Dist: nose; extra == "development"
Requires-Dist: numpy; extra == "read-the-docs"
Requires-Dist: pre-commit; extra == "development"
Requires-Dist: pytest; extra == "development"
Requires-Dist: rawpy; extra == "optional"
Requires-Dist: recordclass
Requires-Dist: restructuredtext-lint; extra == "development"
Requires-Dist: sphinx (<=3.1.2); extra == "development"
Requires-Dist: sphinx_rtd_theme; extra == "development"
Requires-Dist: sphinxcontrib-bibtex; extra == "development" or extra == "read-the-docs"
Requires-Dist: toml; extra == "development"
Requires-Dist: twine; extra == "development"
Requires-Dist: yapf (==0.23); extra == "development"
Project-URL: Repository, https://github.com/colour-science/colour-hdri
Description-Content-Type: text/x-rst

Colour - HDRI
=============

.. start-badges

|actions| |coveralls| |codacy| |version|

.. |actions| image:: https://img.shields.io/github/workflow/status/colour-science/colour-hdri/Continuous%20Integration?label=actions&logo=github&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/290ad2c23b0749b99a1d548ca47d9062/develop.svg?style=flat-square
    :target: https://www.codacy.com/app/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 <https://www.python.org/>`__ package implementing various
HDRI / Radiance image processing algorithms.

It is open source and freely available under the
`New BSD License <https://opensource.org/licenses/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: 3

.. sectnum::

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

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 <https://git-scm.com/book/en/v2/Git-Tools-Submodules>`__
when cloning the
`repository <https://github.com/colour-science/colour-hdri>`__.

Primary Dependencies
^^^^^^^^^^^^^^^^^^^^

**Colour - HDRI** requires various dependencies in order to run:

-   `python>=2.7 <https://www.python.org/download/releases/>`__ or
    `python>=3.5 <https://www.python.org/download/releases/>`__
-   `colour-science <https://pypi.org/project/colour-science/>`__
-   `recordclass <https://pypi.org/project/recordclass/>`__

Optional Features Dependencies
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

-   `colour-demosaicing <https://pypi.org/project/colour-demosaicing/>`__
-   `Adobe DNG Converter <https://www.adobe.com/support/downloads/product.jsp?product=106&platform=Mac>`__
-   `dcraw <https://www.cybercom.net/~dcoffin/dcraw/>`__
-   `ExifTool <http://www.sno.phy.queensu.ca/~phil/exiftool/>`__
-   `rawpy <https://pypi.org/project/rawpy/>`__

Pypi
^^^^

Once the dependencies are satisfied, **Colour - HDRI** can be installed from
the `Python Package Index <http://pypi.python.org/pypi/colour-hdri>`__ 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]'

Usage
-----

API
^^^

The main reference for `Colour - HDRI <https://github.com/colour-science/colour-hdri>`__
is the `Colour - HDRI Manual <https://colour-hdri.readthedocs.io/en/latest/manual.html>`__.

Examples
^^^^^^^^

Various usage examples are available from the
`examples directory <https://github.com/colour-science/colour-hdri/tree/master/colour_hdri/examples>`__.

Contributing
------------

If you would like to contribute to `Colour - HDRI <https://github.com/colour-science/colour-hdri>`__,
please refer to the following `Contributing <https://www.colour-science.org/contributing/>`__
guide for `Colour <https://github.com/colour-science/colour>`__.

Bibliography
------------

The bibliography is available in the repository in
`BibTeX <https://github.com/colour-science/colour-hdri/blob/develop/BIBLIOGRAPHY.bib>`__
format.

Code of Conduct
---------------

The *Code of Conduct*, adapted from the `Contributor Covenant 1.4 <https://www.contributor-covenant.org/version/1/4/code-of-conduct.html>`__,
is available on the `Code of Conduct <https://www.colour-science.org/code-of-conduct/>`__ page.

About
-----

| **Colour - HDRI** by Colour Developers
| Copyright © 2015-2020 – Colour Developers – `colour-developers@colour-science.org <colour-developers@colour-science.org>`__
| This software is released under terms of New BSD License: https://opensource.org/licenses/BSD-3-Clause
| `https://github.com/colour-science/colour-hdri <https://github.com/colour-science/colour-hdri>`__

