python-igraph API 参考

模块文档

无法在其他地方分类的实用函数。

类	`multidict`	类似于字典的对象，经过自定义以处理同一键的多个值。
函数	`consecutive_pairs`	从给定的可迭代对象返回连续的项目对。
函数	`dbl_epsilon`	逼近双精度的机器 epsilon 值。
函数	`named_temporary_file`	上下文管理器，用于创建命名的临时文件并返回其名称。
函数	`numpy_to_contiguous_memoryview`	将 NumPy 数组或矩阵转换为适用于转发到 Graph 构造函数的连续 memoryview 对象。
函数	`rescale`	将数字列表重新缩放到给定的范围。
函数	`safemax`	更安全的变体`max()`如果可迭代对象为空，则返回默认值。
函数	`safemin`	更安全的变体`min()`如果可迭代对象为空，则返回默认值。
函数	`str_to_orientation`	尝试将字符串解释为方向值。
函数	`_is_running_in_ipython`	内部函数，用于确定 igraph 是否在 IPython 中运行。

def consecutive_pairs(iterable, circular=False): ¶

从给定的可迭代对象返回连续的项目对。

当circular是True时，还会返回由最后一个和第一个元素组成的对。

示例

>>> list(consecutive_pairs(range(5)))
[(0, 1), (1, 2), (2, 3), (3, 4)]
>>> list(consecutive_pairs(range(5), circular=True))
[(0, 1), (1, 2), (2, 3), (3, 4), (4, 0)]
>>> list(consecutive_pairs([]))
[]
>>> list(consecutive_pairs([], circular=True))
[]
>>> list(consecutive_pairs([0]))
[]
>>> list(consecutive_pairs([0], circular=True))
[(0, 0)]

def dbl_epsilon(): ¶

逼近双精度的机器 epsilon 值。

@contextmanager
def named_temporary_file(*args, **kwds): ¶

上下文管理器，用于创建命名的临时文件并返回其名称。

所有参数都传递给tempfile.mkstemp，有关更多信息，请参见其文档。

def numpy_to_contiguous_memoryview(obj): ¶

将 NumPy 数组或矩阵转换为适用于转发到 Graph 构造函数的连续 memoryview 对象。

这在内部用于允许我们在构造 Graph 时直接使用 NumPy 数组或矩阵。

def rescale(values, out_range=(0.0, 1.0), in_range=None, clamp=False, scale=None): ¶

将数字列表重新缩放到给定的范围。

out_range给出输出值的范围；默认情况下，列表中的原始数字的最小值将映射到输出范围中的第一个元素，最大值将映射到第二个元素。输入列表中最小值和最大值之间的元素将在输出范围的第一个和第二个值之间线性插值。

in_range可用于覆盖哪些数字映射到输出范围的第一个和第二个值。这也必须是一个元组，其中第一个元素将映射到输出范围的第一个元素，第二个元素将映射到第二个元素。

如果clamp是True，重新缩放后超出给定范围的元素out_rangeafter rescaling are clamped to the output range to ensure that no number will be outsideout_range缩放到输出范围，以确保结果中没有数字超出范围。

如果scale不是None，将针对values的每个元素调用它，并且将在结果上进行重新缩放。例如，可以使用它来转换原始值的对数而不是实际值。一个典型的用例是将某个范围的值以对数刻度映射到颜色标识符。缩放也适用于in_range如果存在，则参数。

示例

>>> rescale(range(5), (0, 8))
[0.0, 2.0, 4.0, 6.0, 8.0]
>>> rescale(range(5), (2, 10))
[2.0, 4.0, 6.0, 8.0, 10.0]
>>> rescale(range(5), (0, 4), (1, 3))
[-2.0, 0.0, 2.0, 4.0, 6.0]
>>> rescale(range(5), (0, 4), (1, 3), clamp=True)
[0.0, 0.0, 2.0, 4.0, 4.0]
>>> rescale([0]*5, (1, 3))
[2.0, 2.0, 2.0, 2.0, 2.0]
>>> from math import log10
>>> rescale([1, 10, 100, 1000, 10000], (0, 8), scale=log10)
[0.0, 2.0, 4.0, 6.0, 8.0]
>>> rescale([1, 10, 100, 1000, 10000], (0, 4), (10, 1000), scale=log10)
[-2.0, 0.0, 2.0, 4.0, 6.0]

def safemax(iterable, default=0): ¶

更安全的变体max()如果可迭代对象为空，则返回默认值。

示例

>>> safemax([-5, 6, 4])
6
>>> safemax([])
0
>>> safemax((), 2)
2

def safemin(iterable, default=0): ¶

更安全的变体min()如果可迭代对象为空，则返回默认值。

示例

>>> safemin([-5, 6, 4])
-5
>>> safemin([])
0
>>> safemin((), 2)
2

def str_to_orientation(value, reversed_horizontal=False, reversed_vertical=False): ¶

尝试将字符串解释为方向值。

理解以下基本值left-right, bottom-top, right-left, top-bottom。可能的别名是

horizontal, horiz, h和lr对于left-right

vertical, vert, v和tb对于 top-bottom。

lr对于left-right.

rl对于right-left.

reversed_horizontal反转了horizontal, horiz和h到rl的含义（而不是lr）；类似地，reversed_vertical反转了vertical, vert和v到bt的含义（而不是tb).

返回lr, rl, tb之一或bt，或抛出ValueError如果无法将字符串解释为方向。

def _is_running_in_ipython(): ¶

内部函数，用于确定 igraph 是否在 IPython 中运行。

igraph.utils

`igraph.utils`