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
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
|
{% extends "layout.html" %}
{% set title = 'Matplotlib: Python plotting' %}
{% block extrahead %}
<script>
function getSnippet(id, url) {
var req = false;
// For Safari, Firefox, and other non-MS browsers
if (window.XMLHttpRequest) {
try {
req = new XMLHttpRequest();
} catch (e) {
req = false;
}
} else if (window.ActiveXObject) {
// For Internet Explorer on Windows
try {
req = new ActiveXObject("Msxml2.XMLHTTP");
} catch (e) {
try {
req = new ActiveXObject("Microsoft.XMLHTTP");
} catch (e) {
req = false;
}
}
}
var element = document.getElementById(id);
if (req) {
// Synchronous request, wait till we have it all
req.open('GET', url, false);
req.send(null);
element.innerHTML = req.responseText;
}
}
</script>
{{ super() }}
{% endblock %}
{% block body %}
<h1>Introduction</h1>
<p>Matplotlib is a Python 2D plotting library which produces
publication quality figures in a variety of hardcopy formats and
interactive environments across platforms. Matplotlib can be used
in Python scripts, the Python and <a
href="http://ipython.org">IPython</a> shell,
the <a href="http://jupyter.org/index.html">jupyter</a> notebook,
web application servers, and four graphical user
interface toolkits.</p>
<div class="responsive_screenshots">
<a a href="{{ pathto('users/screenshots') }}">
<div class="responsive_subfig">
<img align="middle", src="{{ pathto('_static/membrane_frontpage.png', 1) }}", border="0", alt="screenshots"/>
</div>
<div class="responsive_subfig">
<img align="middle", src="{{ pathto('_static/histogram_frontpage.png', 1) }}", border="0", alt="screenshots"/>
</div>
<div class="responsive_subfig">
<img align="middle", src="{{ pathto('_static/contour_frontpage.png', 1) }}", border="0", alt="screenshots"/>
</div>
<div class="responsive_subfig">
<img align="middle", src="{{ pathto('_static/surface3d_frontpage.png', 1) }}", border="0", alt="screenshots"/>
</div>
</a>
</div>
<span class="clear_screenshots"></span>
<p>Matplotlib tries to make easy things easy and hard things possible.
You can generate plots, histograms, power spectra, bar charts,
errorcharts, scatterplots, etc., with just a few lines of code.
For a sampling, see the <a href="{{ pathto('users/screenshots') }}">screenshots</a>, <a href="{{ pathto('gallery') }}">thumbnail</a> gallery, and
<a href="{{ pathto('examples/index') }}">examples</a> directory</p>
<p>For simple plotting the <tt>pyplot</tt> module provides a
MATLAB-like interface, particularly when combined
with <tt>IPython</tt>. For the power user, you have full control
of line styles, font properties, axes properties, etc, via an object
oriented interface or via a set of functions familiar to MATLAB
users.</p>
<h1>Installation</h1>
Visit the <a href="{{ pathto('users/installing') }}">Matplotlib installation instructions</a>.
<h1>Documentation</h1>
This is the documentation for Matplotlib version {{ version }}.
<p id="other_versions"></p>
<script>
getSnippet('other_versions', '/versions.html');
</script>
<p>Trying to learn how to do a particular kind of plot? Check out
the <a href="{{ pathto('gallery') }}">gallery</a>, <a href="{{ pathto('examples/index') }}">examples</a>,
or the <a href="{{ pathto('api/pyplot_summary') }}">list of plotting
commands</a>.</p>
<h4>Other learning resources</h4>
<p>There are many <a href="{{ pathto('resources/index') }}">external learning
resources</a> available including printed material, videos and tutorials.</p>
<h4>Need help?</h4>
<p>Matplotlib is a welcoming, inclusive project, and we try to follow
the <a href="http://www.python.org/psf/codeofconduct/">Python Software
Foundation Code of Conduct</a> in everything we do.</p>
<p>Check the <a href="{{ pathto('faq/index') }}">faq</a>,
the <a href="{{ pathto('api/index') }}">api</a> docs and
<a href="http://matplotlib.1069221.n5.nabble.com/matplotlib-users-f3.html">mailing list archives</a> for resources.
Join the <a href="https://gitter.im/matplotlib/matplotlib">gitter</a> and the mailing lists: <a href="https://mail.python.org/mailman/listinfo/matplotlib-users">Users</a>,
<a href="https://mail.python.org/mailman/listinfo/matplotlib-announce">Announce</a> and
<a href="https://mail.python.org/mailman/listinfo/matplotlib-devel">Devel</a>.
Check out the Matplotlib questions
on <a href="http://stackoverflow.com/questions/tagged/matplotlib">stackoverflow</a>.
The <a href="{{ pathto('search') }}">search</a> tool searches all of
the documentation, including full text search of over 350 complete
examples which exercise almost every corner of Matplotlib.</p>
<p>You can file bugs, patches and feature requests on the
github
<a href="https://github.com/matplotlib/matplotlib/issues?sort=created&direction=desc&state=open">tracker</a>,
but it is a good idea to ping us on the mailing list too.</p>
<p>To keep up to date with what's going on in Matplotlib, see
the <a href="{{ pathto('users/whats_new.html', 1) }}">what's new
page</a> or browse the <a href="https://github.com/matplotlib/matplotlib">source
code</a>. Anything that could require changes to your existing code
is logged in the <a href="{{ pathto('api/api_changes.html', 1) }}">api
changes</a> file.</p>
<h1>Toolkits</h1>
<p>There are several Matplotlib add-on <a href="{{ pathto('mpl_toolkits/index') }}">toolkits</a>,
including a choice of two projection and mapping toolkits <a href="http://matplotlib.org/basemap">basemap</a> and
<a href="http://scitools.org.uk/cartopy/docs/latest">cartopy</a>,
3d plotting with <a href="{{ pathto('mpl_toolkits/mplot3d/index') }}">mplot3d</a>,
axes and axis helpers in <a href="{{ pathto('mpl_toolkits/axes_grid/index') }}">axes_grid</a>,
several higher-level plotting interfaces
<a href="https://seaborn.github.io/">seaborn</a>,
<a href="http://holoviews.org">holoviews</a>,
<a href="http://ggplot.yhathq.com">ggplot</a>, and more.
</p>
<h1>Citing Matplotlib</h1>
<p>
Matplotlib is the brainchild of John Hunter (1968-2012), who, along with its many
contributors, have put an immeasurable amount of time and effort into producing a
piece of software utilized by thousands of scientists worldwide.
If Matplotlib contributes to a project that leads to a scientific publication,
please acknowledge this work by citing the project. You can use this
<a href="{{ pathto('citing') }}">ready-made citation entry</a>.
</p>
<h1>Open source</h1>
<img src="_static/numfocus_badge.png" alt="A Fiscally Sponsored Project of NUMFocus"
style="float:right; margin-left:20px" />
<p>
Please
consider <a href="https://www.flipcause.com/widget/MjI1OA==">donating
to the Matplotlib project</a> through the Numfocus organization or to
the <a href="http://numfocus.org/johnhunter/">John Hunter Technology Fellowship</a>.
</p>
<p>
The Matplotlib <a href="{{ pathto('users/license') }}">license</a> is based on the Python Software Foundation
<a href="http://www.python.org/psf/license">(PSF)</a> license.
</p>
<p>
There is an active developer community and a long list of people
who have made significant <a href="{{ pathto('users/credits') }}">contributions</a>.
</p>
<p>
Matplotlib is hosted on <a href="https://github.com/matplotlib/matplotlib">Github</a>.
<a href="https://github.com/matplotlib/matplotlib/issues">Issues</a> and
<a href="https://github.com/matplotlib/matplotlib/pulls">Pull requests</a>
are tracked at Github too.
</p>
<div class="footnote"><p>
<sup><a name="ftn.matlab" href="#matlab">*</a></sup>
MATLAB is a registered trademark of The MathWorks, Inc.
</p>
{% endblock %}
|
