Metadata-Version: 2.3
Name: roseus
Version: 1.1.0a1
Summary: Colormap family with full range of lightness
Project-URL: Homepage, https://github.com/dofuuz/roseus
Project-URL: Source, https://github.com/dofuuz/roseus
Author: KEUM Myungchul
License-File: LICENSE
Keywords: visualization
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.6
Provides-Extra: generate
Requires-Dist: colorspacious; extra == 'generate'
Requires-Dist: colour-science; extra == 'generate'
Requires-Dist: matplotlib; extra == 'generate'
Requires-Dist: numpy; extra == 'generate'
Requires-Dist: scipy; extra == 'generate'
Description-Content-Type: text/markdown

# Roseus colormap family

A perceptually uniform colormaps with **full range of lightness**.


## Preview

![roseus-bars](img/roseus-bars.png)

![audacity-roseus](img/audacity-roseus.png)


## Installation

```sh
pip install roseus
```

If installation fails, upgrade pip with python -m pip install --upgrade pip and try again.


## Usage

To use with matplotlib, import `roseus.mpl`.

```python
import matplotlib.pyplot as plt
import roseus.mpl as rs

plt.imshow(x, cmap=rs.roseus)
# or
plt.imshow(x, cmap='rs.roseus')
```

To prevent confusion in namespace, prefix `rs.` is added. (ex. `rs.arcus`, `rs.b`, `rs.gr`, ...)


## Motivation

All colormaps of the Roseus family has (almost) full range of lightness. They have excellent contrast which visualize data more clearly.

Roseus was developed for [Audacity](https://www.audacityteam.org/) spectrogram. More perceptually uniform colormaps are added and aim to be used in a wider range of fields.

Further readings about perceptually uniform colormaps:  
https://bids.github.io/colormap/  
https://cran.r-project.org/web/packages/viridis/vignettes/intro-to-viridis.html


## Look into the colormaps

To plot measures of a colormap in Roseus family,

```python
from roseus.util import plot_measures

plot_measures('roseus')
```

![viscm-roseus](img/viscm-roseus.png)  
Note: [viscm](https://github.com/matplotlib/viscm) used in measurements has been modified to target CAM16-UCS instead of CAM02-UCS.

![roseus-lch](img/roseus-lch.png)  
All colormaps has [smooth](https://en.wikipedia.org/wiki/Smoothness) chroma, hue transition.

![roseus-rgb](img/roseus-rgb.png)


## Changelog

#### v1.1
- Added more colormaps (r, b, cyanus, rbg, arcus, gr, rg, lavendula)
- Packed into Python package

#### v1.0
- The colormap is named 'Roseus'. (inspiration from [Viridis](https://sjmgarnier.github.io/viridis/))
- It was perceptually smooth, but wasn't perceptually uniform. Now it is.
- Roseus now targets CAM16-UCS color space instead of the obsolute CAM02-UCS.

#### [v0.1](https://github.com/dofuuz/roseus/releases/tag/v0.1.0)
- First release for Audacity spectrogram.
