Implementde color appearance models, tests and documentation - Githubissues

gtaylor / python-colormath

A python module that abstracts common color math operations. For example, converting from CIE L*a*b to XYZ, or from RGB to CMYK

python-colormath.readthedocs.org

BSD 3-Clause "New" or "Revised" License

456 stars 83 forks source link

Implementde color appearance models, tests and documentation #40

Closed MichaelMauderer closed 10 years ago

MichaelMauderer commented 10 years ago

Notable new additions:

Added color_appearance_models module including the following models: Nayatani95, Hunt, RLAB, ATD95, LLAB, CIECAM02 and CIECAM02-m1
New section in the documentation giving a short introduction to color appearance models and describing the input parameters, the results and references for each model
Short example of how to use CIECAM02 in examples/color_appearance_models.py

Small but potentially important things:

I activated the sphinx.ext.mathjax add-on so I could use mathematical notation in the docs.
I added some legal mumbo jumbo to the new files. Same license as for the overall project, but attributed to me and my university.

A few words about testing:

the models are verified using independent calculations that can be found here: http://rit-mcsl.org/fairchild/CAM.html (under "Example Calculations and Functions") but not all corner cases might be covered (especially more advanced features of the Hunt model).
notable exception: CIECAM02-m1 is currently untested, as no independent data set exists (to my knowledge).

Any feedback is welcome. I am sure there are still plenty of things to do, but things are in a pretty good shape now so they can be reviewed for inclusion.

gtaylor commented 10 years ago

Very well done, we'll merge this in and see if anything turns up over the next little while.