PointNet分类模型必须对输入点云做固定数量采样，因PyTorch不提供原生点云预处理，要求所有输入为N×3张量且N统一（如1024），点数不一则堆叠报错；需在Dataset的__getitem__中用torch.randperm随机下采样或补零并掩码，禁用collate_fn重采样；T-Net非可选而是训练稳定关键，须加入正交性正则；全局池化必须用torch.max而非mean，且输入须归一化至单位球内。
PointNet分类模型必须对输入点云做固定数量采样
PyTorch本身不提供点云预处理，PointNet要求所有输入为 N×3 张量（N个点，每个点x/y/z坐标），且N必须统一（如1024）。实际点云往往点数不一，直接堆叠会报错：RuntimeError: stack expects each tensor to be equal size。
实操建议：
- 用
torch.utils.data.Dataset子类在__getitem__中调用torch.randperm随机下采样，或用torch.nn.functional.interpolate（需先转为 (1, 3, N) 再插值）——但后者不适合无序点云，推荐前者 - 若原始点云少于目标点数（如只有200个点），应补零而非重复采样，否则引入虚假局部结构；补零后需在模型中屏蔽这些位置（例如在
torch.max前用mask过滤） - 别在 DataLoader 的
collate_fn里做重采样——它运行在多进程子进程中，无法共享随机状态，会导致所有 batch 采样同一组点索引
特征变换矩阵（T-Net）不是可选模块，而是训练稳定的关键
原始 PointNet 论文中的 input_transform_net 是一个小型 MLP + 对称函数，输出 3×3 正交变换矩阵，用于对齐点云坐标系。跳过它看起来能省参数，但实际训练中 loss 会剧烈震荡，甚至完全不收敛。
常见错误现象：
立即学习“Python免费学习笔记（深入）”；
- 训练准确率卡在 10%–20%，和随机猜测差不多
-
loss.backward()后grad在transform层全为None—— 很可能是你用了torch.no_grad()或忘了在forward中把变换矩阵加进计算图 - 模型对旋转敏感：测试时绕 z 轴转 15°，分类结果就全错
正确做法是让 T-Net 输出的矩阵参与 loss 计算：在损失函数中加入正则项 torch.mean(torch.norm(torch.bmm(M, M.transpose(1, 2)) - torch.eye(3), dim=(1, 2)))，系数通常设为 0.001。
全局池化必须用 torch.max，不能用 torch.mean
PointNet 的核心设计是用最大池化（max-pooling）聚合点特征，因为它对点顺序不变、对异常点鲁棒。换成均值池化看似更平滑，但会显著降低 ModelNet40 上的分类准确率（实测下降 8–12 个百分点）。
注意细节：
-
torch.max(x, dim=1)返回(values, indices)，只需取values；别误用torch.max(x, dim=0)，那是在 batch 维度上取最大，结果形状错乱 - 如果用了 BatchNorm1d，输入必须是
(B, C, N)形式；而 max 池化后变成(B, C)，后续 FC 层前无需再 permute - 不要在池化后接 Dropout——PointNet 的泛化能力主要来自 max 池化的内在不变性，Dropout 反而破坏该特性
ModelNet40 数据加载时路径和标签映射极易出错
官方 ModelNet40 是按文件夹组织的：modelnet40_normal_resampled/airplane/airplane_0001.txt，每行三个浮点数。但很多公开脚本直接用 os.listdir 获取类别名，结果把 .DS_Store 或 Thumbs.db 当成类别，导致 IndexError: list index out of range。
安全做法：
- 硬编码类别列表：
CLASS_NAMES = ['airplane', 'bathtub', ..., 'vase']，长度必须为 40；用sorted(os.listdir(root))得到的顺序不可靠 - 读取
.txt文件时用np.loadtxt(f, dtype=np.float32)，别用pd.read_csv——有些文件末尾有空行，pandas 会多读一行 nan 导致 shape 变成 (N+1, 3) - 验证集划分不能按文件名哈希（如
hash(filename) % 10 == 0），ModelNet40 官方已提供 train/test 划分，应严格使用其train.txt/test.txt列表
最常被忽略的一点：PointNet 输入需要归一化到单位球内，不是简单减均值除标准差。必须对每个点云单独做——先中心化（减去质心），再缩放到最大距离为 1（除以 torch.max(torch.norm(points, dim=1))）。漏掉这步，模型基本学不会。
