Plotting docs (#13)

* update plotting gifs

* add gridplot functionality

* use new plots in gallery and readme

* change keyword for aggregate in scatter plot

* update docstrings

* add tests and example for gridplot

Author: Seth-Rothschild

README.rst

@@ -1,14 +1,14 @@
 Welcome to Henchman!
 =====================
-Henchman is a collection of free and `open source
+Henchman is a collection of `open source
 <LICENSE>`_ python
 utility functions for working in a jupyter notebook. With
 Henchman, you can rapidly prototype end-to-end data science
 workflows. You can explore data with
 ``henchman.diagnostics``, make interesting plots with
 ``henchman.plotting``, and do feature selection and machine
 learning with ``henchman.selection`` and 
-``henchman.learning``.
+``henchman.learning``. For more information, visit the henchman `documentation <henchman.featurelabs.com>`_.
 
 Why?
 ~~~~~~~
@@ -20,18 +20,20 @@ Henchman:
   analysis plots. With sliders and checkboxes, finding the
   right plot parameters is as easy as a single function call.
 
-.. image:: docs/_source/img/dynamic_piechart.gif
+.. image:: docs/_source/img/piechart.gif
    :width: 47%
    :height: 300px
-.. image:: docs/_source/img/dynamic_histogram.gif
+.. image:: docs/_source/img/histogram.gif
    :width: 47%
    :height: 300px
 
-- **Memorable API, Extensive documentation**: We have a heavy
-  emphasis on ease of use. That means all the functions are
-  sorted into one of 4 semantically named modules and names
-  should be easy to remember inside that module. On top of
-  that, every function has a docstring, an example and a documentation page.
+- **Memorable API, Extensive documentation**: We have a
+  heavy emphasis on ease of use. That means all the
+  functions are sorted into one of 4 semantically named
+  modules and names should be easy to remember inside that
+  module. On top of that, every function has a docstring, an
+  example and a `documentation <henchman.featurelabs.com>`_
+  page.
 
 .. image:: docs/_source/img/create_model_docs.png
    :width: 75%
@@ -62,7 +64,7 @@ To install Henchman, run this command in your terminal:
 
 .. code-block:: console
 
-    $ python -m pip install ft-henchman
+    $ python -m pip install fl-henchman
 
 This is the preferred method to install Henchman, as it will always install the most recent stable release.
 

docs/_source/documentation.rst

@@ -187,20 +187,19 @@ We can check :func:`feature importances
 
 .. _plotting:
 
-Plotting
-~~~~~~~~
-The plotting module gives a collection of useful
-dataset agnostic plots. There are *static* plots which which
-have tunable controls to give a good exportable, image and
-there are *dynamic* plots which are fun and useful for
-dataset exploration. We recommend importing the whole module
-at once using ``import henchman.plotting as hplot`` for easy
-access to all of the functions. The single exception might
-be :func:`henchman.plotting.show`, which is useful enough that you might consider
-importing it as itself.
+Plotting 
+~~~~~~~~~
+
+The plotting module gives a collection of useful dataset
+agnostic plots. Plots have the ability to be *dynamic* or
+*static*. We recommend importing the whole module at once
+using ``import henchman.plotting as hplot`` for easy access
+to all of the functions. The single exception might be
+:func:`henchman.plotting.show`, which is useful enough that
+you might consider importing it as itself.
 
 The :func:`show <henchman.plotting.show>` function has many parameters which can be hard
-to remember. Because of that, there's a :func:`templating function <henchman.plotting.show_template>` from which you can copy and paste the ones you want.
+to remember. Because of that, there's a :func:`templating function <henchman.plotting.show_template>` from which you can copy and paste the arguments you want.
 
 .. ipython:: python
 

docs/_source/img/dynamic_histogram.gif

@@ -1,6 +1,6 @@
 Welcome to Henchman!
 =====================
-Henchman is a collection of free and open source python
+Henchman is a collection of open source python
 utility functions for working in a jupyter notebook. With
 Henchman, you can rapidly prototype end-to-end data science
 workflows. You can explore data with
@@ -19,12 +19,16 @@ Henchman:
   analysis plots. With sliders and checkboxes, finding the
   right plot parameters is as easy as a single function call.
 
-.. image:: img/dynamic_piechart.gif
+.. image:: img/piechart.gif
    :width: 47%
-   :height: 300px
-.. image:: img/dynamic_histogram.gif
+   :height: 400px
+.. image:: img/histogram.gif
    :width: 47%
-   :height: 300px
+   :height: 400px
+
+.. image:: img/timeseries.gif
+   :height: 400px
+   :align: center
 
 - **Memorable API, Extensive documentation**: We have a heavy
   emphasis on ease of use. That means all the functions are
@@ -61,7 +65,7 @@ To install Henchman, run this command in your terminal:
 
 .. code-block:: console
 
-    $ python -m pip install ft-henchman
+    $ python -m pip install fl-henchman
 
 This is the preferred method to install Henchman, as it will always install the most recent stable release.