g6/README.md
2023-11-02 16:53:34 +08:00

5.6 KiB
Raw Blame History

G6图分析引擎

v5 在线体验地址https://g6.antv.antgroup.com/g6v5

travis-ci codecov typescript MIT npm package NPM downloads Percentage of issues still open

English README

什么是 G6

G6 是一个图可视化引擎。它提供了图的绘制、布局、分析、交互、动画等图可视化的基础能力。旨在让关系变得透明,简单。让用户获得关系数据的 Insight。

基于 G6用户可以快速搭建自己的 图分析图编辑 应用。

G6 的特性 (5.0 Alpha)

G6 作为一款专业的图可视化引擎,具有以下特性:

  • 易扩展:七大插件化模块(见下图);
  • 样式、动画规范,信息分层(见下图);
  • 内置亮色、暗色主题,主题可自定义;动画易配置(见下图);
  • 高性能布局:内置了 10+ 常用的图布局,支持 GPU、Rust 并行计算,支持自定义布局;
  • 可控的交互:内置 10+ 交互行为,支持自定义交互;
  • 友好的体验:根据用户需求分层梳理文档,支持 TypeScript 类型推断;
  • 运行时切换多渲染器Canvas、SVG、WebGL
  • 3D 大图:

GIF 未完整加载,点此看原图

3D 大图

GIF 未完整加载,点此看原图

动画规范与信息分层

内置主题与自定义主题

七大插件化模块

  • (待迁移)丰富的元素:内置丰富的节点与边元素,自由配置,支持自定义;
  • (待迁移)便捷的组件:优化内置组件功能及性能;

除了默认好用、配置自由的内置功能,元素、交互、布局均具有高可扩展的自定义机制。

安装 (5.0 Alpha)

$ npm install @antv/g6@5.0.0-alpha.8

使用 (5.0 Alpha)

图配置 Specification 类型见:https://github.com/antvis/G6/blob/v5/packages/g6/src/types/spec.ts

Graph API 见:2b44df189d/packages/g6/src/types/graph.ts (L23)

最简单的图 Demo

Edit compassionate-lalande-5lxm7

import G6 from "@antv/g6";

const data = {
  nodes: [
    {
      id: "node1",
      label: "Node 1",
      data: {
        x: 150,
        y: 150,
      },
    },
    {
      id: "node2",
      label: "Node 2",
      data: {
        x: 400,
        y: 150,
      },
    },
  ],
  edges: [
    {
      id: "edge1",
      label: "Edge 1",
      source: "node1",
      target: "node2",
      data: {},
    },
  ],
};

const graph = new G6.Graph({
  container: "container",
  width: 500,
  height: 500,
  data,
  node: (innerModel) => ({
    ...innerModel,
    type: "circle",
    data: {
      ...innerModel.data,
      labelShape: {
        text: innerModel.label,
      },
      labelBackgroundShape: {},
      iconShape: {
        img: "https://gw.alipayobjects.com/zos/basement_prod/012bcf4f-423b-4922-8c24-32a89f8c41ce.svg",
      },
    },
  }),
  edge: (innerModel) => ({
    ...innerModel,
    type: "line",
    data: {
      labelShape: {
        text: innerModel.label,
      },
      labelBackgroundShape: {},
    },
  }),
});

开发 (5.0 Alpha)

# 在项目的根目录安装依赖

$ pnpm install

# 从项目根目录进入到 g6 包文件目录下
$ cd packages/g6

# 构建
$ npm run build

# 启动集成测试 demo
$ npm run dev

# 运行所有单元测试
$ npm run test

# 运行单个单元测试
npm test -- --watch ./tests/unit/node-spec
DEBUG_MODE=1 npm test -- --watch ./tests/unit/node-spec

文档

使用文档待 5.0 稳定后完善。

如何贡献

请让我们知道您要解决或贡献什么,所以在贡献之前请先提交 issues 描述 bug 或建议。

赏金猎人计划

参见 Issue Hunt 计划文档

License

MIT license.