Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.


mpltools is unavailable in PyPM, because there aren't any builds for it in the package repositories. Click the linked icons to find out why.

 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
Windows (64-bit)
Mac OS X (10.5+)
Linux (32-bit)
Linux (64-bit)
0.1 Failed View build log
Modified BSD
Lastest release
version 0.1 on Jan 9th, 2014

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.


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:


text.fontsize = 12 figure.dpi = 150


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.


Installation from source

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.

Subscribe to package updates

Last updated Jan 9th, 2014

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.