chrys 3.1.2

A collection of color palettes for mapping and visualisation

chrys

A collection of color palettes for mapping and visualisation.

Demo

netbek.github.io/chrys

Node.js

Installation

npm install chrys

Usage

Generate a new palette as a subset of a given palette:

>>> const {VEGA_PALETTES, toDiscretePalette} = require('chrys');
>>> toDiscretePalette(VEGA_PALETTES['viridis'], 6);
['#46327f', '#375c8d', '#27808e', '#1fa187', '#4ac26d', '#9fda3a']

Generate a new palette as a subset of a palette from a given provider:

>>> const {VEGA_VIRIDIS, discretePalette} = require('chrys');
>>> discretePalette(VEGA_VIRIDIS, 6);
['#46327f', '#375c8d', '#27808e', '#1fa187', '#4ac26d', '#9fda3a']

Get the vendor library and palette names from a given name:

>>> const {VEGA_VIRIDIS, parsePaletteName} = require('chrys');
>>> parsePaletteName(VEGA_VIRIDIS);
{vendor: 'vega', palette: 'viridis'}

Sass

Installation

npm install chrys

Usage

@import 'node_modules/chrys/src/variables';

// Get the first color of the `bokeh-colorblind` palette, size 3
$palette-name: 'bokeh-colorblind';
$palette-size: 3;
$palette:      map-get(map-get($chrys-palettes, $palette-name), $palette-size);
$color:        nth($palette, 1);

div {
  background: $color;
}

Python

Installation

pip install chrys

Usage

Generate a new palette as a subset of a given palette:

>>> from chrys.palettes import VEGA_PALETTES, to_continuous_palette, to_discrete_palette
>>> to_discrete_palette(VEGA_PALETTES['viridis'], 6)
['#46327f', '#375c8d', '#27808e', '#1fa187', '#4ac26d', '#9fda3a']
>>> to_continuous_palette(VEGA_PALETTES['viridis'][256], 6)
['#440356', '#414587', '#2a788e', '#22a884', '#79d152', '#fbe724']

Generate a new palette as a subset of a palette from a given provider:

>>> from chrys.palettes import VEGA_VIRIDIS, continuous_palette, discrete_palette
>>> discrete_palette(VEGA_VIRIDIS, 6)
['#46327f', '#375c8d', '#27808e', '#1fa187', '#4ac26d', '#9fda3a']
>>> continuous_palette(VEGA_VIRIDIS, 6)
['#440356', '#414587', '#2a788e', '#22a884', '#79d152', '#fbe724']

Get the vendor library and palette names from a given name:

>>> from chrys.palettes import VEGA_VIRIDIS, parse_palette_name
>>> parse_palette_name(VEGA_VIRIDIS)
PaletteName(vendor='vega', palette='viridis')

Development

Install Node and Python dependencies:

./scripts/install.sh

Build palette data:

npm run build-data

Build JavaScript and Python distribution packages, Sass, CSS, Illustrator scripts:

npm run build-dist

Deploy documentation to GitHub Pages:

npm run deploy

Publish JavaScript and Python distribution packages:

npm publish

Credit

Palettes from:

• Bokeh (BSD 3-Clause)
• Vega (BSD 3-Clause)

License

Copyright (c) 2017 Hein Bekker. Licensed under the BSD 3-Clause License.