Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jrwrigh/fluent_colormaps

Scientific colormaps for ANSYS Fluent
https://github.com/jrwrigh/fluent_colormaps

ansys-fluent colormaps common-colormaps fluent-colormaps

Last synced: 26 days ago
JSON representation

Scientific colormaps for ANSYS Fluent

Awesome Lists containing this project

README 

        
# fluent_colormaps

#### Working in ANSYS CFD Post or CFX? Check out [cfdpost_colormaps](https://github.com/u2berggeist/cfdpost_colormaps)!

[![Say Thanks!](https://img.shields.io/badge/Say-Thanks!-orange.svg?longCache=true&style=flat-square)](https://saythanks.io/to/u2berggeist)



## Why Colormaps?



Because rainbow is bad. 



To start, what are colormaps for? They're a visualization tool. They attempt to communicate a change in numerical value from a sample set by changing color. The "greater" the change in color, the greater the change in numerical value. 



The rainbow is a linear scale of light wavelengths. *However*, how humans perceive a rainbow scale is **not** linear. In fact, the correlation between the perceived color change in a rainbow colormap and the actual numerical change is quite poor.



There are several instances where professionals have made incorrect conclusions from rainbow-based visualizations. Doctors have been found to make better diagnoses by using alternate colormaps:



> In tests, diagnostic accuracy, as measured by the proportion of diseased areas identified, increased dramatically with the new color scheme. [Source](https://phys.org/news/2011-10-heart-disease-visualization-experts-simpler.html)



and climate scientists have misinterpreted their own data by using rainbow colormaps:



>  The same sub-tropical ‘front’ is apparent in rainbow, but far less clear in the sequential scheme.... [the sub-tropical 'front'] is a mirage, an artefact of the choice of colour scale. [Source](http://www.climate-lab-book.ac.uk/2016/why-rainbow-colour-scales-can-be-misleading/)



See [this article](https://matplotlib.org/users/colormaps.html) from matplotlib that details more about the issues in colormaps. In particular, compare the plots of perceptually uniform colormaps and the more common colormaps from the same page (the lower plot in particular). These are plotted based on perceived brightness, so linear is the goal. As you can see, rainbow and the like are quite poor.



![perceptually uniform colormaps](https://matplotlib.org/3.1.0/_images/sphx_glr_colormaps_008.png)



![more common colormaps](images/misc_colormaps_from_matplotlib.png)



**Bottom line: don't use rainbow. \#endrainbow**



## Ok, so what is this repository?



- Scheme script to load colormaps directly into Fluent using it's TUI

- Collection of "good" colormaps in the `.colormap` format

- Tools to translate raw colormap data into the `.colormap` file format



### Fluent Script:

This script allows users to use different color maps in ANSYS Fluent without having to enter then in manually or have them buried in a settings file. Simply import the script and access the functions within the TUI (see Usage).



The scheme script for importing the color maps to Fluent is taken from [this](http://willem.engen.nl/uni/fluent/documents/external/2004-UGM-Tips-Tricks.pdf) pdf presentation. It is also included in this repository for archival purposes.



### Colormap Collection:

The example colormaps are taken from [Kenneth Moreland's webpage](https://www.kennethmoreland.com/color-advice/) on color map advice* as well as other sources.



Examples of the different colormap options are in [`Examples.md`](./Examples.md) or [this imgur album](https://imgur.com/a/hL35KCY) (Note this is currently not a complete list). This is an axisymmetric CFD simulation with flow going right to left. Notice the differences in the appearance of turbulence.



### Colormap Creation Tools:

In `translation_tools`, there are python scripts that will help turn raw colormap data into `.colormap` files for use with the scheme script. A description of using the tools and the `.colormap` file format itself is given there.



## Usage:



In Fluent TUI:

```

> (load "rw_colormap.scm")

Loading ".\.\rw_colormap.scm"

Done.

#f

```

This will add `read-colormap` and `write-colormap` functions to the `/file` menu in the TUI:



```

> file/read-colormap "kindlmann_extended.colormap"

```



After you do that, the color map will be available for use.



### Make Fluent load colormaps automatically:



To do this, you simply need to edit/create the `.fluent` in your home directory (`~` for Linux, `C:\Users\[your account username]`). The `.fluent` file is loaded whenever you start Fluent. The file will look like this:



```scheme

(load "[Path to fluent_colormaps]/rw_colormap.scm")



(ti-menu-load-string "file/read-colormap [Path to fluent_colormaps]/colormaps/blackbody_extended.colormap")

(ti-menu-load-string "file/read-colormap [Path to fluent_colormaps]/colormaps/inferno.colormap")

```



The first line loads the read/write colormap commands while the last 3 load the "Extended Blackbody" and "Inferno" into Fluent. You can add in more of the colormaps simply by copy/pasting the line again.



#### Footnote:

\*Note that the "Extended Black Body" colormap used to be posted on Kenneth's website (though it is still available on [GitHub](https://github.com/kennethmoreland-com/kennethmoreland-com.github.io/tree/master/color-advice)). After discussion with Kenneth over email, it was dropped in favor of "Inferno" as they're both very similar to each other. 

"Inferno" is an interpolation over the [CIELAB colorspace](https://en.wikipedia.org/wiki/CIELAB_color_space) which is calibrated to correlate between the numerical change vs human-perceived change. "Extended Black Body" on the other hand is simply an interpolation between a few hues that is corrected for brightness (ie. not as rigorous). That said, "Extended Black Body" isn't bad, its just not as good as "Inferno", but is definitely better than rainbow!