matplotlib.figure.Figure.suptitle#

Figure.suptitle(t, **kwargs)[source]#

Add a centered suptitle to the figure.

Parameters:
tstr

The suptitle text.

xfloat, default: 0.5

The x location of the text in figure coordinates.

yfloat, default: 0.98

The y location of the text in figure coordinates.

horizontalalignment, ha{'center', 'left', 'right'}, default: center

The horizontal alignment of the text relative to (x, y).

verticalalignment, va{'top', 'center', 'bottom', 'baseline'}, default: top

The vertical alignment of the text relative to (x, y).

fontsize, sizedefault: rcParams["figure.titlesize"] (default: 'large')

The font size of the text. See Text.set_size for possible values.

fontweight, weightdefault: rcParams["figure.titleweight"] (default: 'normal')

The font weight of the text. See Text.set_weight for possible values.

Returns:
text

The Text instance of the suptitle.

Other Parameters:
fontpropertiesNone or dict, optional

A dict of font properties. If fontproperties is given the default values for font size and weight are taken from the FontProperties defaults. rcParams["figure.titlesize"] (default: 'large') and rcParams["figure.titleweight"] (default: 'normal') are ignored in this case.

**kwargs

Additional kwargs are matplotlib.text.Text properties.

Examples using matplotlib.figure.Figure.suptitle#

Plotting categorical variables

Plotting categorical variables

Errorbar subsampling

Errorbar subsampling

Fill Between and Alpha

Fill Between and Alpha

Marker reference

Marker reference

Mapping marker properties to multivariate data

Mapping marker properties to multivariate data

Image Masked

Image Masked

Image nonuniform

Image nonuniform

Multiple images

Multiple images

Figure labels: suptitle, supxlabel, supylabel

Figure labels: suptitle, supxlabel, supylabel

Using Gridspec to make multi-column/row subplot layouts

Using Gridspec to make multi-column/row subplot layouts

Inverted axis

Inverted axis

Figure subfigures

Figure subfigures

Multiple subplots

Multiple subplots

Creating multiple subplots using plt.subplots

Creating multiple subplots using plt.subplots

Artist customization in box plots

Artist customization in box plots

Plotting cumulative distributions

Plotting cumulative distributions

Violin plot basics

Violin plot basics

Scale invariant angle label

Scale invariant angle label

Text Commands

Text Commands

Usetex Fonteffects

Usetex Fonteffects

Colors in the default property cycle

Colors in the default property cycle

Creating a colormap from a list of colors

Creating a colormap from a list of colors

Grayscale style sheet

Grayscale style sheet

Simple Axes Divider 1

Simple Axes Divider 1

Pan/zoom events of overlapping axes

Pan/zoom events of overlapping axes

Stock prices over 32 years

Stock prices over 32 years

Figure/Axes enter and leave events

Figure/Axes enter and leave events

2D and 3D Axes in same figure

2D and 3D Axes in same figure

Spine placement

Spine placement

Date tick locators and formatters

Date tick locators and formatters

Evans test

Evans test

Mouse Cursor

Mouse Cursor

GridSpec demo

GridSpec demo

Constrained layout guide

Constrained layout guide

Arranging multiple Axes in a Figure

Arranging multiple Axes in a Figure

Plotting dates and strings

Plotting dates and strings

Placing colorbars

Placing colorbars

Choosing Colormaps in Matplotlib

Choosing Colormaps in Matplotlib

Text in Matplotlib

Text in Matplotlib

Writing mathematical expressions

Writing mathematical expressions