@@ -22,7 +22,7 @@ Installing an official release
22
22
Matplotlib and most of its dependencies all available as wheel packages for
23
23
OSX, windows and many linux distributions::
24
24
25
- pip install -U numpy scipy scikit-learn
25
+ pip install -U matplotlib
26
26
27
27
Third-party distributions of Matplotlib
28
28
=======================================
73
73
`32 bit <https://www.microsoft.com/en-us/download/details.aspx?id=5555>`__
74
74
for Python 3.4) redistributable packages need to be installed.
75
75
76
- Matplotlib depends on `Pillow <https://pypi.python.org/pypi/Pillow>`_
77
- for reading and saving JPEG, BMP, and TIFF image files.
78
- Matplotlib requires `MiKTeX <https://miktex.org/>`_ and
79
- `GhostScript <https://ghostscript.com/download/>`_ for rendering text
80
- with LaTeX.
81
- `FFmpeg <https://www.ffmpeg.org/>`_, `avconv <https://libav.org/>`_,
82
- `mencoder <http://www.mplayerhq.hu>`_, or
83
- `ImageMagick <http://www.imagemagick.org/script/index.php>`_ are required for the
84
- animation module.
85
76
86
77
The following backends should work out of the box: agg, tkagg, ps,
87
78
pdf and svg.
88
- For other backends you may need to install
89
- `pycairo <https://pypi.python.org/pypi/pycairo>`_,
90
- `PyQt4 <https://pypi.python.org/pypi/PyQt4>`_,
91
- `PyQt5 <https://pypi.python.org/pypi/PyQt5>`_,
92
- `PySide <https://pypi.python.org/pypi/PySide>`_,
93
- `wxPython <https://pypi.python.org/pypi/wxPython>`_,
94
- `PyGTK <https://pypi.python.org/pypi/PyGTK>`_,
95
- `Tornado <https://pypi.python.org/pypi/tornado>`_,
96
- or GhostScript.
97
-
98
79
TkAgg is probably the best backend for interactive use from the
99
80
standard Python shell or IPython. It is enabled as the default backend
100
81
for the official binaries. GTK3 is not supported on Windows.
@@ -115,6 +96,17 @@ To run the test suite:
115
96
<https://inkscape.org/>`_;
116
97
* run ``py.test path\\to\\tests\\directory``.
117
98
99
+ .. note::
100
+
101
+ The following backends work out of the box: Agg, TkAgg, ps, pdf and svg.
102
+ TkAgg is probably the best backend for interactive use from the standard
103
+ Python shell or from IPython and is enabled as default.
104
+
105
+ GTK3 is not supported on windows.
106
+
107
+ For support for other backend, LaTeX rendering, animation input/output and
108
+ larger selection of file format, you may need to install `additional
109
+ dependencies <_install_requirements>`.
118
110
119
111
120
112
.. _install_from_source:
@@ -176,24 +168,30 @@ Matplotlib requires a large number of dependencies:
176
168
* `pyparsing <https://pyparsing.wikispaces.com/>`__
177
169
* `libpng <http://www.libpng.org>`__ ( >= 1.2)
178
170
* `pytz <http://pytz.sourceforge.net/>`__
179
- * FreeType` (>= 2.3)
171
+ * FreeType (>= 2.3)
180
172
* `cycler <http://matplotlib.org/cycler/>`__ (>= 0.10.0)
181
173
* `six <https://pypi.python.org/pypi/six>`_
182
174
* `backports.functools_lru_cache <https://pypi.python.org/pypi/backports.functools_lru_cache>`_
183
175
(for Python 2.7 only)
184
176
* `subprocess32 <https://pypi.python.org/pypi/subprocess32/>`_ (for Python
185
- 2.7 only)
177
+ 2.7 only, on Linux and mac os X only )
186
178
187
179
Optionally, you can also install a number of packages to enables better user
188
180
interface toolkit. See :ref:`what-is-a-backend` for more details on the
189
181
optional Matplotlib backends and the capabilities they provide.
190
182
191
183
* :term:`tk` (>= 8.3, != 8.6.0 or 8.6.1): for the TkAgg backend;
192
- * :term:`pyqt` (>= 4.4): for the Qt4Agg backend;
184
+ * `PyQt4 <https://pypi.python.org/pypi/PyQt4>`_ (>= 4.4): for the Qt4Agg backend;
185
+ * `PyQt5 <https://pypi.python.org/pypi/PyQt5>`_: for the Qt5Agg backend;
193
186
* :term:`pygtk` (>= 2.4): for the GTK and the GTKAgg backend;
194
- * :term:`wxpython` (>= 2.8 or later): for the WX or WXAgg backend.
195
-
196
- For better support of animation output format and image file format, you can
187
+ * :term:`wxpython` (>= 2.8 or later): for the WX or WXAgg backend;
188
+ * `pycairo <https://pypi.python.org/pypi/pycairo>`_;
189
+ * `PySide <https://pypi.python.org/pypi/PySide>`_;
190
+ * `PyGTK <https://pypi.python.org/pypi/PyGTK>`_;
191
+ * `Tornado <https://pypi.python.org/pypi/tornado>`_: for the WebAgg backend.
192
+
193
+ For better support of animation output format and image file format, LaTeX,
194
+ etc you can
197
195
install the following:
198
196
199
197
* `ffmpeg <https://www.ffmpeg.org/>`__/`avconv
@@ -202,7 +200,9 @@ install the following:
202
200
* `ImageMagick <http://www.imagemagick.org/script/index.php>`__ (for saving
203
201
animated gifs);
204
202
* `Pillow <http://python-pillow.org/>`__ (for a larger selection of image
205
- file format).
203
+ file format: JPEG, BMP, and TIFF image files);
204
+ * `Latex <https://miktex.org/>`_ and `GhostScript <https://ghostscript.com/download/>`_
205
+ (for rendering text with LaTeX);
206
206
207
207
.. note::
208
208
@@ -212,6 +212,13 @@ install the following:
212
212
more smoothly if the libraries and headers are not in the expected
213
213
locations.
214
214
215
+ .. note::
216
+
217
+ The following libraries are shipped with Matplotlib:
218
+
219
+ - `Agg`: the antigrain C++ rendering engine;
220
+ - `qhull`: to compute Delaunay triangulation;
221
+ - `ttconv`: a true type font utility.
215
222
216
223
.. _build_linux:
217
224
0 commit comments