matplotlib: plotting with Python
Python C++ Objective-C C JavaScript Jupyter Notebook Other
Switch branches/tags
Clone or download
Pull request Compare This branch is 4831 commits behind matplotlib:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github
LICENSE
ci
doc
examples
extern
lib
release/win32/data
src
tools
unit
.coveragerc
.gitattributes
.gitignore
.mailmap
.travis.yml
CHANGELOG
CONTRIBUTING.md
INSTALL
MANIFEST.in
Makefile
README.osx
README.rst
README.win.md
appveyor.yml
boilerplate.py
build_alllocal.cmd
distribute_setup.py
doc-requirements.txt
license.py
matplotlibrc.template
pytest.ini
setup.cfg.template
setup.py
setup_external_compile.py
setup_tests_only.py
setupext.py
tests.py
tox.ini
versioneer.py
visual_tests.py

README.rst

matplotlib

matplotlib is a Python 2D plotting library which produces publication-quality figures in a variety of hardcopy formats and interactive environments across platforms. matplotlib can be used in Python scripts, the Python and IPython shell (ala MATLAB or Mathematica), web application servers, and various graphical user interface toolkits.

Home page

Installation

For installation instructions and requirements, see the INSTALL file or the install documentation. If you think you may want to contribute to matplotlib, check out the guide to working with the source code.

Testing

After installation, you can launch the test suite:

py.test

Or from the Python interpreter:

import matplotlib
matplotlib.test()

Consider reading http://matplotlib.org/devel/coding_guide.html#testing for more information. Note that the test suite requires pytest and, on Python 2.7, mock. Please install with pip or your package manager of choice.

Contact

matplotlib's communication channels include active mailing lists:

The first is a good starting point for general questions and discussions.

Join the chat at https://gitter.im/matplotlib/matplotlib

Contribute

You've discovered a bug or something else you want to change - excellent!

You've worked out a way to fix it – even better!

You want to tell us about it – best of all!

Start at the contributing guide!