NRD Studio高级教程(8):模板文件

NRD Studio的图谱数据支持从外部导入,方便用户使用自己喜爱的软件进行编辑。

NRD Studio提供了多种类型模板文件,通过【本地导入】功能,可一键转换成符合要求的图谱数据,并创建新项目。

一、Excel模板文件

Excel模板文件有单文件双文件两种形式,其中单文件又分网格式线性式

1.Excel单文件 – 网格式

Excel网格式单文件既包含节点数据,也包含关系数据,均在首个页签。适用于绘制简单的图谱,节点和关系数量少,且节点间最多存在两条关系。

基础规则:

  • 首列为节点名称列表。
  • 首行为节点名称列表副本,用于添加关系。
  • 首个表单名作为项目名称。
  • 行列交叉的单元格填写关系名称。

2.Excel单文件 – 线性式

Excel线性式单文件由两个页签组成,解析器依据页签名进行区分:节点(或nodes)和关系(或links)。适用于绘制复杂的图谱,节点和关系数量较多,且节点间存在两条以上的关系,灵活度更高。

基础规则:

  • 首行为节点和关系属性名,默认是蓝色背景,字段名存在于单元格的标注中,如图红色小三角,尽量不要自定义编辑。
  • 节点页签中节点名称一列需要保证唯一性,这是与关系页签数据之间的桥梁。
节点页签
关系页签

3.Excel双文件

Excel双文件与Excel线性式单文件十分相似,区别仅仅是把两个页签拆分为两个独立的文件,即节点数据文件和关系数据文件,编辑规则不变。

二、CSV模板文件

CSV模板文件由两部分组成:节点数据和关系数据。

文件首行代表节点和关系属性名,前后顺序可灵活调整,每列数据必须对应首行字段。

默认分隔符为英文逗号,编辑文件时,注意输入的图谱数据中避免出现逗号分隔符。

节点属性

字段类型描述
namestring名称
descstring简介(可选)
imagestring图像(可选)

示例:

name,desc,image
N1,N1的简介,https://nrdstudio.cn/res/n.jpg
N2,N2的简介,https://nrdstudio.cn/res/n.jpg
N3,N3的简介,https://nrdstudio.cn/res/n.jpg

关系属性

字段类型描述
sourcestring节点名称
targetstring节点名称
relationstring关系名称

示例:

source,target,relation
N1,N2,V1
N1,N3,V2

三、JSON模板文件

JSON模板文件有单文件双文件两种形式。

1.JSON单文件

JSON单文件既包含节点数据(nodes),也包含节点数据(links),均是数组类型。关系数据中源节点和目标节点的id必须存在于节点数据中,否则在解析时会被忽略。

JSON模板文件对数据格式要求很高,键值对一定要满足定义的属性。

节点属性

字段类型描述
idnumber索引
namestring名称
imagestring图像(可选)

关系属性

字段类型描述
sourcenumber节点索引
targetnumber节点索引
relationstring关系名称

示例:

{
    "nodes": [
        {
            "id": 0, 
            "name": "N1", 
            "image": "https://nrdstudio.cn/res/n.jpg"
        }, 
        {
            "id": 1, 
            "name": "N2", 
            "image": "https://nrdstudio.cn/res/n.jpg"
        },
        {
            "id": 2, 
            "name": "N3", 
            "image": "https://nrdstudio.cn/res/n.jpg"
        }
    ], 
    "links": [
        {
            "source": 0, 
            "target": 1, 
            "relation": "V1"
        },
        {
            "source": 0, 
            "target": 2, 
            "relation": "V2"
        }
    ]
}

2.JSON双文件

JSON双文件由两部分组成:节点数据和关系数据。属性名和单文件中的定义完全一致,形式上是两个独立的数组。

四、NRD Studio模板文件

NRD Studio(.nrd)模板文件是二进制文件,仅支持导入和导出,不可直接编辑。