Matplotlib is hiring a Research Software Engineering Fellow! See discourse for details. Apply by January 3, 2020

Version 3.1.1
matplotlib
Fork me on GitHub

目录

Related Topics

偏心箱

matplotlib.offsetbox

offsetbox是一个简单的容器艺术家。这个儿童艺术家应该被画在与父母相对的位置上。这个 [VH] 打包机、绘图区和文本区都是从Offsetbox派生的。

这个 [VH] packer自动调整其子代的相对位置,这应该是offsetbox的实例。这用于将相似的艺术家排列在一起,例如在传说中。

绘图区域可以包含任何儿童艺术家。绘图区域具有固定的宽度和高度。子级相对于父级的位置是固定的。文本区域包含单个文本实例。TextArea实例的宽度和高度是其子文本的宽度和高度。

class matplotlib.offsetbox.AnchoredOffsetbox(loc, pad=0.4, borderpad=0.5, child=None, prop=None, frameon=True, bbox_to_anchor=None, bbox_transform=None, **kwargs)[源代码]

基类:matplotlib.offsetbox.OffsetBox

根据图例位置loc放置的偏移框。anchoredoffsetbox有一个子级。当需要多个子项时,使用其他OffsetBox类将它们括起来。默认情况下,偏移框锚定在其父轴上。您可以显式指定bbox_to_锚定。

loc是指定图例位置的字符串或整数。有效的位置代码为:

'upper right'  : 1,
'upper left'   : 2,
'lower left'   : 3,
'lower right'  : 4,
'right'        : 5, (same as 'center right', for back-compatibility)
'center left'  : 6,
'center right' : 7,
'lower center' : 8,
'upper center' : 9,
'center'       : 10,
衬垫 : 在孩子周围垫上垫子画一个框。在给定
字体大小的分数。

borderpad:在offsetbox框架和bbox-to-u锚点之间放置,

child:将被锚定的OffsetBox实例。

属性:字体属性。这仅用作填充的参考。

框架:如果为真,则绘制框架框。

bbox ou to ou锚定:bbox to锚定。如果没有,请使用self.axes.bbox。

bbox_转换:用它来转换bbox_to_锚定。

codes = {'center': 10, 'center left': 6, 'center right': 7, 'lower center': 8, 'lower left': 3, 'lower right': 4, 'right': 5, 'upper center': 9, 'upper left': 2, 'upper right': 1}
draw(renderer)[源代码]

画艺术家

get_bbox_to_anchor()[源代码]

返回将锚定图例的bbox

get_child()[源代码]

把孩子还给我

get_children()[源代码]

返回子项列表

get_extent(renderer)[源代码]

返回艺术家的范围。返回添加了PAD的子级的范围

get_window_extent(renderer)[源代码]

获取显示空间中的边界框。

set_bbox_to_anchor(bbox, transform=None)[源代码]

设置要锚定子项的bbox。

bbox 可以是bbox实例,列表 [左、下、宽、高] 或列表 [左、下] 其中宽度和高度假定为零。bbox将通过给定的转换转换为显示坐标。

set_child(child)[源代码]

设置要锚定的子级

update_frame(bbox, fontsize=None)[源代码]
zorder = 5
class matplotlib.offsetbox.AnchoredText(s, loc, pad=0.4, borderpad=0.5, prop=None, **kwargs)[源代码]

基类:matplotlib.offsetbox.AnchoredOffsetbox

带文本的anchoredoffsetbox。

参数:
s : 一串

文本。

loc : STR

位置代码。

pad : 可选浮动

在文本和框架之间填充字体大小的分数。

边界焊盘 : 可选浮动

在框架和轴之间填充(或 bbox_to_anchor

prop : 字典,可选,默认值:无

要传递到的关键字参数字典 Text AnchoredText中包含的实例。

笔记

其他关键字参数 AnchoredOffsetbox 也允许。

class matplotlib.offsetbox.AnnotationBbox(offsetbox, xy, xybox=None, xycoords='data', boxcoords=None, frameon=True, pad=0.4, annotation_clip=None, box_alignment=(0.5, 0.5), bboxprops=None, arrowprops=None, fontsize=None, **kwargs)[源代码]

基类:matplotlib.artist.Artist, matplotlib.text._AnnotationBase

注释类似于类,但使用偏移工具箱而不是文本。

偏心箱 :OffsetBox实例

木栓 : 与注释相同,但可以是两个元组
解释为x和y坐标的字符串。
博克斯公司 : 类似于文本坐标作为注释,但可以是
解释为x和y坐标的两个字符串的元组。
box_alignment : 一个由两个浮点数组成的元组
偏移框W.R.T.的水平对齐 博克斯公司 . 左下角为(0.0),右上角为(1.1)。

其他参数与注释相同。

anncoords
contains(event)[源代码]

测试艺术家是否包含鼠标事件。

返回真值和艺术家特定选择细节的字典,例如拾取半径中包含哪些点。有关详细信息,请参见单个艺术家。

draw(renderer)[源代码]

画出 Annotation 对给定对象的对象 渲染器 .

get_children()[源代码]

返回孩子的列表 Artist S这 Artist 包含。

get_fontsize(s=None)[源代码]

返回字体大小(以磅为单位)

set_figure(fig)[源代码]

设置 Figure 艺术家所属的实例。

参数:
figFigure : 图形
set_fontsize(s=None)[源代码]

以点为单位设置字体大小

update_positions(renderer)[源代码]

更新注释点和文本的像素位置。

xyann
zorder = 3
class matplotlib.offsetbox.AuxTransformBox(aux_transform)[源代码]

基类:matplotlib.offsetbox.OffsetBox

带辅助_变换的偏移框。它的子级将先用aux_转换进行转换,然后再加上括号。辅助变换的绝对坐标是指它将自动调整,以便在偏移变换之前将子对象边界框的左下角设置为(0,0)。

它类似于绘图区域,只是框的范围不是预先确定的,而是根据其子对象的窗口范围计算的。此外,将在转换坐标中计算子对象的范围。

add_artist(a)[源代码]

添加任何 Artist 到集装箱箱

draw(renderer)[源代码]

画孩子们

get_extent(renderer)[源代码]

返回,高度,消逝,盒子气味

get_offset()[源代码]

容器的返回偏移量。

get_transform()[源代码]

返回 Transform 适用于儿童

get_window_extent(renderer)[源代码]

获取显示空间中的边界框。

set_offset(xy)[源代码]

设置容器的偏移量。

参数:
xy : (浮标,浮标)

以显示单位表示的偏移量的(x,y)坐标。

set_transform(t)[源代码]

设置转换被忽略。

class matplotlib.offsetbox.DraggableAnnotation(annotation, use_blit=False)[源代码]

基类:matplotlib.offsetbox.DraggableBase

save_offset()[源代码]
update_offset(dx, dy)[源代码]
class matplotlib.offsetbox.DraggableBase(ref_artist, use_blit=False)[源代码]

基类:object

可拖动艺术家(Legend、OffsetBox)的帮助程序代码派生类必须重写以下两个方法。

def save_offset(自身):
通过
def update_offset(self,dx,dy):
通过

save_offset 当选择要拖动的对象并保存艺术家的参考位置时调用。

update_offset 在拖动过程中调用。dx和dy是像素
从鼠标拖动开始的点偏移。

您可以选择重写以下两种方法。

定义艺术家选择器(self、artist、evt):
返回self.ref_artist.contains(evt)
定义完成偏移量(自身):
通过
artist_picker 是将
使用。 finalize_offset 在释放鼠标时调用。在目前实施的DraggableLegend和DraggableAnnotation中, update_offset 仅将艺术家放置在显示坐标中。和 finalize_offset 重新计算它们在标准化轴坐标中的位置并设置相关属性。
artist_picker(artist, evt)[源代码]
disconnect()[源代码]

断开回调

finalize_offset()[源代码]
on_motion(evt)[源代码]
on_motion_blit(evt)[源代码]
on_pick(evt)[源代码]
on_release(event)[源代码]
save_offset()[源代码]
update_offset(dx, dy)[源代码]
class matplotlib.offsetbox.DraggableOffsetBox(ref_artist, offsetbox, use_blit=False)[源代码]

基类:matplotlib.offsetbox.DraggableBase

get_loc_in_canvas()[源代码]
save_offset()[源代码]
update_offset(dx, dy)[源代码]
class matplotlib.offsetbox.DrawingArea(width, height, xdescent=0.0, ydescent=0.0, clip=False)[源代码]

基类:matplotlib.offsetbox.OffsetBox

绘图区域可以包含任何儿童艺术家。绘图区域具有固定的宽度和高度。子级相对于父级的位置是固定的。可以在父对象的边界处剪裁子对象。

宽度高度 :集装箱箱的宽度和高度。 X下降亚历山大 :箱沿X和Y方向下降。 clip :是否剪辑子项

add_artist(a)[源代码]

添加任何 Artist 到集装箱箱

clip_children

如果此DrawingArea的子级应被DrawingArea边界框剪裁。

draw(renderer)[源代码]

画孩子们

get_extent(renderer)[源代码]

返回,高度,消逝,盒子气味

get_offset()[源代码]

容器的返回偏移量。

get_transform()[源代码]

返回 Transform 适用于儿童

get_window_extent(renderer)[源代码]

获取显示空间中的边界框。

set_offset(xy)[源代码]

设置容器的偏移量。

参数:
xy : (浮标,浮标)

以显示单位表示的偏移量的(x,y)坐标。

set_transform(t)[源代码]

设置转换被忽略。

class matplotlib.offsetbox.HPacker(pad=None, sep=None, width=None, height=None, align='baseline', mode='fixed', children=None)[源代码]

基类:matplotlib.offsetbox.PackerBase

hpacker的子级水平打包。它在绘制时自动调整子对象的相对位置。

参数:
pad : 可选浮动

边界焊盘。

sep : 可选浮动

项目之间的间距。

宽度 : 可选浮动
高度 : 可选浮动

集装箱箱的宽度和高度,如果 None .

排列 : STR

盒子对齐。

mode : STR

包装方式。

笔记

padsep 需要在点中给出,并将与渲染器dpi一起缩放,而 宽度高度 需要以像素为单位。

get_extent_offsets(renderer)[源代码]

更新子对象的偏移量并返回框的范围

class matplotlib.offsetbox.OffsetBox(*args, **kwargs)[源代码]

基类:matplotlib.artist.Artist

offsetbox是一个简单的容器艺术家。这个儿童艺术家被画在与父母相对的位置上。

axes

这个 Axes 艺术家居住的实例,或 None .

contains(mouseevent)[源代码]

测试艺术家是否包含鼠标事件。

返回真值和艺术家特定选择细节的字典,例如拾取半径中包含哪些点。有关详细信息,请参见单个艺术家。

draw(renderer)[源代码]

如有必要,更新子项的位置并将其绘制到给定的 渲染器 .

get_children()[源代码]

返回包含的艺术家列表。

get_extent(renderer)[源代码]

返回,高度,消逝,盒子气味

get_extent_offsets(renderer)[源代码]
get_offset(width, height, xdescent, ydescent, renderer)[源代码]

得到偏移量

接受框的范围

get_visible_children()[源代码]

返回包含的可见艺术家列表。

get_window_extent(renderer)[源代码]

获取显示空间中的边界框。

set_figure(fig)[源代码]

设置数字

接受一个类:figure instance

set_height(height)[源代码]

设置高度

接受浮动

set_offset(xy)[源代码]

设置偏移量。

参数:
xy : (浮动、浮动)或可调用

以显示单位表示的偏移量的(x,y)坐标。可调用文件必须具有签名::

def offset(width, height, xdescent, ydescent, renderer) -> (float, float)
set_width(width)[源代码]

设置宽度

接受浮动

class matplotlib.offsetbox.OffsetImage(arr, zoom=1, cmap=None, norm=None, interpolation=None, origin=None, filternorm=1, filterrad=4.0, resample=False, dpi_cor=True, **kwargs)[源代码]

基类:matplotlib.offsetbox.OffsetBox

draw(renderer)[源代码]

画孩子们

get_children()[源代码]

返回包含的艺术家列表。

get_data()[源代码]
get_extent(renderer)[源代码]

返回,高度,消逝,盒子气味

get_offset()[源代码]

容器的返回偏移量。

get_window_extent(renderer)[源代码]

获取显示空间中的边界框。

get_zoom()[源代码]
set_data(arr)[源代码]
set_zoom(zoom)[源代码]
class matplotlib.offsetbox.PackerBase(pad=None, sep=None, width=None, height=None, align=None, mode=None, children=None)[源代码]

基类:matplotlib.offsetbox.OffsetBox

参数:
pad : 可选浮动

边界焊盘。

sep : 可选浮动

项目之间的间距。

宽度 : 可选浮动
高度 : 可选浮动

集装箱箱的宽度和高度,如果 None .

排列 : 可选的STR

盒子对齐。可以是其中之一 topbottomleftrightcenterbaseline

mode : 可选的STR

包装方式。

笔记

padsep 需要在点中给出,并将与渲染器dpi一起缩放,而 宽度高度 需要以像素为单位。

class matplotlib.offsetbox.PaddedBox(child, pad=None, draw_frame=False, patch_attrs=None