As the name implies, mpltools provides tools for working with matplotlib.
For the most part, these tools are only loosely-connected in functionality, so
the best way to get started is to look at the example gallery.
Note
The style-sheet functionality has been integrated into Matplotlib 1.4. As a result, this module will be removed in a future release. (See PR 2236, matplotlib 1.4 release notes.)
This package got its start by implementing plotting "styles"---essentially
stylesheets that are similar to matplotlibrc files. Unfortunately, the syntax
for an mplstyle file is slightly different than matplotlibrc files because
we use ConfigObj to parse them.
Style names should be specified as sections in a "mplstyle" file. A simple
mplstyle file would look like:
[style1] text.fontsize = 12 figure.dpi = 150 [style2] text.fontsize = 10 font.family = 'serif'
mpltools searches the current working directory and your home directory for
mplstyle files. To use a style, you just add:
>>> from mpltools import style
>>> style.use('style1')
There are a number of pre-defined styles located in mpltools/style/. To
list all available styles, use:
>>> print style.available
For more details about use and installation, see the mpltools documentation. If you're short on time, just check out the Getting Started section or the example gallery.
- matplotlib (of course)
- ConfigObj
mpltools may be installed globally using:
$ git clone git@github.com:tonysyu/mpltools.git $ cd mpltools $ python setup.py install
or locally using:
$ python setup.py install --prefix=${HOME}
If you prefer, you can use it without installing, by simply adding
this path to your PYTHONPATH variable and compiling the extensions:
$ python setup.py build_ext -i
New BSD (a.k.a. Modified BSD). See LICENSE in this directory for details.