[论文解读] Network visualizations with Pyvis and VisJS

Giancarlo Perrone, José Unpingco+1 more|arXiv (Cornell University)|Jun 2, 2020

Computational Physics and Python Applications被引用 11

一句话总结

Pyvis 是一个 Python 库，通过利用 VisJS JavaScript 库，使用户能够基于网页实现交互式网络可视化，允许数据科学家在 Jupyter Notebook 或独立的 HTML 应用中直接创建动态、可自定义的图可视化。它抽象了底层的 JavaScript 编程，使用户能够在 Python 中定义节点、边和布局参数，同时渲染出具备拖拽、缩放、工具提示和基于物理的布局等丰富交互功能的可视化效果。

ABSTRACT

Pyvis is a Python module that enables visualizing and interactively manipulating network graphs in the Jupyter notebook, or as a standalone web application. Pyvis is built on top of the powerful and mature VisJS JavaScript library, which allows for fast and responsive interactions while also abstracting away the low-level JavaScript and HTML. This means that elements of the rendered graph visualization, such as node/edge attributes can be specified within Python and shipped to the JavaScript layer for VisJS to render. This declarative approach makes it easy to quickly explore graph visualizations and investigate data relationships. In addition, Pyvis is highly customizable so that colors, sizes, and hover tooltips can be assigned to the rendered graph. The network graph layout is controlled by a front-end physics engine that is configurable from a Python interface, allowing for the detailed placement of the graph elements. In this paper, we outline use cases for Pyvis with specific examples to highlight key features for any analysis workflow. A brief overview of Pyvis' implementation describes how the Python front-end binding uses simple Pyvis calls.

研究动机与目标

• 简化数据科学家在 Python 中进行交互式网络可视化，特别是在 Jupyter Notebook 环境中的使用。
• 弥合基于 Python 的数据分析与高性能、交互式 JavaScript 可视化之间的差距。
• 提供一种声明式、高层级的接口，用于定义网络图，并对节点/边属性进行丰富自定义。
• 实现与流行数据科学工具（如 NetworkX 和 Pandas）的无缝集成，以支持实际应用场景。
• 通过端到端示例展示实际效用，例如可视化《冰与火之歌》数据集中的人物关系。

提出的方法

• Pyvis 使用 Python 前端绑定，将用户在 Python 中定义的节点、边和布局参数转换为 VisJS 兼容的 JSON 数据结构，用于渲染。
• 该库利用 Jinja 模板引擎，从 Python 对象生成 HTML/JS 代码，确保与 VisJS 的声明式网络定义格式兼容。
• 节点和边的属性（如大小、颜色、标签、标题（悬停工具提示）、位置（x, y）和值（用于缩放））在 Python 中指定，并传递给 VisJS 进行渲染。
• 基于物理的布局通过 VisJS 的 Barnes-Hut 算法实现，可通过 Pyvis 的 Python 接口进行配置，以实现动态、交互式的节点定位。
• 该库支持批量操作，如 add_nodes()、add_edges() 和 add_edge()，并可选地添加权重和元数据参数，以支持复杂网络建模。
• 输出以交互式 HTML 文件形式渲染，或通过 IFrame 嵌入 Jupyter 单元格，支持对网络结构的实时探索。

实验结果

研究问题

• RQ1 如何在不需深入 JavaScript 技能的前提下，使基于 Python 的数据科学家能够轻松实现交互式网络可视化？
• RQ2 基于 Python 到 VisJS 的抽象层在可视化大规模、复杂网络时的性能和可用性如何？
• RQ3 Pyvis 在 Jupyter 环境中对自定义交互功能（如工具提示、动态缩放和基于物理的布局）的支持程度如何？
• RQ4 Pyvis 与 Pandas 和 NetworkX 等现有数据科学工具栈在实际数据分析工作流中的集成效率如何？
• RQ5 Pyvis 是否能够通过交互式可视化，有效支持对复杂关系数据（如《冰与火之歌》中的人物关系）的有意义探索？

主要发现

• Pyvis 仅通过 Python 代码即可成功实现在 Jupyter Notebook 中的交互式、基于物理的网络可视化，完全隐藏了手动编写 JavaScript 或 HTML 的需求。
• 该库支持对节点和边的丰富自定义，包括基于数值的大小缩放、颜色编码，以及包含邻居列表等自定义元数据的悬停工具提示。
• 在渲染输出中，边的权重具有明显视觉区分，其粗细与权重值成比例，显著增强了连接强度的可解释性。
• 《冰与火之歌》数据集示例表明，Pyvis 能够渲染包含数百个节点和加权边的复杂密集网络，支持通过缩放和悬停实现交互式探索。
• 与 NetworkX 和 Pandas 的集成使得数据转换和网络构建更加高效，显示出与常见数据科学工作流的兼容性。
• 生成的 HTML 输出支持完整交互功能——包括拖拽节点、缩放和点击操作，适用于探索性分析和演示场景。