You are reading documentation for the unreleased version of Matplotlib. Try searching for the released version of this page instead?

matplotlib.pyplot.show#

matplotlib.pyplot.show(*, block=None)[source]#

Display all open figures.

Parameters:

blockbool, optional

Whether to wait for all figures to be closed before returning.

If True block and run the GUI main loop until all figure windows are closed.

If False ensure that all figure windows are displayed and return immediately. In this case, you are responsible for ensuring that the event loop is running to have responsive figures.

Defaults to True in non-interactive mode and to False in interactive mode (see pyplot.isinteractive).

See also

ion: Enable interactive mode, which shows / updates the figure after every plotting command, so that calling show() is not necessary.
ioff: Disable interactive mode.
savefig: Save the figure to an image file instead of showing it on screen.

Notes

Saving figures to file and showing a window at the same time

If you want an image file as well as a user interface window, use pyplot.savefig before pyplot.show. At the end of (a blocking) show() the figure is closed and thus unregistered from pyplot. Calling pyplot.savefig afterwards would save a new and thus empty figure. This limitation of command order does not apply if the show is non-blocking or if you keep a reference to the figure and use Figure.savefig.

Auto-show in jupyter notebooks

The jupyter backends (activated via %matplotlib inline, %matplotlib notebook, or %matplotlib widget), call show() at the end of every cell by default. Thus, you usually don't have to call it explicitly there.

Examples using `matplotlib.pyplot.show`#

Infinite lines

Bar chart with individual bar colors

Bar chart with individual bar colors

Bar chart with labels

Bar chart with labels

Stacked bar chart

Stacked bar chart

Grouped bar chart with labels

Grouped bar chart with labels

Horizontal bar chart

Horizontal bar chart

Broken horizontal bars

Broken horizontal bars

CapStyle

Plotting categorical variables

Plotting categorical variables

Plotting the coherence of two signals

Plotting the coherence of two signals

Cross spectral density (CSD)

Cross spectral density (CSD)

Curve with error band

Curve with error band

Errorbar limit selection

Errorbar limit selection

Errorbar subsampling

Errorbar subsampling

EventCollection Demo

EventCollection Demo

Eventplot demo

Filled polygon

fill_between with transparency

fill_between with transparency

Fill the area between two vertical lines

Fill the area between two vertical lines

Bar chart with gradients

Bar chart with gradients

Hat graph

Discrete distribution as horizontal bar chart

Discrete distribution as horizontal bar chart

JoinStyle

Dashed line style configuration

Dashed line style configuration

Lines with a ticked patheffect

Lines with a ticked patheffect

Linestyles

Marker reference

Marker reference

Markevery Demo

Plotting masked and NaN values

Plotting masked and NaN values

Multicolored lines

Multicolored lines

Mapping marker properties to multivariate data

Mapping marker properties to multivariate data

Power spectral density (PSD)

Power spectral density (PSD)

Scatter Demo2

Scatter plot with histograms

Scatter plot with histograms

Scatter plot with masked values

Scatter plot with masked values

Marker examples

Marker examples

Scatter plot with a legend

Scatter plot with a legend

Line plot

Shade regions defined by a logical mask using fill_between

Shade regions defined by a logical mask using fill_between

Spectrum representations

Spectrum representations

Stackplots and streamgraphs

Stackplots and streamgraphs

Stairs Demo

Stem plot

Step Demo

Timeline with lines, dates, and text

Timeline with lines, dates, and text

hlines and vlines

hlines and vlines

Cross- and auto-correlation

Cross- and auto-correlation

Affine transform of an image

Affine transform of an image

Wind barbs

Barcode

Interactive adjustment of colormap range

Interactive adjustment of colormap range

Colormap normalizations

Colormap normalizations

Colormap normalizations SymLogNorm

Colormap normalizations SymLogNorm

Contour corner mask

Contour corner mask

Contour Demo

Contour image

Contour Label Demo

Contour Label Demo

Contourf demo

Contourf hatching

Contourf hatching

Contourf and log color scale

Contourf and log color scale

Contouring the solution space of optimizations

Contouring the solution space of optimizations

BboxImage Demo

Figimage Demo

Annotated heatmap

Annotated heatmap

Image resampling

Image resampling

Clipping images with patches

Clipping images with patches

Many ways to plot images

Many ways to plot images

Image with masked values

Image with masked values

Image nonuniform

Image nonuniform

Blend transparency with color in 2D images

Blend transparency with color in 2D images

Modifying the coordinate formatter

Modifying the coordinate formatter

Interpolations for imshow

Interpolations for imshow

Contour plot of irregularly spaced data

Contour plot of irregularly spaced data

Layer images with alpha blending

Layer images with alpha blending

Visualize matrices with matshow

Visualize matrices with matshow

Multiple images with one colorbar

Multiple images with one colorbar

pcolor images

pcolormesh grids and shading

pcolormesh grids and shading

pcolormesh

Streamplot

QuadMesh Demo

Advanced quiver and quiverkey functions

Advanced quiver and quiverkey functions

Quiver Simple Demo

Quiver Simple Demo

Shading example

Shading example

Spectrogram

Spy Demos

Tricontour Demo

Tricontour Demo

Tricontour Smooth Delaunay

Tricontour Smooth Delaunay

Tricontour Smooth User

Tricontour Smooth User

Trigradient Demo

Trigradient Demo

Triinterp Demo

Tripcolor Demo

Triplot Demo

Watermark image

Watermark image

Align labels and titles

Align labels and titles

Programmatically control subplot adjustment

Programmatically control subplot adjustment

Axes box aspect

Axes box aspect

Axes Demo

Controlling view limits using margins and sticky_edges

Controlling view limits using margins and sticky_edges

Axes properties

Axes properties

Axes zoom effect

Axes zoom effect

Draw regions that span an Axes

Draw regions that span an Axes

Equal axis aspect ratio

Equal axis aspect ratio

Axis label position

Axis label position

Broken axis

Resize Axes with constrained layout

Resize Axes with constrained layout

Resize Axes with tight layout

Resize Axes with tight layout

Different scales on the same Axes

Different scales on the same Axes

Figure size in different units

Figure size in different units

Figure labels: suptitle, supxlabel, supylabel

Figure labels: suptitle, supxlabel, supylabel

Adjacent subplots

Adjacent subplots

Geographic Projections

Geographic Projections

Combine two subplots using subplots and GridSpec

Combine two subplots using subplots and GridSpec

GridSpec with variable sizes and spacing

GridSpec with variable sizes and spacing

Gridspec for multi-column/row subplot layouts

Gridspec for multi-column/row subplot layouts

Nested Gridspecs

Nested Gridspecs

Inverted axis

Manage multiple figures in pyplot

Manage multiple figures in pyplot

Secondary Axis

Share axis limits and views

Share axis limits and views

Shared axis

Figure subfigures

Figure subfigures

Multiple subplots

Multiple subplots

subplot2grid

Subplots spacings and margins

Subplots spacings and margins

Create multiple subplots using plt.subplots

Create multiple subplots using plt.subplots

Plots with different scales

Plots with different scales

Zoom region inset Axes

Zoom region inset Axes

Artist customization in box plots

Artist customization in box plots

Box plots with custom fill colors

Box plots with custom fill colors

Boxplots

Box plot vs. violin plot comparison

Box plot vs. violin plot comparison

Separate calculation and plotting of boxplots

Separate calculation and plotting of boxplots

Plot a confidence ellipse of a two-dimensional dataset

Plot a confidence ellipse of a two-dimensional dataset

Violin plot customization

Violin plot customization

Errorbar function

Errorbar function

Different ways of specifying error bars

Different ways of specifying error bars

Including upper and lower limits in error bars

Including upper and lower limits in error bars

Create boxes from error bars using PatchCollection

Create boxes from error bars using PatchCollection

Hexagonal binned plot

Hexagonal binned plot

Histograms

Bihistogram

Cumulative distributions

Cumulative distributions

Demo of the histogram function's different histtype settings

Demo of the histogram function's different histtype settings

The histogram (hist) function with multiple data sets

The histogram (hist) function with multiple data sets

Histogram bins, density, and weight

Histogram bins, density, and weight

Multiple histograms side by side

Multiple histograms side by side

Time Series Histogram

Time Series Histogram

Violin plot basics

Violin plot basics

Pie charts

Bar of pie

Nested pie charts

Nested pie charts

A pie and a donut with labels

A pie and a donut with labels

Bar chart on polar axis

Bar chart on polar axis

Polar plot

Error bar rendering on polar axis

Error bar rendering on polar axis

Polar legend

Scatter plot on polar axis

Scatter plot on polar axis

Accented text

Align y-labels

Scale invariant angle label

Scale invariant angle label

Angle annotations on bracket arrows

Angle annotations on bracket arrows

Annotate transform

Annotate transform

Annotating a plot

Annotating a plot

Annotate plots

Annotate polar plots

Annotate polar plots

Arrow Demo

Auto-wrap text

Compose custom legends

Compose custom legends

Date tick labels

Date tick labels

AnnotationBbox demo

AnnotationBbox demo

Using a text as a Path

Using a text as a Path

Text rotation mode

Text rotation mode

The difference between \dfrac and \frac

The difference between \dfrac and \frac

Format ticks using engineering notation

Format ticks using engineering notation

Annotation arrow style reference

Annotation arrow style reference

Styling text boxes

Styling text boxes

Figure legend demo

Figure legend demo

Configure the font family

Configure the font family

Using ttf font files

Using ttf font files

Font table

Fonts demo (object-oriented style)

Fonts demo (object-oriented style)

Fonts demo (keyword arguments)

Fonts demo (keyword arguments)

Labelling subplots

Labelling subplots

Legend using pre-defined labels

Legend using pre-defined labels

Legend Demo

Artist within an artist

Artist within an artist

Convert texts to images

Convert texts to images

Mathtext

Mathematical expressions

Mathematical expressions

Math fontfamily

Math fontfamily

Multiline

Placing text boxes

Placing text boxes

Concatenate text objects with different properties

Concatenate text objects with different properties

STIX Fonts

Render math equations using TeX

Render math equations using TeX

Text alignment

Text properties

Text properties

Controlling style of text and labels using a dictionary

Controlling style of text and labels using a dictionary

Text rotation angle in data coordinates

Text rotation angle in data coordinates

Title positioning

Title positioning

Unicode minus

Usetex text baseline

Usetex text baseline

Usetex font effects

Usetex font effects

Text watermark

Color Demo

Color by y-value

Color by y-value

Colors in the default property cycle

Colors in the default property cycle

Named color sequences

Named color sequences

Colorbar

Create a colormap from a list of colors

Create a colormap from a list of colors

Selecting individual colors from a colormap

Selecting individual colors from a colormap

List of named colors

List of named colors

Ways to set a color's alpha value

Ways to set a color's alpha value

Arrow guide

Reference for Matplotlib artists

Reference for Matplotlib artists

Line, Poly and RegularPoly Collection with autoscaling

Line, Poly and RegularPoly Collection with autoscaling

Compound path

Dolphins

Mmh Donuts!!!

Ellipse with orientation arrow demo

Ellipse with orientation arrow demo

Ellipse Collection

Ellipse Collection

Ellipse Demo

Drawing fancy boxes

Drawing fancy boxes

Hatch demo

Plot multiple lines using a LineCollection

Plot multiple lines using a LineCollection

Circles, Wedges and Polygons

Circles, Wedges and Polygons

PathPatch object

PathPatch object

Bezier curve

Scatter plot

Bayesian Methods for Hackers style sheet

Bayesian Methods for Hackers style sheet

Dark background style sheet

Dark background style sheet

FiveThirtyEight style sheet

FiveThirtyEight style sheet

ggplot style sheet

ggplot style sheet

Grayscale style sheet

Grayscale style sheet

Petroff10 style sheet

Petroff10 style sheet

Solarized Light stylesheet

Solarized Light stylesheet

Style sheets reference

Style sheets reference

Simple plot

Text and mathtext using pyplot

Text and mathtext using pyplot

Multiple lines using pyplot

Multiple lines using pyplot

Two subplots using pyplot

Two subplots using pyplot

Anchored Direction Arrow

Anchored Direction Arrow

Axes divider

Demo Axes Grid

Axes Grid2

HBoxDivider and VBoxDivider demo

HBoxDivider and VBoxDivider demo

Show RGB channels using RGBAxes

Show RGB channels using RGBAxes

Colorbar with AxesDivider

Colorbar with AxesDivider

Control the position and size of a colorbar with Inset Axes

Control the position and size of a colorbar with Inset Axes

Per-row or per-column colorbars

Per-row or per-column colorbars

Axes with a fixed physical size

Axes with a fixed physical size

ImageGrid cells with a fixed aspect ratio

ImageGrid cells with a fixed aspect ratio

Inset locator demo

Inset locator demo

Inset locator demo 2

Inset locator demo 2

Make room for ylabel using axes_grid

Make room for ylabel using axes_grid

Parasite Simple

Parasite Simple

Parasite Simple2

Parasite Simple2

Align histogram to scatter plot using locatable Axes

Align histogram to scatter plot using locatable Axes

Simple Anchored Artists

Simple Anchored Artists

Simple Axes Divider 1

Simple Axes Divider 1

Simple axes divider 3

Simple axes divider 3

Simple ImageGrid

Simple ImageGrid

Simple ImageGrid 2

Simple ImageGrid 2

Simple Axisline4

Simple Axisline4

Axis Direction

axis_direction demo

axis_direction demo

Axis line styles

Axis line styles

Curvilinear grid demo

Curvilinear grid demo

Demo CurveLinear Grid2

Demo CurveLinear Grid2

floating_axes features

floating_axes features

floating_axis demo

floating_axis demo

Parasite Axes demo

Parasite Axes demo

Parasite axis demo

Parasite axis demo

Ticklabel alignment

Ticklabel alignment

Ticklabel direction

Ticklabel direction

Simple axis direction

Simple axis direction

Simple axis tick label and tick directions

Simple axis tick label and tick directions

Simple axis pad

Simple axis pad

Custom spines with axisartist

Custom spines with axisartist

Simple Axisline

Simple Axisline

Simple Axisline3

Simple Axisline3

Anatomy of a figure

Anatomy of a figure

Firefox

Integral as the area under a curve

Integral as the area under a curve

Shaded & power normalized rendering

Shaded & power normalized rendering

Stock prices over 32 years

Stock prices over 32 years

XKCD

Decay

Animated histogram

Animated histogram

The Bayes update

The Bayes update

The double pendulum problem

The double pendulum problem

Animated image using a precomputed list of images

Animated image using a precomputed list of images

Multiple Axes animation

Multiple Axes animation

Pause and resume an animation

Pause and resume an animation

Rain simulation

Rain simulation

Animated 3D random walk

Animated 3D random walk

Animated line plot

Animated line plot

Animated scatter saved as GIF

Animated scatter saved as GIF

Oscilloscope

Matplotlib unchained

Matplotlib unchained

Close event

Mouse move and click events

Mouse move and click events

Cross-hair cursor

Cross-hair cursor

Data browser

Figure/Axes enter and leave events

Figure/Axes enter and leave events

Interactive functions

Interactive functions

Scroll event

Keypress event

Lasso Demo

Legend picking

Looking glass

Path editor

Pick event demo

Pick event demo

Pick event demo 2

Pick event demo 2

Polygon editor

Pong

Resampling Data

Resampling Data

Timers

Trifinder Event Demo

Trifinder Event Demo

Viewlims

Zoom modifies other Axes

Zoom modifies other Axes

Anchored Artists

Anchored Artists

Identify whether artists intersect

Identify whether artists intersect

Manual Contour

Coords Report

Custom projection

Custom projection

Customize Rc

AGG filter

Ribbon box

Add lines directly to a figure

Add lines directly to a figure

Fill spiral

Findobj Demo

Building histograms using Rectangles and PolyCollections

Building histograms using Rectangles and PolyCollections

Plotting with keywords

Plotting with keywords

Matplotlib logo

Matplotlib logo

Multiprocessing

Multiprocessing

Packed-bubble chart

Packed-bubble chart

Patheffect Demo

Patheffect Demo

Set and get properties

Set and get properties

Table Demo

TickedStroke patheffect

TickedStroke patheffect

transforms.offset_copy

transforms.offset_copy

Zorder Demo

Plot 2D data on 3D plot

Plot 2D data on 3D plot

Demo of 3D bar charts

Demo of 3D bar charts

Clip the data to the axes view limits

Clip the data to the axes view limits

Create 2D bar graphs in different planes

Create 2D bar graphs in different planes

3D box surface plot

3D box surface plot

Plot contour (level) curves in 3D

Plot contour (level) curves in 3D

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

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

Project contour profiles onto a graph

Project contour profiles onto a graph

Filled contours

Filled contours

Project filled contour onto a graph

Project filled contour onto a graph

Custom hillshading in a 3D surface plot

Custom hillshading in a 3D surface plot

3D errorbars

Fill between 3D lines

Fill between 3D lines

Fill under 3D line graphs

Fill under 3D line graphs

Create 3D histogram of 2D data

Create 3D histogram of 2D data

2D images in 3D

2D images in 3D

Intersecting planes

Intersecting planes

Parametric curve

Parametric curve

Lorenz attractor

Lorenz attractor

2D and 3D Axes in same figure

2D and 3D Axes in same figure

Automatic text offsetting

Automatic text offsetting

Draw flat objects in 3D plot

Draw flat objects in 3D plot

Generate 3D polygons

Generate 3D polygons

3D plot projection types

3D plot projection types

3D quiver plot

3D scatterplot

3D stem

3D plots as subplots

3D plots as subplots

3D surface (colormap)

3D surface (colormap)

3D surface (solid color)

3D surface (solid color)

3D surface (checkerboard)

3D surface (checkerboard)

3D surface with polar coordinates

3D surface with polar coordinates

Text annotations in 3D

Text annotations in 3D

Triangular 3D contour plot

Triangular 3D contour plot

Triangular 3D filled contour plot

Triangular 3D filled contour plot

Triangular 3D surfaces

Triangular 3D surfaces

More triangular 3D surfaces

More triangular 3D surfaces

Primary 3D view planes

Primary 3D view planes

3D voxel / volumetric plot

3D voxel / volumetric plot

3D voxel plot of the NumPy logo

3D voxel plot of the NumPy logo

3D voxel / volumetric plot with RGB colors

3D voxel / volumetric plot with RGB colors

3D voxel / volumetric plot with cylindrical coordinates

3D voxel / volumetric plot with cylindrical coordinates

3D wireframe plot

3D wireframe plot

3D wireframe plots in one direction

3D wireframe plots in one direction

Scales overview

Scales overview

Asinh scale

Loglog aspect

Custom scale

Log scale

Logit scale

Exploring normalizations

Exploring normalizations

Symlog scale

Hillshading

Anscombe's quartet

Anscombe's quartet

Hinton diagrams

Hinton diagrams

Ishikawa Diagram

Ishikawa Diagram

Left ventricle bullseye

Left ventricle bullseye

MRI with EEG

Radar chart (aka spider or star chart)

Radar chart (aka spider or star chart)

The Sankey class

The Sankey class

Long chain of connections using Sankey

Long chain of connections using Sankey

Rankine power cycle

Rankine power cycle

SkewT-logP diagram: using transforms and custom projections

SkewT-logP diagram: using transforms and custom projections

Topographic hillshading

Topographic hillshading

Spines

Spine placement

Spine placement

Dropped spines

Multiple y-axis with Spines

Multiple y-axis with Spines

Centered spines with arrows

Centered spines with arrows

Automatically setting tick positions

Automatically setting tick positions

Center labels between ticks

Center labels between ticks

Colorbar Tick Labelling

Colorbar Tick Labelling

Custom Ticker

Format date ticks using ConciseDateFormatter

Format date ticks using ConciseDateFormatter

Date Demo Convert

Date Demo Convert

Placing date ticks using recurrence rules

Placing date ticks using recurrence rules

Custom tick formatter for time series

Custom tick formatter for time series

Date precision and epochs

Date precision and epochs

Dollar ticks

SI prefixed offsets and natural order of magnitudes

SI prefixed offsets and natural order of magnitudes

Fig Axes Customize Simple

Fig Axes Customize Simple

Major and minor ticks

Major and minor ticks

Multilevel (nested) ticks

Multilevel (nested) ticks

The default tick formatter

The default tick formatter

Tick formatters

Tick formatters

Tick locators

Set default y-axis tick labels on the right

Set default y-axis tick labels on the right

Setting tick labels from a list of values

Setting tick labels from a list of values

Move x-axis tick labels to the top

Move x-axis tick labels to the top

Rotated tick labels

Rotated tick labels

Fixing too many ticks

Fixing too many ticks

Annotation with units

Annotation with units

Artist tests

Bar demo with units

Bar demo with units

Group barchart with units

Group barchart with units

Ellipse with units

Ellipse with units

Evans test

Radian ticks

Inches and centimeters

Inches and centimeters

Unit handling

mplcvd -- an example of figure hook

mplcvd -- an example of figure hook

pyplot with GTK3

pyplot with GTK3

pyplot with GTK4

pyplot with GTK4

Tool Manager

Annotated cursor

Annotated cursor

Buttons

Check buttons

Cursor

Lasso Selector

Menu

Mouse Cursor

Multicursor

Select indices from a collection using polygon selector

Select indices from a collection using polygon selector

Radio Buttons

Image scaling using a RangeSlider

Image scaling using a RangeSlider

Rectangle and ellipse selectors

Rectangle and ellipse selectors

Slider

Snap sliders to discrete values

Snap sliders to discrete values

Span Selector

Textbox

Nested GridSpecs

Nested GridSpecs

Simple Legend01

Simple Legend01

Simple Legend02

Simple Legend02

Pyplot tutorial

Pyplot tutorial

The Lifecycle of a Plot

The Lifecycle of a Plot

Artist tutorial

Artist tutorial

plot(x, y)

scatter(x, y)

bar(x, height)

stem(x, y)

fill_between(x, y1, y2)

fill_between(x, y1, y2)

stackplot(x, y)

stackplot(x, y)

stairs(values)

hist(x)

boxplot(X)

errorbar(x, y, yerr, xerr)

errorbar(x, y, yerr, xerr)

violinplot(D)

eventplot(D)

hist2d(x, y)

hexbin(x, y, C)

hexbin(x, y, C)

pie(x)

ecdf(x)

imshow(Z)

pcolormesh(X, Y, Z)

pcolormesh(X, Y, Z)

contour(X, Y, Z)

contour(X, Y, Z)

contourf(X, Y, Z)

contourf(X, Y, Z)

barbs(X, Y, U, V)

barbs(X, Y, U, V)

quiver(X, Y, U, V)

quiver(X, Y, U, V)

streamplot(X, Y, U, V)

streamplot(X, Y, U, V)

tricontour(x, y, z)

tricontour(x, y, z)

tricontourf(x, y, z)

tricontourf(x, y, z)

tripcolor(x, y, z)

tripcolor(x, y, z)

triplot(x, y)

bar3d(x, y, z, dx, dy, dz)

bar3d(x, y, z, dx, dy, dz)

fill_between(x1, y1, z1, x2, y2, z2)

fill_between(x1, y1, z1, x2, y2, z2)

plot(xs, ys, zs)

plot(xs, ys, zs)

quiver(X, Y, Z, U, V, W)

quiver(X, Y, Z, U, V, W)

scatter(xs, ys, zs)

scatter(xs, ys, zs)

stem(x, y, z)

plot_surface(X, Y, Z)

plot_surface(X, Y, Z)

plot_trisurf(x, y, z)

plot_trisurf(x, y, z)

voxels([x, y, z], filled)

voxels([x, y, z], filled)

plot_wireframe(X, Y, Z)

plot_wireframe(X, Y, Z)

Quick start guide

Quick start guide

Customizing Matplotlib with style sheets and rcParams

Customizing Matplotlib with style sheets and rcParams

Animations using Matplotlib

Animations using Matplotlib

Faster rendering by using blitting

Faster rendering by using blitting

Styling with cycler

Styling with cycler

origin and extent in imshow

origin and extent in imshow

Path effects guide

Path effects guide

Path Tutorial

Transformations Tutorial

Transformations Tutorial

Legend guide

Constrained layout guide

Constrained layout guide

Tight layout guide

Tight layout guide

Arranging multiple Axes in a Figure

Arranging multiple Axes in a Figure

Axis ticks

Specifying colors

Specifying colors

Customized Colorbars Tutorial

Customized Colorbars Tutorial

Creating Colormaps in Matplotlib

Creating Colormaps in Matplotlib

Colormap normalization

Colormap normalization

Choosing Colormaps in Matplotlib

Choosing Colormaps in Matplotlib

Text in Matplotlib

Text in Matplotlib

Text properties and layout

Text properties and layout