donut
收藏资源简介:
DONUT(Dataset Of MaNifold strUcTures)是一个包含29,517个3D样本的数据集,每个样本由水密网格和对应的点云组成。数据集中的每个样本包含一个或多个水密网格组件和一个8192点的点云表示。网格数据以.npz格式存储,包含顶点和面信息;点云数据以.npy格式存储。每个样本通过唯一的id字符串标识,并在metadata.csv中记录其拓扑元数据,包括总孔数(genus)、连接组件数量(components)以及按孔数分布的组件数量(sample_code)。该数据集适用于3D几何处理、形状分析和机器学习任务,特别是那些需要理解3D形状拓扑结构的应用。
DONUT (Dataset Of Manifold Structures) is a dataset consisting of 29,517 3D samples. Each sample comprises a watertight mesh and its corresponding point cloud. Each sample in the dataset contains one or more watertight mesh components and an 8192-point point cloud representation. Mesh data is stored in .npz format, containing vertex and face information; point cloud data is stored in .npy format. Each sample is identified by a unique ID string, and its topological metadata is recorded in metadata.csv, including the total genus, the number of connected components, and the component count distributed by genus (sample_code). This dataset is suitable for 3D geometry processing, shape analysis, and machine learning tasks, especially applications that require understanding the topological structure of 3D shapes.
DONUT (Dataset Of MaNifold strUcTures) 数据集概述
数据集简介
DONUT 是一个包含 3D 样本的数据集,每个样本由水密网格和对应的点云组成。数据集总共有 29,517 个样本。
数据内容与结构
每个样本包含一个或多个水密网格组件和一个包含 8192 个点的点云表示。
数据集文件结构如下:
obj/目录:包含.npz格式的网格文件。pcd/目录:包含.npy格式的点云文件。metadata.csv文件:包含每个样本的拓扑元数据。
obj/ 目录中有 29,517 个网格文件,pcd/ 目录中有 29,517 个点云文件。
文件格式说明
网格文件
每个网格样本存储为 obj/ 目录下的 .npz 文件,归档包含:
vertices.npyfaces.npy
一个样本可能包含一个或多个水密连接的网格组件。
点云文件
每个点云样本存储为 pcd/ 目录下的 .npy 文件。
每个点云包含 8192 个点,并与具有相同 id 的样本对应。
样本标识
每个样本由一个唯一的 id 字符串标识。
相同的 id 用于:
obj/中的文件名pcd/中的文件名metadata.csv中的id列
例如,样本 id 为 abc123 的文件是:
obj/.../abc123.npzpcd/.../abc123.npy
元数据说明
metadata.csv 包含以下列:
id:样本的唯一标识符genus:样本中所有网格组件的总孔洞数components:样本中连接的网格组件总数sample_code:描述每个亏格数组件数量的 6 个整数数组
sample_code 含义
sample_code 是一个包含 6 个整数的数组:[n0, n1, n2, n3, n4, n5]
其中 ni 是样本中亏格数为 i 的网格组件数量。
从 sample_code 计算元数据值:
genus = sum(i * ni for i in [0, 1, 2, 3, 4, 5])components = sum(ni for i in [0, 1, 2, 3, 4, 5])
即:
genus是整个样本中的总孔洞数components是整个样本中的连接组件总数
数据集总结
DONUT 是一个包含 29,517 个流形 3D 结构样本的数据集。 每个样本提供:
- 一个
.npz格式的网格文件 - 一个 8192 个点的
.npy格式点云 metadata.csv中的一个元数据条目
元数据通过总亏格数、连接组件数量和组件级亏格分布来描述每个样本的整体拓扑结构。





