R igraph 手册页

如果您从 R 中使用 igraph,请使用此选项

print.nexusDatasetInfo {igraph}R 文档

从 Nexus 网络存储库查询和下载

描述

Nexus 网络存储库是一个在线的网络数据集集合。这些函数可以用来查询它,并直接将数据作为 igraph 图下载。

用法

## S3 method for class 'nexusDatasetInfo'
print(x, ...)

## S3 method for class 'nexusDatasetInfoList'
summary(object, ...)

## S3 method for class 'nexusDatasetInfoList'
print(x, ...)

nexus_list(
  tags = NULL,
  offset = 0,
  limit = 10,
  operator = c("or", "and"),
  order = c("date", "name", "popularity"),
  nexus.url = igraph_opt("nexus.url")
)

nexus_info(id, nexus.url = igraph_opt("nexus.url"))

nexus_get(
  id,
  offset = 0,
  order = c("date", "name", "popularity"),
  nexus.url = igraph_opt("nexus.url")
)

nexus_search(
  q,
  offset = 0,
  limit = 10,
  order = c("date", "name", "popularity"),
  nexus.url = igraph_opt("nexus.url")
)

## S3 method for class 'nexusDatasetInfoList'
x[i]

参数

x, object

要打印的 nexusDatasetInfo 对象。

...

当前被忽略。

tags

一个字符向量,要搜索的标签。如果不给定(或 NULL),则列出所有数据集。

offset

一个偏移量,用于选择部分结果。结果从 offset+1 开始列出。

limit

要返回的最大结果数。

运算符

一个字符标量。如果为 ‘or’(默认值),则返回至少具有给定标签之一的所有数据集。如果为 ‘and’,则仅返回具有所有给定标签的数据集。

order

结果的排序,可能的值有:‘date’,‘name’,‘popularity’。

nexus.url

Nexus 服务器的 URL。除非您设置了自己的 Nexus 服务器,否则不要更改此默认值。

id

要查询或下载的数据集的数字或字符 ID。除了数据集 ID 之外,还可以直接在此处提供一个 nexusDatasetInfonexusDatasetInfoList 对象,然后对相应的数据集进行查询。

q

Nexus 搜索字符串。请参阅下面的示例。

i

索引。

详细信息

Nexus 是一个在线网络存储库,带有一个 API,允许对其进行程序化查询,并允许程序化数据下载。

nexus_listnexus_info 函数查询在线数据库。它们都返回 nexusDatasetInfo 对象。nexus_info 返回的信息比 nexus_list 更多。

nexus_search 搜索 Nexus,并返回一个数据集列表,作为 nexusDatasetInfo 对象。请参阅下面的搜索示例。

nexus_get 基于数字 ID 或 Nexus 搜索字符串从 Nexus 下载数据集。对于搜索字符串,仅下载第一个搜索命中,但也可以查看 offset 参数。(如果没有找到数据集,则该函数返回一个错误。)

nexus_list 返回的 nexusDatasetInfo 对象具有以下字段

id

数据集的数字 ID。

sid

数据集的字符 ID。

name

字符标量,数据集的名称。

vertices/edges

字符,图中顶点和边的数量。顶点和边用斜杠分隔,如果数据集包含多个网络,则用空格分隔。

tags

字符向量,数据集的标签。有向图具有标签“directed”。无向图被标记为“undirected”。其他常见的标签有:“weighted”,“bipartite”,“social network”等。

networks

数据集中网络的 ID 和名称。数字 ID 和字符 ID 用斜杠分隔,多个网络用空格分隔。

nexusDatasetInfo 对象返回的 nexus_info 具有以下附加字段

date

字符标量,例如“2011-01-09”,数据集添加到数据库的日期。

formats

字符向量,数据集中可用的数据格式。各种格式用分号分隔。

licence

字符标量,数据集的许可证。

licence url

字符标量,数据集许可证的 URL。在使用数据集之前,请务必咨询此内容。

summary

字符标量,数据集的简短描述,通常是一句话。

description

字符标量,数据集的完整描述。

citation

字符标量,描述数据集的论文。如果您在研究中使用该数据集,请引用这些论文,大多数数据集的许可证都要求这样做。

attributes

一个列表的列表,每个列表条目都是一个图、顶点或边属性,并具有以下条目

type

属性的类型,可以是“graph”、“vertex”或“edge”。

datatype

属性的数据类型,目前可以是“numeric”和“string”。

name

字符标量,属性的名称。

description

字符标量,属性的描述。

Nexus 查询的结果以简洁的格式打印到屏幕上,类似于 igraph 图的格式。数据集列表(通常是 nexus_listnexus_search 的结果)如下所示

NEXUS 1-5/18 -- data set list
[1] kaptail.4         39/109-223   #18 Kapferer tailor shop
[2] condmatcollab2003 31163/120029 #17 Condensed matter collaborations+
[3] condmatcollab     16726/47594  #16 Condensed matter collaborations+
[4] powergrid         4941/6594    #15 Western US power grid
[5] celegansneural    297/2359     #14 C. Elegans neural network 

此处的每一行代表一个数据集,并给出了关于它们的以下信息:数据集的字符 ID(例如,kaptailpowergrid),数据集中图的顶点数和边数。对于具有多个图的数据集,此处给出间隔。然后是数据集的数字 ID,剩余空间用数据集的名称填充。

关于单个 Nexus 数据集的摘要信息打印为

NEXUS B--- 39 109-223 #18 kaptail -- Kapferer tailor shop
+ tags: directed; social network; undirected
+ nets: 1/KAPFTI2; 2/KAPFTS2; 3/KAPFTI1; 4/KAPFTS1

这与用于打印 igraph 图的标题非常相似,但也有一些差异。NEXUS 单词后面的四个字符给出了该图的最重要的属性:第一个是 “U” 表示无向图,“D” 表示有向图,如果数据集包含有向图和无向图,则为 “B”。第二个是 “N” 表示命名图。第三个字符是 “W” 表示加权图,第四个是 “B” 表示数据集包含二分图。然后打印顶点数和边数,对于具有多个图的数据集,给出最小值和最大值。然后是数字 ID 和数据集的字符串 ID。第一行的末尾包含数据集的名称。第二行列出数据集标签,第三行列出数据集中包含的网络。

详细的数据集信息以类似的方式打印,但它包含更多字段。

nexus_listnexus_search 返回一个 nexusDatasetInfo 对象的列表。该列表还具有这些属性

size

查询返回的数据集数量。

totalsize

查询找到的数据集总数。

offset

查询的 offset 参数。

limit

查询的 limit 参数。

nexus_info 返回单个 nexusDatasetInfo 对象。

nexus_get 返回一个 igraph 图对象,或者如果数据集包含多个网络,则返回一个图对象列表。

示例

nexus_list(tag="weighted")
nexus_list(limit=3, order="name")
nexus_list(limit=3, order="name")[[1]]
nexus_info(2)
g <- nexus_get(2)
summary(g)

## Data sets related to 'US':
nexus_search("US")

## Search for data sets that have 'network' in their name:
nexus_search("name:network")

## Any word can match
nexus_search("blog or US or karate")

[包 igraph 版本 1.3.5 索引]