Menu
▾
▴
SF.net SVN: matplotlib: [5336] trunk/matplotlib/doc/faq
|
From: <jd...@us...> - 2008-05-30 20:06:01
|
Revision: 5336
http://matplotlib.svn.sourceforge.net/matplotlib/?rev=5336&view=rev
Author: jdh2358
Date: 2008-05-30 13:05:57 -0700 (Fri, 30 May 2008)
Log Message:
-----------
faq updates
Modified Paths:
--------------
trunk/matplotlib/doc/faq/index.rst
trunk/matplotlib/doc/faq/installing_faq.rst
trunk/matplotlib/doc/faq/troubleshooting_faq.rst
Added Paths:
-----------
trunk/matplotlib/doc/faq/howto_faq.rst
Removed Paths:
-------------
trunk/matplotlib/doc/faq/plotting_faq.rst
Copied: trunk/matplotlib/doc/faq/howto_faq.rst (from rev 5335, trunk/matplotlib/doc/faq/plotting_faq.rst)
===================================================================
--- trunk/matplotlib/doc/faq/howto_faq.rst (rev 0)
+++ trunk/matplotlib/doc/faq/howto_faq.rst 2008-05-30 20:05:57 UTC (rev 5336)
@@ -0,0 +1,61 @@
+*****
+HOWTO
+*****
+
+How do I use matplotlib in a web application server?
+====================================================
+
+Many users report initial problems trying to use maptlotlib in web
+application servers, because by default matplotlib ships configured to
+work with a graphical user interface which may require an X11
+connection. Since many barebones application servers do not have X11
+enabled, you may get errors if you don't configure matplotlib for use
+in these environments. Most importantly, you need to decide what
+kinds of images you want to generate (PNG, PDF, SVG) and configure the
+appropriate default backend. For 99% of users, this will be the Agg
+backend, which uses the C++ `antigrain <http://antigrain.com`_
+rendering engine to make nice PNGs. The Agg backend is also
+configured to recognize requests to generate other output formats
+(PDF, PS, EPS, SVG). The easiest way to configure matplotlib to use
+Agg is to call::
+
+ # do this before importing pylab or pyplot
+ import matplotlib
+ matplotlib.use('Agg')
+ import matplotlib.pyplot as plt
+
+Alternatively, you can avoid pylab/pyplot altogeher, which will give
+you a little more control, by calling the API directly as shown in
+`agg_oo.py <http://matplotlib.sf.net/examples/api/agg_oo.py`_ .
+
+You can either generate hardcopy on the filesystem by calling savefig::
+
+ # do this before importing pylab or pyplot
+ import matplotlib
+ matplotlib.use('Agg')
+ import matplotlib.pyplot as plt
+ fig = plt.figure()
+ ax = fig.add_subplot(111)
+ ax.plot([1,2,3])
+ fig.savefig('test.png')
+
+or by saving to a file handle::
+
+ import sys
+ fig.savefig(sys.stdout)
+
+
+How do I use matplotlib with apache?
+------------------------------------
+
+TODO
+
+How do I use matplotlib with dhango?
+------------------------------------
+
+TODO
+
+How do I use matplotlib with zope?
+----------------------------------
+
+TODO
\ No newline at end of file
Modified: trunk/matplotlib/doc/faq/index.rst
===================================================================
--- trunk/matplotlib/doc/faq/index.rst 2008-05-30 19:39:37 UTC (rev 5335)
+++ trunk/matplotlib/doc/faq/index.rst 2008-05-30 20:05:57 UTC (rev 5336)
@@ -13,5 +13,5 @@
installing_faq.rst
troubleshooting_faq.rst
- plotting_faq.rst
+ howto_faq.rst
Modified: trunk/matplotlib/doc/faq/installing_faq.rst
===================================================================
--- trunk/matplotlib/doc/faq/installing_faq.rst 2008-05-30 19:39:37 UTC (rev 5335)
+++ trunk/matplotlib/doc/faq/installing_faq.rst 2008-05-30 20:05:57 UTC (rev 5336)
@@ -21,3 +21,9 @@
* delete ``site-packages/matplotlib`` directory in the Python
installation. The location of ``site-packages`` is
platform-specific.
+ * you may also want to clear some of the cache data that
+ matplotlib stores in your ``.matplotlib`` directory. You can
+ find the location of this directory by doing::
+
+ import matplotlib
+ print matplotlib.get_configdir()
\ No newline at end of file
Deleted: trunk/matplotlib/doc/faq/plotting_faq.rst
===================================================================
--- trunk/matplotlib/doc/faq/plotting_faq.rst 2008-05-30 19:39:37 UTC (rev 5335)
+++ trunk/matplotlib/doc/faq/plotting_faq.rst 2008-05-30 20:05:57 UTC (rev 5336)
@@ -1,5 +0,0 @@
-************
-Plotting FAQ
-************
-
-
Modified: trunk/matplotlib/doc/faq/troubleshooting_faq.rst
===================================================================
--- trunk/matplotlib/doc/faq/troubleshooting_faq.rst 2008-05-30 19:39:37 UTC (rev 5335)
+++ trunk/matplotlib/doc/faq/troubleshooting_faq.rst 2008-05-30 20:05:57 UTC (rev 5336)
@@ -12,15 +12,20 @@
your problem.
If not, please provide the following information in your e-mail to the
-mailing list:
+`mailing list
+<http://lists.sourceforge.net/mailman/listinfo/matplotlib-users>`_:
- * your operating system
- * matplotlib version
+ * your operating system; on Linux/UNIX post the output of ``uname -a``
+ * matplotlib version : ``import matplotlib; print matplotlib.__version__``
* where you obtained matplotlib (e.g. your Linux distribution's
packages or the matplotlib Sourceforge site)
* any customizations to your ``matplotlibrc`` file
- * if the problem is reproducible, please try to provide a minimal,
+ * if the problem is reproducible, please try to provide a *minimal*,
standalone Python script that demonstrates the problem
+ * you can get very helpful debugging output from matlotlib by
+ running your script with a ``verbose-helpful`` or
+ ``--verbose-debug`` flags and posting the verbose output the
+ lists.
If you compiled matplotlib yourself, please also provide
@@ -34,6 +39,8 @@
platform that are useful for the matplotlib developers to diagnose
your problem.
+ * your compiler version -- eg, ``gcc --version``
+
Including this information in your first e-mail to the mailing list
will save a lot of time.
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
|
