The mplot3d toolkit#

Generating 3D plots using the mplot3d toolkit.

This tutorial showcases various 3D plots. Click on the figures to see each full gallery example with the code that generates the figures.

3D Axes (of class Axes3D) are created by passing the projection="3d" keyword argument to Figure.add_subplot:

import matplotlib.pyplot as plt
fig = plt.figure()
ax = fig.add_subplot(projection='3d')

Multiple 3D subplots can be added on the same figure, as for 2D subplots.

../../../_images/sphx_glr_subplot3d_001.png

Changed in version 3.2.0: Prior to Matplotlib 3.2.0, it was necessary to explicitly import the mpl_toolkits.mplot3d module to make the '3d' projection to Figure.add_subplot.

See the mplot3d FAQ for more information about the mplot3d toolkit.

Line plots#

See Axes3D.plot for API documentation.

../../../_images/sphx_glr_lines3d_001.png

Scatter plots#

See Axes3D.scatter for API documentation.

../../../_images/sphx_glr_scatter3d_001.png

Wireframe plots#

See Axes3D.plot_wireframe for API documentation.

../../../_images/sphx_glr_wire3d_001.png

Surface plots#

See Axes3D.plot_surface for API documentation.

../../../_images/sphx_glr_surface3d_001.png

Tri-Surface plots#

See Axes3D.plot_trisurf for API documentation.

../../../_images/sphx_glr_trisurf3d_001.png

Contour plots#

See Axes3D.contour for API documentation.

../../../_images/sphx_glr_contour3d_001.png

Filled contour plots#

See Axes3D.contourf for API documentation.

../../../_images/sphx_glr_contourf3d_001.png

New in version 1.1.0: The feature demoed in the second contourf3d example was enabled as a result of a bugfix for version 1.1.0.

Polygon plots#

See Axes3D.add_collection3d for API documentation.

../../../_images/sphx_glr_polys3d_001.png

Bar plots#

See Axes3D.bar for API documentation.

../../../_images/sphx_glr_bars3d_001.png

Quiver#

See Axes3D.quiver for API documentation.

../../../_images/sphx_glr_quiver3d_001.png

2D plots in 3D#

../../../_images/sphx_glr_2dcollections3d_001.png

Text#

See Axes3D.text for API documentation.

../../../_images/sphx_glr_text3d_001.png