igraph.utils

模块文档
（源代码）

无法归入其他类别的实用函数。

类 multidict 一种类似字典的对象，经过定制以处理同一键的多个值。
函数 consecutive_pairs 从给定可迭代对象中返回连续的对。
函数 dbl_epsilon 近似双精度浮点数的机器 epsilon 值。
函数 deprecated 打印与某个 igraph 功能弃用相关的警告消息。
函数 named_temporary_file 一个上下文管理器，用于创建命名的临时文件并返回其名称。
函数 numpy_to_contiguous_memoryview 将 NumPy 数组或矩阵转换为适合传递给 Graph 构造函数的连续 memoryview 对象。
函数 rescale 将数字列表重新缩放到给定范围。
函数 safemax 更安全的变体max()如果可迭代对象为空，则返回默认值。
函数 safemin 更安全的变体min()如果可迭代对象为空，则返回默认值。
函数 _is_running_in_ipython 内部函数，用于确定 igraph 是否在 IPython 中运行。
def consecutive_pairs(iterable, circular=False): (source)

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

当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(): (source)

近似双精度浮点数的机器 epsilon 值。

def deprecated(message): (source)

打印与某个 igraph 功能弃用相关的警告消息。

def named_temporary_file(*args, **kwds): (source)

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

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

def numpy_to_contiguous_memoryview(obj): (source)

将 NumPy 数组或矩阵转换为适合传递给 Graph 构造函数的连续 memoryview 对象。

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

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

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

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

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

如果clamp为True，超出给定out_range范围的元素在重新缩放后会被钳制到输出范围，以确保结果中没有数字超出out_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]
参数
values未文档化
out_range输出值的范围
in_range输入值的范围；此范围将映射到out_range. None表示分别使用输入的最小值和最大值。
clamp指定当输入值超出范围时如何处理in_range. True表示将值钳制到边界in_range, False表示不进行钳制。
scale在将输入值映射到输出范围之前，对输入值执行的可选转换。
def safemax(iterable, default=0): (source)

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

示例

>>> safemax([-5, 6, 4])
6
>>> safemax([])
0
>>> safemax((), 2)
2
def safemin(iterable, default=0): (source)

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

示例

>>> safemin([-5, 6, 4])
-5
>>> safemin([])
0
>>> safemin((), 2)
2
def _is_running_in_ipython(): (source)

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