https://github.com/colour-science/gamut-mapping-ramblings
Gamut Mapping Ramblings
https://github.com/colour-science/gamut-mapping-ramblings
color color-science color-space color-spaces colorspace colorspaces colour colour-science colour-space colour-spaces colourspace colourspaces gamut-mapping scene-referred
Last synced: 6 months ago
JSON representation
Gamut Mapping Ramblings
- Host: GitHub
- URL: https://github.com/colour-science/gamut-mapping-ramblings
- Owner: colour-science
- License: bsd-3-clause
- Created: 2020-05-11T10:45:29.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-02-09T08:57:16.000Z (over 2 years ago)
- Last Synced: 2024-10-29T21:05:42.839Z (11 months ago)
- Topics: color, color-science, color-space, color-spaces, colorspace, colorspaces, colour, colour-science, colour-space, colour-spaces, colourspace, colourspaces, gamut-mapping, scene-referred
- Language: Jupyter Notebook
- Homepage: https://colour-science.github.io/gamut-mapping-ramblings/
- Size: 64.9 MB
- Stars: 27
- Watchers: 6
- Forks: 6
- Open Issues: 7
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
Gamut Mapping Ramblings
=======================
.. image:: https://raw.githubusercontent.com/colour-science/gamut-mapping-ramblings/master/resources/images/Gamut_Medicina_01.png
Introduction
------------
Ramblings in the world of Scene-Referred Gamut Mapping as part of the
`ACES VWG `__.
The following study models are implemented in the `gamut_mapping_medicina_01 `__
notebook.
- `Mansencal and Scharfenberg (2020) `__
- `Smith (2020) `__
The notebook is intended to be read with the **JupyterLab Dark Theme**:
.. image:: https://raw.githubusercontent.com/colour-science/gamut-mapping-ramblings/master/resources/images/JupyterLab_Dark_Theme.png
Various compression functions are implemented in the `gamut_mapping_compression_functions_01 `__
notebook.
Images courtesy of:
- `Justin Holt `__
- `Thomas Mansencal `__
- `Fabian Matas `__
- `Carol Payne `__
- `Martin Smekal `__
Installation
------------
Docker
~~~~~~
.. code-block:: bash
$ docker build -t colourscience/gamut-mapping-ramblings:latest "."
*Note*
Allocated memory will need to be increased in Docker preferences:
*Preferences --> Resources --> Advanced*, 8Go should be enough.
Pip
~~~
`Node.js `__ is required for the
`Jupyter Lab `__ Matplotlib extension.
`Pip `__ can be used to install the
main dependencies, assuming you have created and activated a
`Virtual Environment `__:
.. code-block:: bash
$ pip install --user -r requirements.txt
$ python -c "import imageio;imageio.plugins.freeimage.download()"
$ jupyter labextension install @jupyter-widgets/jupyterlab-manager jupyter-matplotlib
Poetry
~~~~~~
`Node.js `__ is required for the
`Jupyter Lab `__ Matplotlib extension.
`Poetry `__ can also be used to install the main
dependencies:
.. code-block:: bash
$ poetry install
$ poetry run python -c "import imageio;imageio.plugins.freeimage.download()"
$ poetry run jupyter labextension install @jupyter-widgets/jupyterlab-manager jupyter-matplotlib
Usage
-----
Docker
~~~~~~
.. code-block:: bash
$ docker run -v $PWD:/home/colour-science/gamut-mapping-ramblings -p 8888:8888 colourscience/gamut-mapping-ramblings:latest
Pip
~~~
.. code-block:: bash
$ jupyter lab
Poetry
~~~~~~
.. code-block:: bash
$ poetry run jupyter lab
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 `__
- `Gitter `__
- `X `__
- `Bluesky `__
About
-----
| **Gamut Mapping Ramblings** by Colour Developers
| Copyright 2019 – Colour Developers – `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/gamut-mapping-ramblings `__