1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
|
.. _toolkit_mplot3d-index:
.. currentmodule:: mpl_toolkits.mplot3d
************************
``mpl_toolkits.mplot3d``
************************
The mplot3d toolkit adds simple 3D plotting capabilities (scatter, surface,
line, mesh, etc.) to Matplotlib by supplying an Axes object that can create
a 2D projection of a 3D scene. The resulting graph will have the same look
and feel as regular 2D plots. Not the fastest or most feature complete 3D
library out there, but it ships with Matplotlib and thus may be a lighter
weight solution for some use cases.
See the :ref:`mplot3d tutorial <mplot3d>` for
more information.
.. image:: /_static/demo_mplot3d.png
:align: center
The interactive backends also provide the ability to rotate and zoom the 3D
scene. One can rotate the 3D scene by simply clicking-and-dragging the scene.
Panning is done by clicking the middle mouse button, and zooming is done by
right-clicking the scene and dragging the mouse up and down. Unlike 2D plots,
the toolbar pan and zoom buttons are not used.
.. toctree::
:maxdepth: 2
mplot3d/faq.rst
mplot3d/view_angles.rst
mplot3d/axes3d.rst
.. note::
`.pyplot` cannot be used to add content to 3D plots, because its function
signatures are strictly 2D and cannot handle the additional information
needed for 3D. Instead, use the explicit API by calling the respective
methods on the `.Axes3D` object.
.. automodule:: mpl_toolkits.mplot3d
:no-members:
:no-undoc-members:
.. module:: mpl_toolkits.mplot3d.axes3d
.. currentmodule:: mpl_toolkits.mplot3d
:mod:`~mpl_toolkits.mplot3d.axes3d`
===================================
.. note::
3D plotting in Matplotlib is still not as mature as the 2D case.
Please report any functions that do not behave as expected as a bug.
In addition, help and patches would be greatly appreciated!
`axes3d.Axes3D` (fig[, rect, elev, azim, roll, ...]) 3D Axes object.
.. module:: mpl_toolkits.mplot3d.axis3d
.. currentmodule:: mpl_toolkits.mplot3d
:mod:`~mpl_toolkits.mplot3d.axis3d`
===================================
.. note::
See :attr:`mpl_toolkits.mplot3d.axis3d._axinfo` for a dictionary containing
constants that may be modified for controlling the look and feel
of mplot3d axes (e.g., label spacing, font colors and panel colors).
Historically, axis3d has suffered from having hard-coded constants
that precluded user adjustments, and this dictionary was implemented
in version 1.1 as a stop-gap measure.
.. autosummary::
:toctree: ../_as_gen
:template: autosummary.rst
axis3d.Axis
.. module:: mpl_toolkits.mplot3d.art3d
.. currentmodule:: mpl_toolkits.mplot3d
:mod:`~mpl_toolkits.mplot3d.art3d`
==================================
.. autosummary::
:toctree: ../_as_gen
:template: autosummary.rst
art3d.Line3D
art3d.Line3DCollection
art3d.Patch3D
art3d.Patch3DCollection
art3d.Path3DCollection
art3d.PathPatch3D
art3d.Poly3DCollection
art3d.Text3D
art3d.get_dir_vector
art3d.juggle_axes
art3d.line_2d_to_3d
art3d.line_collection_2d_to_3d
art3d.patch_2d_to_3d
art3d.patch_collection_2d_to_3d
art3d.pathpatch_2d_to_3d
art3d.poly_collection_2d_to_3d
art3d.rotate_axes
art3d.text_2d_to_3d
.. module:: mpl_toolkits.mplot3d.proj3d
.. currentmodule:: mpl_toolkits.mplot3d
:mod:`~mpl_toolkits.mplot3d.proj3d`
===================================
.. autosummary::
:toctree: ../_as_gen
:template: autosummary.rst
proj3d.inv_transform
proj3d.proj_transform
proj3d.proj_transform_clip
proj3d.world_transformation
|
