Voyager 项目使用教程

1. 项目介绍

Voyager 是一个数据探索工具，旨在结合手动和自动化的图表规范。Voyager 2 结合了 PoleStar（受 Tableau 和 Polaris 启发的传统图表规范工具）与两个部分图表规范接口：

• 通配符（Wildcards）：允许用户并行指定多个图表。
• 相关视图（Related Views）：建议与当前指定图表相关的可视化。

Voyager 2 的目标是帮助分析师在广度导向的探索和深度导向的问题回答之间进行交互。

2. 项目快速启动

2.1 安装依赖

首先，确保你已经安装了 yarn，然后克隆项目并安装依赖：

git clone https://github.com/vega/voyager.git
cd voyager
yarn install

2.2 运行测试

安装完成后，运行测试以确保一切正常：

yarn test

2.3 构建项目

要构建一个可部署的版本，运行以下命令：

yarn build

2.4 启动项目

构建完成后，启动项目：

yarn start

3. 应用案例和最佳实践

3.1 在 JupyterLab 中使用 Voyager

Voyager 可以通过 JupyterLab 扩展在 JupyterLab 中使用。安装 DataVoyager.jl 包可以将 Voyager 2 集成到 Julia 编程语言中。

3.2 嵌入式使用

Voyager 可以嵌入到其他 Web 应用程序中。以下是一个简单的嵌入示例：

const libVoyager = require('voyager');
const container = document.getElementById("voyager-embed");
const config = undefined;
const data = undefined;
const voyagerInstance = libVoyager.CreateVoyager(container, config, data);

3.3 更新数据

你可以通过以下方式更新数据：

const data = {
  "values": [
    {"fieldA": "A", "fieldB": 28},
    {"fieldA": "B", "fieldB": 55},
    {"fieldA": "C", "fieldB": 43},
    {"fieldA": "D", "fieldB": 91},
    {"fieldA": "E", "fieldB": 81},
    {"fieldA": "F", "fieldB": 53},
    {"fieldA": "G", "fieldB": 19},
    {"fieldA": "H", "fieldB": 87},
    {"fieldA": "I", "fieldB": 52}
  ]
};
voyagerInstance.updateData(data);

4. 典型生态项目

4.1 Vega-Lite

Vega-Lite 是一个高级语法，用于生成 Vega 可视化规范。Voyager 使用 Vega-Lite 作为其底层可视化规范语言。

4.2 JupyterLab

JupyterLab 是一个基于 Web 的交互式开发环境，支持 Voyager 扩展，使得数据探索和可视化更加便捷。

4.3 Voyager-Server

Voyager-Server 是一个可选的服务器端组件，用于处理 Voyager 中计算密集型的部分，从而提高性能和可扩展性。

通过以上步骤，你可以快速上手并使用 Voyager 进行数据探索和可视化。