matplotlib · WeatherGod · Jan 8, 2016 · Dec 26, 2015 · Dec 26, 2015 · Dec 26, 2015
diff --git a/doc/_templates/index.html b/doc/_templates/index.html
@@ -160,13 +160,21 @@ <h4>Need help?</h4>
 
 <h1>Toolkits</h1>
 
-<p>There are several matplotlib add-on <a href="{{ pathto('mpl_toolkits/index') }}">toolkits</a>,
-including a choice of two projection and mapping toolkits <a href="http://matplotlib.org/basemap">basemap</a> and
-<a href="http://scitools.org.uk/cartopy/docs/latest">cartopy</a>,
-3d plotting with <a href="{{ pathto('mpl_toolkits/mplot3d/index') }}">mplot3d</a>,
-axes and axis helpers in <a href="{{ pathto('mpl_toolkits/axes_grid/index') }}">axes_grid</a> and more.
+<p>Matplotlib ships with several add-on <a href="{{ pathto('mpl_toolkits/index') }}">toolkits</a>,
+    Including 3d plotting with <a href="{{ pathto('mpl_toolkits/mplot3d/index') }}">mplot3d</a>,
+    axes helpers in <a href="{{ pathto('mpl_toolkits/axes_grid1/index') }}">axes_grid1</a> and
+    axis helpers in <a href="{{ pathto('mpl_toolkits/axisartist/index') }}">axisartist</a>.
  </p>
 
+<h1>Third party packages</h1>
+
+<p>A large number of third party <a href="{{ pathto('mpl_toolkits/index') }}">packages</a>
+    extend and build on Matplotlib functionality,
+    including a choice of two projection and mapping toolkits
+    <a href="http://matplotlib.org/basemap">basemap</a> and
+    <a href="http://scitools.org.uk/cartopy/docs/latest">cartopy</a>.
+</p>
+
 <h1>Citing matplotlib</h1>
 
 <p>

diff --git a/doc/api/api_changes/2015-12-30-JHN.rst b/doc/api/api_changes/2015-12-30-JHN.rst
@@ -0,0 +1,7 @@
+`mpl_toolkits.axes_grid` has been deprecated
+````````````````````````````````````````````
+
+All functionallity from `mpl_toolkits.axes_grid` can be found in either 
+`mpl_toolkits.axes_grid1` or `mpl_toolkits.axisartist`. Axes classes from 
+`mpl_toolkits.axes_grid` based on `Axis` from `mpl_toolkits.axisartist` can be
+found in `mpl_toolkits.axisartist`
diff --git a/doc/conf.py b/doc/conf.py
@@ -135,7 +135,8 @@
     ('api', 'API'),
     ('pylab_examples', 'pylab examples'),
     ('mplot3d', 'mplot3d toolkit'),
-    ('axes_grid', 'axes_grid toolkit'),
+    ('axes_grid1', 'axes_grid1 toolkit'),
+    ('axisartist', 'axisartist toolkit'),
     ('units', 'units'),
     ('widgets', 'widgets'),
     )

diff --git a/doc/contents.rst b/doc/contents.rst
@@ -18,6 +18,7 @@ Overview
    users/index.rst
    faq/index.rst
    resources/index.rst
+   thirdpartypackages/index.rst
    devel/index.rst
    mpl_toolkits/index.rst
    api/index.rst

diff --git a/doc/make.py b/doc/make.py
@@ -149,7 +149,8 @@ def all():
 
 required_symlinks = [
     ('mpl_examples', '../examples/'),
-    ('mpl_toolkits/axes_grid/examples', '../../../examples/axes_grid/')
+    ('mpl_toolkits/axes_grid1/examples', '../../../examples/axes_grid1/'),
+    ('mpl_toolkits/axisartist/examples', '../../../examples/axisartist/')
     ]
 
 symlink_warnings = []

diff --git a/doc/mpl_toolkits/axes_grid/api/axes_divider_api.rst b/doc/mpl_toolkits/axes_grid/api/axes_divider_api.rst
diff --git a/doc/mpl_toolkits/axes_grid/api/axes_grid_api.rst b/doc/mpl_toolkits/axes_grid/api/axes_grid_api.rst
diff --git a/doc/mpl_toolkits/axes_grid/api/axes_size_api.rst b/doc/mpl_toolkits/axes_grid/api/axes_size_api.rst
diff --git a/doc/mpl_toolkits/axes_grid/api/axis_artist_api.rst b/doc/mpl_toolkits/axes_grid/api/axis_artist_api.rst
diff --git a/doc/mpl_toolkits/axes_grid/examples b/doc/mpl_toolkits/axes_grid/examples
diff --git a/doc/mpl_toolkits/axes_grid/index.rst b/doc/mpl_toolkits/axes_grid/index.rst
diff --git a/...ts/axes_grid/api/anchored_artists_api.rst → ...s/axes_grid1/api/anchored_artists_api.rst b/...ts/axes_grid/api/anchored_artists_api.rst → ...s/axes_grid1/api/anchored_artists_api.rst
diff --git a/doc/mpl_toolkits/axes_grid1/api/axes_divider_api.rst b/doc/mpl_toolkits/axes_grid1/api/axes_divider_api.rst
@@ -0,0 +1,18 @@
+
+:mod:`mpl_toolkits.axes_grid1.axes_divider`
+===========================================
+
+.. autoclass:: mpl_toolkits.axes_grid1.axes_divider.Divider
+   :members: 
+   :undoc-members:
+
+
+.. autoclass:: mpl_toolkits.axes_grid1.axes_divider.AxesLocator
+   :members: 
+   :undoc-members:
+
+.. autoclass:: mpl_toolkits.axes_grid1.axes_divider.SubplotDivider
+   :members: 
+
+.. autoclass:: mpl_toolkits.axes_grid1.axes_divider.AxesDivider
+   :members: 
diff --git a/doc/mpl_toolkits/axes_grid1/api/axes_grid_api.rst b/doc/mpl_toolkits/axes_grid1/api/axes_grid_api.rst
@@ -0,0 +1,11 @@
+
+:mod:`mpl_toolkits.axes_grid1.axes_grid`
+========================================
+
+.. autoclass:: mpl_toolkits.axes_grid1.axes_grid.Grid
+   :members:
+   :undoc-members:
+
+.. autoclass:: mpl_toolkits.axes_grid1.axes_grid.ImageGrid
+   :members:
+   :undoc-members:
diff --git a/doc/mpl_toolkits/axes_grid1/api/axes_size_api.rst b/doc/mpl_toolkits/axes_grid1/api/axes_size_api.rst
@@ -0,0 +1,5 @@
+:mod:`mpl_toolkits.axes_grid1.axes_size`
+========================================
+
+.. automodule:: mpl_toolkits.axes_grid1.axes_size
+   :members: Fixed, Scaled, AxesX, AxesY, MaxWidth, MaxHeight, Fraction, Padded, from_any
diff --git a/doc/mpl_toolkits/axes_grid/api/index.rst → doc/mpl_toolkits/axes_grid1/api/index.rst b/doc/mpl_toolkits/axes_grid/api/index.rst → doc/mpl_toolkits/axes_grid1/api/index.rst
@@ -1,28 +1,16 @@
-.. _axes_grid-api-index:
+.. _axes_grid1-api-index:
 
 #######################################
-  The Matplotlib AxesGrid Toolkit API
+  The Matplotlib axes_grid1 Toolkit API
 #######################################
 
 :Release: |version|
 :Date: |today|
 
 .. toctree::
 
+    anchored_artists_api.rst
     axes_size_api.rst
     axes_divider_api.rst
     axes_grid_api.rst
-    axis_artist_api.rst
-
-
-#######################################
-  The Matplotlib axes_grid1 Toolkit API
-#######################################
-
-:Release: |version|
-:Date: |today|
-
-.. toctree::
-
-    anchored_artists_api.rst
     inset_locator_api.rst
diff --git a/...lkits/axes_grid/api/inset_locator_api.rst → ...kits/axes_grid1/api/inset_locator_api.rst b/...lkits/axes_grid/api/inset_locator_api.rst → ...kits/axes_grid1/api/inset_locator_api.rst
diff --git a/doc/mpl_toolkits/axes_grid1/examples b/doc/mpl_toolkits/axes_grid1/examples
@@ -0,0 +1 @@
+../../../examples/axes_grid1/
diff --git a/...id/figures/demo_colorbar_of_inset_axes.py → ...d1/figures/demo_colorbar_of_inset_axes.py b/...id/figures/demo_colorbar_of_inset_axes.py → ...d1/figures/demo_colorbar_of_inset_axes.py
@@ -1,7 +1,7 @@
 import matplotlib.pyplot as plt
 
-from mpl_toolkits.axes_grid.inset_locator import inset_axes, zoomed_inset_axes
-from mpl_toolkits.axes_grid.colorbar import colorbar
+from mpl_toolkits.axes_grid1.inset_locator import inset_axes, zoomed_inset_axes
+from mpl_toolkits.axes_grid1.colorbar import colorbar
 
 def get_demo_image():
     from matplotlib.cbook import get_sample_data
@@ -46,4 +46,3 @@ def get_demo_image():
 
 plt.draw()
 plt.show()
-
diff --git a/...igures/demo_colorbar_with_axes_divider.py → ...igures/demo_colorbar_with_axes_divider.py b/...igures/demo_colorbar_with_axes_divider.py → ...igures/demo_colorbar_with_axes_divider.py
@@ -1,7 +1,7 @@
 import matplotlib.pyplot as plt
-from mpl_toolkits.axes_grid.axes_divider import make_axes_locatable
+from mpl_toolkits.axes_grid1.axes_divider import make_axes_locatable
 
-from mpl_toolkits.axes_grid.colorbar import colorbar
+from mpl_toolkits.axes_grid1.colorbar import colorbar
 # from matplotlib.pyplot import colorbar
 
 fig = plt.figure(1, figsize=(6, 3))
@@ -22,4 +22,3 @@
 cb2 = colorbar(im2, cax=cax2, orientation="horizontal")
 cax2.xaxis.set_ticks_position("top")
 plt.show()
-
diff --git a/...axes_grid/figures/demo_fixed_size_axes.py → ...xes_grid1/figures/demo_fixed_size_axes.py b/...axes_grid/figures/demo_fixed_size_axes.py → ...xes_grid1/figures/demo_fixed_size_axes.py
@@ -1,7 +1,6 @@
 import matplotlib.pyplot as plt
 
-from mpl_toolkits.axes_grid \
-     import Divider, LocatableAxes, Size
+from mpl_toolkits.axes_grid1 import Divider, LocatableAxes, Size
 
 def demo_fixed_size_axes():
 

diff --git a/...ts/axes_grid/figures/demo_new_colorbar.py → ...s/axes_grid1/figures/demo_new_colorbar.py b/...ts/axes_grid/figures/demo_new_colorbar.py → ...s/axes_grid1/figures/demo_new_colorbar.py
@@ -10,12 +10,11 @@
 cb1.ax.set_yticks([1, 3])
 ax1.set_title("Original MPL's colorbar w/\nset_yticks([1,3])", size=10)
 
-from mpl_toolkits.axes_grid.colorbar import colorbar
+from mpl_toolkits.axes_grid1.colorbar import colorbar
 ax2 = fig.add_subplot(122)
 im2 = ax2.imshow([[1,2],[3,4]])
 cb2 = colorbar(im2)
 cb2.ax.set_yticks([1, 3])
 ax2.set_title("AxesGrid's colorbar w/\nset_yticks([1,3])", size=10)
 
 plt.show()
-
diff --git a/...kits/axes_grid/figures/parasite_simple.py → ...its/axes_grid1/figures/parasite_simple.py b/...kits/axes_grid/figures/parasite_simple.py → ...its/axes_grid1/figures/parasite_simple.py
diff --git a/...axes_grid/figures/simple_axes_divider1.py → ...xes_grid1/figures/simple_axes_divider1.py b/...axes_grid/figures/simple_axes_divider1.py → ...xes_grid1/figures/simple_axes_divider1.py
@@ -1,12 +1,12 @@
-from mpl_toolkits.axes_grid import Size, Divider
+from mpl_toolkits.axes_grid1 import Size, Divider
 import matplotlib.pyplot as plt
 
 
 fig1 = plt.figure(1, (6, 6))
 
 # fixed size in inch
 horiz = [Size.Fixed(1.), Size.Fixed(.5), Size.Fixed(1.5),
-         Size.Fixed(.5)] 
+         Size.Fixed(.5)]
 vert = [Size.Fixed(1.5), Size.Fixed(.5), Size.Fixed(1.)]
 
 rect = (0.1, 0.1, 0.8, 0.8)
@@ -25,6 +25,5 @@
 ax4.set_axes_locator(divider.new_locator(nx=2, nx1=4, ny=0))
 
 
-
 plt.draw()
 plt.show()
diff --git a/...axes_grid/figures/simple_axes_divider2.py → ...xes_grid1/figures/simple_axes_divider2.py b/...axes_grid/figures/simple_axes_divider2.py → ...xes_grid1/figures/simple_axes_divider2.py
@@ -1,5 +1,5 @@
-import mpl_toolkits.axes_grid.axes_size as Size
-from mpl_toolkits.axes_grid import Divider
+import mpl_toolkits.axes_grid1.axes_size as Size
+from mpl_toolkits.axes_grid1 import Divider
 import matplotlib.pyplot as plt
 
 fig1 = plt.figure(1, (5.5, 4.))

diff --git a/...axes_grid/figures/simple_axes_divider3.py → ...xes_grid1/figures/simple_axes_divider3.py b/...axes_grid/figures/simple_axes_divider3.py → ...xes_grid1/figures/simple_axes_divider3.py
@@ -1,5 +1,5 @@
-import mpl_toolkits.axes_grid.axes_size as Size
-from mpl_toolkits.axes_grid import Divider
+import mpl_toolkits.axes_grid1.axes_size as Size
+from mpl_toolkits.axes_grid1 import Divider
 import matplotlib.pyplot as plt
 
 

diff --git a/...kits/axes_grid/figures/simple_colorbar.py → ...its/axes_grid1/figures/simple_colorbar.py b/...kits/axes_grid/figures/simple_colorbar.py → ...its/axes_grid1/figures/simple_colorbar.py
diff --git a/..._toolkits/axes_grid/figures/simple_rgb.py → ...toolkits/axes_grid1/figures/simple_rgb.py b/..._toolkits/axes_grid/figures/simple_rgb.py → ...toolkits/axes_grid1/figures/simple_rgb.py
diff --git a/doc/mpl_toolkits/axes_grid1/index.rst b/doc/mpl_toolkits/axes_grid1/index.rst
@@ -0,0 +1,29 @@
+
+.. _toolkit_axesgrid1-index:
+
+Matplotlib axes_grid1 Toolkit
+=============================
+
+The matplotlib :class:`mpl_toolkits.axes_grid1` toolkit is a collection of
+helper classes to ease displaying multiple images in matplotlib.  While the
+aspect parameter in matplotlib adjust the position of the single axes,
+axesgrid1 toolkit provides a framework to adjust the position of
+multiple axes according to their aspects.
+
+
+.. image:: ../../_static/demo_axes_grid.png
+
+.. note::
+   AxesGrid toolkit has been a part of matplotlib since v
+   0.99. Originally, the toolkit had a single namespace of
+   *axes_grid*. In more recent version, the toolkit
+   has divided into two separate namespace (*axes_grid1* and *axisartist*).
+   While *axes_grid* namespace is maintained for the backward compatibility,
+   use of *axes_grid1* and *axisartist* is recommended.
+
+.. toctree::
+   :maxdepth: 2
+
+   overview.rst
+   users/index.rst
+   api/index.rst