Examples#

For an overview of the plotting methods we provide, see Plot types

This page contains example plots. Click on any image to see the full image and source code.

For longer tutorials, see our tutorials page. You can also find external resources and a FAQ in our user guide.

Tagging!

You can also browse the example gallery by tags.

Lines, bars and markers#

Bar chart with individual bar colors

Bar chart with labels

Stacked bar chart

Grouped bar chart with labels

Horizontal bar chart

Broken Barh

CapStyle

Plotting categorical variables

Plotting the coherence of two signals

Cross spectral density (CSD)

Curve with error band

Errorbar limit selection

fill_between with transparency

Fill the area between two lines

Fill the area between two vertical lines

Bar chart with gradients

Hat graph

Discrete distribution as horizontal bar chart

JoinStyle

Dashed line style configuration

Lines with a ticked patheffect

Linestyles

Marker reference

Markevery Demo

Plotting masked and NaN values

Multicolored lines

Mapping marker properties to multivariate data

Power spectral density (PSD)

Scatter Demo2

Scatter plot with histograms

Scatter plot with masked values

Marker examples

Scatter plot with a legend

Line plot

Shade regions defined by a logical mask using fill_between

Spectrum representations

Stackplots and streamgraphs

Stairs Demo

Stem plot

Step Demo

Timeline with lines, dates, and text

hlines and vlines

Cross- and auto-correlation

Images, contours and fields#

Affine transform of an image

Wind barbs

Barcode

Interactive adjustment of colormap range

Colormap normalizations

Colormap normalizations SymLogNorm

Contourf and log color scale

Contouring the solution space of optimizations

Clipping images with patches

Many ways to plot images

Image with masked values

Image nonuniform

Blend transparency with color in 2D images

Modifying the coordinate formatter

Interpolations for imshow

Contour plot of irregularly spaced data

Layer images with alpha blending

Visualize matrices with matshow

Multiple images with one colorbar

pcolor images

pcolormesh grids and shading

pcolormesh

Streamplot

QuadMesh Demo

Advanced quiver and quiverkey functions

Tricontour Smooth Delaunay

Tricontour Smooth User

Subplots, axes and figures#

Align labels and titles

Programmatically control subplot adjustment

Axes box aspect

Axes Demo

Controlling view limits using margins and sticky_edges

Axes properties

Axes zoom effect

Draw regions that span an Axes

Equal axis aspect ratio

Axis label position

Broken axis

Custom Figure subclasses

Resize Axes with constrained layout

Resize Axes with tight layout

Different scales on the same Axes

Figure size in different units

Figure labels: suptitle, supxlabel, supylabel

Adjacent subplots

Geographic Projections

Combine two subplots using subplots and GridSpec

Gridspec for multi-column/row subplot layouts

Nested Gridspecs

Inverted axis

Manage multiple figures in pyplot

Secondary Axis

Share axis limits and views

Shared axis

Figure subfigures

Multiple subplots

Subplots spacings and margins

Create multiple subplots using plt.subplots

Plots with different scales

Zoom region inset Axes

Statistics#

Artist customization in box plots

Box plots with custom fill colors

Boxplots

Box plot vs. violin plot comparison

Separate calculation and plotting of boxplots

Plot a confidence ellipse of a two-dimensional dataset

Violin plot customization

Errorbar function

Different ways of specifying error bars

Including upper and lower limits in error bars

Create boxes from error bars using PatchCollection

Hexagonal binned plot

Histograms

Bihistogram

Cumulative distributions

Demo of the histogram function's different histtype settings

The histogram (hist) function with multiple data sets

Histogram bins, density, and weight

Multiple histograms side by side

Time Series Histogram

Violin plot basics

Pie and polar charts#

Pie charts

Bar of pie

Nested pie charts

A pie and a donut with labels

Bar chart on polar axis

Polar plot

Error bar rendering on polar axis

Polar legend

Scatter plot on polar axis

Text, labels and annotations#

Accented text

Align y-labels

Scale invariant angle label

Angle annotations on bracket arrows

Compose custom legends

Date tick labels

AnnotationBbox demo

Using a text as a Path

Text rotation mode

The difference between \dfrac and \frac

Format ticks using engineering notation

Annotation arrow style reference

Styling text boxes

Figure legend demo

Configure the font family

Using ttf font files

Font table

Fonts demo (object-oriented style)

Fonts demo (keyword arguments)

Labelling subplots

Legend using pre-defined labels

Legend Demo

Artist within an artist

Convert texts to images

Mathtext

Mathematical expressions

Math fontfamily

Multiline

Placing text boxes

Concatenate text objects with different properties

STIX Fonts

Render math equations using TeX

Text alignment

Text properties

Controlling style of text and labels using a dictionary

Text rotation angle in data coordinates

Color#

For a description of the colormaps available in Matplotlib, see the colormaps tutorial.

Color Demo

Color by y-value

Colors in the default property cycle

Colorbar

Colormap reference

Create a colormap from a list of colors

Selecting individual colors from a colormap

List of named colors

Ways to set a color's alpha value

Shapes and collections#

Arrow guide

Reference for Matplotlib artists

Line, Poly and RegularPoly Collection with autoscaling

Compound path

Dolphins

Mmh Donuts!!!

Ellipse with orientation arrow demo

Hatch style reference

Plot multiple lines using a LineCollection

Circles, Wedges and Polygons

PathPatch object

Bezier curve

Scatter plot

Style sheets#

Bayesian Methods for Hackers style sheet

Dark background style sheet

FiveThirtyEight style sheet

ggplot style sheet

Grayscale style sheet

Petroff10 style sheet

Solarized Light stylesheet

Style sheets reference

Module - pyplot#

Infinite lines

Simple plot

Text and mathtext using pyplot

Multiple lines using pyplot

Two subplots using pyplot

Module - axes_grid1#

Anchored Direction Arrow

Axes divider

Demo Axes Grid

Axes Grid2

HBoxDivider and VBoxDivider demo

Show RGB channels using RGBAxes

Colorbar with AxesDivider

Control the position and size of a colorbar with Inset Axes

Per-row or per-column colorbars

Axes with a fixed physical size

ImageGrid cells with a fixed aspect ratio

Inset locator demo

Inset locator demo 2

Make room for ylabel using axes_grid

Parasite Simple

Parasite Simple2

Align histogram to scatter plot using locatable Axes

Simple Anchored Artists

Simple Axes Divider 1

Simple axes divider 3

Simple ImageGrid

Simple ImageGrid 2

Simple Axisline4

Module - axisartist#

Axis Direction

axis_direction demo

Axis line styles

Curvilinear grid demo

Demo CurveLinear Grid2

floating_axes features

Simple axis direction

Simple axis tick label and tick directions

Simple axis pad

Custom spines with axisartist

Simple Axisline

Simple Axisline3

Showcase#

Anatomy of a figure

Firefox

Integral as the area under a curve

Shaded & power normalized rendering

Pan/zoom events of overlapping axes

Stock prices over 32 years

XKCD

Animation#

The double pendulum problem

Animated image using a precomputed list of images

Frame grabbing

Multiple Axes animation

Pause and resume an animation

Rain simulation

Animated 3D random walk

Animated line plot

Animated scatter saved as GIF

Oscilloscope

Matplotlib unchained

Event handling#

Matplotlib supports event handling with a GUI neutral event model, so you can connect to Matplotlib events without knowledge of what user interface Matplotlib will ultimately be plugged in to. This has two advantages: the code you write will be more portable, and Matplotlib events are aware of things like data coordinate space and which axes the event occurs in so you don't have to mess with low level transformation details to go from canvas space to data space. Object picking examples are also included.

Close event

Mouse move and click events

Cross-hair cursor

Data browser

Figure/Axes enter and leave events

Interactive functions

Zoom modifies other Axes

Miscellaneous#

Anchored Artists

Identify whether artists intersect

Add lines directly to a figure

Building histograms using Rectangles and PolyCollections

Hyperlinks

Image thumbnail

Plotting with keywords

Print image to stdout

Rasterization for vector graphics

Set and get properties

Apply SVG filter to a line

SVG filter pie

Table Demo

TickedStroke patheffect

transforms.offset_copy

Zorder Demo

3D plotting#

Plot 2D data on 3D plot

Demo of 3D bar charts

Clip the data to the axes view limits

Create 2D bar graphs in different planes

3D box surface plot

Plot contour (level) curves in 3D

Plot contour (level) curves in 3D using the extend3d option

Project contour profiles onto a graph

Filled contours

Project filled contour onto a graph

Custom hillshading in a 3D surface plot

3D errorbars

Fill between 3D lines

Fill under 3D line graphs

Create 3D histogram of 2D data

2D and 3D Axes in same figure

Automatic text offsetting

Draw flat objects in 3D plot

Generate 3D polygons

3D plot projection types

3D surface (colormap)

3D surface (solid color)

3D surface (checkerboard)

3D surface with polar coordinates

Text annotations in 3D

Triangular 3D contour plot

Triangular 3D filled contour plot

Triangular 3D surfaces

More triangular 3D surfaces

Primary 3D view planes

3D voxel / volumetric plot

3D voxel plot of the NumPy logo

3D voxel / volumetric plot with RGB colors

3D voxel / volumetric plot with cylindrical coordinates

3D wireframe plot

Animate a 3D wireframe plot

3D wireframe plots in one direction

Scales#

These examples cover how different scales are handled in Matplotlib.

Exploring normalizations

Scales

Log Axis

Symlog Demo

Specialty plots#

Left ventricle bullseye

MRI with EEG

Radar chart (aka spider or star chart)

The Sankey class

Long chain of connections using Sankey

Rankine power cycle

SkewT-logP diagram: using transforms and custom projections

Topographic hillshading

Spines#

Spines

Spine placement

Dropped spines

Multiple y-axis with Spines

Centered spines with arrows

Ticks#

Automatically setting tick positions

Center labels between ticks

Colorbar Tick Labelling

Custom Ticker

Format date ticks using ConciseDateFormatter

Date Demo Convert

Placing date ticks using recurrence rules

Date tick locators and formatters

Custom tick formatter for time series

Date precision and epochs

Dollar ticks

SI prefixed offsets and natural order of magnitudes

Fig Axes Customize Simple

Major and minor ticks

Multilevel (nested) ticks

The default tick formatter

Tick formatters

Tick locators

Set default y-axis tick labels on the right

Setting tick labels from a list of values

Move x-axis tick labels to the top

Rotated tick labels

Fixing too many ticks

Units#

These examples cover the many representations of units in Matplotlib.

Annotation with units

Artist tests

Bar demo with units

Group barchart with units

Inches and centimeters

Unit handling

Embedding Matplotlib in graphical user interfaces#

You can embed Matplotlib directly into a user interface application by following the embedding_in_SOMEGUI.py examples here. Currently Matplotlib supports PyQt/PySide, PyGObject, Tkinter, and wxPython.

When embedding Matplotlib in a GUI, you must use the Matplotlib API directly rather than the pylab/pyplot procedural interface, so take a look at the examples/api directory for some example code working with the API.