skbio.stats.distance.randdm

skbio.stats.distance.randdm(num_objects, ids=None, constructor=None, random_fn=None)[源代码]

生成填充随机距离的距离矩阵。

状态:从0.4.0开始实验。

使用默认设置 random_fn ,距离从均匀分布中随机抽取 [0, 1)

不管 random_fn ,得到的距离矩阵保证是对称的和中空的。

参数:
  • num_objects (int) -- 结果距离矩阵中的对象数。例如,如果 num_objects 为3,则返回3x3距离矩阵。

  • ids (sequence of str or None, optional) -- 要用作ID的字符串序列。 len(ids) 必须等于 num_objects 。如果未提供,ID将是单调递增的整数,转换为字符串(编号从1开始)。例如, ('1', '2', '3')

  • constructor (type, optional) -- DissimilarityMatrix 或在创建随机距离矩阵时使用的子类构造函数。返回的距离矩阵将属于这种类型。如果 None (默认设置),一个 DistanceMatrix 实例将被返回。

  • random_fn (function, optional) -- 函数来生成随机值。 random_fn 必须接受两个参数(行数和列数)并返回2D numpy.ndarray 浮点数(或可以强制转换为浮点数的对象)。如果 None (默认设置), numpy.random.rand 将会被使用。

返回:

DissimilarityMatrix 随机距离的实例(或子类)。类型取决于 constructor

返回类型:

DissimilarityMatrix