Merge pull request matplotlib#18578 from anntzer/axisartist_direction_demos

Merge all axisartist axis_direction demos together.

Author: jklymak

examples/axisartist/axis_direction.py

@@ -0,0 +1,67 @@
+"""
+==============
+Axis Direction
+==============
+"""
+
+import matplotlib.pyplot as plt
+import mpl_toolkits.axisartist as axisartist
+
+
+def setup_axes(fig, rect):
+    ax = fig.add_axes(axisartist.Subplot(fig, rect))
+
+    ax.set_ylim(-0.1, 1.5)
+    ax.set_yticks([0, 1])
+
+    ax.axis[:].set_visible(False)
+
+    ax.axis["x"] = ax.new_floating_axis(1, 0.5)
+    ax.axis["x"].set_axisline_style("->", size=1.5)
+
+    return ax
+
+
+plt.rcParams.update({
+    "axes.titlesize": "medium",
+    "axes.titley": 1.1,
+})
+
+fig = plt.figure(figsize=(10, 4))
+fig.subplots_adjust(bottom=0.1, top=0.9, left=0.05, right=0.95)
+
+ax1 = setup_axes(fig, 251)
+ax1.axis["x"].set_axis_direction("left")
+
+ax2 = setup_axes(fig, 252)
+ax2.axis["x"].label.set_text("Label")
+ax2.axis["x"].toggle(ticklabels=False)
+ax2.axis["x"].set_axislabel_direction("+")
+ax2.set_title("label direction=$+$")
+
+ax3 = setup_axes(fig, 253)
+ax3.axis["x"].label.set_text("Label")
+ax3.axis["x"].toggle(ticklabels=False)
+ax3.axis["x"].set_axislabel_direction("-")
+ax3.set_title("label direction=$-$")
+
+ax4 = setup_axes(fig, 254)
+ax4.axis["x"].set_ticklabel_direction("+")
+ax4.set_title("ticklabel direction=$+$")
+
+ax5 = setup_axes(fig, 255)
+ax5.axis["x"].set_ticklabel_direction("-")
+ax5.set_title("ticklabel direction=$-$")
+
+ax7 = setup_axes(fig, 257)
+ax7.axis["x"].label.set_text("rotation=10")
+ax7.axis["x"].label.set_rotation(10)
+ax7.axis["x"].toggle(ticklabels=False)
+
+ax8 = setup_axes(fig, 258)
+ax8.axis["x"].set_axislabel_direction("-")
+ax8.axis["x"].label.set_text("rotation=10")
+ax8.axis["x"].label.set_rotation(10)
+ax8.axis["x"].toggle(ticklabels=False)
+
+plt.show()

examples/axisartist/axis_direction_demo_step01.py

@@ -340,51 +340,26 @@
 
 You must understand some underlying concept of directions.
 
- 1. There is a reference direction which is defined as the direction
-    of the axis line with increasing coordinate.  For example, the
-    reference direction of the left x-axis is from bottom to top.
+- There is a reference direction which is defined as the direction
+  of the axis line with increasing coordinate.  For example, the
+  reference direction of the left x-axis is from bottom to top.
 
-    .. figure:: ../../gallery/axisartist/images/sphx_glr_axis_direction_demo_step01_001.png
-       :target: ../../gallery/axisartist/axis_direction_demo_step01.html
-       :align: center
-       :scale: 50
+  The direction, text angle, and alignments of the ticks, ticklabels and
+  axis-label is determined with respect to the reference direction
 
-       Axis Direction Demo - Step 01
+- *label_direction* and *ticklabel_direction* are either the right-hand side
+  (+) of the reference direction or the left-hand side (-).
 
-   The direction, text angle, and alignments of the ticks, ticklabels and
-   axis-label is determined with respect to the reference direction
+- ticks are by default drawn toward the opposite direction of the ticklabels.
 
- 2. *ticklabel_direction* is either the right-hand side (+) of the
-    reference direction or the left-hand side (-).
+- text rotation of ticklabels and label is determined in reference
+  to the *ticklabel_direction* or *label_direction*,
+  respectively. The rotation of ticklabels and label is anchored.
 
-    .. figure:: ../../gallery/axisartist/images/sphx_glr_axis_direction_demo_step02_001.png
-       :target: ../../gallery/axisartist/axis_direction_demo_step02.html
-       :align: center
-       :scale: 50
-
-       Axis Direction Demo - Step 02
-
- 3. same for the *label_direction*
-
-    .. figure:: ../../gallery/axisartist/images/sphx_glr_axis_direction_demo_step03_001.png
-       :target: ../../gallery/axisartist/axis_direction_demo_step03.html
-       :align: center
-       :scale: 50
-
-       Axis Direction Demo - Step 03
-
- 4. ticks are by default drawn toward the opposite direction of the ticklabels.
-
- 5. text rotation of ticklabels and label is determined in reference
-    to the *ticklabel_direction* or *label_direction*,
-    respectively. The rotation of ticklabels and label is anchored.
-
-    .. figure:: ../../gallery/axisartist/images/sphx_glr_axis_direction_demo_step04_001.png
-       :target: ../../gallery/axisartist/axis_direction_demo_step04.html
-       :align: center
-       :scale: 50
-
-       Axis Direction Demo - Step 04
+.. figure:: ../../gallery/axisartist/images/sphx_glr_axis_direction_001.png
+   :target: ../../gallery/axisartist/axis_direction.html
+   :align: center
+   :scale: 50
 
 On the other hand, there is a concept of "axis_direction". This is a
 default setting of above properties for each, "bottom", "left", "top",