样例

Signature:
plt.text(
    x: 'float',
    y: 'float',
    s: 'str',
    fontdict: 'dict[str, Any] | None' = None,
    **kwargs,
) -> 'Text'
Docstring:
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
:doc:`/gallery/text_labels_and_annotations/text_alignment`.

Parameters
----------
x, y : float
    The position to place the text. By default, this is in data
    coordinates. The coordinate system can be changed using the
    *transform* parameter.

s : str
    The text.

fontdict : dict, default: None

    .. admonition:: 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
----------------
**kwargs : `~matplotlib.text.Text` properties.
    Other miscellaneous text parameters.

    Properties:
    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: :mpltype:`color`
    bbox: dict with properties for `.patches.FancyBboxPatch`
    clip_box: unknown
    clip_on: unknown
    clip_path: unknown
    color or c: :mpltype:`color`
    figure: `~matplotlib.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: `~matplotlib.transforms.Transform`
    transform_rotates_text: bool
    url: str
    usetex: bool, default: :rc:`text.usetex`
    verticalalignment or va: {'baseline', 'bottom', 'center', 'center_baseline', 'top'}
    visible: bool
    wrap: bool
    x: float
    y: float
    zorder: float

Notes
-----

.. note::

    This is the :ref:`pyplot wrapper <pyplot_interface>` for `.axes.Axes.text`.

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 `~matplotlib.patches.Rectangle`
properties.  For example::

    >>> text(x, y, s, bbox=dict(facecolor='red', alpha=0.5))
File:      c:\users\26945\appdata\local\programs\python\python39\lib\site-packages\matplotlib\pyplot.py
Type:      function

以下是对 plt.text 函数文档结构的梳理：

函数签名（Signature）

plt.text(x: 'float', y: 'float', s: 'str', fontdict: 'dict[str, Any] | None' = None, **kwargs) -> 'Text'
明确了函数的输入参数类型要求以及返回值类型，参数 x、y 应为浮点数类型，s 为字符串类型，fontdict 可为字典类型（默认值为 None），还有可变的关键字参数 **kwargs，返回值是 Text 类型的实例。

函数文档字符串（Docstring）概述

1. 功能描述
   说明了 plt.text 函数用于向坐标轴（Axes）添加文本，会将指定的文本 s 放置在以数据坐标表示的 x、y 位置处，默认水平对齐方式为 left，垂直对齐方式为 baseline，并提供了相关参考文档链接用于了解更多文本对齐的内容。

参数（Parameters）部分

1. x、y 参数
   详细介绍这两个参数用于指定放置文本的位置，默认采用数据坐标系统，也可通过 transform 参数改变坐标系统。
2. s 参数
   指出其代表要添加的文本内容，类型为字符串。
3. fontdict 参数
   • 先是给出了不鼓励使用该参数的提示，建议将参数以单个关键字参数形式或者使用字典解包的方式传递。
   • 然后说明该参数本质是一个字典，用于覆盖默认的文本属性，如果为 None，则默认文本属性由 .rcParams 确定。

返回值（Returns）部分

明确函数返回一个 .Text 实例，即创建的文本对象。

其他参数（Other Parameters，即 **kwargs）部分

1. 整体说明
   介绍了 **kwargs 可用于传递其他杂项的文本参数，这些参数用于进一步定制文本的各种属性。
2. 具体属性列举
   详细列出了众多可设置的文本属性，例如 agg_filter、alpha、animated 等等，对每个属性都有相应的简要说明，涵盖了从文本的外观样式（如颜色、字体、字号等）到交互相关特性（如鼠标悬停、是否可被拾取等）以及坐标变换、显示控制等多方面的属性设置内容。

注释（Notes）部分

强调此函数是 .axes.Axes.text 的 pyplot 包装器（pyplot wrapper），也就是说明它与面向对象绘图中的对应方法的关联。

示例（Examples）部分

1. 通过单个关键字参数覆盖属性示例
   展示了如何使用单个关键字参数（如 fontsize）来覆盖特定的文本参数，如 text(x, y, s, fontsize=12)。
2. 改变坐标系统放置文本示例
   给出了通过指定 transform 参数将文本放置在坐标轴坐标（transAxes）系统下的示例，以实现在坐标轴中心放置文本的效果，代码为 text(0.5, 0.5, 'matplotlib', horizontalalignment='center', verticalalignment='center', transform=ax.transAxes)。
3. 为文本添加背景框示例
   演示了利用 bbox 参数给文本添加矩形背景框的用法，如 text(x, y, s, bbox=dict(facecolor='red', alpha=0.5))，并说明了 bbox 是 ~matplotlib.patches.Rectangle 属性的字典。

总体来看，文档对 plt.text 函数的功能、参数、返回值、使用注意事项以及常见用法示例都进行了较为全面详细的介绍，方便使用者准确理解和运用该函数进行文本添加及相关属性定制的操作。