lucaju/netvis

NetVis - 网络可视化工具

概述

NetVis是一款基于Javascript、NodeJS和MongoDB开发的网络可视化工具，结合AngularJS和D3库实现。最初由阿尔伯塔大学Kule高级研究所（KIAS）委托开发，用于展示研究人员、部门与研究主题之间的关系，现已可泛化用于渲染任何类型的网络连接。

核心功能

数据集展示

通过“标签”菜单分类显示研究人员、兴趣、部门三类数据，支持名称搜索；节点代表标签，线条代表连接关系，用户可通过选择/取消标签动态更新可视化内容。

数据导入与添加

• 手动操作: 点击"+"按钮手动添加或编辑数据。
• 文件导入: 支持JSON/CSV格式数据集导入，提供明确的格式规范：
  • JSON格式示例（包含必填字段name和type）：

    json
    [{
      "name": "张三",
      "type": "Researcher",
      "firstName": "张",
      "lastName": "三",
      "website": "www.example.com",
      "relations": [{
        "type": "Department",
        "name": "计算机科学系"
      }]
    }]
    

  • CSV格式支持节点（name,type,firstName,lastName,website）和边（source,target,sourceType,targetType）两种 schema。

数据导出

• 数据导出: 以CSV/JSON格式导出节点及关系数据。
• 图形导出: 生成PNG（透明背景 raster 文件）或SVG（矢量文件）格式的可视化图形。

布局自定义

• 支持网络视图与集群视图切换；
• 调整节点间的重力、电荷、距离及碰撞检测参数；
• 自定义节点的权重、大小、颜色（按标签类型或集群社区编码）；
• 修改标题及网络链接的大小和颜色。

使用场景

• 学术研究: 展示研究团队协作关系、机构间合作网络或研究主题关联；
• 组织管理: 可视化企业部门架构、员工协作网络；
• 数据分析: 呈现用户兴趣关联、产品推荐关系等各类实体间的连接。

配置说明（Docker部署）

前提条件

安装Docker和Docker Compose（可参考DigitalOcean的官方教程）。

部署步骤

1. 克隆仓库:

   bash
   git clone https://github.com/lucaju/netvisjs.git
   

2. 配置MongoDB:
   • 进入docker/mongodb/config目录，将mongodb.example.env重命名为mongodb.env，设置用户名和密码：

     env
     MONGO_INITDB_ROOT_USERNAME=root
     MONGO_INITDB_ROOT_PASSWORD=your_password
     

   • MongoDB容器配置（docker-compose片段）：

     yml
     mongo:
       container_name: mongo
       restart: unless-stopped
       image: docker.xuanyuan.run/mongo
       env_file: ./volumes/mongodb/config/mongodb.env
       volumes:
         - ./volumes/mongodb/data/db:/data/db
       ports:
         - "27017:27017"
       networks:
         - netvis
     

3. 配置NetVis:
   • 进入docker/netvis/config目录，将config.example.json重命名为config.json，设置MongoDB连接、管理员信息及元数据：

     json
     {
       "mongoDB": {
         "host": "mongo",
         "port": "27017",
         "rootUser": "root",
         "rootPWD": "your_password",
         "database": "netvis"
       },
       "user": {
         "firstName": "Admin",
         "lastName": "",
         "email": "admin@example.com",
         "password": "YourStrongPassword123!"
       },
       "meta": {
         "title": "NetVis",
         "url": "http://localhost",
         "jwtSecret": "your_jwt_secret",
         "sendgridAPI": ""
       }
     }
     

   • NetVis容器配置（docker-compose片段）：

     yml
     netvis:
       image: docker.xuanyuan.run/lucaju/netvis
       restart: unless-stopped
       volumes:
         - ./volumes/netvis/config/:/app/config/
       ports:
         - "80:3000"
       depends_on:
         - mongo
       networks:
         - netvis
     

4. 启动服务:

   bash
   docker-compose -f ./docker/docker-compose.yml up -d
   

5. 停止服务:

   bash
   docker-compose -f ./docker/docker-compose.yml down
   

访问http://localhost即可使用NetVis工具。 ===END===