机器人几何资料库：基本形状类型与尺寸下标怎样分读

机器人几何资料库中的基本形状类型，决定了尺寸下标应怎样解释。同样位于dimensions数组开头的数值，在不同形状下可能描述不同的几何量。若数据库导出只保留几个数字，删掉type字段，就会丢失解释依据。本文阅读ROS 2 Jazzy与MoveIt公开消息定义，使用虚构目录条目，不导入模型、不计算几何，也不运行规划。

先确认基本形状类型再读数组

官方SolidPrimitive定义单列type与dimensions，并用不同常量描述尺寸数组中的下标含义。这些常量需要和相应类型一起读。资料库不宜把所有基本形状的第一项统一命名为长度，再让后续读者猜测对象。

假设虚构目录同时收录盒体、球体和圆柱体。编辑可以保留它们各自的类型名称，再按原定义展开尺寸字段。这样的字段解释只说明模型数据应如何理解，不证明现实零件具有相同形状，也不表示目录条目已经通过尺寸检验。

盒体与球体的第一项含义不同

BOX类型的BOX_X、BOX_Y、BOX_Z分别指向对应边长。SPHERE类型只使用一个分量，SPHERE_RADIUS表示球体半径。因此，第一项处在相同下标，并不意味着它们都是同一个边长字段。类型与下标共同确定该位置的含义。

虚构导出表若把球体第一项放进盒体X边长列，接收者应要求恢复原始类型与尺寸声明。不能先假设它是直径，再凭外观替贡献者改数值。本文没有实际目录数据，既不执行半径直径换算，也不依据一张渲染图反推缺失的尺寸。

圆柱体还需要保留轴向背景

同一定义对CYLINDER与CONE说明中心线沿Z轴，并分别给出高度与基底半径的下标。圆柱体的第一项是高度，第二项是半径。这里的Z轴属于形状定义的局部背景，不能因为目录页面横向排版，就把高度自动改读为屏幕竖向距离。

数据库摘要可用高度和半径各自的字段名表达这个关系，并保留原始数组声明供回查。若模型后来换成另一类基本形状，应重新解释尺寸项，而不是仅修改类型文字却沿用旧列名。字段结构的修订与实际零件改变，仍需不同证据支持。

尺寸数组不能代替形状的放置位姿

官方MoveIt CollisionObject定义分别列出基本形状数组和相应位姿数组，并说明几何位姿相对于对象位姿的关系。读目录时，应让形状大小和它在对象中的放置保持各自身份；一组尺寸值本身并没有包含全部放置关系。

例如虚构条目有圆柱尺寸，却没有配套位姿背景。接收者可以准确指出尺寸材料存在、放置关系未说明，不能由此补成该圆柱一定与机器人某个轴重合。消息定义描述模型表示方式，并不观察真实安装，也不证明碰撞模型适合某个任务。

让目录字段在转摘后仍可解释

一份清楚的几何资料条目可保留消息类型、版本分支、基本形状类型及尺寸下标说明，再把位姿材料另行关联。若缺少某项内容，应说明缺少哪种关系。用形状已核对一词包住这些不同问题，会让后续使用者误以为所有几何信息都已确认。

两张原创图只展示定义阅读关系，不展示真实零件或尺寸数值。相关内容可进入机器人几何资料栏目与模型参考栏目。保留基本形状类型与尺寸下标的对应关系，能让目录更容易追溯，同时不把数据解释扩大成实物测量或运动许可。