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 color demo

Bar Label Demo

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 and Alpha

Filling the area between lines

Fill Betweenx Demo

Hatch-filled histograms

Bar chart with gradients

Hat graph

Discrete distribution as horizontal bar chart

JoinStyle

Customizing dashed line styles

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 Masked

Marker examples

Scatter plots with a legend

Simple Plot

Shade regions defined by a logical mask using fill_between

Spectrum representations

Stackplots and streamgraphs

Stairs Demo

Stem Plot

Step Demo

Creating a 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

BboxImage Demo

Figimage Demo

Creating annotated heatmaps

Image antialiasing

Clipping images with patches

Many ways to plot images

Image Masked

Image nonuniform

Blend transparency with color in 2D images

Modifying the coordinate formatter

Interpolations for imshow

Contour plot of irregularly spaced data

Layer Images

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#

Aligning Labels and Titles

Programmatically controlling subplot adjustment

Axes box aspect

Axes Demo

Controlling view limits using margins and sticky_edges

Axes Props

Axes Zoom Effect

axhspan Demo

Equal axis aspect ratio

Axis Label Position

Broken Axis

Custom Figure subclasses

Resizing Axes with constrained layout

Resizing Axes with tight layout

Different scales on the same Axes

Figure size in different units

Figure labels: suptitle, supxlabel, supylabel

Creating adjacent subplots

Geographic Projections

Combining two subplots using subplots and GridSpec

Using Gridspec to make multi-column/row subplot layouts

Nested Gridspecs

Inverted axis

Managing multiple figures in pyplot

Secondary Axis

Sharing axis limits and views

Shared axis

Figure subfigures

Multiple subplots

Subplots spacings and margins

Creating multiple subplots using plt.subplots

Plots with different scales

Zoom region inset Axes

Statistics#

Percentiles as horizontal bar chart

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

Creating boxes from error bars using PatchCollection

Hexagonal binned plot

Histograms

Bihistogram

Plotting cumulative distributions

Demo of the histogram function's different histtype settings

The histogram (hist) function with multiple data sets

Histogram bins, density, and weight

Producing multiple histograms side by side

Time Series Histogram

Violin plot basics

Pie and polar charts#

Pie charts

Bar of pie

Nested pie charts

Labeling a pie and a donut

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

Composing Custom Legends

Date tick labels

AnnotationBbox demo

Using a text as a Path

Text Rotation Mode

The difference between \dfrac and \frac

Labeling ticks using engineering notation

Annotation arrow style reference

Styling text boxes

Figure legend demo

Configuring 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

Concatenating text objects with different properties

STIX Fonts

Rendering math equations using TeX

Text alignment

Text Commands

Controlling style of text and labels using a dictionary

Text Rotation Relative To Line

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

Creating 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

Plotting multiple lines with 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

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

Showing RGB channels using RGBAxes

Colorbar with AxesDivider

Controlling the position and size of colorbars with Inset Axes

Per-row or per-column colorbars

Axes with a fixed physical size

Setting a fixed aspect on ImageGrid cells

Inset locator demo

Inset locator demo 2

Make room for ylabel using axes_grid

Parasite Simple

Parasite Simple2

Scatter Histogram (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

Pausing and Resuming 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

Miscellaneous#

Anchored Artists

Changing colors of lines intersecting a box

Adding lines to figures

Building histograms using Rectangles and PolyCollections

Hyperlinks

Image Thumbnail

Plotting with keywords

Rasterization for vector graphics

Set and get properties

SVG Filter 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

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

Create 3D histogram of 2D data

2D and 3D Axes in same figure

Automatic text offsetting

Draw flat objects in 3D plot

Generate polygons to fill under 3D line graph

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

Centering labels between ticks

Colorbar Tick Labelling

Custom Ticker

Formatting 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

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

Rotating custom 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.