/cardiac_DTI_colormaps

Standardise colormaps tailored for cardiac diffusion tensor imaging

Primary LanguageMATLABGNU General Public License v3.0GPL-3.0

Colormaps for cardiac DTI

Introduction

This repository contains colormaps tailored for cardiac DTI. Please feel free to use them and also to commit your own suggestions. I am sure we as a community can considerably improve them.

This repository was created after coming across several articles showing the shortcomings of the colormap "jet", by far the most used colormap in MR, after grayscale:

jet colormap jet colormap

In short, we can divide colours stimulus in three dimensions:

  • The luminance
  • The saturation
  • The hue

Human vision is highly sensitive to luminance, and the 'jet' colour map has a non-monotonical luminance profile which affects human perception. Additionally, when displaying angles that wraparound, such as helix-angle, the colormap should also wrap to aid interpretation.

With this in mind here is a list of colourmaps for tensor orientation measures:

Tensor orientation

Helix-angle

helix-angle

Luminance encodes inclination. Hue encodes polarity of the angle. Angles wrap through black.

E2A

E2A

Luminance encodes inclination. Hue encodes polarity of the angle. Angles wrap through black.

Absolute E2A

absolute E2A

This maps does not wrap as it is showing absolute angles. It separates angles below and above 45 deg in different colours in order to visualise differences between diastole and systole conformations (below and above 45 deg respectively in healthy hearts).

E1 transverse angle

E1 transverse angle Luminance encodes inclination. Hue encodes polarity of the angle. Angles wrap through black.

Rotational invariants

Fractional anisotropy

Fractional anisotropy

Mean diffusivity

Mean diffusivity

Tensor mode

Tensor mode

Colormap data

The colormap data is located in the colormaps_data folder. Each colormap is a text ASCII file with a 256 x 3 RGB array.

There is also a MATLAB script that will go through the text files and creates PNGs of the colormaps in the colormaps_pngs folder.