matplotlib.github.com/2.2.5/index.html at main · matplotlib/matplotlib.github.com

History

317 lines (293 loc) · 15.7 KB

Raw

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

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

227

228

229

230

231

232

233

234

235

236

237

238

239

240

241

242

243

244

245

246

247

248

249

250

251

252

253

254

255

256

257

258

259

260

261

262

263

264

265

266

267

268

269

270

271

272

273

274

275

276

277

278

279

280

281

282

283

284

285

286

287

288

289

290

291

292

293

294

295

296

297

298

299

300

301

302

303

304

305

306

307

308

309

310

311

312

313

314

315

316

317

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"

"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<head>

<title>Matplotlib: Python plotting — Matplotlib 2.2.5 documentation</title>

type="text/css" />

type="text/css" />

var DOCUMENTATION_OPTIONS = {

URL_ROOT: './',

VERSION: '2.2.5',

COLLAPSE_INDEX: false,

FILE_SUFFIX: '.html',

HAS_SOURCE: true,

SOURCELINK_SUFFIX: '.txt'

};

</script>

title="Search within Matplotlib 2.2.5 documentation"

href="_static/opensearch.xml"/>

</head>

<body>

<div id="unreleased-message"> You are reading an old version of the documentation (v2.2.5). For the latest version see <a href="https://matplotlib.org/stable/index.html">https://matplotlib.org/stable/index.html</a></div>

<div style="float: left; position: absolute; width: 496px; bottom: 0; padding-bottom: 24px"><span style="float: right; color: #789; background: white">Version 2.2.5</span></div>

<div id="forkongithub"><a href="https://github.com/matplotlib/matplotlib">Fork me on GitHub</a></div>

</div>

<h3>Navigation</h3>

<ul>

<a href="genindex.html" title="General Index"

accesskey="I">index</a></li>

<a href="py-modindex.html" title="Python Module Index"

>modules</a> |</li>

<li><a href="gallery/index.html">examples</a>| </li>

<li><a href="tutorials/index.html">tutorials</a>| </li>

<li><a href="api/pyplot_summary.html">pyplot</a>| </li>

</ul>

</div>

<h3>Quick search</h3>

</form>

</div>

<p>Python 2 support has been dropped on January 1, 2020.</p>

<p>The last Python 2 compatible release is 2.2.5.</p>

</div><div class="sidebar-versions">

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.querySelector(".sidebar-versions");

if (req) {

// Synchronous request, wait till we have it all

req.open('GET', url, false);

req.send(null);

if (req.status == 200) {

element.innerHTML = req.responseText;

} else {

element.innerHTML = "<mark>Could not find Snippet to insert at " + url + "</mark>"

}

getSnippet('other_versions', '/versions.html');

</script>

</div>

<a href="https://numfocus.org/donate-to-matplotlib" target="_blank"> <div class="donate_button" >Support Matplotlib</div></a>

</div>

<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 class="reference external" href="http://ipython.org">IPython</a>

shells, the <a class="reference external" href="http://jupyter.org">Jupyter</a> notebook, web application servers, and four graphical user

interface toolkits.</p>

<img align="middle" src="_images/sphx_glr_membrane_thumb.png"

border="0" alt="screenshots"/>

</div>

<img align="middle" src="_images/sphx_glr_histogram_thumb.png"

border="0" alt="screenshots"/>

</div>

<img align="middle" src="_images/sphx_glr_contour_thumb.png"

border="0" alt="screenshots"/>

</div>

<img align="middle" src="_images/sphx_glr_3D_thumb.png"

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 examples, see the

<a class="reference internal" href="tutorials/introductory/sample_plots.html"><span class="doc">sample plots</span></a> and <a class="reference internal" href="gallery/index.html"><span class="doc">thumbnail

gallery</span></a>.</p>

<p>For simple plotting the <code class="xref py py-obj docutils literal notranslate"><span class="pre">pyplot</span></code> module provides a MATLAB-like interface,

particularly when combined with IPython. 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<a class="headerlink" href="#installation" title="Permalink to this headline">¶</a></h1>

<p>Visit the <a class="reference internal" href="users/installing.html"><span class="doc">Matplotlib installation instructions</span></a>.</p>

</div>

<h1>Documentation<a class="headerlink" href="#documentation" title="Permalink to this headline">¶</a></h1>

<p>To get started, read the <a class="reference internal" href="users/index.html"><span class="doc">User's Guide</span></a>.</p>

<p>Trying to learn how to do a particular kind of plot? Check out the

<a class="reference internal" href="gallery/index.html"><span class="doc">examples gallery</span></a> or the <a class="reference internal" href="api/pyplot_summary.html"><span class="doc">list of plotting commands</span></a>.</p>

<h2>Other learning resources<a class="headerlink" href="#other-learning-resources" title="Permalink to this headline">¶</a></h2>

<p>There are many <a class="reference internal" href="resources/index.html"><span class="doc">external learning resources</span></a> available

including printed material, videos and tutorials.</p>

</div>

<h2>Join our community!<a class="headerlink" href="#join-our-community" title="Permalink to this headline">¶</a></h2>

<p>Matplotlib is a welcoming, inclusive project, and we try to follow the <a class="reference external" href="http://www.python.org/psf/codeofconduct/">Python

Software Foundation Code of Conduct</a> in everything we do.</p>

<p>Join our community at <a href="https://discourse.matplotlib.org">discourse.matplotlib.org</a>

to get help, discuss contributing & development, and share your work.</p>

</div>

<p>If you have questions, be sure to check the <a href="faq/index.html">FAQ</a>,

the <a href="api/index.html">API</a> docs. The full text

<a href="search.html">search</a> is a good way to discover the docs including the many examples.</p>

</div>

<p>Check out the Matplotlib tag on <a href="http://stackoverflow.com/questions/tagged/matplotlib">stackoverflow</a>.</p>

</div>

<p>Short questions may be posted on the <a href="https://gitter.im/matplotlib/matplotlib">gitter channel</a>.</p>

</div>

<p>To keep up to date with what's going on in Matplotlib, see the

<a href="users/whats_new.html">what's new</a> page 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="api/api_changes.html">API changes</a> file.</p>

</div>

<p>Tweet us at <a href="https://twitter.com/matplotlib">Twitter</a>!

or see cool plots on <a href="https://www.instagram.com/matplotart/">Instagram</a>!</p>

</div>

<h3>Development</h3>

<p>Matplotlib is hosted on <a href="https://github.com/matplotlib/matplotlib">GitHub</a>.</p>

<ul>

<li>File bugs and feature requests on the <a href="https://github.com/matplotlib/matplotlib/issues">issue tracker</a>.</li>

<li><a href="https://github.com/matplotlib/matplotlib/pulls">Pull requests</a> are always welcome.</li>

</ul>

<p>It is a good idea to ping us on <a href="https://discourse.matplotlib.org">Discourse</a> as well.</p>

</div>

<p>Mailing lists</p>

<ul>

<li><a href="https://mail.python.org/mailman/listinfo/matplotlib-users">matplotlib-users</a> for usage questions</li>

<li><a href="https://mail.python.org/mailman/listinfo/matplotlib-devel">matplotlib-devel</a> for development</li>

<li><a href="https://mail.python.org/mailman/listinfo/matplotlib-announce">matplotlib-announce</a> for project announcements</li>

</ul>

</div>

</div><div class="section" id="toolkits">

<h3>Toolkits<a class="headerlink" href="#toolkits" title="Permalink to this headline">¶</a></h3>

<p>Matplotlib ships with several add-on <a class="reference internal" href="api/toolkits/index.html"><span class="doc">toolkits</span></a>,

including 3d plotting with <code class="xref py py-obj docutils literal notranslate"><span class="pre">mplot3d</span></code>, axes helpers in <code class="xref py py-obj docutils literal notranslate"><span class="pre">axes_grid1</span></code> and axis

helpers in <code class="xref py py-obj docutils literal notranslate"><span class="pre">axisartist</span></code>.</p>

</div>

<h3>Third party packages<a class="headerlink" href="#third-party-packages" title="Permalink to this headline">¶</a></h3>

<p>A large number of <a class="reference internal" href="thirdpartypackages/index.html"><span class="doc">third party packages</span></a>

extend and build on Matplotlib functionality, including several higher-level

plotting interfaces (<a class="reference external" href="https://seaborn.github.io/">seaborn</a>, <a class="reference external" href="http://holoviews.org">holoviews</a>, <a class="reference external" href="http://ggplot.yhathq.com">ggplot</a>, ...), and two projection

and mapping toolkits (<a class="reference external" href="http://matplotlib.org/basemap">basemap</a> and <a class="reference external" href="http://scitools.org.uk/cartopy/docs/latest">cartopy</a>).</p>

</div>

<h3>Citing Matplotlib<a class="headerlink" href="#citing-matplotlib" title="Permalink to this headline">¶</a></h3>

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

<p>If Matplotlib contributes to a project that leads to a scientific publication,

please acknowledge this work by citing the project. A <a class="reference internal" href="citing.html"><span class="doc">ready-made citation

entry</span></a> is available.</p>

</div>

<h3>Open source<a class="headerlink" href="#open-source" title="Permalink to this headline">¶</a></h3>

<img src="_static/numfocus_badge.png"

alt="A Fiscally Sponsored Project of NUMFocus"

style="float:right; margin-left:20px" />

</a><p>Please consider <a class="reference external" href="https://www.flipcause.com/secure/cause_pdetails/MjI1OA==">donating to the Matplotlib project</a> through

the Numfocus organization or to the <a class="reference external" href="https://www.numfocus.org/programs/john-hunter-technology-fellowship/">John Hunter Technology Fellowship</a>.</p>

<p>The <a class="reference internal" href="users/license.html"><span class="doc">Matplotlib license</span></a> is based on the <a class="reference external" href="http://www.python.org/psf/license">Python Software

Foundation (PSF) license</a>.</p>

<p>There is an active developer community and a long list of people who have made

significant <a class="reference internal" href="users/credits.html"><span class="doc">contributions</span></a>.</p>

</div>

</div>

<br />

Last updated on Feb 09, 2020.

Created using

<ahref="http://sphinx-doc.org/">Sphinx</a> 1.8.5.

Doc version v2.2.5-2-ga847ffac5.

</div>

</body>

</footer>

</html>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

FilesExpand file tree

index.html

Latest commit

History

index.html

File metadata and controls