1"""
2=================
3Demo Axes Divider
4=================
5
6Axes divider to calculate location of axes and
7create a divider for them using existing axes instances.
8"""
9import matplotlib.pyplot as plt
10
11
12def get_demo_image():
13    import numpy as np
14    from matplotlib.cbook import get_sample_data
15    f = get_sample_data("axes_grid/bivariate_normal.npy", asfileobj=False)
16    z = np.load(f)
17    # z is a numpy array of 15x15
18    return z, (-3, 4, -4, 3)
19
20
21def demo_simple_image(ax):
22    Z, extent = get_demo_image()
23
24    im = ax.imshow(Z, extent=extent, interpolation="nearest")
25    cb = plt.colorbar(im)
26    plt.setp(cb.ax.get_yticklabels(), visible=False)
27
28
29def demo_locatable_axes_hard(fig1):
30
31    from mpl_toolkits.axes_grid1 \
32        import SubplotDivider, LocatableAxes, Size
33
34    divider = SubplotDivider(fig1, 2, 2, 2, aspect=True)
35
36    # axes for image
37    ax = LocatableAxes(fig1, divider.get_position())
38
39    # axes for colorbar
40    ax_cb = LocatableAxes(fig1, divider.get_position())
41
42    h = [Size.AxesX(ax),  # main axes
43         Size.Fixed(0.05),  # padding, 0.1 inch
44         Size.Fixed(0.2),  # colorbar, 0.3 inch
45         ]
46
47    v = [Size.AxesY(ax)]
48
49    divider.set_horizontal(h)
50    divider.set_vertical(v)
51
52    ax.set_axes_locator(divider.new_locator(nx=0, ny=0))
53    ax_cb.set_axes_locator(divider.new_locator(nx=2, ny=0))
54
55    fig1.add_axes(ax)
56    fig1.add_axes(ax_cb)
57
58    ax_cb.axis["left"].toggle(all=False)
59    ax_cb.axis["right"].toggle(ticks=True)
60
61    Z, extent = get_demo_image()
62
63    im = ax.imshow(Z, extent=extent, interpolation="nearest")
64    plt.colorbar(im, cax=ax_cb)
65    plt.setp(ax_cb.get_yticklabels(), visible=False)
66
67
68def demo_locatable_axes_easy(ax):
69    from mpl_toolkits.axes_grid1 import make_axes_locatable
70
71    divider = make_axes_locatable(ax)
72
73    ax_cb = divider.new_horizontal(size="5%", pad=0.05)
74    fig1 = ax.get_figure()
75    fig1.add_axes(ax_cb)
76
77    Z, extent = get_demo_image()
78    im = ax.imshow(Z, extent=extent, interpolation="nearest")
79
80    plt.colorbar(im, cax=ax_cb)
81    ax_cb.yaxis.tick_right()
82    ax_cb.yaxis.set_tick_params(labelright=False)
83
84
85def demo_images_side_by_side(ax):
86    from mpl_toolkits.axes_grid1 import make_axes_locatable
87
88    divider = make_axes_locatable(ax)
89
90    Z, extent = get_demo_image()
91    ax2 = divider.new_horizontal(size="100%", pad=0.05)
92    fig1 = ax.get_figure()
93    fig1.add_axes(ax2)
94
95    ax.imshow(Z, extent=extent, interpolation="nearest")
96    ax2.imshow(Z, extent=extent, interpolation="nearest")
97    ax2.yaxis.set_tick_params(labelleft=False)
98
99
100def demo():
101
102    fig1 = plt.figure(1, (6, 6))
103    fig1.clf()
104
105    # PLOT 1
106    # simple image & colorbar
107    ax = fig1.add_subplot(2, 2, 1)
108    demo_simple_image(ax)
109
110    # PLOT 2
111    # image and colorbar whose location is adjusted in the drawing time.
112    # a hard way
113
114    demo_locatable_axes_hard(fig1)
115
116    # PLOT 3
117    # image and colorbar whose location is adjusted in the drawing time.
118    # a easy way
119
120    ax = fig1.add_subplot(2, 2, 3)
121    demo_locatable_axes_easy(ax)
122
123    # PLOT 4
124    # two images side by side with fixed padding.
125
126    ax = fig1.add_subplot(2, 2, 4)
127    demo_images_side_by_side(ax)
128
129    plt.draw()
130    plt.show()
131
132
133demo()
134