| Name | roseus JSON |
| Version |
2.0.0
JSON |
| download |
| home_page | None |
| Summary | Colormap family with full range of lightness |
| upload_time | 2024-06-23 09:21:43 |
| maintainer | None |
| docs_url | None |
| author | KEUM Myungchul |
| requires_python | >=3.6 |
| license | None |
| keywords |
visualization
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Roseus colormap family
A perceptually uniform colormaps with **full range of lightness**.
## Preview
## 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.arcus)
# or
plt.imshow(x, cmap='rs.arcus')
```
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,
```sh
pip install "roseus[generate]"
```
install additional dependency. Then,
```python
from roseus.util import plot_measures
plot_measures('roseus')
```
Note: [viscm](https://github.com/matplotlib/viscm) used in measurements has been modified to target CAM16-UCS instead of CAM02-UCS.
All colormaps has symmetric and [smooth](https://en.wikipedia.org/wiki/Smoothness) chroma, hue transition.
## Changelog
#### v2.0
- 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.
### OSS libraries used
#### viscm (MIT)
A tool for analyzing colormaps and creating new colormaps.
https://github.com/matplotlib/viscm
viscm is not used for generating the Roseus family. It's modified to target CAM16-UCS and included for analysis.
Raw data
{
"_id": null,
"home_page": null,
"name": "roseus",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "visualization",
"author": "KEUM Myungchul",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/0d/25/88ba8504aa5de8f4cbb314bf746d9bf8b6b526a69465de27b641653a24c7/roseus-2.0.0.tar.gz",
"platform": null,
"description": "# Roseus colormap family\n\nA perceptually uniform colormaps with **full range of lightness**.\n\n\n## Preview\n\n\n\n\n\n\n\n\n## Installation\n\n```sh\npip install roseus\n```\n\nIf installation fails, upgrade pip with `python -m pip install --upgrade pip` and try again.\n\n\n## Usage\n\nTo use with matplotlib, import `roseus.mpl`.\n\n```python\nimport matplotlib.pyplot as plt\nimport roseus.mpl as rs\n\nplt.imshow(x, cmap=rs.arcus)\n# or\nplt.imshow(x, cmap='rs.arcus')\n```\n\nTo prevent confusion in namespace, prefix `rs.` is added. (ex. `rs.arcus`, `rs.b`, `rs.gr`, ...)\n\n\n## Motivation\n\nAll colormaps of the Roseus family has (almost) full range of lightness. They have excellent contrast which visualize data more clearly.\n\nRoseus 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.\n\nFurther readings about perceptually uniform colormaps: \nhttps://bids.github.io/colormap/ \nhttps://cran.r-project.org/web/packages/viridis/vignettes/intro-to-viridis.html\n\n\n## Look into the colormaps\n\nTo plot measures of a colormap in Roseus family,\n```sh\npip install \"roseus[generate]\"\n```\ninstall additional dependency. Then,\n\n```python\nfrom roseus.util import plot_measures\n\nplot_measures('roseus')\n```\n\n \nNote: [viscm](https://github.com/matplotlib/viscm) used in measurements has been modified to target CAM16-UCS instead of CAM02-UCS.\n\n \nAll colormaps has symmetric and [smooth](https://en.wikipedia.org/wiki/Smoothness) chroma, hue transition.\n\n\n## Changelog\n\n#### v2.0\n- Added more colormaps (r, b, cyanus, rbg, arcus, gr, rg, lavendula)\n- Packed into Python package\n\n#### v1.0\n- The colormap is named 'Roseus'. (inspiration from [Viridis](https://sjmgarnier.github.io/viridis/))\n- It was perceptually smooth, but wasn't perceptually uniform. Now it is.\n- Roseus now targets CAM16-UCS color space instead of the obsolute CAM02-UCS.\n\n#### [v0.1](https://github.com/dofuuz/roseus/releases/tag/v0.1.0)\n- First release for Audacity spectrogram.\n\n\n### OSS libraries used\n\n#### viscm (MIT)\nA tool for analyzing colormaps and creating new colormaps. \nhttps://github.com/matplotlib/viscm\n\nviscm is not used for generating the Roseus family. It's modified to target CAM16-UCS and included for analysis.\n",
"bugtrack_url": null,
"license": null,
"summary": "Colormap family with full range of lightness",
"version": "2.0.0",
"project_urls": {
"Homepage": "https://github.com/dofuuz/roseus",
"Source": "https://github.com/dofuuz/roseus"
},
"split_keywords": [
"visualization"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5bd3cd7c063fd4520d811bc5bcffb71c9359629b9d56e96346f889c30e4df6a7",
"md5": "a436ee0b8f9673e86c3c35035a786703",
"sha256": "450d6693d47000770bba26ccc6ea0c8796c921009adceaa621e326e304dbea0f"
},
"downloads": -1,
"filename": "roseus-2.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a436ee0b8f9673e86c3c35035a786703",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 280786,
"upload_time": "2024-06-23T09:21:41",
"upload_time_iso_8601": "2024-06-23T09:21:41.149258Z",
"url": "https://files.pythonhosted.org/packages/5b/d3/cd7c063fd4520d811bc5bcffb71c9359629b9d56e96346f889c30e4df6a7/roseus-2.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0d2588ba8504aa5de8f4cbb314bf746d9bf8b6b526a69465de27b641653a24c7",
"md5": "f6f294f981f221cdea68f639ba80a648",
"sha256": "fdee23340c8aef263075ff28e63862e2f9ddeea20b06287cbad202fc4fdd0492"
},
"downloads": -1,
"filename": "roseus-2.0.0.tar.gz",
"has_sig": false,
"md5_digest": "f6f294f981f221cdea68f639ba80a648",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 275162,
"upload_time": "2024-06-23T09:21:43",
"upload_time_iso_8601": "2024-06-23T09:21:43.353276Z",
"url": "https://files.pythonhosted.org/packages/0d/25/88ba8504aa5de8f4cbb314bf746d9bf8b6b526a69465de27b641653a24c7/roseus-2.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-23 09:21:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "dofuuz",
"github_project": "roseus",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "roseus"
}
