@header@
<h2>Installing matplotlib</h2>
matplotlib requires <a href=http://python.org>python 2.2+</a> and <a
href=http://www.pfdubois.com/numpy>Numeric</a> or <a
href=http://www.stsci.edu/resources/software_hardware/numarray>numarray</a>.

If these dependencies are satisfied, just do the usual thing:<p>

  <pre>
  > python setup.py install
  </pre>

Matplotlib is known to work on several linux, win32 and OS X
platforms; it should run anywhere that python and Numeric run.  

To get the most out of matplotlib, you will probably want to install
one or more of the additional backends, which provide output to
various GUI and image rendering libraries.  Each of these has
different prerequistes and strengths; see <a
href=faq.html#WHICHBACKEND>which backend should I use?</a>. <p>

With the windows installer, the postscript, Agg and TkAgg backends
should work out of the box if you have Numeric/numarray already
installed.  For other backends (WX, Paint) and operating systems,
follow the instructions below and on <a href=backends.html>matplotlib
backends</a>.<p>

Note that if you install matplotlib anywhere other than the default
location, you will need to set the MATPLOTLIBDATA environment variable
to point to the install base dir. 

<h2>Windows</h2>

If you don't already have python installed, you may want to consider
using the <a href=http://www.enthought.com/python/>enthought
edition</a> of python, which has scipy, Numeric, and wxpython, plus a
lot of other goodies, preinstalled.<p>

If you have Numeric or numarray on your system, matplotlib will work
out of the box on windows.  All of the GUI backends run on windows,
but <a href=backends.html#TkAgg>TkAgg</a> is probably the best one to
use since it requires no other libraries and has the best support for
interactive use with the standard python shell.  If you are using the
enthought edition of python, the <a href=backends.html#WXAgg>WXAgg
backend</a> will also work out of the box.

<h2>Linux</h2> 

The GTK backend was the first and thus arguably most mature backend
and is a great choice for linux.  All of the backends, however, run on
linux.  To use GTK or GTKAgg, you need to have GNOME 2 and at least
pygtk-1.99.16 installed.  Don't assume that because you are running
redhat 9 that you have the latest libs.  Redhat 8 and 9 come with the
GNOME2, but you will still need to upgrade to at least pygtk-1.99.16.
The latest version (currently 2.0.0) is recommended.  I don't have
specific information about the other linux distributions.</p>

Edit setup.py to configure the backends you want to build and then do
<tt>python setup.py build</tt>.


<h2><a name=Debian>Debian</a></h3>

Vittorio Palmisano <redclay@email.it> posted this message to matplotlib-devel

<pre>
  Hello,

  I've made a Debian package for matplotlib and I've put it at:
  http://anakonda.altervista.org/debian/

  I've read some specification for dependencies from
  http://bugs.debian.org/206691, this is my first package and so there
  are some (many?) things to fix.  I think that the package may also
  include the api documentation generated with pydoc.  
</pre>

<h2><a name=OSX>OS X</a></h2> 

All of the backends run on OS X.  You will need to install freetype2
via fink or from src.  You will also need the base libraries for a
given backend.  Eg, if you want to run TkAgg, you will need a python
with Tkinter; if you want to use WxAgg, install wxpython.  See <a
href=backends.html>backends</a> for a more comprehensive discussion of
the various backend requirements.  Edit setup.py to configure the
backends you want to build and then do <tt>python setup.py build</tt>.




@footer@