matplotlib--文字图例

一、Figure和Axes上的文本

  • Matplotlib具有广泛的文本支持,包括对数学表达式的支持、对栅格和矢量输出的TrueType支持、具有任意旋转的换行分隔文本以及Unicode支持。
  • 下面的命令是介绍了通过pyplot API和objected-oriented API分别创建文本的方式。
    matplotlib--文字图例

1.text

  • pyplot API:matplotlib.pyplot.text(x, y, s, fontdict=None, **kwargs)
  • OO API:Axes.text(self, x, y, s, fontdict=None, **kwargs)
  • 参数:此方法接受以下描述的参数:
    • s:此参数是要添加的文本。
    • xy:此参数是放置文本的点(x,y)。
    • fontdict:此参数是一个可选参数,并且是一个覆盖默认文本属性的字典。如果fontdict为None,则由rcParams确定默认值。
    • 返回值:此方法返回作为创建的文本实例的文本。

2.title和set_title

  • pyplot API:matplotlib.pyplot.title(label, fontdict=None, loc=None, pad=None, *, y=None, **kwargs)
  • OO API:Axes.set_title(self, label, fontdict=None, loc=None, pad=None, *, y=None, **kwargs)
    该命令是用来设置axes的标题。
  • 参数:此方法接受以下描述的参数:
    • label:str,此参数是要添加的文本
    • fontdict:dict,此参数是控制title文本的外观,默认fontdict如下:
    {'fontsize': rcParams['axes.titlesize'],
     'fontweight': rcParams['axes.titleweight'],
     'color': rcParams['axes.titlecolor'],
     'verticalalignment': 'baseline',
     'horizontalalignment': loc}
    
    • loc:str,{‘center’, ‘left’, ‘right’}默认为center
    • pad:float,该参数是指标题偏离图表顶部的距离,默认为6。
    • y:float,该参数是title所在axes垂向的位置。默认值为1,即title位于axes的顶部。
    • kwargs:该参数是指可以设置的一些奇特文本的属性。
    • 返回值:此方法返回作为创建的title实例的文本。

3.figtext和text

  • pyplot API:matplotlib.pyplot.figtext(x, y, s, fontdict=None, **kwargs)
  • OO API:text(self, x, y, s, fontdict=None,**kwargs)
  • 参数:此方法接受以下描述的参数:
    • x,y:float,此参数是指在figure中放置文本的位置。一般取值是在[0,1]范围内。使用transform关键字可以更改坐标系。
    • s:str,此参数是指文本
    • fontdict:dict,此参数是一个可选参数,并且是一个覆盖默认文本属性的字典。如果fontdict为None,则由rcParams确定默认值。
    • 返回值:此方法返回作为创建的文本实例的文本。

4.suptitle

  • pyplot API:matplotlib.pyplot.suptitle(t, **kwargs)
    OO API:suptitle(self, t, **kwargs)
  • 参数:此方法接受以下描述的参数:
    • t: str,标题的文本
    • x:float,默认值是0.5.该参数是指文本在figure坐标系下的x坐标
    • y:float,默认值是0.95.该参数是指文本在figure坐标系下的y坐标
    • horizontalalignment, ha:该参数是指选择文本水平对齐方式,有三种选择{‘center’, ‘left’, right’},默认值是 ‘center’
    • verticalalignment, va:该参数是指选择文本垂直对齐方式,有四种选择{‘top’, ‘center’, ‘bottom’, ‘baseline’},默认值是 ‘top’
    • fontsize, size:该参数是指文本的大小,默认值是依据rcParams的设置:rcParams[“figure.titlesize”] (default: ‘large’)
    • fontweight, weight:该参数是用来设置字重。默认值是依据rcParams的设置:rcParams[“figure.titleweight”] (default: ‘normal’)
    • fontproperties:None or dict,该参数是可选参数,如果该参数被指定,字体的大小将从该参数的默认值中提取。
    • 返回值:此方法返回作为创建的title实例的文本。

5.xlabel和ylabel

  • pyplot API:matplotlib.pyplot.xlabel(xlabel, fontdict=None, labelpad=None, , loc=None, **kwargs)
         matplotlib.pyplot.ylabel(ylabel, fontdict=None, labelpad=None,
    , loc=None, **kwargs)
  • OO API:  Axes.set_xlabel(self, xlabel, fontdict=None, labelpad=None, , loc=None, **kwargs)
         Axes.set_ylabel(self, ylabel, fontdict=None, labelpad=None,
    , loc=None, **kwargs)
  • 参数:此方法接受以下描述的参数:
    • xlabel或者ylabel:label的文本
    • labelpad:设置label距离轴(axis)的距离
    • loc:{‘left’, ‘center’, ‘right’},默认为center
    • **kwargs:文本属性
上一篇:ffmpeg-python库的使用翻译(三)


下一篇:django rest framework序列化过程剖析