Skip to main content

Contributed colormaps

Project description

contrib_colormaps: User-contributed colormaps

Build Status Linux/MacOS Build Status Windows Build status
Latest dev release Github tag
Latest release Github release PyPI version contrib_colormaps version conda-forge version defaults version
Docs gh-pages site

What is it?

contrib_colormaps is a collection of user-contributed colormaps for use with Python plotting programs such as Bokeh, Matplotlib, HoloViews, and Datashader.

Installation

contrib_colormaps supports Python 2.7, 3.5, 3.6 and 3.7 on Linux, Windows, or Mac and can be installed with conda from the pyviz channel:

conda install -c pyviz contrib_colormaps

or with pip:

pip install contrib_colormaps

Contributing

To add a colormap, open a pull request on this repository adding the following files:

  1. comma-separated file of RGB values to the contrib_colormaps/colormaps directory. This file should look like:

    0, 0.20755, 0.97632
    0, 0.22113, 0.96201
    
  2. A Jupyter notebook in examples/colormaps meeting the following criteria:

    1. a name that matches the name of the csv e.g. for a new colormap called rainforest with a csv rainforest.csv there should be a corresponding rainforest.ipynb
    2. an explanation of the colormap - what is it? and when/why would someone use it?
    3. a swatch of the colormap - we recommend using our swatch function, but it's not required
    4. at least one example plot using the colormap - it can be exclusively Bokeh, Matplotlib, or Holoviews

    The notebook should be cleared of all outputs. To use the UI, click Cell -> All Outputs -> Clear

    Clear all outputs

    OR clear them automatically on commit using the predefined git hook. From within the cloned repository, run:

    git config core.hooksPath .githooks
    
  3. A pytest-mpl baseline image for tests. To create this image first install pytest-mpl:

    pip install pytest-mpl
    

    Then generate the figure from within the tests directory run:

    pytest --mpl-generate-path=baseline
    

    See examples/colormaps for more details.

Sample Pull Request

You can use this sample pull request as a model: #3

About PyViz

contrib_colormaps is part of the PyViz initiative for making Python-based visualization tools work well together. See pyviz.org.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

contrib_colormaps-0.0.1.tar.gz (32.0 kB view hashes)

Uploaded Source

Built Distribution

contrib_colormaps-0.0.1-py2.py3-none-any.whl (15.3 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page