.. redirect-from:: /tutorials/toolkits/mplot3d

.. _mplot3d:

=================== 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.

.. contents:: :backlinks: none

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.

.. figure:: /gallery/mplot3d/images/sphx_glr_subplot3d_001.png :target: /gallery/mplot3d/subplot3d.html :align: center

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

See the :ref:toolkit_mplot3d-faq for more information about the mplot3d toolkit.

.. _plot3d:

Line plots

See .Axes3D.plot for API documentation.

.. figure:: /gallery/mplot3d/images/sphx_glr_lines3d_001.png :target: /gallery/mplot3d/lines3d.html :align: center

.. _scatter3d:

Scatter plots

See .Axes3D.scatter for API documentation.

.. figure:: /gallery/mplot3d/images/sphx_glr_scatter3d_001.png :target: /gallery/mplot3d/scatter3d.html :align: center

.. _wireframe:

Wireframe plots

See .Axes3D.plot_wireframe for API documentation.

.. figure:: /gallery/mplot3d/images/sphx_glr_wire3d_001.png :target: /gallery/mplot3d/wire3d.html :align: center

.. _surface:

Surface plots

See .Axes3D.plot_surface for API documentation.

.. figure:: /gallery/mplot3d/images/sphx_glr_surface3d_001.png :target: /gallery/mplot3d/surface3d.html :align: center

.. _trisurface:

Tri-Surface plots

See .Axes3D.plot_trisurf for API documentation.

.. figure:: /gallery/mplot3d/images/sphx_glr_trisurf3d_001.png :target: /gallery/mplot3d/trisurf3d.html :align: center

.. _contour3d:

Contour plots

See .Axes3D.contour for API documentation.

.. figure:: /gallery/mplot3d/images/sphx_glr_contour3d_001.png :target: /gallery/mplot3d/contour3d.html :align: center

.. _contourf3d:

Filled contour plots

See .Axes3D.contourf for API documentation.

.. figure:: /gallery/mplot3d/images/sphx_glr_contourf3d_001.png :target: /gallery/mplot3d/contourf3d.html :align: center

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

.. _fillbetween3d:

Fill between 3D lines

See .Axes3D.fill_between for API documentation.

.. figure:: /gallery/mplot3d/images/sphx_glr_fillbetween3d_001.png :target: /gallery/mplot3d/fillbetween3d.html :align: center

.. versionadded:: 3.10

.. _polygon3d:

Polygon plots

See .Axes3D.add_collection3d for API documentation.

.. figure:: /gallery/mplot3d/images/sphx_glr_polys3d_001.png :target: /gallery/mplot3d/polys3d.html :align: center

.. _bar3d:

Bar plots

See .Axes3D.bar for API documentation.

.. figure:: /gallery/mplot3d/images/sphx_glr_bars3d_001.png :target: /gallery/mplot3d/bars3d.html :align: center

.. _quiver3d:

Quiver

See .Axes3D.quiver for API documentation.

.. figure:: /gallery/mplot3d/images/sphx_glr_quiver3d_001.png :target: /gallery/mplot3d/quiver3d.html :align: center

.. _2dcollections3d:

2D plots in 3D

.. figure:: /gallery/mplot3d/images/sphx_glr_2dcollections3d_001.png :target: /gallery/mplot3d/2dcollections3d.html :align: center

.. _text3d:

Text

See .Axes3D.text for API documentation.

.. figure:: /gallery/mplot3d/images/sphx_glr_text3d_001.png :target: /gallery/mplot3d/text3d.html :align: center