Giter Club home page Giter Club logo

daltonize's Introduction

Daltonize

https://github.com/joergdietrich/daltonize/actions

Daltonize simulates the three types of dichromatic color blindness for images and matplotlib figures. Generalizing and omitting a lot of details these types are:

  • Deuteranopia: green weakness
  • Protanopia: red weakness
  • Tritanopia: blue weakness (extremely rare)

Daltonize can also adjust the color palette of an input image or matplotlib figure such that a color blind person can perceive the full information content. It can be used as a command line tool to convert pixel images but also as a Python module. If used as the latter, it provides an API to simulate and correct for color blindness in matplotlib figures.

This allows to create color blind friendly vector graphics suitable for publication.

Color vision deficiencies are in fact very complex and can differ in intensity from person to person. The algorithms used in here and in many other comparable software packages are based on often simplifying assumptions. Nicolas Burrus discussed these simplification and reviews daltonize and other software packages in a blog post.

Installation

pip install daltonize

Usage

As a command line tool:

$ daltonize.py -h
usage: daltonize.py [-h] [-s | -d] [-t {d,p,t}] [-g {2.4}] input_image output_image

positional arguments:
  input_image
  output_image

optional arguments:
  -h, --help            show this help message and exit
  -s, --simulate        create simulated image
  -d, --daltonize       adjust image color palette for color blindness
  -t {d,p,t}, --type {d,p,t}
                        type of color blindness (deuteranopia, protanopia,
                        tritanopia), default is deuteranopia (most common)
  -g --gamma {2.4}      exponent of the sRGB gamma correction. The default 
                        2.4 corresponds to an effective exponent of 2.2

As a Python module:

In [1]: from daltonize import daltonize

[ Create a figure ]

In [10]: sim_fig = daltonize.simulate_mpl(fig, copy=True)

In [11]: daltonized_fig = daltonize.daltonize_mpl(fig, copy=True)

Credits

Based on the work and original matlab code by Onur Fidaner, Poliang Lin, Nevran Ozguven. This can be found in 'doc/'.

Based on original Python code by Oliver Siemoneit.

Further information on color blindness and daltonization is available at many web resources, including http://www.daltonize.org/

Color blind friendly color maps can be found at http://colorbrewer2.org/ All of these are included in the python matplotlib and seaborn plotting libraries.

Example Images for Color Blindness

The directory 'example_images/' contains three example Ishihara plates to test for red-green deficiency. This table describes what people with normal, red/green deficient color vision, and total color blindness see on these plates:

Plate Normal r/g deficiency total color blindness
3 29 70 x
7 74 21 x
8 6 x x

You can verify the r/g deficiency column by running daltonize.py with the -s/--simulate option and -t/--type d or p on these images.

Normal

IshiharaPlate3

Deuteranopia

daltonize -s -t=d example_images/Ishihara_Plate_3.jpg example_images/Ishihara_Plate_3-Deuteranopia.jpg

IshiharaPlate3

Protanopia

daltonize -s -t=p example_images/Ishihara_Plate_3.jpg example_images/Ishihara_Plate_3-Protanopia.jpg

IshiharaPlate3

License

This code is released und the GNU GPL version 2. See COPYING for details.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.