检查几何体
功能概述
检查几何体工具用于扫描输入矢量要素中的几何质量问题，并输出问题清单表格。该工具不会修改输入要素，也不会自动修复问题，主要用于数据入库、空间分析和制图生产前的质量检查。
检查结果会记录出现问题的要素标识、问题类型和问题描述，便于后续人工核查或配合【修复几何体】工具处理。
原理简介
工具逐条检查输入要素的 geometry 字段，识别以下问题：
| 问题类型 | 检查内容 | 输出说明 |
|---|---|---|
| 空几何 | 几何值为空或缺失。 | ProblemType 为 空几何。 |
| 空几何对象 | 几何对象存在，但没有坐标。 | ProblemType 为 空几何对象。 |
| 无效几何 | 几何不符合 Shapely/OGC 有效性规则。 | Description 会记录底层有效性说明，例如自相交位置。 |
| 重复顶点 | 相邻顶点坐标完全相同。 | 记录重复顶点的大致位置。 |
| 未闭合环 | 面要素外环首尾坐标不一致。 | 主要面向异常面环结构。 |
| 过短线段 | 线段长度小于【线段长度容差】。 | Description 会记录检测到的线段长度。 |
| 空 Z 值 | 三维几何中存在 NaN 或空 Z 坐标。 | 用于识别 3D 要素中的高程缺失。 |
| 错误的包络 | 几何包络范围与几何范围不一致。 | 用于发现异常几何范围。 |
输出表格包含三列：FeatureID、ProblemType、Description。
适用场景
- 数据入库前质检：检查供应商、外业采集或历史成果中的几何异常。
- 空间分析前预检查：降低叠加、裁剪、缓冲区、空间连接等工具因无效几何失败的概率。
- 编辑后巡检：确认手工编辑、批量处理或格式转换没有引入重复顶点、空几何等问题。
- 三维数据检查：发现带 Z 几何中的空高程值。
参数介绍
| 参数名称 | 参数描述 | 补充说明 |
|---|---|---|
| 输入矢量文件 | 需要检查的矢量要素数据集。 | 必填；支持点、线、面及多部件几何。 |
| 线段长度容差 | 判断过短线段的阈值。 | 必填；默认值：1e-16；单位与输入要素坐标系一致。 |
| 输出表格文件 | 输出的问题清单表格。 | 必填；支持表格输出格式。 |
输出结果
输出为表格。若检查到问题，每一行表示一个要素的一类几何问题：
| 字段 | 含义 |
|---|---|
FeatureID | 出现问题的输入要素索引。 |
ProblemType | 问题类型，例如 无效几何、重复顶点、过短线段。 |
Description | 问题描述或底层几何库返回的解释信息。 |
如果输出表格为空，表示在当前检查规则和容差设置下未发现问题。
操作步骤
- 启动工具：打开【计算工具箱】工具箱 → 导航至【矢量工具】 > 【要素处理】 > 【构建】 → 启动【检查几何体】工具窗格。
- 设置输入：选择需要质检的【输入矢量文件】。
- 设置容差：按数据精度设置【线段长度容差】；通常保持默认即可。
- 配置输出：设置【输出表格文件】路径与名称。
- 执行检查：点击【运行】，完成后打开输出表格查看
ProblemType和Description。 - 处理问题：根据问题类型决定是否人工编辑、重新采集、删除异常要素或运行【修复几何体】。
注意事项
- 本工具仅用于“发现”问题，不执行自动修复。若需修复，请使用【修复几何体】工具。
- 线段长度容差单位与坐标系一致；地理坐标系下单位为度，投影坐标系下通常为米。
FeatureID使用输入要素索引，不一定等同于业务字段中的编号或OBJECTID。- 当前检查规则覆盖常见几何问题，但不等同于完整拓扑规则检查，例如相邻面缝隙、重叠等需要使用拓扑类工具。
- 修复后建议再次运行本工具，确认问题清单为空或符合质量要求。