

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