AntV Data-Set 使用指南

AntV Data-Set 使用指南

项目地址:https://gitcode.com/gh_mirrors/da/data-set

项目介绍

AntV Data-Set 是由 AntV 团队开发的一款数据处理库，它采用了状态驱动的设计理念，旨在提供一站式的数据预处理解决方案，特别适用于数据可视化场景。通过该库，开发者可以更加便捷地进行数据接入、转换等操作，从而为数据可视化图表准备合适的数据结构。Data-Set 支持通过简单的 API 调用来管理数据状态，并执行复杂的数据变换逻辑。

项目快速启动

首先，确保你的环境已经安装了 Node.js。接下来，你可以通过以下步骤快速开始使用 AntV Data-Set：

安装 Data-Set

在项目目录下运行以下命令来安装 @antv/data-set:

npm install @antv/data-set

引入并初始化 Data-Set

在你的代码中引入 Data-Set，并创建一个实例：

import { DataSet } from '@antv/data-set';

const ds = new DataSet({
  state: {
    // 初始化状态示例
    someVariable: 'initialValue',
  },
});

应用案例和最佳实践

假设你需要从原始数据中提取特定字段以供图表使用，可以使用 Data-Set 的 transform 方法：

const data = [
  { year: '1991', value: 3 },
  { year: '1992', value: 4 },
  // 更多数据...
];

// 创建一个新的数据视图
const dv = ds.createView().source(data);
dv.transform({
  type: 'fold',
  fields: ['value'], // 需要折叠的字段列表
  key: 'year', // 折叠后新键的名称
  value: 'value', // 折叠后新值的名称
});

// 现在 dv 已经转换完毕，可以用于图表绘制

典型生态项目

AntV Data-Set 是 AntV 可视化套件的一部分，常与其他 AntV 组件如 G2 或 F6 结合使用，以构建复杂的可视化应用。例如，在使用 G2 进行图表绘制时，可以通过 Data-Set 高效处理数据，简化数据到图形的映射过程。

import { Chart } from '@antv/g2';
import { DataSet } from '@antv/data-set';

// ... 数据准备和转换 ...

const chart = new Chart({
  container: 'container',
  width: 800,
  height: 600,
});

chart.data(dv.views[0].data); // 使用转换后的数据
chart.scale('value', { nice: true });

chart.line().position('year*value');
chart.point().position('year*value').size(4).shape('circle').style({
  stroke: '#fff',
  lineWidth: 1,
});

chart.render();

以上就是使用 AntV Data-Set 的基本教程，包括项目介绍、快速启动示例、简单应用案例以及其在典型生态中的作用。结合这些知识，你可以高效地管理和处理数据，以便于数据可视化。

data-set state driven all in one data process for data visualization. 项目地址: https://gitcode.com/gh_mirrors/da/data-set