Merge pull request #731 from plotly/facet_grid

Facet grid FigureFactory

Author: Kully

CHANGELOG.md

@@ -2,6 +2,14 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## [2.0.10] - 2017-06-09
+### Added
+- The figure_factory can now create facet grids with `.create_facet_grid`. Check it out with:
+```
+import plotly.figure_factory as ff
+help(ff.create_facet_grid)
+```
+
 ## [2.0.9] - 2017-05-30
 ### Fixed
 - Fixes issue [https://github.com/plotly/plotly.py/issues/721](https://github.com/plotly/plotly.py/issues/721). There was an issue when running `import plotly` with old versions of the `decorator` package. We now require installations to use at least version `4.0.6` of the `decorator` package. See [https://github.com/micheles/decorator/blob/master/CHANGES.md](https://github.com/micheles/decorator/blob/master/CHANGES.md) for the `decorator` package changelog.

plotly/colors.py

@@ -4,6 +4,7 @@
 
 Functions that manipulate colors and arrays of colors.
 
+-----
 There are three basic types of color types: rgb, hex and tuple:
 
 rgb - An rgb color is a string of the form 'rgb(a,b,c)' where a, b and c are
@@ -16,6 +17,19 @@
 tuple - A tuple color is a 3-tuple of the form (a,b,c) where a, b and c are
 floats between 0 and 1 inclusive.
 
+-----
+Types of colormap:
+There are typically two main types of colormaps that exist: numerical and
+categorical colormaps.
+
+Numerical colormaps are used when a the coloring column being used takes a
+spectrum of values or numbers. Alternatively, a categorical colormap is used
+to assign a specific value in a color column to a specific color everytime it
+appears in the plot at hand. For instance, a column of strings in a dataframe
+would naturally use a categorical colormap. You can choose however to use a
+categorical colormap with a column of numbers. Be careful though, as if you
+have a large set of unique numbers in your column you'll get a lot of colors.
+
 """
 from __future__ import absolute_import
 

plotly/figure_factory/__init__.py

@@ -8,6 +8,7 @@
 from plotly.figure_factory._candlestick import create_candlestick
 from plotly.figure_factory._dendrogram import create_dendrogram
 from plotly.figure_factory._distplot import create_distplot
+from plotly.figure_factory._facet_grid import create_facet_grid
 from plotly.figure_factory._gantt import create_gantt
 from plotly.figure_factory._ohlc import create_ohlc
 from plotly.figure_factory._quiver import create_quiver