free-ningirsu941/HOMIE-toolkit

# 🧰 HOMIE-toolkit - 读取与查看 Xperience 数据 [](https://github.com/free-ningirsu941/HOMIE-toolkit) ## 🪟 此应用程序的功能 HOMIE-toolkit 帮助你在 Windows 上打开并处理 **Xperience-10M** 数据。它专为以下需求设计： - 加载标注文件 (annotation files) - 检查校准数据 (calibration data) - 查看手部和身体运动数据 - 可视化深度图和点云数据 - 在自己的脚本中使用相同的数据 - 创建简单的 Rerun 视图以供分析 此工具包旨在读取和可视化数据，而非编辑数据。 ## 📥 下载并打开 1. 打开此页面： https://github.com/free-ningirsu941/HOMIE-toolkit 2. 在仓库页面，下载源文件或列出的最新发布包。 3. 将文件保存到你容易找到的文件夹，例如 `Downloads` 或 `Desktop`。 4. 如果你下载的是 `.zip` 文件，右键点击并选择 **Extract All (全部解压缩)**。 5. 打开解压后的文件夹。 6. 在 `examples` 文件夹中查找示例文件。 ## 🖥️ 系统需求 使用符合以下条件的 Windows PC： - Windows 10 或 Windows 11 - 至少 8 GB 内存 - 足够的可用磁盘空间以存放数据文件 - 首次设置时需要可用的互联网连接 - 如需更流畅的 3D 查看，建议使用现代显卡 为了获得最佳效果，在处理大型数据集时，请使用具有强大 CPU 和更多内存的计算机。 ## 📂 工具包内容 该仓库包含以下主要文件： - `data_loader.py` 打开 `annotation.hdf5` 文件并读取数据，例如校准、SLAM、手部和身体运动、深度图、IMU 和点云数据。它还可以列出文件内容并加载视频帧。 - `visualization.py` 提供用于可视化输出的辅助工具，例如： - `create_blueprint` - `depth_to_colormap` - `depth_to_pointcloud` - `build_line3d_skeleton` - `examples/example_load_annotation.py` 展示如何列出 HDF5 内容、加载标注数据以及检查校准信息。 - `examples/example_visualize_rrd.py` 展示如何将骨骼和深度数据记录到 Rerun `.rrd` 文件中。 ## 🚀 如何在 Windows 上开始使用 请按顺序执行以下步骤： 1. 从此处下载工具包： https://github.com/free-ningirsu941/HOMIE-toolkit 2. 如果文件是 ZIP 压缩包，请解压缩。 3. 在文件资源管理器中打开该文件夹。 4. 找到 `examples` 文件夹。 5. 打开符合你需求的示例文件。 6. 使用文件夹中的文件名来查找主数据加载器和可视化工具。 7. 如果项目包含 Python 设置，请在运行示例之前安装所需的工具。 ## 🧪 首先尝试的事项 从加载示例开始： 1. 打开 `examples/example_load_annotation.py` 2. 使用你的 Python 环境运行它 3. 检查打印出的文件内容 4. 打开你自己的 `annotation.hdf5` 文件 5. 检查校准数据和标注布局 这是确认工具包能否读取你的数据的最简单方法。 ## 🧭 使用你的数据 要处理你自己的 Xperience 数据： 1. 将你的 `annotation.hdf5` 文件放在一个易于访问的文件夹中。 2. 打开加载器示例。 3. 将脚本中的文件路径更改为你自己的文件路径。 4. 再次运行脚本。 5. 查看输出以确认文件已加载。 该加载器专为常见数据任务而构建，例如导出、训练和自定义可视化检查。 ## 👁️ 查看深度和骨骼数据 如果你想以可视化形式查看数据，请使用可视化辅助工具： - 将深度图转换为彩色视图 - 将深度图转换为点云 - 绘制 3D 骨骼线条视图 - 创建 Rerun blueprint 以便更清晰地显示 这些工具可帮助你检查运动和深度数据，而无需自己构建可视化组件。 ## 🛠️ 示例工作流 一个简单的工作流如下所示： 1. 下载并解压 HOMIE-toolkit 2. 打开示例文件 3. 加载 `annotation.hdf5` 文件 4. 检查文件内容 5. 查看校准数据 6. 使用可视化辅助工具 7. 如有需要，保存 Rerun 输出 ## 📁 推荐的文件夹布局 使用如下文件夹设置： - `HOMIE-toolkit` - `examples` - `assets` - 你的 `annotation.hdf5` 文件 - 你的输出文件 将数据文件放在工具包文件夹附近可以使其更易于查找和加载。 ## 🔧 各辅助功能的作用 ### 创建 blueprint 设置 Rerun 布局以实现清晰查看。 ### depth 转 colormap 将深度数据转换为彩色图像，以便于阅读。 ### depth 转 pointcloud 将深度数据转换为 3D 点云视图。 ### 构建 line3d skeleton 根据身体或手部关节数据构建 3D 骨骼。 ## 🧩 常见用途 人们可以使用此工具包进行： - 在训练模型之前检查数据 - 制作自定义图表和视图 - 测试标注文件 - 检查校准设置 - 探索手部和身体运动数据 - 构建小型研究工具 ## ⌨️ 运行示例文件 如果你的 Windows 环境安装了 Python，示例文件是最容易的起点： 1. 打开终端或命令提示符窗口 2. 进入工具包文件夹 3. 运行你想要测试的示例脚本 4. 在窗口中阅读输出 5. 使用你自己的文件路径重复操作 如果脚本打开了查看器，请保持窗口打开，直到你完成数据检查。 ## 📌 你可能会看到的文件类型 该工具包旨在处理以下类型的文件： - `.hdf5` - `.rrd` - 加载过程中使用的图像和视频帧数据 - 与数据集相关的校准和运动数据 ## 🧠 顺畅使用技巧 - 保持文件名简单 - 将大型数据文件存储在空间充足的驱动器上 - 先使用一个测试文件 - 在使用可视化示例之前，先从加载示例开始 - 将输出文件保存在单独的文件夹中，以便于查找 ## 🧱 项目布局一览 | 路径 | 用途 | |------|----------------| | `data_loader.py` | 读取标注及相关数据 | | `visualization.py` | 构建深度、骨骼和点云视图 | | `examples/example_load_annotation.py` | 展示如何检查数据文件 | | `examples/example_visualize_rrd.py` | 展示如何创建 Rerun 视图 | ## 📎 再次下载 如果你需要再次获取工具包，请使用此链接： [HOMIE-toolkit 下载页面](https://github.com/free-ningirsu941/HOMIE-toolkit) ## 🔍 如果文件无法打开，请检查什么 - 确保文件路径正确 - 确认文件是 `annotation.hdf5` 文件 - 检查文件是否仍处于 ZIP 压缩包中 - 在使用可视化示例之前，先尝试加载示例 - 确认你的 Windows 用户账户拥有该文件夹的读取权限 ## 📦 建议首先使用的文件 首先使用一个较小的示例 `annotation.hdf5` 文件。这样可以更容易验证： - 加载器正常工作 - 校准数据出现 - 标注列表可读 - 可视化输出看起来正确

标签：HDF5, HOMIE-toolkit, IMU数据, Python, Rerun, SLAM, Windows软件, Xperience-10M, 三维重建, 二进制发布, 人体动作捕捉, 开源工具, 手部姿态估计, 数据加载器, 数据标注, 无后门, 深度图处理, 点云可视化, 计算机视觉, 逆向工具, 骨骼绘制