{"id":19252599,"url":"https://github.com/colour-science/colour-hdri","last_synced_at":"2025-04-12T21:27:45.942Z","repository":{"id":2966019,"uuid":"42766203","full_name":"colour-science/colour-hdri","owner":"colour-science","description":"HDRI / Radiance image processing algorithms for Python","archived":false,"fork":false,"pushed_at":"2025-04-07T21:33:15.000Z","size":100760,"stargazers_count":144,"open_issues_count":3,"forks_count":19,"subscribers_count":21,"default_branch":"develop","last_synced_at":"2025-04-10T19:48:43.651Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://www.colour-science.org","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/colour-science.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":".github/funding.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":null,"open_collective":"colour-science","ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2015-09-19T08:46:45.000Z","updated_at":"2025-03-26T13:49:06.000Z","dependencies_parsed_at":"2023-07-05T18:31:45.555Z","dependency_job_id":"e21c48bf-f406-4878-9de8-e26142cc4092","html_url":"https://github.com/colour-science/colour-hdri","commit_stats":{"total_commits":575,"total_committers":2,"mean_commits":287.5,"dds":"0.019130434782608674","last_synced_commit":"80251bc7ca26051ca1a3e2bad173a82c35f70c36"},"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colour-science%2Fcolour-hdri","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colour-science%2Fcolour-hdri/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colour-science%2Fcolour-hdri/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colour-science%2Fcolour-hdri/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/colour-science","download_url":"https://codeload.github.com/colour-science/colour-hdri/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248348333,"owners_count":21088851,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"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"],"created_at":"2024-11-09T18:27:37.848Z","updated_at":"2025-04-12T21:27:45.907Z","avatar_url":"https://github.com/colour-science.png","language":"Jupyter Notebook","funding_links":["https://opencollective.com/colour-science"],"categories":[],"sub_categories":[],"readme":"Colour - HDRI\n=============\n\n.. start-badges\n\n|actions| |coveralls| |codacy| |version|\n\n.. |actions| image:: https://img.shields.io/github/actions/workflow/status/colour-science/colour-hdri/.github/workflows/continuous-integration-quality-unit-tests.yml?branch=develop\u0026style=flat-square\n    :target: https://github.com/colour-science/colour-hdri/actions\n    :alt: Develop Build Status\n.. |coveralls| image:: http://img.shields.io/coveralls/colour-science/colour-hdri/develop.svg?style=flat-square\n    :target: https://coveralls.io/r/colour-science/colour-hdri\n    :alt: Coverage Status\n.. |codacy| image:: https://img.shields.io/codacy/grade/f422dc0703dd4653b2b766217c745813/develop.svg?style=flat-square\n    :target: https://app.codacy.com/gh/colour-science/colour-hdri\n    :alt: Code Grade\n.. |version| image:: https://img.shields.io/pypi/v/colour-hdri.svg?style=flat-square\n    :target: https://pypi.org/project/colour-hdri\n    :alt: Package Version\n\n.. end-badges\n\nA `Python \u003chttps://www.python.org\u003e`__ package implementing various\nHDRI processing algorithms.\n\nIt is open source and freely available under the\n`BSD-3-Clause \u003chttps://opensource.org/licenses/BSD-3-Clause\u003e`__ terms.\n\n..  image:: https://raw.githubusercontent.com/colour-science/colour-hdri/master/docs/_static/Radiance_001.png\n\n.. contents:: **Table of Contents**\n    :backlinks: none\n    :depth: 2\n\n.. sectnum::\n\nFeatures\n--------\n\nThe following features are available:\n\n- HDRI Generation\n- Debevec (1997) Camera Response Function Computation\n- Grossberg (2003) Histogram Based Image Sampling\n- Variance Minimization Light Probe Sampling\n- Global Tonemapping Operators\n- Adobe DNG SDK Colour Processing\n- Absolute Luminance Calibration\n- Digital Still Camera (DSC) Exposure Model\n- Raw Processing Helpers\n- Vignette Characterisation \u0026 Correction\n- Graph and Node Network-Based Processing\n\nExamples\n^^^^^^^^\n\nVarious usage examples are available from the\n`examples directory \u003chttps://github.com/colour-science/colour-hdri/tree/master/colour_hdri/examples\u003e`__.\n\nUser Guide\n----------\n\nInstallation\n^^^^^^^^^^^^\n\nBecause of their size, the resources dependencies needed to run the various\nexamples and unit tests are not provided within the Pypi package. They are\nseparately available as\n`Git Submodules \u003chttps://git-scm.com/book/en/v2/Git-Tools-Submodules\u003e`__\nwhen cloning the\n`repository \u003chttps://github.com/colour-science/colour-hdri\u003e`__.\n\nPrimary Dependencies\n~~~~~~~~~~~~~~~~~~~~\n\n**Colour - HDRI** requires various dependencies in order to run:\n\n- `python \u003e= 3.10, \u003c 3.14 \u003chttps://www.python.org/download/releases\u003e`__\n- `colour-science \u003e= 4.4 \u003chttps://pypi.org/project/colour-science\u003e`__\n- `imageio \u003e= 2, \u003c 3 \u003chttps://imageio.github.io\u003e`__\n- `numpy \u003e= 1.24, \u003c 3 \u003chttps://pypi.org/project/numpy\u003e`__\n- `scipy \u003e= 1.10, \u003c 2 \u003chttps://pypi.org/project/scipy\u003e`__\n\nOptional Features Dependencies\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n- `colour-demosaicing \u003chttps://pypi.org/project/colour-demosaicing\u003e`__\n- `Adobe DNG Converter \u003chttps://helpx.adobe.com/nz/camera-raw/using/adobe-dng-converter.html\u003e`__\n- `dcraw \u003chttps://dechifro.org/dcraw/\u003e`__\n- `ExifTool \u003chttp://www.sno.phy.queensu.ca/~phil/exiftool\u003e`__\n- `rawpy \u003chttps://pypi.org/project/rawpy\u003e`__\n\nPypi\n~~~~\n\nOnce the dependencies are satisfied, **Colour - HDRI** can be installed from\nthe `Python Package Index \u003chttp://pypi.python.org/pypi/colour-hdri\u003e`__ by\nissuing this command in a shell::\n\n    pip install --user colour-hdri\n\nThe optional features dependencies are installed as follows::\n\n    pip install --user 'colour-hdri[optional]'\n\nThe figures plotting dependencies are installed as follows::\n\n    pip install --user 'colour-hdri[plotting]'\n\nThe overall development dependencies are installed as follows::\n\n    pip install --user 'colour-hdri[development]'\n\nContributing\n^^^^^^^^^^^^\n\nIf you would like to contribute to `Colour - HDRI \u003chttps://github.com/colour-science/colour-hdri\u003e`__,\nplease refer to the following `Contributing \u003chttps://www.colour-science.org/contributing\u003e`__\nguide for `Colour \u003chttps://github.com/colour-science/colour\u003e`__.\n\nBibliography\n^^^^^^^^^^^^\n\nThe bibliography is available in the repository in\n`BibTeX \u003chttps://github.com/colour-science/colour-hdri/blob/develop/BIBLIOGRAPHY.bib\u003e`__\nformat.\n\nAPI Reference\n-------------\n\nThe main technical reference for `Colour - HDRI \u003chttps://github.com/colour-science/colour-hdri\u003e`__\nis the `API Reference \u003chttps://colour-hdri.readthedocs.io/en/latest/reference.html\u003e`__.\n\nSee Also\n--------\n\nPublications\n^^^^^^^^^^^^\n\n- `Advanced High Dynamic Range Imaging: Theory and Practice \u003chttps://dl.acm.org/doi/book/10.5555/1996408\u003e`__ by Banterle, F. et al.\n\n*Advanced High Dynamic Range Imaging: Theory and Practice* was used as a\nreference for some of the algorithms of **Colour - HDRI**.\n\nSoftware\n^^^^^^^^\n\n**C/C++**\n\n- `OpenCV \u003chttps://opencv.org\u003e`__ by Bradski, G.\n- `Piccante \u003chttps://github.com/cnr-isti-vclab/piccante\u003e`__ by Banterle, F. and Benedetti, L.,\n\n*Piccante* was used to verify the Grossberg (2003) Histogram Based Image Sampling.\n\n**Matlab**\n\n- `HDR Toolbox \u003chttps://github.com/banterle/HDR_Toolbox\u003e`__ by Banterle, F. et al.\n\nCode of Conduct\n---------------\n\nThe *Code of Conduct*, adapted from the `Contributor Covenant 1.4 \u003chttps://www.contributor-covenant.org/version/1/4/code-of-conduct.html\u003e`__,\nis available on the `Code of Conduct \u003chttps://www.colour-science.org/code-of-conduct\u003e`__ page.\n\nContact \u0026 Social\n----------------\n\nThe *Colour Developers* can be reached via different means:\n\n- `Email \u003cmailto:colour-developers@colour-science.org\u003e`__\n- `Facebook \u003chttps://www.facebook.com/python.colour.science\u003e`__\n- `Github Discussions \u003chttps://github.com/colour-science/colour-hdri/discussions\u003e`__\n- `Gitter \u003chttps://gitter.im/colour-science/colour\u003e`__\n- `X \u003chttps://x.com/colour_science\u003e`__\n- `Bluesky \u003chttps://bsky.app/profile/colour-science.bsky.social\u003e`__\n\nAbout\n-----\n\n| **Colour - HDRI** by Colour Developers\n| Copyright 2015 Colour Developers – `colour-developers@colour-science.org \u003ccolour-developers@colour-science.org\u003e`__\n| This software is released under terms of BSD-3-Clause: https://opensource.org/licenses/BSD-3-Clause\n| `https://github.com/colour-science/colour-hdri \u003chttps://github.com/colour-science/colour-hdri\u003e`__\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcolour-science%2Fcolour-hdri","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcolour-science%2Fcolour-hdri","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcolour-science%2Fcolour-hdri/lists"}