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`#

Bar color demo

Bar Label Demo

Stacked bar chart

Stacked bar chart

Grouped bar chart with labels

Grouped bar chart with labels

Horizontal bar chart

Horizontal bar chart

Broken Barh

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

Fill Between and Alpha

Fill Betweenx Demo

Fill Betweenx Demo

Hatch-filled histograms

Hatch-filled histograms

Bar chart with gradients

Bar chart with gradients

Hat graph

Discrete distribution as horizontal bar chart

Discrete distribution as horizontal bar chart

JoinStyle

Customizing dashed line styles

Customizing dashed line styles

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 Masked

Marker examples

Marker examples

Scatter plots with a legend

Scatter plots with a legend

Simple 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

Creating a timeline with lines, dates, and text

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

Creating annotated heatmaps

Creating annotated heatmaps

Image antialiasing

Image antialiasing

Clipping images with patches

Clipping images with patches

Many ways to plot images

Many ways to plot images

Image Masked

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

Visualize matrices with matshow

Visualize matrices with matshow

Multiple images

Multiple images

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

Aligning Labels

Aligning Labels

Programmatically controlling subplot adjustment

Programmatically controlling 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 Props

Axes Zoom Effect

Axes Zoom Effect

axhspan Demo

Equal axis aspect ratio

Equal axis aspect ratio

Axis Label Position

Axis Label Position

Broken Axis

Resizing axes with constrained layout

Resizing axes with constrained layout

Resizing axes with tight layout

Resizing 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

Creating adjacent subplots

Creating adjacent subplots

Geographic Projections

Geographic Projections

Combining two subplots using subplots and GridSpec

Combining two subplots using subplots and GridSpec

Using Gridspec to make multi-column/row subplot layouts

Using Gridspec to make multi-column/row subplot layouts

Nested Gridspecs

Nested Gridspecs

Invert Axes

Managing multiple figures in pyplot

Managing multiple figures in pyplot

Secondary Axis

Sharing axis limits and views

Sharing axis limits and views

Shared axis

Figure subfigures

Figure subfigures

Multiple subplots

Multiple subplots

Subplots spacings and margins

Subplots spacings and margins

Creating multiple subplots using plt.subplots

Creating multiple subplots using plt.subplots

Plots with different scales

Plots with different scales

Zoom region inset axes

Zoom region inset axes

Percentiles as horizontal bar chart

Percentiles as horizontal bar chart

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

Boxplot drawer function

Boxplot drawer function

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

Creating boxes from error bars using PatchCollection

Creating boxes from error bars using PatchCollection

Hexagonal binned plot

Hexagonal binned plot

Histograms

Plotting cumulative distributions

Plotting cumulative distributions

Some features of the histogram (hist) function

Some features of the histogram (hist) function

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

Producing multiple histograms side by side

Producing 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

Labeling a pie and a donut

Labeling a pie and a donut

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

Annotating Plots

Annotating Plots

Annotation Polar

Annotation Polar

Arrow Demo

Auto-wrapping text

Auto-wrapping text

Composing Custom Legends

Composing 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

Labeling ticks using engineering notation

Labeling ticks using engineering notation

Annotation arrow style reference

Annotation arrow style reference

Styling text boxes

Styling text boxes

Figure legend demo

Figure legend demo

Configuring the font family

Configuring 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

Mathtext Examples

Mathtext Examples

Math fontfamily

Math fontfamily

Multiline

Placing text boxes

Placing text boxes

Concatenating text objects with different properties

Concatenating text objects with different properties

STIX Fonts

Rendering math equations using TeX

Rendering math equations using TeX

Text alignment

Text Commands

Controlling style of text and labels using a dictionary

Controlling style of text and labels using a dictionary

Text Rotation Relative To Line

Text Rotation Relative To Line

Title positioning

Title positioning

Unicode minus

Usetex Baseline Test

Usetex Baseline Test

Usetex Fonteffects

Usetex Fonteffects

Text watermark

Color Demo

Color by y-value

Color by y-value

Colors in the default property cycle

Colors in the default property cycle

Colorbar

Creating a colormap from a list of colors

Creating a colormap from a list of colors

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

Plotting multiple lines with a LineCollection

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

Solarized Light stylesheet

Solarized Light stylesheet

Style sheets reference

Style sheets reference

Infinite lines

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

Showing RGB channels using RGBAxes

Showing RGB channels using RGBAxes

Adding a colorbar to inset axes

Adding a colorbar to inset axes

Colorbar with AxesDivider

Colorbar with AxesDivider

Controlling the position and size of colorbars with Inset Axes

Controlling the position and size of colorbars 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

Setting a fixed aspect on ImageGrid cells

Setting a fixed aspect on ImageGrid cells

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

Scatter Histogram (Locatable Axes)

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

Simple Colorbar

Simple Colorbar

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

Pausing and Resuming an Animation

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

Poly Editor

Pong

Resampling Data

Resampling Data

Timers

Trifinder Event Demo

Trifinder Event Demo

Viewlims

Zoom Window

Anchored Artists

Anchored Artists

Changing colors of lines intersecting a box

Changing colors of lines intersecting a box

Manual Contour

Coords Report

Custom projection

Custom projection

Customize Rc

AGG filter

Ribbon Box

Adding lines to figures

Adding lines to figures

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

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

Create 3D histogram of 2D data

Create 3D histogram of 2D data

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 polygons to fill under 3D line graph

Generate polygons to fill under 3D line graph

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

Asinh Demo

Loglog Aspect

Custom scale

Log Bar

Log Demo

Logit Demo

Exploring normalizations

Exploring normalizations

Scales

Log Axis

Symlog Demo

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

Centering labels between ticks

Centering labels between ticks

Colorbar Tick Labelling

Colorbar Tick Labelling

Custom Ticker

Formatting date ticks using ConciseDateFormatter

Formatting 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

Fig Axes Customize Simple

Fig Axes Customize Simple

Major and minor ticks

Major and minor 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

Rotating custom tick labels

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

Thresholding an Image with RangeSlider

Thresholding an Image with RangeSlider

Rectangle and ellipse selectors

Rectangle and ellipse selectors

Slider

Snapping Sliders to Discrete Values

Snapping Sliders to Discrete Values

Span Selector

Textbox

Annotate Explain

Annotate Explain

Annotate Text Arrow

Annotate Text Arrow

Connection styles for annotations

Connection styles for annotations

Custom box styles

Custom box styles

subplot2grid demo

subplot2grid demo

GridSpec demo

Nested GridSpecs

Nested GridSpecs

Simple Annotate01

Simple Annotate01

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)

scatter(xs, ys, zs)

scatter(xs, ys, zs)

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)

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 ~.Axes.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

Standalone colorbars

Standalone colorbars

Creating Colormaps

Creating Colormaps

Colormap Normalization

Colormap Normalization

Choosing Colormaps

Choosing Colormaps

Text in Matplotlib

Text in Matplotlib

Text properties and layout

Text properties and layout