修复几何 (数据管理工具)

汇总

检查要素的几何问题并修复它们。如发现问题，将对其执行修复，并将通过一行描述识别要素及修复的几何问题。

此工具将使用与 检查几何 工具相同的逻辑来修复几何问题。

了解有关检查和修复几何的详细信息

用法

注意：

此工具会修改输入数据。有关详细信息以及避免意外更改数据的策略，请参阅修改或更新输入数据的工具。

有效的输入格式包括 shapefile 以及存储在文件地理数据库、企业级数据库、企业级地理数据库、GeoPackage 或 SpatiaLite 数据库中的要素类。移动地理数据库不受支持。对于存储在企业级数据库或企业级地理数据库中的要素类，支持以下空间类型：
- Microsoft SQL Server—几何和地理。
- PostgreSQL—PostGIS、几何和地理
- Oracle—SDO_Geometry
- SAP HANA—ST_Geometry
许可：

如果输入位于企业级数据库或企业级地理数据库中，则需要 Desktop Standard 或 Desktop Advanced 许可。
不支持存储在企业级地理数据库中并注册为版本的要素类。
启用撤消 切换按钮对于企业级地理数据库的输入无效。
下面是所有几何问题和此工具将执行的相应修复的列表：
- Null geometry—从要素类中删除记录。要保留具有空几何的记录，请取消选中删除几何为空的要素参数。
- Short segment—删除几何的短线段。
- Incorrect ring ordering—更新几何以获得正确的环走向。
- Incorrect segment orientation—更新几何以获得正确的线段方向。
- Self intersections—融合面中的重叠区域。
- Unclosed rings—通过连接环的端点可将非闭合环闭合。
- Empty parts—删除 null 或空的部分。
- Duplicate vertex—删除其中一个折点。
- Mismatched attributes—更新 z 或 m 坐标以实现匹配。
- Discontinuous parts—根据现有的不连续部分创建多部分。
- Empty Z values—z 值将设置为 0。
- Bad envelope—更新要素的包络矩形以实现更正。
- Bad dataset extent—要素类范围将更新为正确范围。
下面是可能会由企业级地理数据库中存储的数据导致的几何问题和此工具将执行的相应修复（如果存在）的列表：
- NEEDS_REORDERING—将对形状进行重新排序，并移除重复点。
- SE_INVALID_ENTITY_TYPE—不会修复实体类型（必须删除要素）。
- SE_SHAPE_INTEGRITY_ERROR—可能不会修复形状。
- SE_INVALID_SHAPE_OBJECT—可能不会修复形状对象。
- SE_COORD_OUT_OF_BOUNDS—不会修复坐标。
- SE_POLY_SHELLS_OVERLAP—重叠外壳将被合并。
- SE_TOO_FEW_POINTS—不会修复点。
- SE_INVALID_PART_SEPARATOR—可能不会修复部分分隔符。
- SE_INVALID_POLYGON_CLOSURE—未闭合的外壳将被丢弃（生成面可能留空）。
- SE_INVALID_OUTER_SHELL—将尝试修复要素的外壳；在此过程中可能会丢弃外壳。
- SE_ZERO_AREA_POLYGON—面将转换为空形状。
- SE_POLYGON_HAS_VERTICAL_LINE—将移除垂直线（形状可能转换为 2D）。
- SE_OUTER_SHELLS_OVERLAP—重叠部分将被合并。
- SE_SELF_INTERSECTING—将根据需要添加交叉点。
注:

可能无法使用 ArcGIS 工具修复与企业级数据库中存储的数据相关的某些问题。
执行修复后，此工具将重新评估所得几何，如果发现了其他问题，将执行该问题的相关修复。例如，修复具有 Incorrect ring ordering 问题的几何结果可能会导致具有 Null geometry 问题的几何。
Esri 几何验证选项通过 Esri 简化方法确保几何在拓扑上是正确的。对于存储在企业级地理数据库中的数据，仅 Esri 验证可用。
OGC 几何验证方法选项确保几何符合地理信息的 OpenGIS 执行标准（简单要素访问）第 1 部分：公用架构中定义的开放地理空间联盟 OGC 规范。
使用 OGC 选项修复要素的几何后，任何后续的编辑或修改都可能导致几何不再符合 OGC 规范。

修改要素后，运行 检查几何 工具以检查新几何问题。如有必要，重新运行修复几何工具。
使用 OGC 选项验证或修复后的几何将适用于 Esri 选项。要了解有关这两种验证方法的详细信息，请参阅什么是简单面。

标注	说明	数据类型
输入要素	将处理的要素类或图层。不支持要素服务。许可：如果输入位于企业级数据库或企业级地理数据库中，则需要 Desktop Standard 或 Desktop Advanced 许可。	Feature Layer
删除几何为空的要素（可选）	指定是否删除几何为空的要素。注: 仅选中选项适用于来自企业级数据库、企业级地理数据库、GeoPackage 或 SpatiaLite 数据库的输入。选中—从输入中删除几何为空的要素。这是默认设置。未选中—不从输入中删除几何为空的要素。	Boolean
验证方法（可选）	指定用于识别几何问题的几何验证方法。 Esri—将使用 Esri 几何验证方法。这是默认设置。 OGC—将使用 OGC 几何验证方法。	String

标注

说明

数据类型

输入要素

将处理的要素类或图层。

不支持要素服务。

许可：

如果输入位于企业级数据库或企业级地理数据库中，则需要 Desktop Standard 或 Desktop Advanced 许可。

Feature Layer

删除几何为空的要素

（可选）

指定是否删除几何为空的要素。

注:

仅选中选项适用于来自企业级数据库、企业级地理数据库、GeoPackage 或 SpatiaLite 数据库的输入。

选中—从输入中删除几何为空的要素。这是默认设置。
未选中—不从输入中删除几何为空的要素。

Boolean

验证方法

（可选）

指定用于识别几何问题的几何验证方法。

Esri—将使用 Esri 几何验证方法。这是默认设置。
OGC—将使用 OGC 几何验证方法。

String

派生输出

标注	说明	数据类型
修复的输入要素	更新后的输入要素。	Feature Layer

arcpy.management.RepairGeometry(in_features, {delete_null}, {validation_method})

名称说明数据类型

名称	说明	数据类型
in_features	将处理的要素类或图层。不支持要素服务。许可：如果输入位于企业级数据库或企业级地理数据库中，则需要 Desktop Standard 或 Desktop Advanced 许可。	Feature Layer
delete_null （可选）	指定是否删除几何为空的要素。注: 仅 `KEEP_NULL` 选项适用于来自企业级数据库、企业级地理数据库、GeoPackage 或 SpatiaLite 数据库的输入。 `DELETE_NULL`—从输入中删除几何为空的要素。这是默认设置。 `KEEP_NULL`—不从输入中删除几何为空的要素。	Boolean
validation_method （可选）	指定用于识别几何问题的几何验证方法。 `ESRI`—将使用 Esri 几何验证方法。这是默认设置。 `OGC`—将使用 OGC 几何验证方法。	String

in_features

将处理的要素类或图层。

不支持要素服务。

许可：

如果输入位于企业级数据库或企业级地理数据库中，则需要 Desktop Standard 或 Desktop Advanced 许可。

Feature Layer

delete_null

（可选）

指定是否删除几何为空的要素。

注:

仅 KEEP_NULL 选项适用于来自企业级数据库、企业级地理数据库、GeoPackage 或 SpatiaLite 数据库的输入。

DELETE_NULL—从输入中删除几何为空的要素。这是默认设置。
KEEP_NULL—不从输入中删除几何为空的要素。

Boolean

validation_method

（可选）

指定用于识别几何问题的几何验证方法。

ESRI—将使用 Esri 几何验证方法。这是默认设置。
OGC—将使用 OGC 几何验证方法。

String

派生输出

名称	说明	数据类型
out_feature_class	更新后的输入要素。	Feature Layer

代码示例

RepairGeometry 示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下对 shapefile 使用 RepairGeometry 函数。

import arcpy
arcpy.management.RepairGeometry("c:/data/data.shp")

RepairGeometry 示例 2（独立脚本）

以下独立脚本是如何在脚本中应用 RepairGeometry 函数的示例。

# Description:
#   Goes through the table generated by the Check Geometry tool and does
#   the following
#   1) backs-up all features which will be 'fixed' to a "_bad_geom" feature class
#   2) runs RepairGeometry on all feature classes listed in the table

import arcpy
import os

# Table that was produced by Check Geometry tool
table = r"c:\temp\data.gdb\cg_sample1"

# Create local variables
fcs = []

# Loop through the table and get the list of fcs
for row in arcpy.da.SearchCursor(table, ("CLASS")):
    # Get the class (feature class) from the cursor
    if not row[0] in fcs:
        fcs.append(row[0])

# Now loop through the fcs list, backup the bad geometries into fc + "_bad_geom"
# then repair the fc
print("> Processing {0} feature classes".format(len(fcs)))
for fc in fcs:
    print("Processing " + fc)
    lyr = 'temporary_layer'
    if arcpy.Exists(lyr):
        arcpy.management.Delete(lyr)

    tv = "cg_table_view"
    if arcpy.Exists(tv):
        arcpy.management.Delete(tv)

    arcpy.management.MakeTableView(table, tv, ("\"CLASS\" = '%s'" % fc))
    arcpy.management.MakeFeatureLayer(fc, lyr)
    arcpy.management.AddJoin(lyr, arcpy.Describe(lyr).OIDFieldName, tv, "FEATURE_ID")
    arcpy.management.CopyFeatures(lyr, fc + "_bad_geom")
    arcpy.management.RemoveJoin(lyr, os.path.basename(table))
    arcpy.management.RepairGeometry(lyr)

环境

当前工作空间, 范围, 并行处理因子

特殊情况

并行处理因子: If the environment is not set (the default) or is set to 0, parallel processing will be disabled. If set to 100, the tool will attempt to distribute the work to all the logical cores on the machine. Specifying a factor between 1 and 99 will cause the tool to identify the percentage of logical cores to use by applying the formula (Parallel Processing Factor / 100 * Logical Cores) rounded up to the nearest integer. If the result of this formula is 0 or 1, parallel processing will not be enabled.

许可信息

基本: 受限
部分参数会受到许可级别的限制。
标准: 是
高级: 是

修复几何 (数据管理工具)

汇总

用法

注意：

许可：

注:

参数

许可：

注:

派生输出

环境

特殊情况

许可信息

相关主题