GenAI Hackathon Project March 2025
HueHarmonics is a personalized and web-based application designed to help individuals with color vision deficiency see digital images more clearly.
For the completed final version of our HueHarmonics web app, please download the my_project.zip, and run app.py after extract the zip file in local. Then, click on the IP link displayed in your console, and it will take you to the webpage of our app.
What does HueHarmonics do:
-
Takes a D-15 Color Vision Test Users take an Farnsworth D-15 color vision test. Based on their arrangement of colored tiles, we calculate 3 metrics: confusion angle, confusion index, and total error score — which together define their unique type and severity of color blindness.
-
Stores Personalized Vision Data These results are automatically stored and used to build a custom color vision profile for each user — no manual input required!
-
Image Upload & Real-Time Adjustment Users can then upload any image. Our backend uses the test results to automatically adjust the image's colors by shifting hues and enhancing contrasts in directions the user can better perceive.
-
The adjusted image will be shown right away, helping users experience more vibrant and accurate colors!
What is a Farnsworth D15 Color Blind Test: Farnsworth D-15 test is a color blindness test that uses a set of colored tiles. When taking the test, people have to arrange these colored tiles in the correct order based on their perception of different colors. Colorblind people will have difficulties in arranging the given colors and make mistakes. Based on these mistakes and the resulting confusion vector(including confusion angle, confusion index, and total error score), the type of color blindness and its severity can be calculated.
References:
[1] 234 Birds, "Title of the Page or Image," 234 Birds, [Online]. Available: https://234birds.org/. Accessed: Mar. 22, 2025.
[2] Farnsworth D. The Farnsworth Dichotomous Test for Color Blindness Panel D-15 Manual. New York, The Psychological Corp., 1947, pp. 1-8. [Online]. Available: https://www.sciencedirect.com/science/article/abs/pii/0002939466916734. Accessed: Mar. 22, 2025.
[3] G. M. Marmor and M. R. Holder, "Color Vision," in StatPearls, StatPearls Publishing, Treasure Island (FL), 2024. [Online]. Available: https://www.ncbi.nlm.nih.gov/books/NBK217816/
[4] J. M. Barbur, "Understanding colour vision deficiency," The British Journal of Ophthalmology, vol. 88, no. 8, pp. 986–995, Aug. 2004. [Online]. Available: https://www.ncbi.nlm.nih.gov/pmc/articles/PMC4014780/