matplotlib.github.com/1.4.2/faq/troubleshooting_faq.html at main · matplotlib/matplotlib.github.com · GitHub

History

309 lines (284 loc) · 17 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

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

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

<head>

<title>Troubleshooting — Matplotlib 1.4.2 documentation</title>

type="text/css" />

type="text/css" />

var DOCUMENTATION_OPTIONS = {

URL_ROOT: '../',

VERSION: '1.4.2',

COLLAPSE_INDEX: false,

FILE_SUFFIX: '.html',

HAS_SOURCE: true

};

</script>

title="Search within Matplotlib 1.4.2 documentation"

href="../_static/opensearch.xml"/>

</head>

<body>

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

</map>

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

<a href="environment_variables_faq.html" title="Environment Variables"

accesskey="N">next</a> |</li>

<a href="howto_faq.html" title="How-To"

accesskey="P">previous</a> |</li>

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

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

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

<li><a href="index.html" accesskey="U">The Matplotlib FAQ</a> »</li>

</ul>

</div>

<h3><a href="../contents.html">Table Of Contents</a></h3>

<ul>

<li><a class="reference internal" href="#">Troubleshooting</a><ul>

<li><a class="reference internal" href="#obtaining-matplotlib-version">Obtaining matplotlib version</a></li>

<li><a class="reference internal" href="#matplotlib-install-location"><code class="file docutils literal"><span class="pre">matplotlib</span></code> install location</a></li>

<li><a class="reference internal" href="#matplotlib-directory-location"><code class="file docutils literal"><span class="pre">.matplotlib</span></code> directory location</a></li>

<li><a class="reference internal" href="#getting-help">Getting help</a></li>

<li><a class="reference internal" href="#problems-with-recent-git-versions">Problems with recent git versions</a></li>

</ul>

</li>

</ul>

<h4>Previous topic</h4>

<p class="topless"><a href="howto_faq.html"

title="previous chapter">How-To</a></p>

<h4>Next topic</h4>

<p class="topless"><a href="environment_variables_faq.html"

title="next chapter">Environment Variables</a></p>

<li><a href="../_sources/faq/troubleshooting_faq.txt"

rel="nofollow">Show Source</a></li>

</ul>

</div>

<h3>Quick search</h3>

</form>

Enter search terms or a module, class or function name.

</p>

</div>

</div>

<span id="troubleshooting-faq"></span><h1>Troubleshooting<a class="headerlink" href="#troubleshooting" title="Permalink to this headline">¶</a></h1>

<p class="topic-title first">Contents</p>

<li><a class="reference internal" href="#troubleshooting" id="id1">Troubleshooting</a><ul>

<li><a class="reference internal" href="#obtaining-matplotlib-version" id="id2">Obtaining matplotlib version</a></li>

<li><a class="reference internal" href="#matplotlib-install-location" id="id3"><code class="file docutils literal"><span class="pre">matplotlib</span></code> install location</a></li>

<li><a class="reference internal" href="#matplotlib-directory-location" id="id4"><code class="file docutils literal"><span class="pre">.matplotlib</span></code> directory location</a></li>

<li><a class="reference internal" href="#getting-help" id="id5">Getting help</a></li>

<li><a class="reference internal" href="#problems-with-recent-git-versions" id="id6">Problems with recent git versions</a></li>

</ul>

</li>

</ul>

</div>

<span id="matplotlib-version"></span><h2>Obtaining matplotlib version<a class="headerlink" href="#obtaining-matplotlib-version" title="Permalink to this headline">¶</a></h2>

<p>To find out your matplotlib version number, import it and print the

<code class="docutils literal"><span class="pre">__version__</span></code> attribute:</p>

<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="kn">import</span> <span class="nn">matplotlib</span>

<span class="gp">>>> </span><span class="n">matplotlib</span><span class="o">.</span><span class="n">__version__</span>

</pre></div>

</div>

<span id="locating-matplotlib-install"></span><h2><code class="file docutils literal"><span class="pre">matplotlib</span></code> install location<a class="headerlink" href="#matplotlib-install-location" title="Permalink to this headline">¶</a></h2>

<p>You can find what directory matplotlib is installed in by importing it

and printing the <code class="docutils literal"><span class="pre">__file__</span></code> attribute:</p>

<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="kn">import</span> <span class="nn">matplotlib</span>

<span class="gp">>>> </span><span class="n">matplotlib</span><span class="o">.</span><span class="n">__file__</span>

<span class="go">'/home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/__init__.pyc'</span>

</pre></div>

</div>

<span id="locating-matplotlib-config-dir"></span><h2><code class="file docutils literal"><span class="pre">.matplotlib</span></code> directory location<a class="headerlink" href="#matplotlib-directory-location" title="Permalink to this headline">¶</a></h2>

<p>Each user has a matplotlib configuration directory which may contain a

<a class="reference internal" href="../users/customizing.html#customizing-with-matplotlibrc-files"><em>matplotlibrc</em></a> file. To

locate your <code class="file docutils literal"><span class="pre">.matplotlib/</span></code> directory, use

<code class="xref py py-func docutils literal"><span class="pre">matplotlib.get_configdir()</span></code>:</p>

<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="kn">import</span> <span class="nn">matplotlib</span> <span class="kn">as</span> <span class="nn">mpl</span>

<span class="gp">>>> </span><span class="n">mpl</span><span class="o">.</span><span class="n">get_configdir</span><span class="p">()</span>

<span class="go">'/home/darren/.matplotlib'</span>

</pre></div>

</div>

<p>On unix-like systems, this directory is generally located in your

<span class="target" id="index-0"></span><a class="reference internal" href="environment_variables_faq.html#envvar-HOME"><code class="xref std std-envvar docutils literal"><span class="pre">HOME</span></code></a> directory. On windows, it is in your documents and

settings directory by default:</p>

<div class="highlight-python"><div class="highlight"><pre><span class="gp">>>> </span><span class="kn">import</span> <span class="nn">matplotlib</span>

<span class="gp">>>> </span><span class="n">mpl</span><span class="o">.</span><span class="n">get_configdir</span><span class="p">()</span>

<span class="go">'C:\\Documents and Settings\\jdhunter\\.matplotlib'</span>

</pre></div>

</div>

<p>If you would like to use a different configuration directory, you can

do so by specifying the location in your <span class="target" id="index-1"></span><a class="reference internal" href="environment_variables_faq.html#envvar-MPLCONFIGDIR"><code class="xref std std-envvar docutils literal"><span class="pre">MPLCONFIGDIR</span></code></a>

environment variable – see

<a class="reference internal" href="environment_variables_faq.html#setting-linux-osx-environment-variables"><em>Setting environment variables in Linux and OS-X</em></a>.</p>

</div>

<span id="reporting-problems"></span><h2>Getting help<a class="headerlink" href="#getting-help" title="Permalink to this headline">¶</a></h2>

<p>There are a number of good resources for getting help with matplotlib.

There is a good chance your question has already been asked:</p>

<li>The <a class="reference external" href="http://matplotlib.1069221.n5.nabble.com/">mailing list archive</a>.</li>

<li><a class="reference external" href="https://github.com/matplotlib/matplotlib/issues">Github issues</a>.</li>

<li>Stackoverflow questions tagged <a class="reference external" href="http://stackoverflow.com/questions/tagged/matplotlib">matplotlib</a>.</li>

</ul>

</div></blockquote>

<p>If you are unable to find an answer to your question through search,

please provide the following information in your e-mail to the

<a class="reference external" href="http://lists.sourceforge.net/mailman/listinfo/matplotlib-users">mailing list</a>:</p>

<li><p class="first">your operating system; (Linux/UNIX users: post the output of <code class="docutils literal"><span class="pre">uname</span> <span class="pre">-a</span></code>)</p>

</li>

<li><p class="first">matplotlib version:</p>

<div class="highlight-python"><div class="highlight"><pre>python -c `import matplotlib; print matplotlib.__version__`

</pre></div>

</div>

</li>

<li><p class="first">where you obtained matplotlib (e.g., your Linux distribution’s

packages or the matplotlib Sourceforge site, or

<a class="reference external" href="https://store.continuum.io/cshop/anaconda/">Anaconda</a> or

<a class="reference external" href="https://www.enthought.com/products/canopy/">Enthought Canopy</a>).</p>

</li>

</ul>

</div></blockquote>

<li><p class="first">any customizations to your <code class="docutils literal"><span class="pre">matplotlibrc</span></code> file (see

<a class="reference internal" href="../users/customizing.html#customizing-matplotlib"><em>Customizing matplotlib</em></a>).</p>

</li>

<li><p class="first">if the problem is reproducible, please try to provide a <em>minimal</em>,

standalone Python script that demonstrates the problem. This is

<em>the</em> critical step. If you can’t post a piece of code that we

can run and reproduce your error, the chances of getting help are

significantly diminished. Very often, the mere act of trying to

minimize your code to the smallest bit that produces the error

will help you find a bug in <em>your</em> code that is causing the

problem.</p>

</li>

<li><p class="first">you can get very helpful debugging output from matlotlib by

running your script with a <code class="docutils literal"><span class="pre">verbose-helpful</span></code> or

<code class="docutils literal"><span class="pre">--verbose-debug</span></code> flags and posting the verbose output the

lists:</p>

<div class="highlight-python"><div class="highlight"><pre>> python simple_plot.py --verbose-helpful > output.txt

</pre></div>

</div>

</li>

</ul>

</div></blockquote>

<p>If you compiled matplotlib yourself, please also provide</p>

<li><p class="first">any changes you have made to <code class="docutils literal"><span class="pre">setup.py</span></code> or <code class="docutils literal"><span class="pre">setupext.py</span></code></p>

</li>

<li><p class="first">the output of:</p>

<div class="highlight-python"><div class="highlight"><pre>rm -rf build

python setup.py build

</pre></div>

</div>

<p>The beginning of the build output contains lots of details about your

platform that are useful for the matplotlib developers to diagnose

your problem.</p>

</li>

<li><p class="first">your compiler version – eg, <code class="docutils literal"><span class="pre">gcc</span> <span class="pre">--version</span></code></p>

</li>

</ul>

</div></blockquote>

<p>Including this information in your first e-mail to the mailing list

will save a lot of time.</p>

<p>You will likely get a faster response writing to the mailing list than

filing a bug in the bug tracker. Most developers check the bug

tracker only periodically. If your problem has been determined to be

a bug and can not be quickly solved, you may be asked to file a bug in

the tracker so the issue doesn’t get lost.</p>

</div>

<span id="git-trouble"></span><h2>Problems with recent git versions<a class="headerlink" href="#problems-with-recent-git-versions" title="Permalink to this headline">¶</a></h2>

<p>First make sure you have a clean build and install (see

<a class="reference internal" href="installing_faq.html#clean-install"><em>How to completely remove matplotlib</em></a>), get the latest git update, install it and run a

simple test script in debug mode:</p>

<div class="highlight-python"><div class="highlight"><pre>rm -rf build

rm -rf /path/to/site-packages/matplotlib*

git pull

python setup.py install > build.out

python examples/pylab_examples/simple_plot.py --verbose-debug > run.out

</pre></div>

</div>

<p>and post <code class="file docutils literal"><span class="pre">build.out</span></code> and <code class="file docutils literal"><span class="pre">run.out</span></code> to the

<a class="reference external" href="http://lists.sourceforge.net/mailman/listinfo/matplotlib-devel">matplotlib-devel</a>

mailing list (please do not post git problems to the <a class="reference external" href="http://lists.sourceforge.net/mailman/listinfo/matplotlib-users">users list</a>).</p>

<p>Of course, you will want to clearly describe your problem, what you

are expecting and what you are getting, but often a clean build and

install will help. See also <a class="reference internal" href="#reporting-problems"><em>Getting help</em></a>.</p>

</div>

</div>

Last updated on Oct 25, 2014.

Created using <a

href="http://sphinx-doc.org/">Sphinx</a> 1.3b2.

</div>

</body>

</html>

matplotlib.github.com/1.4.2/faq/troubleshooting_faq.html at main · matplotlib/matplotlib.github.com · GitHub

Expand file tree

Breadcrumbs

troubleshooting_faq.html

Latest commit

History

Breadcrumbs

troubleshooting_faq.html

File metadata and controls