python-igraph API 参考

python-igraph 中所有类、函数和方法的列表

类文档

表示任意绘图的类

每个绘图都有一个相关的 surface 对象,绘图就在这里完成。surface 是以下实例:cairo.Surface, 隶属于pycairo库。surface 本身提供了一个统一的 API,用于各种绘图目标,如 SVG 文件、X11 窗口、PostScript 文件、PNG 文件等等。igraph通常不知道当前正在哪个 surface 上绘图,因为pycairo负责实际的绘图。 Cairo 支持的所有功能pycairo此类也应该支持。

当前的 Cairo surfaces 包括

  • cairo.GlitzSurface-- 用于 X11 窗口系统的 OpenGL 加速 surface。
  • cairo.ImageSurface-- 内存缓冲区 surface。可以写入PNG图像文件。
  • cairo.PDFSurface-- PDF 文档 surface。
  • cairo.PSSurface-- PostScript 文档 surface。
  • cairo.SVGSurface-- SVG(可缩放矢量图形)文档 surface。
  • cairo.Win32Surface-- Microsoft Windows 屏幕渲染。
  • cairo.XlibSurface-- X11 窗口系统屏幕渲染。

如果你创建一个Plot对象,其中字符串作为目标 surface,则该字符串将被视为文件名,其扩展名将决定使用哪个 surface 类。 请注意,并非所有 surfaces 都可用,具体取决于你的pycairo安装。

APlot有一个指定的默认调色板(参见 igraph.drawing.colors.Palette),用于绘制对象。

APlot对象还具有要绘制的对象的列表,以及它们各自的边界框、调色板和不透明度。 分配给对象的调色板会覆盖绘图的默认调色板。 可以通过 Plot.add 方法添加对象,并通过 Plot.remove 方法删除对象。

方法 __init__ 创建一个新的绘图。
方法 add 向绘图添加一个对象。
方法 background.setter 设置绘图的背景颜色。None表示透明背景。 你可以在这里使用当前调色板的get方法或 igraph.drawing.colors.color_name_to_rgb 理解的任何颜色规范...
方法 mark_dirty 将绘图标记为脏(应该重新绘制)
方法 redraw 重新绘制绘图
方法 remove 从绘图中删除一个对象。
方法 save 保存绘图。
方法 show 将绘图保存到临时文件并显示它。
实例变量 bbox 未归档
属性 background 返回绘图的背景颜色。None表示透明背景。
属性 bounding_box 将 Cairo surface 的边界框作为 BoundingBox 对象返回
属性 height 返回绘制绘图的 Cairo surface 的高度
属性 surface 返回绘制绘图的 Cairo surface
属性 width 返回绘制绘图的 Cairo surface 的宽度
方法 _repr_svg_ 以字符串形式返回此绘图的 SVG 表示形式。
实例变量 _background 未归档
实例变量 _ctx 未归档
实例变量 _filename 未归档
实例变量 _is_dirty 未归档
实例变量 _need_tmpfile 未归档
实例变量 _objects 未归档
实例变量 _palette 未归档
实例变量 _surface 未归档
实例变量 _surface_was_created 未归档
实例变量 _windows_hacks 未归档
def __init__(self, target=None, bbox=None, palette=None, background=None):

创建一个新的绘图。

参数
目标

要写入的目标 surface。 它可以是以下类型之一

  • None-- 将创建一个适当的 surface,并且对象将在那里绘制。
  • cairo.Surface-- 将使用给定的 Cairo surface。
  • string-- 将创建一个具有给定名称的文件,并将一个合适的 Cairo surface 附加到它。
bboxsurface 的边界框。 它在不同的 surfaces 上有不同的解释:PDF 和 PS surfaces 会将其视为点(1 点 = 1/72 英寸)。 图像 surfaces 会将其视为像素。 SVG surfaces 会将其视为抽象单位,但在 Firefox 中查看 SVG 文件时,它通常会被解释为像素。
palette如果添加的对象未指定私有调色板,则绘图上主要使用的调色板。 必须是 igraph.drawing.colors.Palette 对象或引用有效键的字符串igraph.drawing.colors.palettes(请参阅模块 igraph.drawing.colors)或None。在后一种情况下,使用配置键给出的默认调色板plotting.palette
background背景颜色。 如果None, 背景将是透明的。 你可以在这里使用 igraph.drawing.colors.color_name_to_rgba 理解的任何颜色规范。
def add(self, obj, bbox=None, palette=None, opacity=1.0, *args, **kwds):

向绘图添加一个对象。

此处未指定的参数将被存储,并在必要时传递给对象的绘图函数。 由于你很可能对图可以接受的参数感兴趣,请参阅 Graph.__plot__ 了解更多详细信息。

参数
obj要添加的对象
bbox对象的边界框。 如果None, 对象将填充绘图的整个区域。
palette用于绘制对象的调色板。 如果对象尝试获取分配给正整数的颜色,它将使用此调色板。 如果None, 默认为绘图的全局调色板。
不透明度要绘制的对象的不透明度,范围为 0.0-1.0
*args未归档
**kwds未归档
参见
Graph.__plot__
@background.setter
def background(self, color):

设置绘图的背景颜色。None表示透明背景。 你可以在这里使用当前调色板的get当前调色板的方法或 igraph.drawing.colors.color_name_to_rgb

def mark_dirty(self):

将绘图标记为脏(应该重新绘制)

def redraw(self, context=None):

重新绘制绘图

def remove(self, obj, bbox=None, idx=1):

从绘图中删除一个对象。

如果对象已多次添加且未指定边界框,则它将删除对象相同实例列表中第 idx 个出现的实例。

参数
obj要删除的对象
bbox对象的可选边界框规范。 如果给定,则只会考虑具有完全此边界框的对象。
idx如果多个对象匹配 objbbox 给出的规范,则只会删除第 idx 个匹配项。
返回值
True如果对象已成功删除,False如果对象根本不在绘图上或 idx 大于出现的次数
def save(self, fname=None):

保存绘图。

参数
fname要保存到的文件名。 如果绘图的 surface 不是ImageSurface.
def show(self):

将绘图保存到临时文件并显示它。

从 igraph 0.9.1 开始,此方法已弃用,将在 0.10.0 版本中删除。

未知字段: deprecated
使用临时文件打开图像查看器在各个平台上从未可靠地工作过。
bbox =

未归档

@property
background =

返回绘图的背景颜色。None表示透明背景。

@property
bounding_box =

将 Cairo surface 的边界框作为 BoundingBox 对象返回

@property
height =

返回绘制绘图的 Cairo surface 的高度

@property
surface =

返回绘制绘图的 Cairo surface

@property
width =

返回绘制绘图的 Cairo surface 的宽度

def _repr_svg_(self):

以字符串形式返回此绘图的 SVG 表示形式。

IPython 使用此方法内联显示此绘图。

_background =

未归档

_ctx =

未归档

_filename =

未归档

_is_dirty: bool =

未归档

_need_tmpfile: bool =

未归档

_objects: list =

未归档

_palette =

未归档

_surface =

未归档

_surface_was_created =

未归档

_windows_hacks =

未归档