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, with a default horizontalalignment on the left and verticalalignment at the baseline. See Text alignment.

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

Discouraged

The use of fontdict is discouraged. Parameters should be passed as individual keyword arguments or using dictionary-unpacking text(..., **fontdict).

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

antialiased

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 or fontname

{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

list of 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

{'baseline', 'bottom', '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

BboxImage Demo

BboxImage Demo

Creating annotated heatmaps

Creating annotated heatmaps

Boxplots

Boxplots

Accented text

Accented text

Angle annotations on bracket arrows

Angle annotations on bracket arrows

Arrow Demo

Arrow Demo

Text Rotation Mode

Text Rotation Mode

Annotation arrow style reference

Annotation arrow style reference

Labelling subplots

Labelling subplots

Mathtext

Mathtext

Math fontfamily

Math fontfamily

Multiline

Multiline

Placing text boxes

Placing text boxes

Concatenating text objects with different properties

Concatenating text objects with different properties

Rendering math equations using TeX

Rendering math equations using TeX

Text alignment

Text alignment

Text Commands

Text Commands

Text Rotation Relative To Line

Text Rotation Relative To Line

Usetex Baseline Test

Usetex Baseline Test

Text watermark

Text watermark

List of named colors

List of named colors

Drawing fancy boxes

Drawing fancy boxes

Hatch style reference

Hatch style reference

Anatomy of a figure

Anatomy of a figure

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

The double pendulum problem

The double pendulum problem

MATPLOTLIB UNCHAINED

MATPLOTLIB UNCHAINED

Cross-hair cursor

Cross-hair cursor

Data browser

Data browser

Pick event demo 2

Pick event demo 2

Packed-bubble chart

Packed-bubble chart

Rasterization for vector graphics

Rasterization for vector graphics

Text annotations in 3D

Text annotations in 3D

Anscombe's quartet

Anscombe's quartet

Ishikawa Diagram

Ishikawa Diagram

Date tick locators and formatters

Date tick locators and formatters

Mouse Cursor

Mouse Cursor

Annotate Explain

Annotate Explain

Annotate Text Arrow

Annotate Text Arrow

Connection styles for annotations

Connection styles for annotations

Custom box styles

Custom box styles

PGF fonts

PGF fonts

PGF texsystem

PGF texsystem

Simple Annotate01

Simple Annotate01

The Lifecycle of a Plot

The Lifecycle of a Plot

Quick start guide

Quick start guide

Path Tutorial

Path Tutorial

Transformations Tutorial

Transformations Tutorial

Arranging multiple Axes in a Figure

Arranging multiple Axes in a Figure

Axis ticks

Axis ticks

Specifying colors

Specifying colors

Choosing Colormaps in Matplotlib

Choosing Colormaps in Matplotlib

Text in Matplotlib

Text in Matplotlib

Text properties and layout

Text properties and layout

Annotations

Annotations