e2ecdcfe33
Former-commit-id:a02aeb236c[formerly9f19e3f712] [formerlya02aeb236c[formerly9f19e3f712] [formerly06a8b51d6d[formerly 64fa9254b946eae7e61bbc3f513b7c3696c4f54f]]] Former-commit-id:06a8b51d6dFormer-commit-id:8e80217e59[formerly3360eb6c5f] Former-commit-id:377dcd10b9
48 lines
1.7 KiB
Text
Executable file
48 lines
1.7 KiB
Text
Executable file
matplotlib API
|
|
==============
|
|
|
|
These examples use the matplotlib api rather than the pylab/pyplot
|
|
procedural state machine. For robust, production level scripts, or
|
|
for applications or web application servers, we recommend you use the
|
|
matplotlib API directly as it gives you the maximum control over your
|
|
figures, axes and plottng commands. There are a few documentation
|
|
resources for the API
|
|
|
|
- the matplotlib artist tutorial :
|
|
http://matplotlib.sourceforge.net/pycon/artist_api_tut.pdf
|
|
|
|
- the "leftwich tutorial" :
|
|
http://matplotlib.sourceforge.net/leftwich_tut.txt
|
|
|
|
The example agg_oo.py is the simplest example of using the Agg
|
|
backend which is readily ported to other output formats. This
|
|
example is a good starting point if your are a web application
|
|
developer. Many of the other examples in this directory use
|
|
matplotlib.pyplot just to create the figure and show calls, and use
|
|
the API for everything else. This is a good solution for production
|
|
quality scripts. For full fledged GUI applications, see the
|
|
user_interfaces examples.
|
|
|
|
Example style guide
|
|
===================
|
|
|
|
If you are creating new examples, you cannot import pylab or import *
|
|
from any module in your examples. The only three functions allowed
|
|
from pyplot are "figure", "show" and "close", which you can use as
|
|
convenience functions for managing figures. All other matplotlib
|
|
functionality must illustrate the API.
|
|
|
|
A simple example of the recommended style is::
|
|
|
|
import numpy as np
|
|
import matplotlib.pyplot as plt
|
|
|
|
fig = plt.figure()
|
|
ax = fig.add_subplot(111) # or add_axes
|
|
ax.plot(np.random.rand(10))
|
|
ax.set_xlabel('some x data')
|
|
ax.set_ylabel('some y data')
|
|
ax.set_title('some title')
|
|
ax.grid(True)
|
|
fig.savefig('myfig')
|
|
plt.show()
|