color-matcher¶
Description¶
color-matcher enables color transfer across images which comes in handy for automatic color-grading of photographs, paintings and film sequences as well as light-field and stopmotion corrections. The methods behind the mappings are based on the approach from Reinhard et al., an analytical solution to a Multi-Variate Gaussian Distribution (MVGD) transfer, the Monge-Kantorovich solution as proposed by Pitie et al. and classical histogram matching.
Installation¶
- via pip:
install with
pip3 install color-matcher
type
color-matcher -h
to the command line once installation finished
- from source:
install Python from https://www.python.org/
download the source using
git clone https://github.com/hahnec/color-matcher.git
go to the root directory
cd color-matcher
load dependencies
$ pip3 install -r requirements.txt
install with
python3 setup.py install
if installation ran smoothly, enter
color-matcher -h
to the command line
Command Line Usage¶
From the root directory of your downloaded repo, you can run the tool on the provided test data by
color-matcher -s './tests/data/scotland_house.png' -r './tests/data/scotland_plain.png'
on a UNIX system where the result is found at ./tests/data/
. A windows equivalent of the above command is
color-matcher --src=".\\tests\\data\\scotland_house.png" --ref=".\\tests\\data\\scotland_plain.png"
Alternatively, you can specify the method or select your images manually with
color-matcher --win --method='hm-mkl-hm'
More information on optional arguments, can be found using the help parameter
color-matcher -h