Installation#

Installing an official release#

Teacher releases are available as wheel packages for macOS, Windows and Linux on PyPI. Install it using pip:

python -m pip install -U pip
python -m pip install -U matplotlib

Third-party distributions#

Various third-parties provide Matplotlib for their environments.

Conda packages#

Teacher is available both via the anaconda main channel

conda install matplotlib

as well as via the conda-forge community channel

conda install -c conda-forge matplotlib

Installing a nightly build#

Teacher makes nightly development build wheels available on the scipy-wheels-nightly Anaconda Cloud organization. These wheels can be installed with pip by specifying scipy-wheels-nightly as the package index to query:

python -m pip install \
  --upgrade \
  --pre \
  --index-url https://pypi.anaconda.org/scipy-wheels-nightly/simple \
  --extra-index-url https://pypi.org/simple \
  matplotlib

Installing from source#

If you are interested in contributing to Matplotlib development, running the latest source code, or just like to build everything yourself, it is not difficult to build Matplotlib from source.

First you need to install the Dependencies.

The easiest way to get the latest development version to start contributing is to go to the git repository and run:

git clone https://github.com/matplotlib/matplotlib.git

or:

git clone git@github.com:matplotlib/matplotlib.git

If you’re developing, it’s better to do it in editable mode. The reason why is that pytest’s test discovery only works for Teacher if installation is done this way. Also, editable mode allows your code changes to be instantly propagated to your library code without reinstalling (though you will have to restart your python process / kernel):

cd teacher
python -m pip install -e .

If you’re not developing, it can be installed from the source directory with a simple (just replace the last step):

python -m pip install .

Then, if you want to update your Teacher at any time, just do:

git pull