view_init docstring for primary view angles

scottshambaugh · web-flow · commit 534f20143a66 · 2022-08-10T11:36:20.000-06:00
diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -738,6 +738,21 @@ def view_init(self, elev=None, azim=None, roll=None, vertical_axis="z"):
 
         This can be used to rotate the axes programmatically.
 
+        To look normal to the primary planes, the following elevation and
+        azimuth angles can be used. A roll angle of 0, 90, 180, or 270 deg
+        will rotate these views while keeping the axes at right angles.
+
+        ==========   ====  ====
+        view plane   elev  azim
+        ==========   ====  ====
+        XY           90    -90
+        XZ           0     -90
+        YZ           0     0
+        -XY          -90   90
+        -XZ          0     90
+        -YZ          0     180
+        ==========   ====  ====
+
         Parameters
         ----------
         elev : float, default: None
