Polyscope 开源项目教程

1. 项目介绍

Polyscope 是一个用于 3D 数据（如网格和点云）的 C++/Python 查看器和用户界面。它允许用户注册数据并快速生成信息丰富且美观的可视化效果，既可以通过编程方式实现，也可以通过动态 GUI 实现。Polyscope 设计轻量级，不会“接管”整个程序，易于与现有代码库和流行库集成。其主要目标是提供一个通过一行代码即可访问的有用数据可视化界面。

Polyscope 采用结构和数量的范式：

• 结构：场景中的几何对象，如表面网格或点云。
• 数量：与结构关联的数据，如标量函数或向量场。

当这些结构和数量被注册时，Polyscope 会在交互式 3D 场景中显示它们，处理诸如切换可见性、颜色映射数据和调整映射、“拾取”以在场景中点击并查询数值量等常见问题。

2. 项目快速启动

2.1 安装 Polyscope

首先，确保你已经安装了必要的依赖项（如 CMake、Eigen 等），然后从 GitHub 克隆 Polyscope 项目：

git clone https://github.com/nmwsharp/polyscope.git
cd polyscope
mkdir build
cd build
cmake ..
make

2.2 快速启动示例

以下是一个简单的 C++ 示例，展示如何使用 Polyscope 可视化点云和表面网格：

#include "polyscope/polyscope.h"
#include "polyscope/surface_mesh.h"

int main() {
    // 初始化 Polyscope
    polyscope::init();

    // 注册一个点云
    std::vector<std::array<double, 3>> points = {{0, 0, 0}, {1, 1, 1}, {2, 2, 2}};
    polyscope::registerPointCloud("my points", points);

    // 注册一个表面网格
    std::vector<std::array<double, 3>> meshVerts = {{0, 0, 0}, {1, 0, 0}, {1, 1, 0}, {0, 1, 0}};
    std::vector<std::array<size_t, 3>> meshFaces = {{0, 1, 2}, {0, 2, 3}};
    polyscope::registerSurfaceMesh("my mesh", meshVerts, meshFaces);

    // 添加一个标量和向量函数到网格上
    std::vector<double> scalarQuantity = {1.0, 2.0, 3.0, 4.0};
    std::vector<std::array<double, 3>> vectorQuantity = {{1, 0, 0}, {0, 1, 0}, {0, 0, 1}, {1, 1, 0}};
    polyscope::getSurfaceMesh("my mesh")->addVertexScalarQuantity("my_scalar", scalarQuantity);
    polyscope::getSurfaceMesh("my mesh")->addFaceVectorQuantity("my_vector", vectorQuantity);

    // 在 3D UI 中查看注册的点云和网格
    polyscope::show();

    return 0;
}

3. 应用案例和最佳实践

3.1 应用案例

Polyscope 广泛应用于以下领域：

• 计算机图形学：可视化网格和点云数据。
• 计算机视觉：分析和可视化 3D 点云数据。
• 机器人学：可视化机器人路径和环境。

3.2 最佳实践

• 数据管理：使用 Polyscope 的结构和数量范式，确保数据组织清晰。
• 性能优化：对于大型数据集，考虑使用分块加载和动态更新。
• 用户交互：利用 Polyscope 的交互功能，如拾取和动态 GUI，增强用户体验。

4. 典型生态项目

Polyscope 可以与以下开源项目集成：

• Geometry Central：用于几何处理的 C++ 库。
• libIGL：用于几何处理的 C++ 库。
• DGtal：用于数字几何处理的 C++ 库。
• OpenMesh：用于网格处理的 C++ 库。

这些项目与 Polyscope 结合使用，可以实现更复杂和强大的 3D 数据可视化和分析功能。