菜单

数据管理

相关源文件

本文档描述了 Apache ECharts 中数据的结构、处理和管理方式。数据管理系统是使各种图表类型能够可视化数据集的核心组件。本页重点介绍数据集组件、数据结构格式、编码机制以及数据在 ECharts 系统中的流转。

概述

ECharts 中的数据管理系统负责数据摄取、转换和为可视化做准备。它位于原始数据输入和视觉渲染系统之间,实现了数据处理与视觉表示的分离。

来源: test/dataset-category.html132-153 test/dataset-category.html395-479

数据集组件

数据集组件是 ECharts 数据管理系统中一个核心的元素。它将数据与视觉配置解耦,允许您将数据与图表规范分开定义。

基本结构

数据集组件接受各种格式的数据,并根据图表要求进行处理。它作为 ECharts option 对象的一部分进行配置。

来源: test/dataset-category.html92-103 test/dataset-layout.html81-94

多个数据集

ECharts 支持在单个图表中包含多个数据集,从而可以实现结合不同数据源的复杂可视化。

来源: test/dataset-category.html261-300 test/dataset-layout.html289-338

数据结构格式

ECharts 支持多种数据格式,为数据结构化和输入可视化提供了灵活性。

数组行格式

在此格式中,每一行是一个数组,第一行通常包含维度名称。

来源: test/dataset-layout.html57-63 test/dataset-category.html82-90

对象数组格式

每一项是一个带有命名属性的对象

来源: test/dataset-category.html681-706 test/dataset-category.html935-948

键列格式

数据按列组织,其中每个键代表一个维度

来源: test/dataset-category.html63-69 test/dataset-category.html1020-1025

数据维度

维度定义了数据值的含义。它们可以被显式声明,也可以从数据中自动推断。

显式维度

维度可以在数据集组件中显式定义。

来源: test/dataset-category.html99-100 test/dataset-category.html934-940

维度推断

如果未显式定义维度,ECharts 会进行推断。

  • 对于数组行格式,第一行用作维度名称。
  • 对于对象数组格式,键用作维度名称。
  • 对于键列格式,键用作维度名称。

来源: test/dataset-category.html388-393 test/dataset-category.html474-479

数据编码

数据编码将数据维度映射到诸如 x 轴、y 轴、颜色等视觉通道。

encode 选项

encode 选项明确地将维度映射到视觉通道。

来源: test/dataset-category.html542-576 test/dataset-layout.html319-337

Encode 键

常见的 encode 键包括:

  • x: x 轴
  • y: y 轴
  • tooltip: 提示框内容
  • itemName: 数据项名称
  • value: 非笛卡尔坐标系系列(如饼图)的值

来源: test/dataset-category.html191-195 test/dataset-layout.html389-398

系列布局

ECharts 支持两种组织系列数据的方式:按行和按列。

列布局(默认)

在列布局中,数据集的每一列(不包括包含维度值的首列)被映射到一个系列。

来源: test/dataset-layout.html81-94 test/dataset-layout.html96-101

行布局

在行布局中,每一行(不包括包含维度值的首行)被映射到一个系列。

来源: test/dataset-layout.html134-137 test/dataset-layout.html178-182

动态数据

ECharts 支持动态数据更新,允许可视化根据新数据随时间变化。

更新数据

可以通过调用 setOption() 并传入新的数据集配置来更新数据。

来源: test/dataset-category.html820-847 test/dataset-category.html885-912

时间序列数据

ECharts 对时间序列数据有特殊处理。

来源: test/dataset-layout.html289-304 test/dataset-layout.html362-369

内部数据结构

在内部,ECharts 使用一种称为 List 的专用数据结构来高效管理数据。

List 类是核心数据结构,负责数据存储、索引和检索。它针对不同的可视化操作优化了数据访问模式。

来源: test/dataset-category.html

ECharts 中的数据流

要了解数据如何流经系统,请查看数据管道的完整视图。

来源: test/dataset-category.html test/dataset-layout.html

结论

ECharts 的数据管理系统提供了一种灵活而强大的方式来处理各种数据格式,并将它们转化为可视化表示。通过将数据与视觉配置分离,它能够实现更易于维护和可重用的图表配置。

有关如何将特定图表类型与数据集一起使用的相关信息,请参阅 图表类型