matplotlib.axes.Axes.text#

Axes.text(x, y, s, fontdict=None, **kwargs)[source]#

Add text to the Axes.

Add the text s to the Axes at location x, y in data coordinates.

Parameters:
x, yfloat

The position to place the text. By default, this is in data coordinates. The coordinate system can be changed using the transform parameter.

sstr

The text.

fontdictdict, default: None

A dictionary to override the default text properties. If fontdict is None, the defaults are determined by rcParams.

Returns:
Text

The created Text instance.

Other Parameters:
**kwargsText properties.

Other miscellaneous text parameters.

Property

Description

agg_filter

a filter function, which takes a (m, n, 3) float array and a dpi value, and returns a (m, n, 3) array and two offsets from the bottom left corner of the image

alpha

scalar or None

animated

bool

backgroundcolor

color

bbox

dict with properties for patches.FancyBboxPatch

clip_box

unknown

clip_on

unknown

clip_path

unknown

color or c

color

figure

Figure

fontfamily or family

{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}

fontproperties or font or font_properties

font_manager.FontProperties or str or pathlib.Path

fontsize or size

float or {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}

fontstretch or stretch

{a numeric value in range 0-1000, 'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'}

fontstyle or style

{'normal', 'italic', 'oblique'}

fontvariant or variant

{'normal', 'small-caps'}

fontweight or weight

{a numeric value in range 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black'}

gid

str

horizontalalignment or ha

{'left', 'center', 'right'}

in_layout

bool

label

object

linespacing

float (multiple of font size)

math_fontfamily

str

mouseover

bool

multialignment or ma

{'left', 'right', 'center'}

parse_math

bool

path_effects

AbstractPathEffect

picker

None or bool or float or callable

position

(float, float)

rasterized

bool

rotation

float or {'vertical', 'horizontal'}

rotation_mode

{None, 'default', 'anchor'}

sketch_params

(scale: float, length: float, randomness: float)

snap

bool or None

text

object

transform

Transform

transform_rotates_text

bool

url

str

usetex

bool or None

verticalalignment or va

{'bottom', 'baseline', 'center', 'center_baseline', 'top'}

visible

bool

wrap

bool

x

float

y

float

zorder

float

Examples

Individual keyword arguments can be used to override any given parameter:

>>> text(x, y, s, fontsize=12)

The default transform specifies that text is in data coords, alternatively, you can specify text in axis coords ((0, 0) is lower-left and (1, 1) is upper-right). The example below places text in the center of the Axes:

>>> text(0.5, 0.5, 'matplotlib', horizontalalignment='center',
...      verticalalignment='center', transform=ax.transAxes)

You can put a rectangular box around the text instance (e.g., to set a background color) by using the keyword bbox. bbox is a dictionary of Rectangle properties. For example:

>>> text(x, y, s, bbox=dict(facecolor='red', alpha=0.5))

Examples using matplotlib.axes.Axes.text#

Marker reference

Marker reference

Marker reference
BboxImage Demo

BboxImage Demo

BboxImage Demo
Creating annotated heatmaps

Creating annotated heatmaps

Creating annotated heatmaps
Boxplots

Boxplots

Boxplots
Using accented text in Matplotlib

Using accented text in Matplotlib

Using accented text in Matplotlib
Arrow Demo

Arrow Demo

Arrow Demo
Annotation arrow style reference

Annotation arrow style reference

Annotation arrow style reference
Labelling subplots

Labelling subplots

Labelling subplots
Mathtext

Mathtext

Mathtext
Math fontfamily

Math fontfamily

Math fontfamily
Multiline

Multiline

Multiline
Placing text boxes

Placing text boxes

Placing text boxes
Rendering math equations using TeX

Rendering math equations using TeX

Rendering math equations using TeX
Text alignment

Text alignment

Text alignment
Text Rotation Relative To Line

Text Rotation Relative To Line

Text Rotation Relative To Line
Usetex Baseline Test

Usetex Baseline Test

Usetex Baseline Test
Text watermark

Text watermark

Text watermark
Text Commands

Text Commands

Text Commands
Drawing fancy boxes

Drawing fancy boxes

Drawing fancy boxes
Hatch style reference

Hatch style reference

Hatch style reference
Anatomy of a figure

Anatomy of a figure

Anatomy of a figure
Integral as the area under a curve

Integral as the area under a curve

Integral as the area under a curve
Shaded & power normalized rendering

Shaded & power normalized rendering

Shaded & power normalized rendering
Stock prices over 32 years

Stock prices over 32 years

Stock prices over 32 years
The double pendulum problem

The double pendulum problem

The double pendulum problem
MATPLOTLIB **UNCHAINED**

MATPLOTLIB UNCHAINED

MATPLOTLIB **UNCHAINED**
Cross hair cursor

Cross hair cursor

Cross hair cursor
Data Browser

Data Browser

Data Browser
Pick Event Demo2

Pick Event Demo2

Pick Event Demo2
Packed-bubble chart

Packed-bubble chart

Packed-bubble chart
Rasterization for vector graphics

Rasterization for vector graphics

Rasterization for vector graphics
Text annotations in 3D

Text annotations in 3D

Text annotations in 3D
Anscombe's quartet

Anscombe's quartet

Anscombe's quartet
Annotate Explain

Annotate Explain

Annotate Explain
Annotate Text Arrow

Annotate Text Arrow

Annotate Text Arrow
Connection styles for annotations

Connection styles for annotations

Connection styles for annotations
Custom box styles

Custom box styles

Custom box styles
PGF fonts

PGF fonts

PGF fonts
PGF texsystem

PGF texsystem

PGF texsystem
Simple Annotate01

Simple Annotate01

Simple Annotate01
Mouse Cursor

Mouse Cursor

Mouse Cursor
The Lifecycle of a Plot

The Lifecycle of a Plot

The Lifecycle of a Plot
Quick start guide

Quick start guide

Quick start guide
Artist tutorial

Artist tutorial

Artist tutorial
Arranging multiple Axes in a Figure

Arranging multiple Axes in a Figure

Arranging multiple Axes in a Figure
Path Tutorial

Path Tutorial

Path Tutorial
Transformations Tutorial

Transformations Tutorial

Transformations Tutorial
Specifying Colors

Specifying Colors

Specifying Colors
Choosing Colormaps in Matplotlib

Choosing Colormaps in Matplotlib

Choosing Colormaps in Matplotlib
Text in Matplotlib Plots

Text in Matplotlib Plots

Text in Matplotlib Plots
Text properties and layout

Text properties and layout

Text properties and layout