Merge pull request matplotlib#28568 from farquh/'tagging_mplot3d'

scottshambaugh · web-flow · commit 3c7bc4593b39 · 2024-10-15T19:35:45.000-06:00
added tags to mplot3d examples
diff --git a/galleries/examples/mplot3d/2dcollections3d.py b/galleries/examples/mplot3d/2dcollections3d.py
@@ -46,3 +46,9 @@
 ax.view_init(elev=20., azim=-35, roll=0)
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D, plot-type: scatter, plot-type: line,
+#    component: axes,
+#    level: intermediate
diff --git a/galleries/examples/mplot3d/3d_bars.py b/galleries/examples/mplot3d/3d_bars.py
@@ -31,3 +31,10 @@
 ax2.set_title('Not Shaded')
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    styling: texture,
+#    plot-type: bar,
+#    level: beginner
diff --git a/galleries/examples/mplot3d/bars3d.py b/galleries/examples/mplot3d/bars3d.py
@@ -40,3 +40,9 @@
 ax.set_yticks(yticks)
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D, plot-type: bar,
+#    styling: color,
+#    level: beginner
diff --git a/galleries/examples/mplot3d/box3d.py b/galleries/examples/mplot3d/box3d.py
@@ -76,3 +76,8 @@
 
 # Show Figure
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    level: intermediate
diff --git a/galleries/examples/mplot3d/contour3d.py b/galleries/examples/mplot3d/contour3d.py
@@ -18,3 +18,8 @@
 ax.contour(X, Y, Z, cmap=cm.coolwarm)  # Plot contour curves
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    level: beginner
diff --git a/galleries/examples/mplot3d/contour3d_2.py b/galleries/examples/mplot3d/contour3d_2.py
@@ -17,3 +17,8 @@
 ax.contour(X, Y, Z, extend3d=True, cmap=cm.coolwarm)
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    level: beginner
diff --git a/galleries/examples/mplot3d/contour3d_3.py b/galleries/examples/mplot3d/contour3d_3.py
@@ -29,3 +29,9 @@
        xlabel='X', ylabel='Y', zlabel='Z')
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    component: axes,
+#    level: intermediate
diff --git a/galleries/examples/mplot3d/contourf3d.py b/galleries/examples/mplot3d/contourf3d.py
@@ -20,3 +20,8 @@
 ax.contourf(X, Y, Z, cmap=cm.coolwarm)
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    level: beginner
diff --git a/galleries/examples/mplot3d/contourf3d_2.py b/galleries/examples/mplot3d/contourf3d_2.py
@@ -29,3 +29,9 @@
        xlabel='X', ylabel='Y', zlabel='Z')
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    component: axes,
+#    level: intermediate
diff --git a/galleries/examples/mplot3d/custom_shaded_3d_surface.py b/galleries/examples/mplot3d/custom_shaded_3d_surface.py
@@ -34,3 +34,9 @@
                        linewidth=0, antialiased=False, shade=False)
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    level: intermediate,
+#    domain: cartography
diff --git a/galleries/examples/mplot3d/errorbar3d.py b/galleries/examples/mplot3d/errorbar3d.py
@@ -27,3 +27,9 @@
 ax.set_zlabel("Z label")
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    component: error,
+#    level: beginner
diff --git a/galleries/examples/mplot3d/hist3d.py b/galleries/examples/mplot3d/hist3d.py
@@ -31,3 +31,9 @@
 ax.bar3d(xpos, ypos, zpos, dx, dy, dz, zsort='average')
 
 plt.show()
+
+
+# %%
+# .. tags::
+#    plot-type: 3D, plot-type: histogram,
+#    level: beginner
diff --git a/galleries/examples/mplot3d/imshow3d.py b/galleries/examples/mplot3d/imshow3d.py
@@ -86,3 +86,9 @@ def imshow3d(ax, array, value_direction='z', pos=0, norm=None, cmap=None):
 imshow3d(ax, data_zx, value_direction='y', pos=ny, cmap='plasma')
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    styling: colormap,
+#    level: advanced
diff --git a/galleries/examples/mplot3d/intersecting_planes.py b/galleries/examples/mplot3d/intersecting_planes.py
@@ -87,3 +87,9 @@ def figure_3D_array_slices(array, cmap=None):
 
 figure_3D_array_slices(r_square, cmap='viridis_r')
 plt.show()
+
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    level: advanced
diff --git a/galleries/examples/mplot3d/lines3d.py b/galleries/examples/mplot3d/lines3d.py
@@ -22,3 +22,8 @@
 ax.legend()
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    level: beginner
diff --git a/galleries/examples/mplot3d/lorenz_attractor.py b/galleries/examples/mplot3d/lorenz_attractor.py
@@ -59,3 +59,8 @@ def lorenz(xyz, *, s=10, r=28, b=2.667):
 ax.set_title("Lorenz Attractor")
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    level: intermediate
diff --git a/galleries/examples/mplot3d/mixed_subplots.py b/galleries/examples/mplot3d/mixed_subplots.py
@@ -44,3 +44,9 @@ def f(t):
 ax.set_zlim(-1, 1)
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    component: subplot,
+#    level: beginner
diff --git a/galleries/examples/mplot3d/offset.py b/galleries/examples/mplot3d/offset.py
@@ -29,3 +29,10 @@
 ax.set_zlim(0, 2)
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    component: label,
+#    interactivity: pan,
+#    level: beginner
diff --git a/galleries/examples/mplot3d/pathpatch3d.py b/galleries/examples/mplot3d/pathpatch3d.py
@@ -69,3 +69,9 @@ def text3d(ax, xyz, s, zdir="z", size=None, angle=0, usetex=False, **kwargs):
 ax.set_zlim(0, 10)
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    component: label,
+#    level: advanced
diff --git a/galleries/examples/mplot3d/polys3d.py b/galleries/examples/mplot3d/polys3d.py
@@ -33,3 +33,9 @@
 ax.set_aspect('equalxy')
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    styling: colormap,
+#    level: intermediate
diff --git a/galleries/examples/mplot3d/projections.py b/galleries/examples/mplot3d/projections.py
@@ -53,3 +53,10 @@
 axs[2].set_title("'persp'\nfocal_length = 0.2", fontsize=10)
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    styling: small-multiples,
+#    component: subplot,
+#    level: intermediate
diff --git a/galleries/examples/mplot3d/quiver3d.py b/galleries/examples/mplot3d/quiver3d.py
@@ -25,3 +25,8 @@
 ax.quiver(x, y, z, u, v, w, length=0.1, normalize=True)
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    level: beginner
diff --git a/galleries/examples/mplot3d/rotate_axes3d_sgskip.py b/galleries/examples/mplot3d/rotate_axes3d_sgskip.py
@@ -49,3 +49,10 @@
 
     plt.draw()
     plt.pause(.001)
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    component: animation,
+#    level: advanced,
+#    internal: high-bandwidth
diff --git a/galleries/examples/mplot3d/scatter3d.py b/galleries/examples/mplot3d/scatter3d.py
@@ -38,3 +38,8 @@ def randrange(n, vmin, vmax):
 ax.set_zlabel('Z Label')
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D, plot-type: scatter,
+#    level: beginner
diff --git a/galleries/examples/mplot3d/stem3d_demo.py b/galleries/examples/mplot3d/stem3d_demo.py
@@ -49,3 +49,8 @@
 ax.set(xlabel='x', ylabel='y', zlabel='z')
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D, plot-type: speciality,
+#    level: beginner
diff --git a/galleries/examples/mplot3d/subplot3d.py b/galleries/examples/mplot3d/subplot3d.py
@@ -43,3 +43,9 @@
 ax.plot_wireframe(X, Y, Z, rstride=10, cstride=10)
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    component: subplot,
+#    level: advanced
diff --git a/galleries/examples/mplot3d/surface3d.py b/galleries/examples/mplot3d/surface3d.py
@@ -53,3 +53,8 @@
 #    - `matplotlib.axis.Axis.set_major_locator`
 #    - `matplotlib.ticker.LinearLocator`
 #    - `matplotlib.ticker.StrMethodFormatter`
+#
+# .. tags::
+#    plot-type: 3D,
+#    styling: colormap,
+#    level: advanced
diff --git a/galleries/examples/mplot3d/surface3d_2.py b/galleries/examples/mplot3d/surface3d_2.py
@@ -26,3 +26,8 @@
 ax.set_aspect('equal')
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    level: beginner
diff --git a/galleries/examples/mplot3d/surface3d_3.py b/galleries/examples/mplot3d/surface3d_3.py
@@ -38,3 +38,9 @@
 ax.zaxis.set_major_locator(LinearLocator(6))
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    styling: color, styling: texture,
+#    level: intermediate
diff --git a/galleries/examples/mplot3d/surface3d_radial.py b/galleries/examples/mplot3d/surface3d_radial.py
@@ -35,3 +35,8 @@
 ax.set_zlabel(r'$V(\phi)$')
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D, plot-type: polar,
+#    level: beginner
diff --git a/galleries/examples/mplot3d/text3d.py b/galleries/examples/mplot3d/text3d.py
@@ -44,3 +44,9 @@
 ax.set_zlabel('Z axis')
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    component: annotation,
+#    level: beginner
diff --git a/galleries/examples/mplot3d/tricontour3d.py b/galleries/examples/mplot3d/tricontour3d.py
@@ -43,3 +43,8 @@
 ax.view_init(elev=45.)
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D, plot-type: specialty,
+#    level: intermediate
diff --git a/galleries/examples/mplot3d/tricontourf3d.py b/galleries/examples/mplot3d/tricontourf3d.py
@@ -44,3 +44,8 @@
 ax.view_init(elev=45.)
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D, plot-type: specialty,
+#    level: intermediate
diff --git a/galleries/examples/mplot3d/trisurf3d.py b/galleries/examples/mplot3d/trisurf3d.py
@@ -30,3 +30,8 @@
 ax.plot_trisurf(x, y, z, linewidth=0.2, antialiased=True)
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    level: intermediate
diff --git a/galleries/examples/mplot3d/trisurf3d_2.py b/galleries/examples/mplot3d/trisurf3d_2.py
@@ -77,3 +77,8 @@
 
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D, plot-type: specialty,
+#    level: intermediate
diff --git a/galleries/examples/mplot3d/view_planes_3d.py b/galleries/examples/mplot3d/view_planes_3d.py
@@ -55,3 +55,9 @@ def annotate_axes(ax, text, fontsize=18):
 axd['L'].set_axis_off()
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    component: axes, component: subplot,
+#    level: beginner
diff --git a/galleries/examples/mplot3d/voxels.py b/galleries/examples/mplot3d/voxels.py
@@ -32,3 +32,8 @@
 ax.voxels(voxelarray, facecolors=colors, edgecolor='k')
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    level: beginner
diff --git a/galleries/examples/mplot3d/voxels_numpy_logo.py b/galleries/examples/mplot3d/voxels_numpy_logo.py
@@ -45,3 +45,9 @@ def explode(data):
 ax.set_aspect('equal')
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    level: beginner,
+#    purpose: fun
diff --git a/galleries/examples/mplot3d/voxels_rgb.py b/galleries/examples/mplot3d/voxels_rgb.py
@@ -42,3 +42,8 @@ def midpoints(x):
 ax.set_aspect('equal')
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    styling: color
diff --git a/galleries/examples/mplot3d/voxels_torus.py b/galleries/examples/mplot3d/voxels_torus.py
@@ -44,3 +44,9 @@ def midpoints(x):
           linewidth=0.5)
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    styling: color,
+#    level: intermediate
diff --git a/galleries/examples/mplot3d/wire3d.py b/galleries/examples/mplot3d/wire3d.py
@@ -20,3 +20,8 @@
 ax.plot_wireframe(X, Y, Z, rstride=10, cstride=10)
 
 plt.show()
+
+# %%
+# .. tags::
+#    plot-type: 3D,
+#    level: beginner
diff --git a/galleries/examples/mplot3d/wire3d_animation_sgskip.py b/galleries/examples/mplot3d/wire3d_animation_sgskip.py
diff --git a/galleries/examples/mplot3d/wire3d_zero_stride.py b/galleries/examples/mplot3d/wire3d_zero_stride.py
