.. _api_examples:

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.

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.