Skip to content

Python library to calculate CIEDE2000 color difference.

License

Notifications You must be signed in to change notification settings

shameempk/pyciede2000

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

About

Python implementation of CIEDE2000 color difference calculation based on this paper:

The CIEDE2000 Color-Difference Formula: Implementation Notes, Supplementary Test Data, and Mathematical Observations.

More info: http://www2.ece.rochester.edu/~gsharma/ciede2000/

Use this BibTeX to cite:

@article{Sharma2005TheObservations,
    title = {{The CIEDE2000 color-difference formula: Implementation notes, supplementary test data, and mathematical observations}},
    year = {2005},
    journal = {Color Research {\&} Application},
    author = {Sharma, Gaurav and Wu, Wencheng and Dalal, Edul N},
    number = {1},
    month = {2},
    pages = {21--30},
    volume = {30},
    publisher = {Wiley Subscription Services, Inc., A Wiley Company},
    url = {http://dx.doi.org/10.1002/col.20070},
    doi = {10.1002/col.20070},
    issn = {1520-6378},
    keywords = {CIE, CIE94, CIEDE2000, CIELAB, CMC, color-difference metrics}
}

Install

pip install pyciede2000

Usage

from pyciede2000 import ciede2000

res = ciede2000((50.0000,2.6772,-79.7751), (50.0000,0.0000,-82.7485))

print(res)

ciede2000 accepts two color values as tuples in Lab representation. Also supports optional keyword parameters for para-metric weighting factor k_L, k_C and k_H.

Output format

ciede2000() returns a dict with all significant fields in CIEDE2000 calculation.

res = {
	"a_1_dash": a_1_dash,
	"a_2_dash": a_2_dash,
	"C_1_dash": C_1_dash,
	"C_2_dash": C_2_dash,
	"h_1_dash": h_1_dash,
	"h_2_dash": h_2_dash,
	"h_bar_dash": h_bar_dash,
	"G": G,
	"T": T,
	"S_L": S_L,
	"S_H": S_H,
	"S_C": S_C,
	"R_T": R_T,
	"delta_E_00": delta_E_00
}

You might be only interested in the final delta value, delta_E_00.

print(res['delta_E_00'])

Releases

No releases published

Packages

No packages published

Languages