概述

text函數作用是根據x，y坐標向圖像添加文本。

annotate函數作用是根據x，y坐標向圖像添加文本注解。

兩者非常相似，但是又有一定差別。

text函數概述

text函數的簽名為：matplotlib.pyplot.text(x, y, s, fontdict=None, **kwargs)

參數說明如下：

• x，y：放置文本的坐標。浮點數。必備參數。
• s：文本。字符串。必備參數。
• fontdict：字體屬性字典，用于覆蓋默認文本的字體屬性。字典。默認值為None，應用rcParams中的字體屬性。可選參數。
• **kwargs：Text對象的相關屬性。

text函數的返回值為Text對象。

annotate函數概述

annotate函數的簽名為：matplotlib.pyplot.annotate(text, xy, *args, **kwargs))

參數說明如下：

text：注解文本。字符串。必備參數。

xy：需要注解的坐標，使用xycoords參數確定的坐標系。浮點數元組。必備參數。

xycoords：設置xy參數所使用的坐標系。字符串、Artist Transform 、可調用對象、 (float, float)。默認值為'data'，即被注解對象的坐標系。可選參數。

xytext：放置注解文本的坐標。浮點數元組。默認值為xy。必備參數。

textcoords：設置xytext所使用的的坐標系。字符串、Artist Transform 、可調用對象、 (float, float)。默認值為xycoords參數。

annotation_clip：當注解超出子圖區域后是否繪制。布爾值或None。默認值為None。可選參數。

• True：只有當xy坐標位于子圖之內才繪制注解。
• False：不檢測xy坐標位置，一直繪制注解。
• None：只有當xy坐標位于子圖之內才繪制注解，且xycoords 參數值為'data'。

**kwargs：Text對象的相關屬性。

arrowprops：被注解坐標點xy與注解文本位置xytext之間的箭頭屬性。字典, FancyArrowPatch對象屬性。默認值為None，即不繪制箭頭。可選參數。

FancyArrowPatch相關屬性如下：

text函數和annotate函數的對比

根據下面的示例可知：

text函數可在指定坐標點繪制文本。

annotate函數如果只使用text和xy參數，那么功能與text函數類似。

但是annotate函數可以獨立設置注解文本的位置，還可以添加需要注解的數據坐標與注解文本之間的箭頭。

import matplotlib.pyplot as plt

plt.xlim(0,5)
plt.ylim(0,5)
# 繪制3個坐標點
plt.plot((3,3,3),(1,2,3),'o')
# 使用text函數設置文本
plt.text(3,1,'text')
# 使用annotate函數必備參數繪制注解
plt.annotate('annotate', xy=(3, 2))
# 使用annotate函數繪制注解，添加指示箭頭
plt.annotate('annotate', xy=(3, 3), xytext=(4,3),
            arrowprops=dict(arrowstyle='->',facecolor='black')
            )
plt.show()

總結