matplotlib-colorbar 0.3.2

Installation

Easiest way to install using pip:

$ pip install matplotlib-colorbar

For development installation from the git repository:

$ git clone git@github.com:ppinard/matplotlib-colorbar.git
$ pip install -e matplotlib-colorbar

Example

Here is an example how to add a color bar:

>>> import numpy as np
>>> import matplotlib.pyplot as plt
>>> import matplotlib.cbook as cbook
>>> from matplotlib_colorbar.colorbar import Colorbar
>>> plt.figure()
>>> data = np.array(plt.imread(cbook.get_sample_data('grace_hopper.png')))
>>> mappable = plt.imshow(data[...,0], cmap='viridis')
>>> colorbar = Colorbar(mappable, location='lower left')
>>> colorbar.set_ticks([0.0, 0.5, 1.0])
>>> plt.gca().add_artist(colorbar)
>>> plt.show()

matplotlibrc parameters

Here are parameters that can either be customized in the constructor of the Colorbar class or from the class properties:

• mappable: scalar mappable object which implements the methods get_cmap and get_array (default: None, the mappable can be specified later)

• label: label on top of the color bar (default: None, no label is shown)

• orientation: orientation, vertical or horizontal (default: vertical)

• length_fraction: length of the color bar as a fraction of the axes’s width (horizontal) or height (vertical) depending on the orientation (default: 0.2)

• width_fraction: width of the color bar as a fraction of the axes’s height (horizontal) or width (vertical) depending on the orientation (default: 0.02)

• location: a location code (same as legend) (default: upper right)

• pad: fraction of the font size (default: 0.2)

• border_pad: fraction of the font size (default: 0.1)

• sep: separation between color bar and label in points (default: 5)

• frameon: if True, will draw a box around the color bar (default: True)

• color: color for the tick text and label (default: k)

• box_color: color of the box (if frameon) (default: w)

• box_alpha: transparency of box (default: 1.0)

• font_properties: a matplotlib.font_manager.FontProperties instance, optional sets the font properties for the label text

• ticks: ticks location (default: minimal and maximal values)

• ticklabels: a list of tick labels (same length as ticks argument)

• ticklocation: location of the ticks (default: auto)

Some of these parameters can be set in the matplotlibrc file:

• colorbar.orientation

• colorbar.length_fraction

• colorbar.width_fraction

• colorbar.location

• colorbar.pad

• colorbar.border_pad

• colorbar.sep

• colorbar.frameon

• colorbar.color

• colorbar.box_color

• colorbar.box_alpha

• colorbar.ticklocation

License

License under the BSD License, compatible with matplotlib.

Copyright (c) 2015-2016 Philippe Pinard and collaborators