matplotlib.axes.Axes.text — Matplotlib 3.10.1 documentation (original) (raw)
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 andverticalalignment at the baseline. SeeText 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-unpackingtext(..., **fontdict).
A dictionary to override the default text properties. If fontdict is None, the defaults are determined by rcParams.
Returns:
The created Text instance.
Other Parameters:
**kwargsText properties.
Other miscellaneous text parameters.
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 Rectangleproperties. For example:
text(x, y, s, bbox=dict(facecolor='red', alpha=0.5))