matplotlib
diff --git a/‎doc/users/next_whats_new/3d_plot_aspects.rst
Copy file name to clipboardExpand all lines: doc/users/next_whats_new/3d_plot_aspects.rst
+7-3Lines changed: 7 additions & 3 deletions b/‎doc/users/next_whats_new/3d_plot_aspects.rst
Copy file name to clipboardExpand all lines: doc/users/next_whats_new/3d_plot_aspects.rst
+7-3Lines changed: 7 additions & 3 deletions
@@ -2,7 +2,9 @@ Set equal aspect ratio for 3D plots
 -----------------------------------
 
 Users can set the aspect ratio for the X, Y, Z axes of a 3D plot to be 'equal',
-'equalxy', 'equalxz', or 'equalyz' rather than the default of 'auto'.
+'equalxy', 'equalxz', or 'equalyz' rather than the default of 'auto'. Just like
+in case of 2D plots, either the data limits or the bounding box can be adjusted
+to achieve the desired aspect.
 
 .. plot::
     :include-source: true
@@ -26,7 +28,9 @@ Users can set the aspect ratio for the X, Y, Z axes of a 3D plot to be 'equal',
     # Set the aspect ratios
     for i, ax in enumerate(axs):
         ax.set_box_aspect((3, 4, 5))
-        ax.set_aspect(aspects[i])
-        ax.set_title("set_aspect('{aspects[i]}')")
+        ax.set_aspect(aspects[i], adjustable='datalim')
+        # Alternatively: ax.set_aspect(aspects[i], adjustable='box')
+        # which will modify the box aspect ratio instead of the data limits.
+        ax.set_title(f"set_aspect('{aspects[i]}')")
 
     plt.show()