From 9dc9f0caba22fcb925e4124376d9c72327b1ee9e Mon Sep 17 00:00:00 2001
From: Joris Van den Bossche <jorisvandenbossche@gmail.com>
Date: Mon, 23 Mar 2015 09:19:49 +0100
Subject: [PATCH] DOC: try to use matplotlib style (mpl >= 1.4) in all docs

---
 doc/source/10min.rst         |  8 +++++---
 doc/source/categorical.rst   |  1 -
 doc/source/computation.rst   |  6 +++++-
 doc/source/cookbook.rst      |  7 ++++++-
 doc/source/faq.rst           |  6 +++++-
 doc/source/groupby.rst       |  8 ++++++--
 doc/source/sparse.rst        |  4 ----
 doc/source/visualization.rst | 10 +++++++---
 8 files changed, 34 insertions(+), 16 deletions(-)

diff --git a/doc/source/10min.rst b/doc/source/10min.rst
index c98f41973e1ee..1f59c38d75f93 100644
--- a/doc/source/10min.rst
+++ b/doc/source/10min.rst
@@ -12,7 +12,11 @@
    from pandas import options
    import pandas as pd
    np.set_printoptions(precision=4, suppress=True)
-   options.display.mpl_style='default'
+   import matplotlib
+   try:
+      matplotlib.style.use('ggplot')
+   except AttributeError:
+      options.display.mpl_style = 'default'
    options.display.max_rows=15
 
    #### portions of this were borrowed from the
@@ -695,8 +699,6 @@ Plotting
 
    import matplotlib.pyplot as plt
    plt.close('all')
-   from pandas import options
-   options.display.mpl_style='default'
 
 .. ipython:: python
 
diff --git a/doc/source/categorical.rst b/doc/source/categorical.rst
index 7fe04af716cec..d03e0fb117c5c 100644
--- a/doc/source/categorical.rst
+++ b/doc/source/categorical.rst
@@ -13,7 +13,6 @@
    from pandas import *
    import pandas as pd
    np.set_printoptions(precision=4, suppress=True)
-   options.display.mpl_style='default'
    options.display.max_rows=15
 
 
diff --git a/doc/source/computation.rst b/doc/source/computation.rst
index 759675c51b960..4b0fe39d929a9 100644
--- a/doc/source/computation.rst
+++ b/doc/source/computation.rst
@@ -10,9 +10,13 @@
    import pandas.util.testing as tm
    randn = np.random.randn
    np.set_printoptions(precision=4, suppress=True)
+   import matplotlib
+   try:
+      matplotlib.style.use('ggplot')
+   except AttributeError:
+      options.display.mpl_style = 'default'
    import matplotlib.pyplot as plt
    plt.close('all')
-   options.display.mpl_style='default'
    options.display.max_rows=15
 
 Computational tools
diff --git a/doc/source/cookbook.rst b/doc/source/cookbook.rst
index 6a3751cf7a0b8..0e6386955a653 100644
--- a/doc/source/cookbook.rst
+++ b/doc/source/cookbook.rst
@@ -17,7 +17,12 @@
    np.random.seed(123456)
 
    pd.options.display.max_rows=15
-   pd.options.display.mpl_style='default'
+
+   import matplotlib
+   try:
+      matplotlib.style.use('ggplot')
+   except AttributeError:
+      pd.options.display.mpl_style = 'default'
 
    np.set_printoptions(precision=4, suppress=True)
 
diff --git a/doc/source/faq.rst b/doc/source/faq.rst
index de88b436198dd..467ec02b55f20 100644
--- a/doc/source/faq.rst
+++ b/doc/source/faq.rst
@@ -21,7 +21,11 @@ Frequently Asked Questions (FAQ)
    from pandas.tseries.offsets import *
    import matplotlib.pyplot as plt
    plt.close('all')
-   options.display.mpl_style='default'
+   import matplotlib
+   try:
+      matplotlib.style.use('ggplot')
+   except AttributeError:
+      options.display.mpl_style = 'default'
    from pandas.compat import lrange
 
 
diff --git a/doc/source/groupby.rst b/doc/source/groupby.rst
index db19e0de3d788..7ad2641dec52a 100644
--- a/doc/source/groupby.rst
+++ b/doc/source/groupby.rst
@@ -12,7 +12,11 @@
    np.set_printoptions(precision=4, suppress=True)
    import matplotlib.pyplot as plt
    plt.close('all')
-   options.display.mpl_style='default'
+   import matplotlib
+   try:
+      matplotlib.style.use('ggplot')
+   except AttributeError:
+      options.display.mpl_style = 'default'
    from pandas.compat import zip
 
 *****************************
@@ -346,7 +350,7 @@ A single group can be selected using ``GroupBy.get_group()``:
 .. ipython:: python
 
    grouped.get_group('bar')
-   
+
 Or for an object grouped on multiple columns:
 
 .. ipython:: python
diff --git a/doc/source/sparse.rst b/doc/source/sparse.rst
index e72ee6b709282..79def066f0710 100644
--- a/doc/source/sparse.rst
+++ b/doc/source/sparse.rst
@@ -10,9 +10,6 @@
    import pandas.util.testing as tm
    randn = np.random.randn
    np.set_printoptions(precision=4, suppress=True)
-   import matplotlib.pyplot as plt
-   plt.close('all')
-   options.display.mpl_style='default'
    options.display.max_rows = 15
 
 **********************
@@ -222,4 +219,3 @@ row and columns coordinates of the matrix. Note that this will consume a signifi
 
    ss_dense = SparseSeries.from_coo(A, dense_index=True)
    ss_dense
-
diff --git a/doc/source/visualization.rst b/doc/source/visualization.rst
index 852397c355361..9d4cba2e5ee8c 100644
--- a/doc/source/visualization.rst
+++ b/doc/source/visualization.rst
@@ -31,10 +31,14 @@ We use the standard convention for referencing the matplotlib API:
 
    import matplotlib.pyplot as plt
 
-.. versionadded:: 0.11.0
+The plots in this document are made using matplotlib's ``ggplot`` style (new in version 1.4):
 
-The plots in this document are made using matplotlib's ``ggplot`` style (new in version 1.4).
-If your version of matplotlib is 1.3 or lower, setting the ``display.mpl_style`` to ``'default'``
+.. code-block:: python
+
+   import matplotlib
+   matplotlib.style.use('ggplot')
+
+If your version of matplotlib is 1.3 or lower, you can set ``display.mpl_style`` to ``'default'``
 with ``pd.options.display.mpl_style = 'default'``
 to produce more appealing plots.
 When set, matplotlib's ``rcParams`` are changed (globally!) to nicer-looking settings.